Hello world

\";\n\nconst translated = await lingoDotDev.localizeHtml(html, {\n sourceLocale: \"en\",\n targetLocale: \"es\",\n});\n// Returns: \"

Hola mundo

\"\n```\n\nLa traducción HTML mantiene todas las etiquetas, atributos y estructura mientras traduce solo el contenido textual.\n\n## Detección de idioma\n\n**Detecta automáticamente el idioma de origen:**\n\n```javascript\nconst locale = await lingoDotDev.recognizeLocale(\"Bonjour le monde\");\n// Returns: 'fr'\n```\n\n**Uso con detección automática:**\n\n```javascript\nconst result = await lingoDotDev.localizeText(\"Bonjour le monde\", {\n sourceLocale: null, // Auto-detect\n targetLocale: \"en\",\n});\n// Returns: \"Hello world\"\n```\n\nLa detección de idioma añade tiempo de procesamiento, por lo que debe utilizarse solo cuando se desconoce el idioma de origen.\n\n## Opciones de configuración\n\n**Configura el comportamiento del SDK:**\n\n```javascript\nconst lingoDotDev = new LingoDotDevEngine({\n apiKey: \"your-api-key-here\",\n batchSize: 100, // Max items per API request (default: 50, max: 250)\n idealBatchItemSize: 1000, // Target word count per batch (default: 500, max: 2500)\n});\n```\n\n**Batch size** controla cuántos elementos se envían en cada solicitud API. Valores más altos reducen las llamadas API pero aumentan el tamaño de la solicitud.\n\n**Ideal batch item size** controla el recuento de palabras objetivo para una eficiencia de procesamiento óptima.\n\n## Parámetros de traducción\n\n**Control de velocidad vs calidad:**\n\n```javascript\nconst result = await lingoDotDev.localizeText(\"Hello world\", {\n sourceLocale: \"en\",\n targetLocale: \"es\",\n fast: true, // Prioritize speed over quality\n});\n```\n\nEl parámetro `fast` permite traducciones más rápidas con una posible reducción de calidad para aplicaciones sensibles al tiempo.\n\n## Seguimiento de progreso\n\n**Monitoriza trabajos de traducción grandes:**\n\n```javascript\nawait lingoDotDev.localizeObject(\n largeObject,\n { sourceLocale: \"en\", targetLocale: \"es\" },\n (progress) => {\n console.log(`Translation progress: ${progress}%`);\n // Update UI progress bar\n },\n);\n```\n\nLos callbacks de progreso proporcionan retroalimentación en tiempo real para operaciones de traducción grandes, útiles para actualizaciones de interfaz de usuario.\n\n## Manejo de errores\n\n**Implementa un manejo de errores adecuado:**\n\n```javascript\ntry {\n const result = await lingoDotDev.localizeText(\"Hello\", {\n sourceLocale: \"en\",\n targetLocale: \"es\",\n });\n} catch (error) {\n console.error(\"Translation failed:\", error.message);\n // Handle error appropriately\n}\n```\n\nEl SDK incluye reintentos automáticos para problemas de red, pero el manejo de errores a nivel de aplicación sigue siendo importante.\n","content","\nEl **SDK de JavaScript de Lingo.dev** añade traducción en tiempo real impulsada por IA a aplicaciones web, servidores Node.js y frameworks frontend. El SDK gestiona contenido dinámico como mensajes de chat, comentarios de usuarios y datos en vivo que necesitan traducción instantánea.\n\nA diferencia de la localización de archivos estáticos con **Lingo.dev CLI**, el SDK procesa contenido bajo demanda, lo que lo hace ideal para aplicaciones de chat, clientes de correo electrónico y herramientas de redes sociales donde el contenido cambia constantemente.\n\n## Instalación\n\n```bash\nnpm install lingo.dev\n```\n\n## Configuración básica\n\n```javascript\nimport { LingoDotDevEngine } from \"lingo.dev/sdk\";\n\nconst lingoDotDev = new LingoDotDevEngine({\n apiKey: \"your-api-key-here\",\n});\n```\n\n## Traducción de texto\n\n**Traducir texto simple:**\n\n```javascript\nconst result = await lingoDotDev.localizeText(\"Hello, world!\", {\n sourceLocale: \"en\",\n targetLocale: \"es\",\n});\n// Devuelve: \"¡Hola Mundo!\"\n```\n\n**Traducir a múltiples idiomas:**\n\n```javascript\nconst results = await lingoDotDev.batchLocalizeText(\"Hello, world!\", {\n sourceLocale: \"en\",\n targetLocales: [\"es\", \"fr\", \"de\"],\n});\n// Devuelve: ['¡Hola Mundo!', 'Bonjour le monde!', 'Hallo Welt!']\n```\n\n## Traducción de objetos\n\n**Traducir datos estructurados:**\n\n```javascript\nconst content = {\n greeting: \"Hello\",\n farewell: \"Goodbye\",\n message: \"Welcome to our platform\",\n};\n\nconst translated = await lingoDotDev.localizeObject(content, {\n sourceLocale: \"en\",\n targetLocale: \"es\",\n});\n// Devuelve: { greeting: \"Hola\", farewell: \"Adiós\", message: \"Bienvenido a nuestra plataforma\" }\n```\n\nEste método maneja objetos anidados y preserva la estructura original mientras traduce los valores de texto.\n\n## Traducción de chat\n\n**Traducir arrays de conversación:**\n\n```javascript\nconst conversation = [\n { name: \"Alice\", text: \"Hello!\" },\n { name: \"Bob\", text: \"How are you?\" },\n { name: \"Alice\", text: \"I'm doing well, thanks!\" },\n];\n\nconst translated = await lingoDotDev.localizeChat(conversation, {\n sourceLocale: \"en\",\n targetLocale: \"es\",\n});\n// Devuelve la conversación traducida con la misma estructura\n```\n\nEl método de chat preserva metadatos como nombres de usuario mientras traduce solo el contenido textual.\n\n## Traducción HTML\n\n**Traduce HTML preservando el marcado:**\n\n```javascript\nconst html = \"

Hello world

\";\n\nconst translated = await lingoDotDev.localizeHtml(html, {\n sourceLocale: \"en\",\n targetLocale: \"es\",\n});\n// Returns: \"

Hola mundo