@jjlmoya/utils-health 1.1.0

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

@@ -0,0 +1,218 @@
+import type { WithContext, SoftwareApplication, FAQPage, HowToThing } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { BloodUnitConverterUI } from '../ui';
+
+const slug = 'convertisseur-unites-analyses-sanguines';
+const title = "Convertisseur d'Unités d'Analyses Sanguines";
+const description =
+  "Calculatrice médicale pour convertir les résultats d'analyses de sang entre mg/dL et mmol/L. Compatible avec le glucose, le cholestérol total, HDL, LDL, les triglycérides, la créatinine et l'urée.";
+
+const faqData = [
+  {
+    question: 'Que signifie mg/dL?',
+    answer:
+      "Milligrammes par décilitre. Une unité de concentration de masse qui indique combien de milligrammes d'une substance sont présents dans 100 millilitres de sang. C'est la norme en Espagne, aux États-Unis et en Amérique latine.",
+  },
+  {
+    question: 'Que signifie mmol/L?',
+    answer:
+      "Millimoles par litre. L'unité du Système International pour mesurer la concentration de substances basée sur le nombre de molécules (moles) par volume. Préférée par la communauté scientifique internationale et des pays comme le Royaume-Uni ou le Canada.",
+  },
+  {
+    question: "Pourquoi le facteur de conversion est-il différent pour chaque substance?",
+    answer:
+      "Parce que le facteur dépend du poids moléculaire de la molécule. Une molécule plus lourde comme le cholestérol (PM ≈ 387 g/mol) nécessite un diviseur plus grand que le glucose (PM ≈ 180 g/mol). La formule est: mmol/L = mg/dL ÷ poids moléculaire × 10.",
+  },
+  {
+    question: 'Comment convertir manuellement de mmol/L à mg/dL?',
+    answer:
+      "Multipliez la valeur en mmol/L par le facteur de conversion spécifique à la substance. Par exemple, pour le glucose, multipliez par 18.016. Pour le cholestérol, par 38.67. La calculatrice effectue ce calcul automatiquement et instantanément.",
+  },
+  {
+    question: "Cette calculatrice est-elle fiable pour les diagnostics médicaux?",
+    answer:
+      "Cet outil est purement informatif et utilise des facteurs de conversion selon les directives de l'IFCC. Il ne remplace pas un diagnostic professionnel. Les plages de référence affichées sont indicatives et peuvent varier selon les laboratoires, les âges et les circonstances cliniques individuelles. Consultez toujours votre médecin.",
+  },
+];
+
+const howToData = [
+  {
+    name: "Sélectionnez l'analyte",
+    text: "Cliquez sur l'icône correspondant à la substance que vous souhaitez convertir: Glucose, Cholestérol Total, HDL, LDL, Triglycérides, Créatinine ou Urée.",
+  },
+  {
+    name: 'Saisissez la valeur',
+    text: "Tapez le nombre dans le champ mg/dL ou mmol/L. Utilisez le bouton d'échange pour inverser la direction de conversion. Le résultat apparaît instantanément.",
+  },
+  {
+    name: 'Lisez le feu de signalisation visuel',
+    text: "L'indicateur de statut montre si le niveau se situe dans la plage basse, normale, limite ou élevée selon les directives de référence clinique pour cette substance.",
+  },
+  {
+    name: 'Enregistrez vos résultats',
+    text: 'Cliquez sur "Ajouter au Tableau" pour enregistrer la valeur dans l\'historique et comparer plusieurs lectures dans la même 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: "Questions fréquentes sur la conversion des unités d'analyses sanguines",
+  faq: faqData,
+  bibliographyTitle: 'Références scientifiques',
+  bibliography: [
+    {
+      name: "IFCC Division Scientifique — Facteurs de conversion biochimique",
+      url: 'https://www.ifcc.org/',
+    },
+    {
+      name: "Mayo Clinic — Interprétation des analyses de sang",
+      url: 'https://www.mayoclinic.org/',
+    },
+    {
+      name: "Organisation Mondiale de la Santé — Critères diagnostiques du diabète",
+      url: 'https://www.who.int/',
+    },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  ui: {
+    appTitle: 'Analytics Suite',
+    appSubtitle: "Convertisseur d'unités cliniques professionnel",
+    sectionAnalyte: "Sélectionner l'Analyte",
+    sectionHistory: 'Mon Historique',
+    labelMg: 'Masse (mg/dL)',
+    labelMmol: 'Molaire (mmol/L)',
+    swapAriaLabel: 'Inverser la direction de conversion',
+    statusIdle: 'Saisissez une valeur à analyser',
+    analyteGlucosa: 'Glucose',
+    analyteColesterolTotal: 'Cholestérol Total',
+    analyteHdl: 'Cholestérol HDL',
+    analyteLdl: 'Cholestérol LDL',
+    analyteTriglic: 'Triglycérides',
+    analyteCreatinina: 'Créatinine',
+    analyteUrea: 'Urée',
+    rangeBajo: 'Bas',
+    rangeNormal: 'Normal',
+    rangeAlto: 'Élevé',
+    rangeMuyAlto: 'Très Élevé',
+    rangeLimite: 'Limite',
+    rangeElevado: 'Augmenté',
+    rangePrediabetes: 'Prédiabète',
+    rangeDiabetes: 'Diabète',
+    rangeDeseable: 'Souhaitable',
+    rangeRiesgo: 'À Risque',
+    rangeAceptable: 'Acceptable',
+    rangeExcelente: 'Excellent',
+    rangeOptimo: 'Optimal',
+    rangeCasiOptimo: 'Quasi Optimal',
+    historyAdd: 'Ajouter au Tableau',
+    historyAnalyte: 'Analyte',
+    historyMg: 'mg/dL',
+    historyMmol: 'mmol/L',
+    historyStatus: 'Statut',
+    historyEmpty: 'Aucun enregistrement sauvegardé',
+    disclaimerText:
+      "Avis Médical: Cet outil est informatif et utilise des facteurs de conversion selon les directives de l'IFCC. Il ne remplace pas un diagnostic professionnel. Consultez toujours votre médecin.",
+  },
+  seo: [
+    {
+      type: 'summary',
+      title: "Convertisseur d'Unités d'Analyses Sanguines",
+      items: [
+        "<strong>7 analytes</strong>: glucose, cholestérol total, HDL, LDL, triglycérides, créatinine et urée.",
+        '<strong>Bidirectionnel</strong>: convertit de mg/dL à mmol/L et inversement en un clic.',
+        '<strong>Feu de signalisation clinique</strong>: indicateur visuel des plages basse, normale, limite et élevée.',
+        "<strong>Historique de session</strong>: sauvegardez et comparez plusieurs valeurs dans un tableau.",
+      ],
+    },
+    {
+      type: 'title',
+      text: "Guide Complet sur la Conversion des Unités dans les Analyses de Sang",
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: "Les résultats d'analyses de sang peuvent être déroutants lorsqu'ils sont présentés dans différents systèmes d'unités. Les laboratoires médicaux utilisent principalement deux types: la concentration de masse (<strong>mg/dL</strong>) et la concentration molaire (<strong>mmol/L</strong>). Comprendre comment passer de l'un à l'autre est crucial pour les patients qui consultent la littérature scientifique internationale ou qui vivent dans des pays avec des normes différentes.",
+    },
+    {
+      type: 'title',
+      text: 'Tableau des Facteurs de Conversion Biochimique',
+      level: 2,
+    },
+    {
+      type: 'table',
+      headers: ['Analyte', 'Unité de masse', 'Unité molaire', 'Facteur de conversion'],
+      rows: [
+        ['<strong>Glucose</strong>', 'mg/dL', 'mmol/L', '18.016 (diviser mg/dL)'],
+        ['<strong>Cholestérol Total</strong>', 'mg/dL', 'mmol/L', '38.67 (diviser mg/dL)'],
+        ['<strong>Triglycérides</strong>', 'mg/dL', 'mmol/L', '88.57 (diviser mg/dL)'],
+        ["<strong>Urée</strong>", 'mg/dL', 'mmol/L', '6.006 (diviser mg/dL)'],
+        ['<strong>Créatinine</strong>', 'mg/dL', 'mmol/L', '11.312 (diviser mg/dL)'],
+      ],
+    },
+    {
+      type: 'title',
+      text: "Glucose: Le Carburant de l'Organisme",
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: "Le glucose est la principale source d'énergie pour les cellules. Sa mesure est fondamentale pour la gestion du diabète et la santé métabolique. Un niveau à jeun inférieur à <strong>100 mg/dL (5,55 mmol/L)</strong> est considéré comme normal. Des valeurs entre 100 et 125 mg/dL peuvent indiquer un prédiabète, et des niveaux supérieurs à <strong>126 mg/dL (7,0 mmol/L)</strong> lors de deux tests séparés sont généralement indicatifs d'un diabète de type 2.",
+    },
+    {
+      type: 'tip',
+      title: 'Confidentialité avant tout',
+      html: "Vos données médicales sont privées. Cet outil traite tous les calculs <strong>localement dans votre navigateur</strong>. Aucune information sensible n'est envoyée ni stockée sur aucun serveur.",
+    },
+    {
+      type: 'title',
+      text: 'Quand Consulter Votre Médecin',
+      level: 2,
+    },
+    {
+      type: 'list',
+      items: [
+        'Glycémie à jeun <strong>répétitivement supérieure à 100 mg/dL</strong>.',
+        'Cholestérol total <strong>supérieur à 240 mg/dL</strong> ou LDL au-dessus de 160 mg/dL.',
+        'Triglycérides <strong>supérieurs à 200 mg/dL</strong> de façon persistante.',
+        "Créatinine élevée ou soudainement diminuée, indiquant une altération de la fonction rénale.",
+        'Toute valeur hors plage confirmée lors de <strong>deux mesures consécutives</strong>.',
+      ],
+    },
+  ],
+};

package/src/tool/bloodUnitConverter/index.ts

@@ -0,0 +1,27 @@
+import type { HealthToolEntry, ToolDefinition } from '../../types';
+import BloodUnitConverterComponent from './component.astro';
+import BloodUnitConverterSEO from './seo.astro';
+import BloodUnitConverterBibliography from './bibliography.astro';
+import type { BloodUnitConverterUI } from './ui';
+
+export const bloodUnitConverter: HealthToolEntry<BloodUnitConverterUI> = {
+  id: 'bloodUnitConverter',
+  icons: {
+    bg: 'mdi:test-tube',
+    fg: 'mdi:water-percent',
+  },
+  i18n: {
+    es: () => import('./i18n/es').then((m) => m.content),
+    en: () => import('./i18n/en').then((m) => m.content),
+    fr: () => import('./i18n/fr').then((m) => m.content),
+  },
+};
+
+export { BloodUnitConverterComponent, BloodUnitConverterSEO, BloodUnitConverterBibliography };
+
+export const BLOOD_UNIT_CONVERTER_TOOL: ToolDefinition = {
+  entry: bloodUnitConverter,
+  Component: BloodUnitConverterComponent,
+  SEOComponent: BloodUnitConverterSEO,
+  BibliographyComponent: BloodUnitConverterBibliography,
+};

package/src/tool/bloodUnitConverter/seo.astro

@@ -0,0 +1,14 @@
+---
+import { SEORenderer } from '@jjlmoya/utils-shared';
+import { bloodUnitConverter } from './index';
+import type { KnownLocale } from '../../types';
+
+interface Props {
+  locale?: KnownLocale;
+}
+
+const { locale = 'es' } = Astro.props;
+const content = await bloodUnitConverter.i18n[locale]?.();
+---
+
+{content && <SEORenderer content={{ locale, sections: content.seo }} />}

package/src/tool/bloodUnitConverter/ui.ts

@@ -0,0 +1,38 @@
+export interface BloodUnitConverterUI extends Record<string, string> {
+  appTitle: string;
+  appSubtitle: string;
+  sectionAnalyte: string;
+  sectionHistory: string;
+  labelMg: string;
+  labelMmol: string;
+  swapAriaLabel: string;
+  statusIdle: string;
+  analyteGlucosa: string;
+  analyteColesterolTotal: string;
+  analyteHdl: string;
+  analyteLdl: string;
+  analyteTriglic: string;
+  analyteCreatinina: string;
+  analyteUrea: string;
+  rangeBajo: string;
+  rangeNormal: string;
+  rangeAlto: string;
+  rangeMuyAlto: string;
+  rangeLimite: string;
+  rangeElevado: string;
+  rangePrediabetes: string;
+  rangeDiabetes: string;
+  rangeDeseable: string;
+  rangeRiesgo: string;
+  rangeAceptable: string;
+  rangeExcelente: string;
+  rangeOptimo: string;
+  rangeCasiOptimo: string;
+  historyAdd: string;
+  historyAnalyte: string;
+  historyMg: string;
+  historyMmol: string;
+  historyStatus: string;
+  historyEmpty: string;
+  disclaimerText: string;
+}

package/src/tool/bmiCalculator/bibliography.astro

@@ -0,0 +1,14 @@
+---
+import { Bibliography } from '@jjlmoya/utils-shared';
+import { bmiCalculator } from './index';
+import type { KnownLocale } from '../../types';
+
+interface Props {
+  locale?: KnownLocale;
+}
+
+const { locale = 'es' } = Astro.props;
+const content = await bmiCalculator.i18n[locale]?.();
+---
+
+{content && <Bibliography items={content.bibliography} title={content.bibliographyTitle} />}