valtech-components 2.0.691 → 2.0.692

package/lib/services/i18n/config.d.ts

@@ -0,0 +1,29 @@
+import { EnvironmentProviders } from '@angular/core';
+import { I18nConfig } from './types';
+/**
+ * Configura el sistema de internacionalización de Valtech Components.
+ *
+ * @param config Configuración de i18n
+ * @returns Providers para agregar en app.config.ts
+ *
+ * @example
+ * // app.config.ts
+ * import { provideValtechI18n } from 'valtech-components';
+ * import { GLOBAL_CONTENT } from './i18n/_global';
+ * import { LOGIN_CONTENT } from './i18n/login.i18n';
+ *
+ * export const appConfig: ApplicationConfig = {
+ *   providers: [
+ *     provideValtechI18n({
+ *       defaultLanguage: 'es',
+ *       supportedLanguages: ['es', 'en'],
+ *       detectBrowserLanguage: true,
+ *       content: {
+ *         '_global': GLOBAL_CONTENT,
+ *         'Login': LOGIN_CONTENT,
+ *       }
+ *     }),
+ *   ]
+ * };
+ */
+export declare function provideValtechI18n(config?: I18nConfig): EnvironmentProviders;

package/lib/services/i18n/default-content.d.ts

@@ -0,0 +1,30 @@
+import { ContentStore } from './types';
+/**
+ * Traducciones por defecto de valtech-components.
+ *
+ * Estas traducciones se cargan automáticamente cuando se usa provideValtechI18n()
+ * sin necesidad de configuración adicional.
+ *
+ * Las apps pueden sobrescribir cualquier key pasando su propio content:
+ *
+ * @example Sobrescribir traducciones específicas
+ * ```typescript
+ * provideValtechI18n({
+ *   content: {
+ *     _global: {
+ *       es: { success: '¡Lo hicimos!' },  // Sobrescribe solo esta key
+ *       en: { success: 'We did it!' },
+ *     },
+ *   },
+ * })
+ * ```
+ *
+ * @example Desactivar traducciones por defecto
+ * ```typescript
+ * provideValtechI18n({
+ *   includeDefaultContent: false,
+ *   content: MY_CUSTOM_CONTENT,
+ * })
+ * ```
+ */
+export declare const VALTECH_DEFAULT_CONTENT: ContentStore;

package/lib/services/i18n/i18n.service.d.ts

