@jjlmoya/utils-health 1.1.0

package/src/tool/bloodUnitConverter/i18n/en.ts

@@ -0,0 +1,227 @@
+import type { WithContext, SoftwareApplication, FAQPage, HowToThing } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { BloodUnitConverterUI } from '../ui';
+
+const slug = 'blood-test-unit-converter';
+const title = 'Blood Test Unit Converter';
+const description =
+  'Medical calculator to convert blood test results between mg/dL and mmol/L. Compatible with glucose, total cholesterol, HDL, LDL, triglycerides, creatinine and urea.';
+
+const faqData = [
+  {
+    question: 'What does mg/dL mean?',
+    answer:
+      'Milligrams per decilitre. A unit of mass concentration that indicates how many milligrams of a substance are present in 100 millilitres of blood. It is the standard in Spain, the United States and Latin America.',
+  },
+  {
+    question: 'What does mmol/L mean?',
+    answer:
+      'Millimoles per litre. The International System unit for measuring substance concentration based on the number of molecules (moles) per volume. It is the standard preferred by the international scientific community and countries such as the UK or Canada.',
+  },
+  {
+    question: 'Why is the conversion factor different for each substance?',
+    answer:
+      'Because the factor depends on the molecular weight of the molecule. A heavier molecule like cholesterol (MW ≈ 387 g/mol) requires a larger divisor than glucose (MW ≈ 180 g/mol). The formula is: mmol/L = mg/dL ÷ molecular weight × 10.',
+  },
+  {
+    question: 'How do I manually convert from mmol/L to mg/dL?',
+    answer:
+      'Multiply the mmol/L value by the substance-specific conversion factor. For example, for glucose multiply by 18.016. For cholesterol, by 38.67. The calculator performs this calculation automatically and instantly.',
+  },
+  {
+    question: 'Is this calculator reliable for medical diagnoses?',
+    answer:
+      'This tool is purely informational and uses conversion factors per IFCC guidelines. It does not replace professional diagnosis. The reference ranges shown are indicative and may vary between laboratories, ages and individual clinical circumstances. Always consult your doctor.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Select the analyte',
+    text: 'Click the icon corresponding to the substance you want to convert: Glucose, Total Cholesterol, HDL, LDL, Triglycerides, Creatinine or Urea.',
+  },
+  {
+    name: 'Enter the value',
+    text: 'Type the number in the mg/dL or mmol/L field. Use the swap button to reverse the direction of conversion. The result appears instantly.',
+  },
+  {
+    name: 'Read the visual traffic light',
+    text: 'The status indicator shows whether the level is in the low, normal, borderline or high range according to the clinical reference guidelines for that substance.',
+  },
+  {
+    name: 'Save your results',
+    text: 'Click "Add to Table" to record the value in the history and compare multiple readings in the same session.',
+  },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faqData.map((item) => ({
+    '@type': 'Question',
+    name: item.question,
+    acceptedAnswer: { '@type': 'Answer', text: item.answer },
+  })),
+};
+
+const howToSchema: WithContext<HowToThing> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: title,
+  description,
+  step: howToData.map((step, i) => ({
+    '@type': 'HowToStep',
+    position: i + 1,
+    name: step.name,
+    text: step.text,
+  })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description,
+  applicationCategory: 'HealthApplication',
+  operatingSystem: 'Web',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+};
+
+export const content: ToolLocaleContent<BloodUnitConverterUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Frequently asked questions about blood test unit conversion',
+  faq: faqData,
+  bibliographyTitle: 'Scientific references',
+  bibliography: [
+    {
+      name: 'IFCC Scientific Division — Biochemical conversion factors',
+      url: 'https://www.ifcc.org/',
+    },
+    {
+      name: 'Mayo Clinic — Blood test interpretation',
+      url: 'https://www.mayoclinic.org/',
+    },
+    {
+      name: 'World Health Organization — Diabetes diagnostic criteria',
+      url: 'https://www.who.int/',
+    },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  ui: {
+    appTitle: 'Analytics Suite',
+    appSubtitle: 'Professional clinical unit converter',
+    sectionAnalyte: 'Select Analyte',
+    sectionHistory: 'My History',
+    labelMg: 'Mass (mg/dL)',
+    labelMmol: 'Molar (mmol/L)',
+    swapAriaLabel: 'Swap conversion direction',
+    statusIdle: 'Enter a value to analyse',
+    analyteGlucosa: 'Glucose',
+    analyteColesterolTotal: 'Total Cholesterol',
+    analyteHdl: 'HDL Cholesterol',
+    analyteLdl: 'LDL Cholesterol',
+    analyteTriglic: 'Triglycerides',
+    analyteCreatinina: 'Creatinine',
+    analyteUrea: 'Urea',
+    rangeBajo: 'Low',
+    rangeNormal: 'Normal',
+    rangeAlto: 'High',
+    rangeMuyAlto: 'Very High',
+    rangeLimite: 'Borderline',
+    rangeElevado: 'Elevated',
+    rangePrediabetes: 'Prediabetes',
+    rangeDiabetes: 'Diabetes',
+    rangeDeseable: 'Desirable',
+    rangeRiesgo: 'At Risk',
+    rangeAceptable: 'Acceptable',
+    rangeExcelente: 'Excellent',
+    rangeOptimo: 'Optimal',
+    rangeCasiOptimo: 'Near Optimal',
+    historyAdd: 'Add to Table',
+    historyAnalyte: 'Analyte',
+    historyMg: 'mg/dL',
+    historyMmol: 'mmol/L',
+    historyStatus: 'Status',
+    historyEmpty: 'No records saved',
+    disclaimerText:
+      'Medical Notice: This tool is informational and uses conversion factors per IFCC guidelines. It does not replace professional diagnosis. Always consult your doctor.',
+  },
+  seo: [
+    {
+      type: 'summary',
+      title: 'Blood Test Unit Converter',
+      items: [
+        '<strong>7 analytes</strong>: glucose, total cholesterol, HDL, LDL, triglycerides, creatinine and urea.',
+        '<strong>Bidirectional</strong>: converts from mg/dL to mmol/L and back with one click.',
+        '<strong>Clinical traffic light</strong>: visual indicator of low, normal, borderline and high ranges.',
+        '<strong>Session history</strong>: save and compare multiple values in a table.',
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Complete Guide to Blood Test Unit Conversion',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Blood test results can be confusing when presented in different unit systems. Medical laboratories mainly use two types: mass concentration (<strong>mg/dL</strong>) and molar concentration (<strong>mmol/L</strong>). Understanding how to convert between them is crucial for patients consulting international scientific literature or living in countries with different standards, such as the United States (mg/dL) versus most of Europe (mmol/L).',
+    },
+    {
+      type: 'title',
+      text: 'Biochemical Conversion Factor Table',
+      level: 2,
+    },
+    {
+      type: 'table',
+      headers: ['Analyte', 'Mass unit', 'Molar unit', 'Conversion factor'],
+      rows: [
+        ['<strong>Glucose</strong>', 'mg/dL', 'mmol/L', '18.016 (divide mg/dL)'],
+        ['<strong>Total Cholesterol</strong>', 'mg/dL', 'mmol/L', '38.67 (divide mg/dL)'],
+        ['<strong>Triglycerides</strong>', 'mg/dL', 'mmol/L', '88.57 (divide mg/dL)'],
+        ['<strong>Urea</strong>', 'mg/dL', 'mmol/L', '6.006 (divide mg/dL)'],
+        ['<strong>Creatinine</strong>', 'mg/dL', 'mmol/L', '11.312 (divide mg/dL)'],
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Glucose: The Body\'s Fuel',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Glucose is the primary energy source for cells. Its measurement is fundamental for diabetes management and metabolic health. A fasting level below <strong>100 mg/dL (5.55 mmol/L)</strong> is considered normal. Values between 100 and 125 mg/dL may indicate prediabetes, and levels above <strong>126 mg/dL (7.0 mmol/L)</strong> on two separate tests are usually indicative of type 2 diabetes mellitus.',
+    },
+    {
+      type: 'title',
+      text: 'Cholesterol and the Lipid Profile',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Cholesterol is a waxy substance necessary for building cells and hormones, but elevated levels increase the risk of cardiovascular disease. A desirable total cholesterol level is below <strong>200 mg/dL (5.17 mmol/L)</strong>. HDL "good" cholesterol above 60 mg/dL and LDL "bad" cholesterol below 100 mg/dL are the usual targets for healthy adults.',
+    },
+    {
+      type: 'tip',
+      title: 'Privacy first',
+      html: 'Your medical data is private. This tool processes all calculations <strong>locally in your browser</strong>. No sensitive information is sent to or stored on any server.',
+    },
+    {
+      type: 'title',
+      text: 'How to Interpret Results Safely',
+      level: 2,
+    },
+    {
+      type: 'list',
+      items: [
+        'Fasting glucose <strong>repeatedly above 100 mg/dL</strong>.',
+        'Total cholesterol <strong>above 240 mg/dL</strong> or LDL above 160 mg/dL.',
+        'Triglycerides <strong>above 200 mg/dL</strong> on a sustained basis.',
+        'Creatinine elevated or suddenly decreased, indicating altered kidney function.',
+        'Any out-of-range value confirmed in <strong>two consecutive measurements</strong>.',
+      ],
+    },
+  ],
+};

package/src/tool/bloodUnitConverter/i18n/es.ts

@@ -0,0 +1,250 @@
+import type { WithContext, SoftwareApplication, FAQPage, HowToThing } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { BloodUnitConverterUI } from '../ui';
+
+const slug = 'conversor-unidades-analitica-sangre';
+const title = 'Conversor de Unidades de Analítica de Sangre';
+const description =
+  'Calculadora médica para convertir resultados de análisis de sangre entre mg/dL y mmol/L. Compatible con glucosa, colesterol total, HDL, LDL, triglicéridos, creatinina y urea.';
+
+const faqData = [
+  {
+    question: '¿Qué significa mg/dL?',
+    answer:
+      'Miligramos por decilitro. Es una unidad de concentración de masa que indica cuántos miligramos de una sustancia hay en 100 mililitros de sangre. Es el estándar habitual en España, Estados Unidos y Latinoamérica.',
+  },
+  {
+    question: '¿Qué significa mmol/L?',
+    answer:
+      'Milimoles por litro. Es la unidad del Sistema Internacional para medir la concentración de sustancias basándose en la cantidad de moléculas (moles) por volumen. Es el estándar preferido por la comunidad científica y países como Reino Unido o Canadá.',
+  },
+  {
+    question: '¿Por qué el factor de conversión es diferente para cada sustancia?',
+    answer:
+      'Porque el factor depende del peso molecular de la molécula. Una molécula más pesada como el colesterol (PM ≈ 387 g/mol) requiere un divisor mayor que la glucosa (PM ≈ 180 g/mol). La fórmula es: mmol/L = mg/dL ÷ peso molecular × 10.',
+  },
+  {
+    question: '¿Cómo paso manualmente de mmol/L a mg/dL?',
+    answer:
+      'Multiplica el valor en mmol/L por el factor de conversión de la sustancia. Por ejemplo, para glucosa multiplica por 18.016. Para colesterol, por 38.67. La calculadora hace este cálculo de forma automática e instantánea.',
+  },
+  {
+    question: '¿Es fiable esta calculadora para diagnósticos médicos?',
+    answer:
+      'Esta herramienta es puramente informativa y utiliza factores de conversión según la IFCC. No sustituye un diagnóstico profesional. Los rangos de referencia mostrados son orientativos y pueden variar entre laboratorios, edades y circunstancias clínicas individuales. Consulte siempre con su médico.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Selecciona la sustancia analítica',
+    text: 'Haz clic en el icono correspondiente a la sustancia que deseas convertir: Glucosa, Colesterol Total, HDL, LDL, Triglicéridos, Creatinina o Urea.',
+  },
+  {
+    name: 'Introduce el valor',
+    text: 'Escribe el número en el campo mg/dL o mmol/L. Usa el botón de intercambio para cambiar la dirección de la conversión. El resultado aparece al instante.',
+  },
+  {
+    name: 'Interpreta el semáforo visual',
+    text: 'El indicador de estado muestra si el nivel se encuentra en rango bajo, normal, límite o alto según las guías clínicas de referencia para esa sustancia.',
+  },
+  {
+    name: 'Guarda tus resultados',
+    text: 'Pulsa "Añadir a Tabla" para registrar el valor en el historial y poder comparar varias analíticas en la misma sesión.',
+  },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faqData.map((item) => ({
+    '@type': 'Question',
+    name: item.question,
+    acceptedAnswer: { '@type': 'Answer', text: item.answer },
+  })),
+};
+
+const howToSchema: WithContext<HowToThing> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: title,
+  description,
+  step: howToData.map((step, i) => ({
+    '@type': 'HowToStep',
+    position: i + 1,
+    name: step.name,
+    text: step.text,
+  })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description,
+  applicationCategory: 'HealthApplication',
+  operatingSystem: 'Web',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+};
+
+export const content: ToolLocaleContent<BloodUnitConverterUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Preguntas frecuentes sobre la conversión de unidades analíticas',
+  faq: faqData,
+  bibliographyTitle: 'Referencias científicas',
+  bibliography: [
+    {
+      name: 'IFCC Scientific Division — Factores de conversión bioquímica',
+      url: 'https://www.ifcc.org/',
+    },
+    {
+      name: 'Mayo Clinic — Interpretación de análisis de sangre',
+      url: 'https://www.mayoclinic.org/',
+    },
+    {
+      name: 'Organización Mundial de la Salud — Criterios diagnósticos de diabetes',
+      url: 'https://www.who.int/',
+    },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  ui: {
+    appTitle: 'Analítica Suite',
+    appSubtitle: 'Conversor de unidades clínicas profesional',
+    sectionAnalyte: 'Seleccionar Analito',
+    sectionHistory: 'Mi Historial',
+    labelMg: 'Masa (mg/dL)',
+    labelMmol: 'Molar (mmol/L)',
+    swapAriaLabel: 'Cambiar dirección de conversión',
+    statusIdle: 'Analice un valor',
+    analyteGlucosa: 'Glucosa',
+    analyteColesterolTotal: 'Colesterol Total',
+    analyteHdl: 'Colesterol HDL',
+    analyteLdl: 'Colesterol LDL',
+    analyteTriglic: 'Triglicéridos',
+    analyteCreatinina: 'Creatinina',
+    analyteUrea: 'Urea',
+    rangeBajo: 'Bajo',
+    rangeNormal: 'Normal',
+    rangeAlto: 'Alto',
+    rangeMuyAlto: 'Muy Alto',
+    rangeLimite: 'Límite',
+    rangeElevado: 'Elevado',
+    rangePrediabetes: 'Prediabetes',
+    rangeDiabetes: 'Diabetes',
+    rangeDeseable: 'Deseable',
+    rangeRiesgo: 'Riesgo',
+    rangeAceptable: 'Aceptable',
+    rangeExcelente: 'Excelente',
+    rangeOptimo: 'Óptimo',
+    rangeCasiOptimo: 'Casi Óptimo',
+    historyAdd: 'Añadir a Tabla',
+    historyAnalyte: 'Analito',
+    historyMg: 'mg/dL',
+    historyMmol: 'mmol/L',
+    historyStatus: 'Estado',
+    historyEmpty: 'No hay registros guardados',
+    disclaimerText:
+      'Aviso Médico: Esta herramienta es informativa y utiliza factores de conversión según la IFCC. No sustituye un diagnóstico profesional. Consulte siempre con su médico.',
+  },
+  seo: [
+    {
+      type: 'summary',
+      title: 'Conversor de Unidades de Analítica de Sangre',
+      items: [
+        '<strong>7 analitos</strong>: glucosa, colesterol total, HDL, LDL, triglicéridos, creatinina y urea.',
+        '<strong>Bidireccional</strong>: convierte de mg/dL a mmol/L y viceversa con un solo clic.',
+        '<strong>Semáforo clínico</strong>: indicador visual de rangos bajo, normal, límite y alto.',
+        '<strong>Historial de sesión</strong>: guarda y compara múltiples valores en tabla.',
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Guía Completa sobre la Conversión de Unidades en Analíticas de Sangre',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'La interpretación de los resultados de una analítica de sangre puede resultar confusa cuando nos encontramos con diferentes sistemas de unidades. Los laboratorios médicos utilizan principalmente dos tipos: la concentración de masa (<strong>mg/dL</strong>) y la concentración molar (<strong>mmol/L</strong>). Entender cómo pasar de mg/dL a mmol/L es crucial para pacientes que consultan literatura científica internacional o que viven en países con distintos estándares, como Estados Unidos (mg/dL) frente a la mayor parte de Europa (mmol/L).',
+    },
+    {
+      type: 'title',
+      text: 'Tabla de Factores de Conversión Bioquímica',
+      level: 2,
+    },
+    {
+      type: 'table',
+      headers: ['Analito', 'Unidad masa', 'Unidad molar', 'Factor de conversión'],
+      rows: [
+        ['<strong>Glucosa</strong>', 'mg/dL', 'mmol/L', '18.016 (dividir mg/dL)'],
+        ['<strong>Colesterol Total</strong>', 'mg/dL', 'mmol/L', '38.67 (dividir mg/dL)'],
+        ['<strong>Triglicéridos</strong>', 'mg/dL', 'mmol/L', '88.57 (dividir mg/dL)'],
+        ['<strong>Urea</strong>', 'mg/dL', 'mmol/L', '6.006 (dividir mg/dL)'],
+        ['<strong>Creatinina</strong>', 'mg/dL', 'mmol/L', '11.312 (dividir mg/dL)'],
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Diferencias entre los Sistemas de Medición',
+      level: 2,
+    },
+    {
+      type: 'list',
+      items: [
+        '<strong>Concentración de masa (mg/dL):</strong> indica cuántos miligramos de la sustancia hay en 100 ml de sangre. Estándar en España, EE.UU. y Latinoamérica.',
+        '<strong>Concentración molar (mmol/L):</strong> se basa en la cantidad de moléculas (moles) por litro. Preferida por la comunidad científica internacional y países como Reino Unido o Canadá.',
+        '<strong>Precisión bioquímica:</strong> el sistema molar permite comparar la cantidad real de moléculas que interactúan en los procesos biológicos, independientemente de su peso individual.',
+        '<strong>Interoperabilidad:</strong> esta calculadora permite que pacientes y profesionales hablen el mismo idioma médico sin importar su ubicación geográfica.',
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Glucosa: El Combustible del Organismo',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'La glucosa es la principal fuente de energía para las células. Su medición es fundamental para el control de la diabetes y la salud metabólica. Un nivel en ayunas inferior a <strong>100 mg/dL (5.55 mmol/L)</strong> se considera normal. Valores entre 100 y 125 mg/dL pueden indicar prediabetes, y niveles superiores a <strong>126 mg/dL (7.0 mmol/L)</strong> en varias determinaciones suelen ser indicativos de diabetes mellitus tipo 2.',
+    },
+    {
+      type: 'title',
+      text: 'Colesterol y el Perfil Lipídico',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'El colesterol es una sustancia cerosa necesaria para construir células y hormonas, pero niveles elevados aumentan el riesgo de enfermedades cardiovasculares. Un nivel deseable de colesterol total es inferior a <strong>200 mg/dL (5.17 mmol/L)</strong>. El HDL "bueno" por encima de 60 mg/dL y el LDL "malo" por debajo de 100 mg/dL son los objetivos habituales para adultos sanos.',
+    },
+    {
+      type: 'tip',
+      title: 'Privacidad ante todo',
+      html: 'Tus datos médicos son privados. Esta herramienta procesa todos los cálculos <strong>localmente en tu navegador</strong>. Ninguna información sensible se envía ni se almacena en ningún servidor.',
+    },
+    {
+      type: 'title',
+      text: 'Cómo Interpretar los Resultados de Forma Segura',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Es vital recordar que los rangos de normalidad pueden variar entre laboratorios, según las técnicas de análisis empleadas. Además, factores como la <strong>edad, el sexo, la dieta y la medicación</strong> influyen en lo que se considera normal para cada individuo. Los valores de referencia mostrados en esta calculadora son orientativos y basados en las guías de la OMS y las principales sociedades clínicas.',
+    },
+    {
+      type: 'title',
+      text: 'Cuándo Consultar con tu Médico',
+      level: 2,
+    },
+    {
+      type: 'list',
+      items: [
+        'Valores de glucosa en ayunas <strong>repetidamente superiores a 100 mg/dL</strong>.',
+        'Colesterol total <strong>superior a 240 mg/dL</strong> o LDL por encima de 160 mg/dL.',
+        'Triglicéridos <strong>superiores a 200 mg/dL</strong> de forma mantenida.',
+        'Creatinina elevada o descendente de forma brusca, indicadora de función renal alterada.',
+        'Cualquier valor fuera de rango confirmado en <strong>dos determinaciones consecutivas</strong>.',
+      ],
+    },
+  ],
+};