@jjlmoya/utils-health 1.1.0

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

@@ -0,0 +1,198 @@
+import type { WithContext, SoftwareApplication, FAQPage, HowToThing } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { CaffeineTrackerUI } from '../ui';
+
+const slug = 'caffeine-tracker';
+const title = 'Caffeine Metabolism Tracker: Sleep Simulator';
+const description =
+  'Calculate how much caffeine remains in your system based on your metabolism. Decay visualizer to avoid insomnia and improve your rest.';
+
+const faqData = [
+  {
+    question: 'What is caffeine half-life?',
+    answer:
+      'It is the time it takes your body to eliminate 50% of the caffeine consumed. In a healthy adult, the half-life ranges between 5 and 6 hours, though it can vary drastically based on genetics and habits.',
+  },
+  {
+    question: 'Why does coffee affect me more in the afternoon?',
+    answer:
+      'Caffeine blocks adenosine receptors (the tiredness molecule). If you consume coffee in the afternoon, adenosine accumulates but cannot act. When caffeine is metabolized, all that adenosine hits at once, causing the "crash".',
+  },
+  {
+    question: 'How does smoking affect coffee metabolism?',
+    answer:
+      'Smoking accelerates the CYP1A2 enzyme responsible for processing caffeine. That is why smokers tend to metabolize coffee up to 50% faster than non-smokers.',
+  },
+  {
+    question: 'Is it safe to consume caffeine during pregnancy?',
+    answer:
+      'During pregnancy, the half-life of caffeine can increase to 15 hours due to metabolic changes. It is recommended to limit consumption to less than 200mg daily and always under medical supervision.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Log your intake',
+    text: 'Enter the amount of caffeine (in mg) and the time you consumed it.',
+  },
+  {
+    name: 'Adjust your metabolism',
+    text: 'Configure whether you are a smoker or have a slow/fast metabolism for greater accuracy.',
+  },
+  {
+    name: 'Visualize the decay',
+    text: 'Watch the chart to see how much caffeine will remain in your blood at bedtime.',
+  },
+  {
+    name: 'Optimize your rest',
+    text: 'Use the data to decide if you can have another cup or if it is better to stop to ensure quality sleep.',
+  },
+];
+
+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<CaffeineTrackerUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Frequently asked questions about caffeine and sleep',
+  faq: faqData,
+  bibliographyTitle: 'Metabolism Science and Pharmacokinetics',
+  bibliography: [
+    {
+      name: 'Caffeine effects on sleep taken 0, 3, or 6 hours before going to bed (Journal of Clinical Sleep Medicine)',
+      url: 'https://jcsm.aasm.org/doi/10.5664/jcsm.3170',
+    },
+    {
+      name: 'Effect of smoking on caffeine elimination (Clinical Pharmacology & Therapeutics)',
+      url: 'https://pubmed.ncbi.nlm.nih.gov/2482799/',
+    },
+    {
+      name: 'Caffeine metabolism during pregnancy (British Journal of Clinical Pharmacology)',
+      url: 'https://www.bmj.com/content/313/7069/1358.short',
+    },
+    {
+      name: 'Common genetic variation in the CYP1A2 gene and caffeine metabolism (JAMA)',
+      url: 'https://pmc.ncbi.nlm.nih.gov/articles/PMC9880799/',
+    },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  ui: {
+    drinkEspressoName: 'Espresso',
+    drinkDoubleEspressoName: 'Double Espresso',
+    drinkBrewedName: 'Filter Coffee',
+    drinkEnergySmallName: 'Energy Drink',
+    drinkMonsterName: 'XL Energy Can',
+    drinkSodaName: 'Cola Soda',
+    drinkTeaName: 'Black Tea',
+    drinkEspressoDesc: '60mg • 30ml',
+    drinkDoubleEspressoDesc: '120mg • 60ml',
+    drinkBrewedDesc: '95mg • 250ml',
+    drinkEnergySmallDesc: '80mg • 250ml',
+    drinkMonsterDesc: '160mg • 500ml',
+    drinkSodaDesc: '35mg • 330ml',
+    drinkTeaDesc: '45mg • 250ml',
+    metabolismFastLabel: 'Fast (Smoker)',
+    metabolismNormalLabel: 'Standard',
+    metabolismSlowLabel: 'Slow (Contraceptives)',
+    metabolismPregnancyLabel: 'Very Slow (Pregnancy)',
+    metabolismFastDesc: 'Smoking speeds up caffeine elimination.',
+    metabolismNormalDesc: 'Average for a healthy adult.',
+    metabolismSlowDesc: 'Certain medications slow the process.',
+    metabolismPregnancyDesc: 'Very slow elimination.',
+    sectionAddDrink: 'Add Drink',
+    sectionMetabolism: 'Metabolism',
+    sectionJournal: 'Total Intake',
+    labelCurrentMg: 'In Blood Now',
+    labelEliminationTime: 'Clearance Time',
+    labelSleepQuestion: 'When will you sleep?',
+    statusOptimal: 'Optimal',
+    statusModerate: 'Moderate',
+    statusCritical: 'Critical',
+    btnReset: 'Reset',
+    journalEmpty: 'Empty',
+    sleepAtPrefix: 'At',
+  },
+  seo: [
+    {
+      type: 'summary',
+      title: 'Caffeine Metabolism Tracker',
+      items: [
+        '<strong>Pharmacological half-life</strong>: time it takes your body to eliminate 50% of consumed caffeine.',
+        '<strong>Personalized metabolism</strong>: adjust for smokers, contraceptive users, or pregnancy.',
+        '<strong>Real-time decay chart</strong>: visualize how much caffeine remains in blood hour by hour over 24h.',
+        '<strong>Integrated sleep simulator</strong>: calculate exactly how much caffeine you will have at bedtime.',
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Caffeine Half-Life: Why That 5 PM Coffee Ruins Your Sleep',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Most people consume caffeine daily without really understanding how it interacts with their biology. The key concept to master is the <strong>half-life</strong>. In pharmacology, the half-life is the time it takes the body to eliminate 50% of a substance from the blood. For the average healthy adult, caffeine has a half-life of about <strong>5 to 6 hours</strong>.',
+    },
+    {
+      type: 'paragraph',
+      html: 'This means that if you drink a cup of coffee with 100mg of caffeine at 4 PM, at 10 PM you will still have 50mg circulating in your brain. At 4 AM (12 hours later), 25mg will still be active. That amount is more than enough to disrupt your sleep architecture, reducing deep sleep even if you manage to fall asleep.',
+    },
+    { type: 'title', text: 'The Energy Lie: Adenosine', level: 2 },
+    {
+      type: 'paragraph',
+      html: 'We often say caffeine "gives us energy," but this is biologically incorrect. Caffeine does not add energy; what it does is <strong>block the perception of fatigue</strong>. From the moment you wake up, your brain accumulates a molecule called <strong>adenosine</strong>. The more adenosine binds to its receptors, the sleepier you feel. Caffeine fits into those same receptors, blocking them. When it finally metabolizes, all the accumulated adenosine hits at once: the famous <strong>"Caffeine Crash"</strong>.',
+    },
+    { type: 'title', text: 'Factors That Alter Your Caffeine Metabolism', level: 2 },
+    {
+      type: 'list',
+      items: [
+        '<strong>Smoking (Accelerator):</strong> Smoking induces the CYP1A2 enzyme. Smokers eliminate caffeine twice as fast, which is why they tend to drink more cups to feel the same effect.',
+        '<strong>Oral contraceptives (Decelerator):</strong> Can double the half-life to 10-12 hours. A midday coffee can be equivalent to an evening coffee.',
+        '<strong>Pregnancy:</strong> During the third trimester, the half-life can extend to 15 hours due to hormonal and metabolic changes.',
+        '<strong>Genetics (CYP1A2):</strong> 50% of the population are "slow metabolizers" who feel jittery from just one small cup.',
+      ],
+    },
+    { type: 'title', text: 'Optimizing Your Sleep Hygiene with Caffeine', level: 2 },
+    {
+      type: 'paragraph',
+      html: 'Most sleep experts recommend stopping caffeine consumption <strong>8 to 10 hours before</strong> bedtime. If your goal is to sleep at 11 PM, your last coffee should be between 1 PM and 3 PM. Also, to avoid the afternoon crash, wait 90 minutes after waking up before having your first cup.',
+    },
+    {
+      type: 'tip',
+      title: 'Caffeine Curfew',
+      html: 'Use the simulator to calculate exactly how much caffeine you will have in your blood at bedtime. Experts recommend less than 20mg for quality sleep. Adjust the slider until the level shows "Optimal".',
+    },
+  ],
+};

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

@@ -0,0 +1,198 @@
+import type { WithContext, SoftwareApplication, FAQPage, HowToThing } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { CaffeineTrackerUI } from '../ui';
+
+const slug = 'rastreador-cafeina';
+const title = 'Rastreador de Vida Media de la Cafeína: Simulador de Sueño';
+const description =
+  'Calcula cuánta cafeína queda en tu sistema según tu metabolismo. Visualizador de degradación para evitar el insomnio y mejorar tu descanso.';
+
+const faqData = [
+  {
+    question: '¿Qué es la vida media de la cafeína?',
+    answer:
+      'Es el tiempo que tarda tu cuerpo en eliminar el 50% de la cafeína consumida. En un adulto sano, la vida media oscila entre 5 y 6 horas, aunque puede variar drásticamente según la genética y hábitos.',
+  },
+  {
+    question: '¿Por qué el café me afecta más por la tarde?',
+    answer:
+      'La cafeína bloquea los receptores de adenosina (la molécula del cansancio). Si consumes café por la tarde, la adenosina se acumula pero no puede actuar. Cuando la cafeína se metaboliza, toda esa adenosina golpea de golpe, causando el "crash".',
+  },
+  {
+    question: '¿Cómo afecta el tabaco al metabolismo del café?',
+    answer:
+      'Fumar acelera la enzima CYP1A2, encargada de procesar la cafeína. Por eso, los fumadores suelen metabolizar el café hasta un 50% más rápido que los no fumadores.',
+  },
+  {
+    question: '¿Es seguro tomar cafeína durante el embarazo?',
+    answer:
+      'Durante el embarazo, la vida media de la cafeína puede aumentar hasta las 15 horas debido a cambios metabólicos. Se recomienda limitar el consumo a menos de 200mg diarios y siempre bajo supervisión médica.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Registrar consumo',
+    text: 'Introduce la cantidad de cafeína (en mg) y la hora a la que la has consumido.',
+  },
+  {
+    name: 'Ajustar metabolismo',
+    text: 'Configura si eres fumador o si tienes un metabolismo lento/rápido para mayor precisión.',
+  },
+  {
+    name: 'Visualizar degradación',
+    text: 'Observa el gráfico para ver cuánta cafeína quedará en tu sangre a la hora de ir a dormir.',
+  },
+  {
+    name: 'Optimizar descanso',
+    text: 'Usa los datos para decidir si puedes tomar otra taza o si es mejor parar para garantizar un sueño reparador.',
+  },
+];
+
+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<CaffeineTrackerUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Preguntas frecuentes sobre la cafeína y el sueño',
+  faq: faqData,
+  bibliographyTitle: 'Ciencia del Metabolismo y Farmacocinética',
+  bibliography: [
+    {
+      name: 'Caffeine effects on sleep taken 0, 3, or 6 hours before going to bed (Journal of Clinical Sleep Medicine)',
+      url: 'https://jcsm.aasm.org/doi/10.5664/jcsm.3170',
+    },
+    {
+      name: 'Effect of smoking on caffeine elimination (Clinical Pharmacology & Therapeutics)',
+      url: 'https://pubmed.ncbi.nlm.nih.gov/2482799/',
+    },
+    {
+      name: 'Caffeine metabolism during pregnancy (British Journal of Clinical Pharmacology)',
+      url: 'https://www.bmj.com/content/313/7069/1358.short',
+    },
+    {
+      name: 'Common genetic variation in the CYP1A2 gene and caffeine metabolism (JAMA)',
+      url: 'https://pmc.ncbi.nlm.nih.gov/articles/PMC9880799/',
+    },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  ui: {
+    drinkEspressoName: 'Espresso',
+    drinkDoubleEspressoName: 'Doble Espresso',
+    drinkBrewedName: 'Café de Filtro',
+    drinkEnergySmallName: 'Bebida Energética',
+    drinkMonsterName: 'Lata XL Energy',
+    drinkSodaName: 'Refresco Cola',
+    drinkTeaName: 'Té Negro',
+    drinkEspressoDesc: '60mg • 30ml',
+    drinkDoubleEspressoDesc: '120mg • 60ml',
+    drinkBrewedDesc: '95mg • 250ml',
+    drinkEnergySmallDesc: '80mg • 250ml',
+    drinkMonsterDesc: '160mg • 500ml',
+    drinkSodaDesc: '35mg • 330ml',
+    drinkTeaDesc: '45mg • 250ml',
+    metabolismFastLabel: 'Rápido (Fumador)',
+    metabolismNormalLabel: 'Estándar',
+    metabolismSlowLabel: 'Lento (Anticonceptivos)',
+    metabolismPregnancyLabel: 'Muy Lento (Embarazo)',
+    metabolismFastDesc: 'El tabaco acelera la eliminación del café.',
+    metabolismNormalDesc: 'Promedio para un adulto sano.',
+    metabolismSlowDesc: 'Ciertos medicamentos ralentizan el proceso.',
+    metabolismPregnancyDesc: 'Eliminación muy pausada.',
+    sectionAddDrink: 'Añadir Bebida',
+    sectionMetabolism: 'Metabolismo',
+    sectionJournal: 'Consumo Acumulado',
+    labelCurrentMg: 'En Sangre ahora',
+    labelEliminationTime: 'Tiempo de limpieza',
+    labelSleepQuestion: '¿A qué hora dormirás?',
+    statusOptimal: 'Óptimo',
+    statusModerate: 'Moderado',
+    statusCritical: 'Crítico',
+    btnReset: 'Reiniciar',
+    journalEmpty: 'Vacío',
+    sleepAtPrefix: 'A las',
+  },
+  seo: [
+    {
+      type: 'summary',
+      title: 'Rastreador de Vida Media de la Cafeína',
+      items: [
+        '<strong>Vida media farmacológica</strong>: tiempo que tarda tu cuerpo en eliminar el 50% de la cafeína consumida.',
+        '<strong>Metabolismo personalizado</strong>: ajusta si eres fumador, tomas anticonceptivos o estás embarazada.',
+        '<strong>Gráfico de degradación</strong>: visualiza cuánta cafeína queda en sangre hora a hora durante 24h.',
+        '<strong>Simulador de sueño</strong>: calcula exactamente cuánta cafeína tendrás al acostarte.',
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Vida Media de la Cafeína: Por qué ese café de las 5 PM arruina tu sueño',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'La mayoría de las personas consumen cafeína a diario sin entender realmente cómo interactúa con su biología. El concepto clave que debemos dominar es la <strong>vida media</strong>. En farmacología, la vida media es el tiempo que tarda el cuerpo en eliminar el 50% de una sustancia de la sangre. Para un adulto sano promedio, la cafeína tiene una vida media de unas <strong>5 a 6 horas</strong>.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Esto significa que si tomas una taza de café con 100mg de cafeína a las 4 de la tarde, a las 10 de la noche todavía tendrás 50mg circulando en tu cerebro. A las 4 de la mañana (12 horas después), aún quedarán 25mg activos. Esa cantidad es más que suficiente para alterar la arquitectura de tu sueño, reduciendo la fase de sueño profundo incluso si logras quedarte dormido.',
+    },
+    { type: 'title', text: 'La Mentira de la Energía: La Adenosina', level: 2 },
+    {
+      type: 'paragraph',
+      html: 'A menudo decimos que la cafeína nos "da energía", pero esto es biológicamente incorrecto. La cafeína no añade energía; lo que hace es <strong>bloquear la percepción del cansancio</strong>. Desde que te despiertas, tu cerebro acumula una molécula llamada <strong>adenosina</strong>. Cuanta más adenosina se une a sus receptores, más sueño sientes. La cafeína encaja en esos mismos receptores, bloqueándolos. Cuando se metaboliza, toda la adenosina acumulada golpea de golpe: el famoso <strong>"Caffeine Crash"</strong>.',
+    },
+    { type: 'title', text: 'Factores que Alteran tu Metabolismo del Café', level: 2 },
+    {
+      type: 'list',
+      items: [
+        '<strong>Tabaquismo (Acelerador):</strong> Fumar induce la enzima CYP1A2. Los fumadores eliminan la cafeína el doble de rápido, por eso suelen tomar más tazas para sentir el mismo efecto.',
+        '<strong>Anticonceptivos orales (Ralentizador):</strong> Pueden duplicar la vida media hasta las 10-12 horas. Un café al mediodía puede equivaler a un café nocturno.',
+        '<strong>Embarazo:</strong> Durante el tercer trimestre, la vida media puede extenderse hasta las 15 horas por cambios hormonales y metabólicos.',
+        '<strong>Genética (CYP1A2):</strong> El 50% de la población son "metabolizadores lentos" que sienten nerviosismo con una sola taza.',
+      ],
+    },
+    { type: 'title', text: 'Optimizando tu Higiene del Sueño con Cafeína', level: 2 },
+    {
+      type: 'paragraph',
+      html: 'La mayoría de los expertos en sueño recomiendan dejar de consumir cafeína <strong>8 a 10 horas antes</strong> de acostarse. Si tu objetivo es dormir a las 11 PM, tu último café debería ser entre la 1 PM y las 3 PM. Además, para evitar el crash de la tarde, espera 90 minutos después de despertarte antes de tomar tu primera taza.',
+    },
+    {
+      type: 'tip',
+      title: 'Caffeine Curfew (Toque de Queda de la Cafeína)',
+      html: 'Usa el simulador para calcular exactamente cuánta cafeína tendrás en sangre cuando quieras dormir. Los expertos recomiendan menos de 20mg para un sueño de calidad. Ajusta el deslizador hasta que el nivel sea "Óptimo".',
+    },
+  ],
+};

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

@@ -0,0 +1,198 @@
+import type { WithContext, SoftwareApplication, FAQPage, HowToThing } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { CaffeineTrackerUI } from '../ui';
+
+const slug = 'traceur-cafeine';
+const title = 'Calculateur de Métabolisme de la Caféine: Simulateur de Sommeil';
+const description =
+  'Calculez quelle quantité de caféine reste dans votre système selon votre métabolisme. Visualiseur de dégradation pour éviter l\'insomnie et améliorer votre repos.';
+
+const faqData = [
+  {
+    question: 'Qu\'est-ce que la demi-vie de la caféine?',
+    answer:
+      'C\'est le temps que met votre corps pour éliminer 50% de la caféine consommée. Chez un adulte en bonne santé, la demi-vie se situe entre 5 et 6 heures, bien qu\'elle puisse varier considérablement selon la génétique et les habitudes.',
+  },
+  {
+    question: 'Pourquoi le café m\'affecte-t-il plus l\'après-midi?',
+    answer:
+      'La caféine bloque les récepteurs d\'adénosine (la molécule de fatigue). Si vous consommez du café l\'après-midi, l\'adénosine s\'accumule mais ne peut pas agir. Quand la caféine est métabolisée, toute cette adénosine frappe d\'un coup, provoquant le "crash".',
+  },
+  {
+    question: 'Comment le tabac affecte-t-il le métabolisme du café?',
+    answer:
+      'Fumer accélère l\'enzyme CYP1A2 responsable du traitement de la caféine. C\'est pourquoi les fumeurs métabolisent généralement le café jusqu\'à 50% plus vite que les non-fumeurs.',
+  },
+  {
+    question: 'Est-il sûr de consommer de la caféine pendant la grossesse?',
+    answer:
+      'Pendant la grossesse, la demi-vie de la caféine peut augmenter jusqu\'à 15 heures en raison de changements métaboliques. Il est recommandé de limiter la consommation à moins de 200mg par jour et toujours sous surveillance médicale.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Enregistrer la consommation',
+    text: 'Saisissez la quantité de caféine (en mg) et l\'heure à laquelle vous l\'avez consommée.',
+  },
+  {
+    name: 'Ajuster le métabolisme',
+    text: 'Configurez si vous êtes fumeur ou si vous avez un métabolisme lent/rapide pour plus de précision.',
+  },
+  {
+    name: 'Visualiser la dégradation',
+    text: 'Observez le graphique pour voir combien de caféine restera dans votre sang à l\'heure du coucher.',
+  },
+  {
+    name: 'Optimiser votre repos',
+    text: 'Utilisez les données pour décider si vous pouvez prendre une autre tasse ou s\'il vaut mieux arrêter pour garantir un sommeil réparateur.',
+  },
+];
+
+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<CaffeineTrackerUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Questions fréquentes sur la caféine et le sommeil',
+  faq: faqData,
+  bibliographyTitle: 'Science du Métabolisme et Pharmacocinétique',
+  bibliography: [
+    {
+      name: 'Caffeine effects on sleep taken 0, 3, or 6 hours before going to bed (Journal of Clinical Sleep Medicine)',
+      url: 'https://jcsm.aasm.org/doi/10.5664/jcsm.3170',
+    },
+    {
+      name: 'Effect of smoking on caffeine elimination (Clinical Pharmacology & Therapeutics)',
+      url: 'https://pubmed.ncbi.nlm.nih.gov/2482799/',
+    },
+    {
+      name: 'Caffeine metabolism during pregnancy (British Journal of Clinical Pharmacology)',
+      url: 'https://www.bmj.com/content/313/7069/1358.short',
+    },
+    {
+      name: 'Common genetic variation in the CYP1A2 gene and caffeine metabolism (JAMA)',
+      url: 'https://pmc.ncbi.nlm.nih.gov/articles/PMC9880799/',
+    },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  ui: {
+    drinkEspressoName: 'Espresso',
+    drinkDoubleEspressoName: 'Double Espresso',
+    drinkBrewedName: 'Café Filtre',
+    drinkEnergySmallName: 'Boisson Énergétique',
+    drinkMonsterName: 'Canette XL Energy',
+    drinkSodaName: 'Soda Cola',
+    drinkTeaName: 'Thé Noir',
+    drinkEspressoDesc: '60mg • 30ml',
+    drinkDoubleEspressoDesc: '120mg • 60ml',
+    drinkBrewedDesc: '95mg • 250ml',
+    drinkEnergySmallDesc: '80mg • 250ml',
+    drinkMonsterDesc: '160mg • 500ml',
+    drinkSodaDesc: '35mg • 330ml',
+    drinkTeaDesc: '45mg • 250ml',
+    metabolismFastLabel: 'Rapide (Fumeur)',
+    metabolismNormalLabel: 'Standard',
+    metabolismSlowLabel: 'Lent (Contraceptifs)',
+    metabolismPregnancyLabel: 'Très Lent (Grossesse)',
+    metabolismFastDesc: 'Le tabac accélère l\'élimination de la caféine.',
+    metabolismNormalDesc: 'Moyenne pour un adulte en bonne santé.',
+    metabolismSlowDesc: 'Certains médicaments ralentissent le processus.',
+    metabolismPregnancyDesc: 'Élimination très lente.',
+    sectionAddDrink: 'Ajouter une Boisson',
+    sectionMetabolism: 'Métabolisme',
+    sectionJournal: 'Consommation Totale',
+    labelCurrentMg: 'Dans le Sang',
+    labelEliminationTime: 'Temps de Clairance',
+    labelSleepQuestion: 'Quand dormirez-vous?',
+    statusOptimal: 'Optimal',
+    statusModerate: 'Modéré',
+    statusCritical: 'Critique',
+    btnReset: 'Réinitialiser',
+    journalEmpty: 'Vide',
+    sleepAtPrefix: 'À',
+  },
+  seo: [
+    {
+      type: 'summary',
+      title: 'Calculateur de Métabolisme de la Caféine',
+      items: [
+        '<strong>Demi-vie pharmacologique</strong>: temps que met votre corps à éliminer 50% de la caféine consommée.',
+        '<strong>Métabolisme personnalisé</strong>: ajustez pour fumeurs, contraceptifs ou grossesse.',
+        '<strong>Graphique de dégradation</strong>: visualisez la caféine restante dans le sang heure par heure sur 24h.',
+        '<strong>Simulateur de sommeil</strong>: calculez exactement la caféine que vous aurez au coucher.',
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Demi-Vie de la Caféine: Pourquoi ce café de 17h ruine votre sommeil',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'La plupart des gens consomment de la caféine quotidiennement sans vraiment comprendre comment elle interagit avec leur biologie. Le concept clé à maîtriser est la <strong>demi-vie</strong>. En pharmacologie, la demi-vie est le temps que met le corps à éliminer 50% d\'une substance du sang. Pour un adulte sain moyen, la caféine a une demi-vie d\'environ <strong>5 à 6 heures</strong>.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Cela signifie que si vous buvez un café avec 100mg de caféine à 16h, à 22h vous aurez encore 50mg circulant dans votre cerveau. À 4h du matin (12 heures plus tard), il restera encore 25mg actifs. Cette quantité est plus que suffisante pour perturber l\'architecture de votre sommeil, réduisant le sommeil profond même si vous réussissez à vous endormir.',
+    },
+    { type: 'title', text: 'Le Mensonge de l\'Énergie: L\'Adénosine', level: 2 },
+    {
+      type: 'paragraph',
+      html: 'On dit souvent que la caféine nous "donne de l\'énergie", mais c\'est biologiquement incorrect. La caféine n\'ajoute pas d\'énergie ; ce qu\'elle fait c\'est <strong>bloquer la perception de la fatigue</strong>. Depuis votre réveil, votre cerveau accumule une molécule appelée <strong>adénosine</strong>. Plus l\'adénosine se lie à ses récepteurs, plus vous vous sentez somnolent. La caféine s\'imbrique dans ces mêmes récepteurs, les bloquant. Quand elle se métabolise finalement, toute l\'adénosine accumulée frappe d\'un coup : le fameux <strong>"Caffeine Crash"</strong>.',
+    },
+    { type: 'title', text: 'Facteurs qui Altèrent votre Métabolisme de la Caféine', level: 2 },
+    {
+      type: 'list',
+      items: [
+        '<strong>Tabagisme (Accélérateur):</strong> Fumer induit l\'enzyme CYP1A2. Les fumeurs éliminent la caféine deux fois plus vite, ce qui explique pourquoi ils boivent souvent plus de tasses.',
+        '<strong>Contraceptifs oraux (Décélérateur):</strong> Peuvent doubler la demi-vie jusqu\'à 10-12 heures. Un café à midi peut équivaloir à un café du soir.',
+        '<strong>Grossesse:</strong> Au troisième trimestre, la demi-vie peut s\'étendre jusqu\'à 15 heures en raison de changements hormonaux.',
+        '<strong>Génétique (CYP1A2):</strong> 50% de la population sont des "métaboliseurs lents" qui ressentent de la nervosité avec une seule petite tasse.',
+      ],
+    },
+    { type: 'title', text: 'Optimiser votre Hygiène du Sommeil avec la Caféine', level: 2 },
+    {
+      type: 'paragraph',
+      html: 'La plupart des experts du sommeil recommandent d\'arrêter la consommation de caféine <strong>8 à 10 heures avant</strong> le coucher. Si votre objectif est de dormir à 23h, votre dernier café devrait être entre 13h et 15h. De plus, pour éviter le crash de l\'après-midi, attendez 90 minutes après le réveil avant de prendre votre première tasse.',
+    },
+    {
+      type: 'tip',
+      title: 'Heure Limite Caféine',
+      html: 'Utilisez le simulateur pour calculer exactement la caféine que vous aurez dans le sang au moment de dormir. Les experts recommandent moins de 20mg pour un sommeil de qualité. Ajustez le curseur jusqu\'à ce que le niveau affiche "Optimal".',
+    },
+  ],
+};

package/src/tool/caffeineTracker/index.ts

@@ -0,0 +1,27 @@
+import type { HealthToolEntry, ToolDefinition } from '../../types';
+import CaffeineTrackerComponent from './component.astro';
+import CaffeineTrackerSEO from './seo.astro';
+import CaffeineTrackerBibliography from './bibliography.astro';
+import type { CaffeineTrackerUI } from './ui';
+
+export const caffeineTracker: HealthToolEntry<CaffeineTrackerUI> = {
+  id: 'caffeineTracker',
+  icons: {
+    bg: 'mdi:coffee',
+    fg: 'mdi:sleep',
+  },
+  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 { CaffeineTrackerComponent, CaffeineTrackerSEO, CaffeineTrackerBibliography };
+
+export const CAFFEINE_TRACKER_TOOL: ToolDefinition = {
+  entry: caffeineTracker,
+  Component: CaffeineTrackerComponent,
+  SEOComponent: CaffeineTrackerSEO,
+  BibliographyComponent: CaffeineTrackerBibliography,
+};

package/src/tool/caffeineTracker/logic.ts

@@ -0,0 +1,31 @@
+export interface DrinkPreset {
+  id: string;
+  mg: number;
+  icon: string;
+}
+
+export interface MetabolismPreset {
+  id: string;
+  halfLife: number;
+}
+
+export const DRINK_PRESETS: DrinkPreset[] = [
+  { id: 'espresso', mg: 60, icon: 'mdi:coffee-outline' },
+  { id: 'double_espresso', mg: 120, icon: 'mdi:coffee' },
+  { id: 'brewed', mg: 95, icon: 'mdi:coffee-maker-outline' },
+  { id: 'energy_small', mg: 80, icon: 'mdi:lightning-bolt' },
+  { id: 'monster', mg: 160, icon: 'mdi:lightning-bolt-circle' },
+  { id: 'soda', mg: 35, icon: 'mdi:cup-water' },
+  { id: 'tea', mg: 45, icon: 'mdi:tea' },
+];
+
+export const METABOLISM_PRESETS: MetabolismPreset[] = [
+  { id: 'fast', halfLife: 3 },
+  { id: 'normal', halfLife: 5.5 },
+  { id: 'slow', halfLife: 10 },
+  { id: 'pregnancy', halfLife: 15 },
+];
+
+export function calculateDecay(initialMg: number, hours: number, halfLife: number): number {
+  return initialMg * Math.pow(0.5, hours / halfLife);
+}

package/src/tool/caffeineTracker/seo.astro

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