@@ -0,0 +1,112 @@
+import { I18nLang, LanguagesContent, ContentStore } from './types';
+import * as i0 from "@angular/core";
+/**
+ * Servicio de internacionalización basado en Angular Signals.
+ *
+ * Características:
+ * - Sin RxJS: usa Signals para evitar memory leaks y congelamiento
+ * - Namespace-based: organiza traducciones por contexto
+ * - Fallback multi-nivel: namespace → _global → placeholder
+ * - Interpolación: soporta {variable} en textos
+ *
+ * @example
+ * // En un componente
+ * i18n = inject(I18nService);
+ *
+ * // Obtener texto
+ * const title = this.i18n.t('title', 'Login');
+ *
+ * // Con interpolación
+ * const welcome = this.i18n.t('welcome', 'Login', { name: 'Juan' });
+ *
+ * // Cambiar idioma
+ * this.i18n.setLanguage('en');
+ */
+export declare class I18nService {
+    private readonly _lang;
+    private readonly _content;
+    private readonly _supportedLanguages;
+    readonly lang: import("@angular/core").Signal<I18nLang>;
+    readonly supportedLanguages: import("@angular/core").Signal<I18nLang[]>;
+    readonly isSpanish: import("@angular/core").Signal<boolean>;
+    readonly isEnglish: import("@angular/core").Signal<boolean>;
+    constructor();
+    /**
+     * Obtiene texto traducido (alias corto de getText)
+     *
+     * @param key Clave del texto
+     * @param namespace Namespace (default: '_global')
+     * @param data Variables para interpolación
+     * @returns Texto traducido o placeholder [namespace.key]
+     *
+     * @example
+     * i18n.t('submit');                    // busca en _global
+     * i18n.t('title', 'Login');            // busca en Login
+     * i18n.t('welcome', 'Login', {name});  // con interpolación
+     */
+    t(key: string, namespace?: string, data?: Record<string, string>): string;
+    /**
+     * Obtiene texto traducido
+     *
+     * Fallback order:
+     * 1. content[namespace][lang][key]
+     * 2. content['_global'][lang][key]
+     * 3. "[namespace.key]" (placeholder)
+     */
+    getText(key: string, namespace?: string, data?: Record<string, string>): string;
+    /**
+     * Cambia el idioma de la aplicación
+     *
+     * @param lang Nuevo idioma
+     * @param forceReload Si true, recarga la página (fallback si reactividad falla)
+     */
+    setLanguage(lang: I18nLang, forceReload?: boolean): void;
+    /**
+     * Registra contenido de traducciones para un namespace
+     *
+     * @param namespace Nombre del namespace
+     * @param content Contenido de traducciones
+     *
+     * @example
+     * i18n.registerContent('Login', {
+     *   es: { title: 'Iniciar sesión' },
+     *   en: { title: 'Sign in' }
+     * });
+     */
+    registerContent(namespace: string, content: LanguagesContent): void;
+    /**
+     * Registra múltiples namespaces de una vez
+     *
+     * @param contentStore Objeto con namespaces como keys
+     */
+    registerContentBulk(contentStore: ContentStore): void;
+    /**
+     * Configura los idiomas soportados
+     */
+    setI18nLanguages(languages: I18nLang[]): void;
+    /**
+     * Obtiene todos los namespaces registrados
+     */
+    getNamespaces(): string[];
+    /**
+     * Verifica si un namespace tiene traducciones
+     */
+    hasNamespace(namespace: string): boolean;
+    /**
+     * Carga idioma guardado en localStorage o detecta del navegador
+     */
+    private loadStoredLanguage;
+    /**
+     * Valida si un idioma está soportado
+     */
+    private isValidLanguage;
+    /**
+     * Reemplaza {variable} en texto con valores de data
+     *
+     * @example
+     * interpolate('Hola {name}', { name: 'Juan' }) // 'Hola Juan'
+     */
+    private interpolate;
+    static ɵfac: i0.ɵɵFactoryDeclaration<I18nService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<I18nService>;
+}

package/lib/services/i18n/index.d.ts

@@ -0,0 +1,6 @@
+export { I18nLang, LanguagesContent, ContentStore, I18nConfig, LANG_STORAGE_KEY, } from './types';
+export { I18nService } from './i18n.service';
+export { InputI18nHelper, InputMetadataWithI18n, FormMetadataWithI18n, FormSectionWithI18n, ButtonMetadataWithI18n, } from './input-i18n.helper';
+export { TranslatePipe } from './translate.pipe';
+export { provideValtechI18n } from './config';
+export { VALTECH_DEFAULT_CONTENT } from './default-content';

package/lib/services/i18n/input-i18n.helper.d.ts

@@ -0,0 +1,70 @@
+import { InputMetadata, FormMetadata, ButtonMetadata, ComponentState } from '../../components/types';
+import * as i0 from "@angular/core";
+/**
+ * Helper para resolver traducciones i18n en InputMetadata y FormMetadata.
+ *
+ * @example
+ * ```typescript
+ * helper = inject(InputI18nHelper);
+ *
+ * // Resolver un input
+ * emailInput = this.helper.resolveInput({
+ *   ...baseEmailInput,
+ *   labelKey: 'email',
+ *   placeholderKey: 'emailPlaceholder',
+ *   errorKeys: { required: 'emailRequired', email: 'emailInvalid' },
+ *   i18nNamespace: '_auth',
+ * });
+ *
+ * // Resolver un form completo
+ * loginForm = this.helper.resolveForm(loginFormConfig);
+ * ```
+ */
+export declare class InputI18nHelper {
+    private i18n;
+    /**
+     * Resuelve traducciones para un InputMetadata.
+     * Si hay keys de i18n, las resuelve; sino, usa los valores directos.
+     */
+    resolveInput(input: InputMetadataWithI18n): InputMetadata;
+    /**
+     * Resuelve traducciones para un FormMetadata completo.
+     * Lee i18n.lang() para crear dependencia reactiva con computed().
+     */
+    resolveForm(form: FormMetadataWithI18n): FormMetadata;
+    /**
+     * Resuelve traducciones para un ButtonMetadata.
+     */
+    resolveButton(button: ButtonMetadataWithI18n, namespace?: string): ButtonMetadata;
+    /**
+     * Resuelve un mapa de error keys a mensajes traducidos.
+     */
+    private resolveErrors;
+    static ɵfac: i0.ɵɵFactoryDeclaration<InputI18nHelper, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<InputI18nHelper>;
+}
+export interface InputMetadataWithI18n extends Partial<InputMetadata> {
+    i18nNamespace?: string;
+    labelKey?: string;
+    placeholderKey?: string;
+    hintKey?: string;
+    errorKeys?: Record<string, string>;
+}
+export interface FormSectionWithI18n {
+    name?: string;
+    nameKey?: string;
+    order: number;
+    fields: InputMetadataWithI18n[];
+}
+export interface FormMetadataWithI18n {
+    name?: string;
+    nameKey?: string;
+    i18nNamespace?: string;
+    sections: FormSectionWithI18n[];
+    actions: ButtonMetadataWithI18n;
+    state: ComponentState;
+}
+export interface ButtonMetadataWithI18n extends Partial<ButtonMetadata> {
+    i18nNamespace?: string;
+    textKey?: string;
+}

package/lib/services/i18n/translate.pipe.d.ts

@@ -0,0 +1,36 @@
+import { PipeTransform } from '@angular/core';
+import * as i0 from "@angular/core";
+/**
+ * Pipe de traducción para templates.
+ *
+ * NOTA: Es impure para detectar cambios de idioma.
+ * El costo es mínimo porque I18nService usa Signals internamente.
+ *
+ * @example
+ * <!-- Busca en _global -->
+ * {{ 'submit' | t }}
+ *
+ * <!-- Busca en namespace específico -->
+ * {{ 'title' | t:'Login' }}
+ *
+ * <!-- Con interpolación -->
+ * {{ 'welcome' | t:'Login':{ name: userName } }}
+ *
+ * <!-- En atributos -->
+ * <val-button [label]="'submit' | t"></val-button>
+ * <val-input [label]="'email' | t:'Login'"></val-input>
+ */
+export declare class TranslatePipe implements PipeTransform {
+    private readonly i18n;
+    /**
+     * Transforma una key de traducción a su valor
+     *
+     * @param key Clave del texto
+     * @param namespace Namespace opcional (default: '_global')
+     * @param data Variables para interpolación opcional
+     * @returns Texto traducido
+     */
+    transform(key: string, namespace?: string, data?: Record<string, string>): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<TranslatePipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<TranslatePipe, "t", true>;
+}

package/lib/services/i18n/types.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Idiomas soportados por el sistema i18n
+ */
+export type I18nLang = 'es' | 'en' | 'pt' | 'fr' | 'de';
+/**
+ * Contenido de traducciones para un namespace
+ *
+ * @example
+ * const loginContent: LanguagesContent = {
+ *   es: { title: 'Iniciar sesión', submit: 'Entrar' },
+ *   en: { title: 'Sign in', submit: 'Sign in' }
+ * };
+ */
+export type LanguagesContent = {
+    [lang in I18nLang]?: Record<string, string>;
+};
+/**
+ * Almacén de contenido por namespace
+ *
+ * @example
+ * {
+ *   '_global': { es: {...}, en: {...} },
+ *   'Login': { es: {...}, en: {...} },
+ *   'Profile': { es: {...}, en: {...} }
+ * }
+ */
+export type ContentStore = Record<string, LanguagesContent>;
+/**
+ * Configuración para provideValtechI18n()
+ */
+export interface I18nConfig {
+    /**
+     * Idioma por defecto si no hay preferencia guardada
+     * @default 'es'
+     */
+    defaultLanguage?: I18nLang;
+    /**
+     * Lista de idiomas habilitados en la app
+     * @default ['es', 'en']
+     */
+    supportedLanguages?: I18nLang[];
+    /**
+     * Detectar idioma del navegador al iniciar
+     * @default true
+     */
+    detectBrowserLanguage?: boolean;
+    /**
+     * Contenido inicial de traducciones por namespace.
+     * Si includeDefaultContent es true, este contenido se mergea
+     * con VALTECH_DEFAULT_CONTENT (las keys del usuario ganan).
+     */
+    content?: ContentStore;
+    /**
+     * Si es true, incluye traducciones por defecto de valtech-components.
+     * Las traducciones del usuario sobrescriben las por defecto.
+     *
+     * @default true
+     *
+     * @example Usar defaults (comportamiento por defecto)
+     * ```typescript
+     * provideValtechI18n() // Funciona sin configuración
+     * ```
+     *
+     * @example Sobrescribir keys específicas
+     * ```typescript
+     * provideValtechI18n({
+     *   content: {
+     *     _global: {
+     *       es: { success: '¡Lo hicimos!' },
+     *       en: { success: 'We did it!' },
+     *     },
+     *   },
+     * })
+     * ```
+     *
+     * @example Desactivar defaults completamente
+     * ```typescript
+     * provideValtechI18n({
+     *   includeDefaultContent: false,
+     *   content: MY_CUSTOM_CONTENT,
+     * })
+     * ```
+     */
+    includeDefaultContent?: boolean;
+}
+/**
+ * Valores por defecto de configuración
+ */
+export declare const DEFAULT_I18N_CONFIG: Required<I18nConfig>;
+/**
+ * Clave para persistir idioma en localStorage
+ */
+export declare const LANG_STORAGE_KEY = "app_lang";

package/lib/services/icons.service.d.ts

@@ -0,0 +1,9 @@
+import * as i0 from "@angular/core";
+export declare class IconService {
+    /**
+     * Registers a set of Ionicons icons for use throughout the app.
+     */
+    constructor();
+    static ɵfac: i0.ɵɵFactoryDeclaration<IconService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<IconService>;
+}

package/lib/services/image/image.service.d.ts

@@ -0,0 +1,76 @@
+import { CropData, ImageCompressOptions, ImageValidateOptions, ImageValidationResult, ProcessedImage } from './types';
+import * as i0 from "@angular/core";
+/**
+ * ImageService
+ *
+ * Service for image processing including compression, thumbnails, cropping and validation.
+ * Uses HTML Canvas for all operations - no external dependencies.
+ *
+ * @example
+ * ```typescript
+ * const imageService = inject(ImageService);
+ *
+ * // Compress an image
+ * const compressed = await imageService.compress(file, { maxWidth: 800, quality: 0.8 });
+ *
+ * // Generate thumbnail
+ * const thumb = await imageService.thumbnail(file, 150);
+ *
+ * // Validate before processing
+ * const validation = imageService.validate(file, { maxSize: 5 * 1024 * 1024 });
+ * if (!validation.valid) {
+ *   console.error(validation.message);
+ * }
+ * ```
+ */
+export declare class ImageService {
+    /**
+     * Compress an image maintaining aspect ratio
+     * @param file - File or Blob to compress
+     * @param options - Compression options
+     * @returns Promise with processed image data
+     */
+    compress(file: File | Blob, options?: ImageCompressOptions): Promise<ProcessedImage>;
+    /**
+     * Generate a square thumbnail from an image
+     * @param file - File or Blob to process
+     * @param size - Thumbnail size in pixels (default: 150)
+     * @returns Promise with processed thumbnail
+     */
+    thumbnail(file: File | Blob, size?: number): Promise<ProcessedImage>;
+    /**
+     * Crop an image with specific coordinates
+     * @param file - File or Blob to crop
+     * @param cropData - Crop coordinates and dimensions
+     * @param options - Optional compression options for output
+     * @returns Promise with cropped image
+     */
+    crop(file: File | Blob, cropData: CropData, options?: ImageCompressOptions): Promise<ProcessedImage>;
+    /**
+     * Validate an image file before processing
+     * @param file - File to validate
+     * @param options - Validation options
+     * @returns Validation result with error details if invalid
+     */
+    validate(file: File, options?: ImageValidateOptions): ImageValidationResult;
+    /**
+     * Validate image dimensions (async - requires loading image)
+     * @param file - File to validate
+     * @param options - Validation options with minWidth/minHeight
+     * @returns Promise with validation result
+     */
+    validateDimensions(file: File, options: Pick<ImageValidateOptions, 'minWidth' | 'minHeight'>): Promise<ImageValidationResult>;
+    /**
+     * Convert a Blob/File to a data URL
+     */
+    toDataUrl(file: File | Blob): Promise<string>;
+    /**
+     * Convert a data URL to a Blob
+     */
+    dataUrlToBlob(dataUrl: string): Blob;
+    private loadImage;
+    private calculateDimensions;
+    private canvasToBlob;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ImageService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ImageService>;
+}

package/lib/services/image/types.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Options for image compression
+ */
+export interface ImageCompressOptions {
+    /** Maximum width in pixels (default: 800) */
+    maxWidth?: number;
+    /** Maximum height in pixels (default: 800) */
+    maxHeight?: number;
+    /** Quality 0-1 (default: 0.8) */
+    quality?: number;
+    /** Output MIME type (default: 'image/jpeg') */
+    mimeType?: 'image/jpeg' | 'image/png' | 'image/webp';
+}
+/**
+ * Options for image validation
+ */
+export interface ImageValidateOptions {
+    /** Maximum file size in bytes (default: 10MB) */
+    maxSize?: number;
+    /** Allowed MIME types (default: ['image/jpeg', 'image/png', 'image/webp', 'image/gif']) */
+    allowedTypes?: string[];
+    /** Minimum width in pixels */
+    minWidth?: number;
+    /** Minimum height in pixels */
+    minHeight?: number;
+}
+/**
+ * Result of image validation
+ */
+export interface ImageValidationResult {
+    valid: boolean;
+    error?: 'invalidType' | 'fileTooLarge' | 'imageTooSmall';
+    message?: string;
+}
+/**
+ * Processed image result
+ */
+export interface ProcessedImage {
+    /** Processed image as Blob */
+    blob: Blob;
+    /** Data URL for preview */
+    dataUrl: string;
+    /** Final width in pixels */
+    width: number;
+    /** Final height in pixels */
+    height: number;
+    /** File size in bytes */
+    size: number;
+}
+/**
+ * Crop data for manual cropping
+ */
+export interface CropData {
+    /** X position of crop area */
+    x: number;
+    /** Y position of crop area */
+    y: number;
+    /** Width of crop area */
+    width: number;
+    /** Height of crop area */
+    height: number;
+}
+/**
+ * Default values for image processing
+ */
+export declare const IMAGE_DEFAULTS: {
+    maxWidth: number;
+    maxHeight: number;
+    quality: number;
+    mimeType: "image/jpeg";
+    maxSize: number;
+    allowedTypes: string[];
+    thumbnailSize: number;
+};

package/lib/services/in-app-browser.service.d.ts

@@ -0,0 +1,16 @@
+import { OpenOptions } from '@capacitor/browser';
+import * as i0 from "@angular/core";
+export declare class InAppBrowserService {
+    /**
+     * Default options for the in-app browser.
+     */
+    options: OpenOptions;
+    constructor();
+    /**
+     * Opens a URL using Capacitor's InAppBrowser with the configured options.
+     * @param url The URL to open
+     */
+    openWithInAppBrowser(url: string): Promise<void>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<InAppBrowserService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<InAppBrowserService>;
+}

package/lib/services/link-processor.service.d.ts

@@ -0,0 +1,104 @@
+import { DomSanitizer, SafeHtml } from '@angular/platform-browser';
+import * as i0 from "@angular/core";
+export interface LinkProcessorConfig {
+    /** Whether to open external links in new tab (default: true) */
+    openExternalInNewTab?: boolean;
+    /** Whether to open internal links in new tab (default: false) */
+    openInternalInNewTab?: boolean;
+    /** Custom CSS classes for links */
+    linkClass?: string;
+    /** Custom CSS classes for external links */
+    externalLinkClass?: string;
+    /** Custom CSS classes for internal links */
+    internalLinkClass?: string;
+    /** Whether to process Markdown-style links [text](url) (default: true) */
+    processMarkdownLinks?: boolean;
+}
+/**
+ * LinkProcessorService - Service for processing text content to convert URLs and internal routes into clickable links.
+ *
+ * This service automatically detects external URLs (http/https), internal routes (starting with /),
+ * and Markdown-style links [text](url) and converts them into HTML anchor elements with appropriate attributes.
+ *
+ * @example Basic usage:
+ * ```typescript
+ * constructor(private linkProcessor: LinkProcessorService) {}
+ *
+ * processText() {
+ *   const text = 'Visit https://example.com, go to /profile, or [check docs](https://docs.example.com)';
+ *   const processed = this.linkProcessor.processLinks(text);
+ *   // Returns SafeHtml with clickable links
+ * }
+ * ```
+ */
+export declare class LinkProcessorService {
+    private sanitizer;
+    private readonly urlRegex;
+    private readonly internalRouteRegex;
+    private readonly markdownLinkRegex;
+    constructor(sanitizer: DomSanitizer);
+    /**
+     * Limpia la puntuación del final de una URL.
+     * Mantiene caracteres válidos de URL pero remueve signos de puntuación comunes al final.
+     * Preserva parámetros de consulta, fragmentos y caracteres válidos en URLs.
+     */
+    private cleanUrlPunctuation;
+    /**
+     * Procesa texto para convertir enlaces en elementos <a> clickeables.
+     * Detecta automáticamente URLs externas, rutas internas y enlaces estilo Markdown.
+     *
+     * @param text - Texto a procesar
+     * @param config - Configuración del procesamiento
+     * @returns SafeHtml con enlaces procesados o string original
+     *
+     * @example
+     * ```typescript
+     * const result = this.linkProcessor.processLinks(
+     *   'Visit https://example.com, go to /profile, or [check docs](https://docs.example.com)',
+     *   {
+     *     openExternalInNewTab: true,
+     *     openInternalInNewTab: false,
+     *     processMarkdownLinks: true,
+     *     linkClass: 'custom-link'
+     *   }
+     * );
+     * ```
+     */
+    processLinks(text: string, config?: LinkProcessorConfig): SafeHtml | string;
+    /**
+     * Detecta si un texto contiene enlaces (URLs, rutas internas o enlaces Markdown).
+     *
+     * @param text - Texto a analizar
+     * @returns true si contiene enlaces
+     *
+     * @example
+     * ```typescript
+     * const hasLinks = this.linkProcessor.hasLinks('Visit https://example.com or [docs](https://docs.com)');
+     * // Returns: true
+     * ```
+     */
+    hasLinks(text: string): boolean;
+    /**
+     * Extrae todos los enlaces de un texto.
+     *
+     * @param text - Texto a analizar
+     * @returns Array de enlaces encontrados con su tipo y texto (si es Markdown)
+     *
+     * @example
+     * ```typescript
+     * const links = this.linkProcessor.extractLinks('Visit https://example.com, /profile, or [docs](https://docs.com)');
+     * // Returns: [
+     * //   { url: 'https://example.com', type: 'external', text: 'https://example.com' },
+     * //   { url: '/profile', type: 'internal', text: '/profile' },
+     * //   { url: 'https://docs.com', type: 'external', text: 'docs' }
+     * // ]
+     * ```
+     */
+    extractLinks(text: string): Array<{
+        url: string;
+        type: 'external' | 'internal';
+        text: string;
+    }>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<LinkProcessorService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<LinkProcessorService>;
+}