@jjlmoya/utils-alcohol 1.8.0 → 1.10.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jjlmoya/utils-alcohol",
-  "version": "1.8.0",
+  "version": "1.10.0",
   "type": "module",
   "main": "./src/index.ts",
   "types": "./src/index.ts",

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

@@ -2,8 +2,8 @@ import type { WithContext, SoftwareApplication } from 'schema-dts';
 import type { AlcoholClearanceUI, AlcoholClearanceLocaleContent } from '../index';
 
 const slug = 'alcohol-clearance-calculator';
-const title = 'BAC & Alcohol Metabolism Calculator';
-const description = 'Estimate your Blood Alcohol Content (BAC) and the time needed for your body to eliminate alcohol based on Widmark\'s formula.';
+const title = 'Hangover & BAC Calculator: Recovery Predictor';
+const description = 'Calculate your Blood Alcohol Content (BAC) and time to reach 0.0 using Widmark\'s formula. Plan your pre-sleep hydration and know when you\'ll be fully recovered.';
 
 const ui: AlcoholClearanceUI = {
   biologicalSexLabel: 'Biological Sex',
@@ -35,23 +35,35 @@ const bibliographyTitle = 'Bibliography & Sources';
 
 const faq: AlcoholClearanceLocaleContent['faq'] = [
   {
-    question: "What is Widmark's formula?",
-    answer: "It is the standard pharmacokinetics model that relates the amount of alcohol ingested with body weight and a distribution factor based on biological sex.",
+    question: "What is a Standard Drink Unit and how much is in each drink?",
+    answer: "A Standard Drink Unit contains approximately 10 grams of pure alcohol (UK/EU definition; 14g in the US). A regular beer (330ml at 5%) contains ~1.3 units, a glass of wine (150ml at 12%) ~1.4 units, and a shot (40ml at 40%) ~1.3 units. Knowing the units in what you drink is essential for interpreting the calculator's results correctly.",
   },
   {
-    question: "Can coffee speed up alcohol elimination?",
-    answer: "No. The liver eliminates alcohol at a constant rate (approx. 0.15 g/L per hour). Coffee may make you feel more alert, but it doesn't reduce blood alcohol levels.",
+    question: "Why does biological sex affect BAC calculations?",
+    answer: "Biological sex influences the Widmark factor 'r', which represents total body water as a fraction of weight. Men average r=0.68 because they have proportionally more body water. Women average r=0.55 due to a higher percentage of body fat, which retains less alcohol. This means that for the same drinks and body weight, women will reach a higher BAC.",
   },
   {
-    question: "Why does biological sex affect BAC calculations?",
-    answer: "Biological sex influences the Widmark factor 'r', which represents total body water as a fraction of weight. Men average r=0.68 because they have proportionally more body water. Women average r=0.55 due to higher body fat percentages, which holds less alcohol. This means for the same drinks and weight, women will have a higher BAC.",
+    question: "Can coffee, water or exercise speed up alcohol elimination?",
+    answer: "No. The liver eliminates alcohol at a constant rate of approximately 0.15 g/L per hour (zero-order kinetics). Coffee can mask tiredness, water helps with dehydration, and exercise improves general wellbeing — but none of them reduce your actual BAC. Only time eliminates alcohol from the blood.",
+  },
+  {
+    question: "Does eating after drinking help lower BAC?",
+    answer: "Eating after drinking does not reduce the alcohol already in your bloodstream. Where food makes a huge difference is before or during drinking: food in the stomach — especially proteins and fats — slows gastric absorption and can reduce your peak BAC by up to 50%. Once alcohol is absorbed, only hepatic metabolism can eliminate it.",
+  },
+  {
+    question: "How long does it take to reach 0.0 BAC?",
+    answer: "It depends on your starting BAC. Divide your estimated BAC (in g/L) by 0.15 to get the approximate hours. For example, a BAC of 1.5 g/L takes around 10 hours. The liver never stops: it processes alcohol even while you sleep. But be aware — alcohol can still be present in your blood even when you feel completely recovered.",
+  },
+  {
+    question: "Is this calculator 100% reliable for deciding whether to drive?",
+    answer: "No. This tool is a theoretical estimate based on Widmark's formula. Factors such as food intake, medications, fatigue, genetic ADH enzyme variants, and stress can shift your actual BAC by 20–30% in either direction. Never use this calculator to decide whether to drive. If you have been drinking, do not drive — that is the only rule with zero margin for error.",
   },
 ];
 
 const bibliography: AlcoholClearanceLocaleContent['bibliography'] = [
   {
-    name: "Widmark's Formula for BAC Calculation - Forensic Science Lab",
-    url: "https://www.forensic-science.com/widmark-formula",
+    name: "Alcohol calculations and their uncertainty - PMC",
+    url: "https://pmc.ncbi.nlm.nih.gov/articles/PMC4361698/",
   },
   {
     name: "Alcohol Metabolism: How the body processes alcohol - NIH",

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

@@ -2,8 +2,8 @@ import type { WithContext, SoftwareApplication } from 'schema-dts';
 import type { AlcoholClearanceUI, AlcoholClearanceLocaleContent } from '../index';
 
 const slug = 'calculadora-alcohol-resaca';
-const title = 'Calculadora de Alcoholemia y Metabolismo';
-const description = 'Estima tu tasa de alcoholemia (BAC) y el tiempo necesario para eliminar el alcohol de tu organismo basándote en la fórmula de Widmark.';
+const title = 'Calculadora de Resaca y Alcoholemia: Predictor de Recuperación';
+const description = 'Calcula tu alcoholemia (BAC) y el tiempo hasta 0.0 según la fórmula de Widmark. Planifica tu hidratación pre-sueño y sabe cuándo estarás recuperado.';
 
 const ui: AlcoholClearanceUI = {
   biologicalSexLabel: 'Sexo Biológico',
@@ -35,17 +35,29 @@ const bibliographyTitle = 'Bibliografía y Fuentes';
 
 const faq: AlcoholClearanceLocaleContent['faq'] = [
   {
-    question: "¿Qué es la fórmula de Widmark?",
-    answer: "Es el modelo estándar de farmacocinética que relaciona la cantidad de alcohol ingerido con el peso corporal y un factor de distribución según el sexo biológico.",
-  },
-  {
-    question: "¿Se puede acelerar la eliminación con café?",
-    answer: "No. El hígado elimina el alcohol a una tasa constante (aprox. 0.15 g/L por hora). El café puede espabilarte, pero no reduce el alcohol en sangre.",
+    question: "¿Qué es una UBE y cuántas lleva cada bebida?",
+    answer: "Una UBE (Unidad de Bebida Estándar) equivale a 10 gramos de alcohol puro en España. Una caña (330ml al 5%) aporta ~1.3 UBE, una copa de vino (150ml al 12%) ~1.4 UBE y un chupito (40ml al 40%) ~1.3 UBE. Conocer las UBE de lo que bebes es clave para interpretar correctamente el resultado de la calculadora.",
   },
   {
     question: "¿Por qué el sexo biológico afecta al cálculo de la alcoholemia?",
     answer: "El sexo biológico influye en el factor de Widmark 'r', que representa el agua corporal total como fracción del peso. Los hombres tienen de media r=0.68 porque tienen proporcionalmente más agua corporal. Las mujeres tienen de media r=0.55 debido a un mayor porcentaje de grasa corporal, que retiene menos el alcohol. Esto significa que, con las mismas bebidas y peso, las mujeres tendrán una tasa de alcoholemia más alta.",
   },
+  {
+    question: "¿Se puede acelerar la eliminación con café, agua o ejercicio?",
+    answer: "No. El hígado elimina el alcohol a una tasa constante de aproximadamente 0.15 g/L por hora (cinética de orden cero). El café puede disimular el cansancio, el agua ayuda con la deshidratación y el ejercicio mejora el bienestar general, pero ninguno reduce el BAC real. Solo el tiempo elimina el alcohol de la sangre.",
+  },
+  {
+    question: "¿Comer después de beber ayuda a bajar el BAC?",
+    answer: "Comer después de beber no reduce el alcohol que ya está en sangre. Donde sí marca una diferencia enorme es antes o durante: la comida en el estómago, especialmente proteínas y grasas, ralentiza la absorción gástrica y puede reducir el BAC máximo alcanzado hasta un 50%. Una vez el alcohol está absorbido, solo el metabolismo hepático puede eliminarlo.",
+  },
+  {
+    question: "¿Cuánto tiempo tardo en dar 0.0?",
+    answer: "Depende de tu BAC inicial. Dividiendo tu alcoholemia estimada (en g/L) entre 0.15 obtienes las horas aproximadas. Por ejemplo, un BAC de 1.5 g/L requiere unas 10 horas. El hígado no descansa: procesa alcohol incluso mientras duermes. Pero atención: todavía puede haber alcohol en sangre aunque te sientas completamente recuperado.",
+  },
+  {
+    question: "¿Es esta calculadora 100% fiable para decidir si puedo conducir?",
+    answer: "No. Esta herramienta es una estimación teórica basada en la fórmula de Widmark. Factores como la comida, medicamentos, fatiga, genética de la enzima ADH o el estrés pueden desviarte un 20-30% del valor calculado. Nunca uses esta calculadora para decidir si conduces. Si has bebido, no conduzcas — es la única regla sin margen de error.",
+  },
 ];
 
 const howTo: AlcoholClearanceLocaleContent['howTo'] = [
@@ -65,8 +77,8 @@ const howTo: AlcoholClearanceLocaleContent['howTo'] = [
 
 const bibliography: AlcoholClearanceLocaleContent['bibliography'] = [
   {
-    name: "Widmark's Formula for BAC Calculation - Forensic Science Lab",
-    url: "https://www.forensic-science.com/widmark-formula",
+    name: "Alcohol calculations and their uncertainty - PMC",
+    url: "https://pmc.ncbi.nlm.nih.gov/articles/PMC4361698/",
   },
   {
     name: "Alcohol Metabolism: How the body processes alcohol - NIH",

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

@@ -2,8 +2,8 @@ import type { WithContext, SoftwareApplication } from 'schema-dts';
 import type { AlcoholClearanceUI, AlcoholClearanceLocaleContent } from '../index';
 
 const slug = 'calculateur-elimination-alcohol';
-const title = 'Calculateur d\'Alcooolémie et Métabolisme';
-const description = 'Estimez votre taux d\'alcoolémie (BAC) et le temps nécessaire à votre corps pour éliminer l\'alcool selon la formule de Widmark.';
+const title = 'Calculateur de Gueule de Bois et Alcoolémie : Prédicteur de Récupération';
+const description = 'Calculez votre alcoolémie (BAC) et le temps jusqu\'à 0,0 selon la formule de Widmark. Planifiez votre hydratation pré-sommeil et sachez quand vous serez complètement rétabli.';
 
 const ui: AlcoholClearanceUI = {
   biologicalSexLabel: 'Sexe Biologique',
@@ -35,23 +35,35 @@ const bibliographyTitle = 'Bibliographie & Sources';
 
 const faq: AlcoholClearanceLocaleContent['faq'] = [
   {
-    question: "Qu'est-ce que la formule de Widmark ?",
-    answer: "C'est le modèle standard de pharmacocinétique qui relie la quantité d'alcool ingérée au poids corporel et à un facteur de distribution selon le sexe biologique.",
-  },
-  {
-    question: "Le café peut-il accélérer l'élimination de l'alcool ?",
-    answer: "Non. Le foie élimine l'alcool à un taux constant (environ 0,15 g/L par heure). Le café peut vous réveiller, mais ne réduit pas le taux d'alcool dans le sang.",
+    question: "Qu'est-ce qu'une Unité Standard de Boisson et combien chaque verre en contient-il ?",
+    answer: "Une Unité Standard de Boisson contient environ 10 grammes d'alcool pur (définition européenne). Une bière ordinaire (330ml à 5%) représente ~1,3 unité, un verre de vin (150ml à 12%) ~1,4 unité et un shot (40ml à 40%) ~1,3 unité. Connaître les unités de ce que vous buvez est essentiel pour interpréter correctement les résultats du calculateur.",
   },
   {
     question: "Pourquoi le sexe biologique affecte-t-il le calcul de l'alcoolémie ?",
     answer: "Le sexe biologique influence le facteur de Widmark 'r', qui représente l'eau corporelle totale en fraction du poids. Les hommes ont en moyenne r=0,68 car ils ont proportionnellement plus d'eau corporelle. Les femmes ont en moyenne r=0,55 en raison d'un pourcentage plus élevé de graisses corporelles, qui retiennent moins l'alcool. Ainsi, à boissons et poids égaux, les femmes auront un BAC plus élevé.",
   },
+  {
+    question: "Le café, l'eau ou le sport peuvent-ils accélérer l'élimination de l'alcool ?",
+    answer: "Non. Le foie élimine l'alcool à un taux constant d'environ 0,15 g/L par heure (cinétique d'ordre zéro). Le café peut masquer la fatigue, l'eau aide contre la déshydratation et le sport améliore le bien-être général — mais aucun ne réduit votre alcoolémie réelle. Seul le temps élimine l'alcool du sang.",
+  },
+  {
+    question: "Manger après avoir bu aide-t-il à faire baisser l'alcoolémie ?",
+    answer: "Manger après avoir bu ne réduit pas l'alcool déjà présent dans le sang. Là où la nourriture fait une énorme différence, c'est avant ou pendant la consommation : les aliments dans l'estomac — notamment les protéines et les graisses — ralentissent l'absorption gastrique et peuvent réduire le BAC maximum atteint jusqu'à 50 %. Une fois l'alcool absorbé, seul le métabolisme hépatique peut l'éliminer.",
+  },
+  {
+    question: "Combien de temps faut-il pour atteindre 0,0 ?",
+    answer: "Cela dépend de votre BAC initial. Divisez votre alcoolémie estimée (en g/L) par 0,15 pour obtenir le nombre d'heures approximatif. Par exemple, un BAC de 1,5 g/L nécessite environ 10 heures. Le foie ne s'arrête jamais : il traite l'alcool même pendant le sommeil. Attention : il peut encore y avoir de l'alcool dans le sang même si vous vous sentez complètement rétabli.",
+  },
+  {
+    question: "Ce calculateur est-il fiable à 100 % pour décider si je peux conduire ?",
+    answer: "Non. Cet outil est une estimation théorique basée sur la formule de Widmark. Des facteurs comme l'alimentation, les médicaments, la fatigue, les variants génétiques de l'enzyme ADH et le stress peuvent faire dévier votre alcoolémie réelle de 20 à 30 % dans les deux sens. N'utilisez jamais ce calculateur pour décider de conduire. Si vous avez bu, ne conduisez pas — c'est la seule règle sans marge d'erreur.",
+  },
 ];
 
 const bibliography: AlcoholClearanceLocaleContent['bibliography'] = [
   {
-    name: "Widmark's Formula for BAC Calculation - Forensic Science Lab",
-    url: "https://www.forensic-science.com/widmark-formula",
+    name: "Alcohol calculations and their uncertainty - PMC",
+    url: "https://pmc.ncbi.nlm.nih.gov/articles/PMC4361698/",
   },
   {
     name: "Alcohol Metabolism: How the body processes alcohol - NIH",

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

@@ -72,12 +72,12 @@ const howTo: BeerCoolerLocaleContent['howTo'] = [
 
 const bibliography: BeerCoolerLocaleContent['bibliography'] = [
   {
-    name: "Newton's Law of Cooling - Physics Hypertextbook",
-    url: "https://physics.info/newton-cooling/",
+    name: "Newton's Law of Cooling - Wikipedia",
+    url: "https://en.wikipedia.org/wiki/Newton%27s_law_of_cooling",
   },
   {
-    name: "The Science of Better Beer - American Chemical Society",
-    url: "https://www.acs.org/content/acs/en/pressroom/reactions/videos/2016/the-science-of-better-beer.html",
+    name: "Advanced Chemistry of Beer and Brewing - American Chemical Society",
+    url: "https://www.acs.org/acs-webinars/library/advanced-chemistry-of-beer-and-brewing.html",
   },
 ];
 

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

@@ -72,12 +72,12 @@ const howTo: BeerCoolerLocaleContent['howTo'] = [
 
 const bibliography: BeerCoolerLocaleContent['bibliography'] = [
   {
-    name: "Newton's Law of Cooling - Physics Hypertextbook",
-    url: "https://physics.info/newton-cooling/",
+    name: "Ley del enfriamiento de Newton - Wikipedia",
+    url: "https://en.wikipedia.org/wiki/Newton%27s_law_of_cooling",
   },
   {
-    name: "The Science of Better Beer - American Chemical Society",
-    url: "https://www.acs.org/content/acs/en/pressroom/reactions/videos/2016/the-science-of-better-beer.html",
+    name: "Advanced Chemistry of Beer and Brewing - American Chemical Society",
+    url: "https://www.acs.org/acs-webinars/library/advanced-chemistry-of-beer-and-brewing.html",
   },
 ];
 

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

@@ -72,12 +72,12 @@ const howTo: BeerCoolerLocaleContent['howTo'] = [
 
 const bibliography: BeerCoolerLocaleContent['bibliography'] = [
   {
-    name: "Newton's Law of Cooling - Physics Hypertextbook",
-    url: "https://physics.info/newton-cooling/",
+    name: "Loi du refroidissement de Newton - Wikipedia",
+    url: "https://en.wikipedia.org/wiki/Newton%27s_law_of_cooling",
   },
   {
-    name: "The Science of Better Beer - American Chemical Society",
-    url: "https://www.acs.org/content/acs/en/pressroom/reactions/videos/2016/the-science-of-better-beer.html",
+    name: "Advanced Chemistry of Beer and Brewing - American Chemical Society",
+    url: "https://www.acs.org/acs-webinars/library/advanced-chemistry-of-beer-and-brewing.html",
   },
 ];
 

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

@@ -3,7 +3,7 @@ import type { CarbonationUI, CarbonationLocaleContent } from '../index';
 
 const slug = 'beer-carbonation-calculator';
 const title = 'Beer Carbonation & Priming Calculator';
-const description = 'Calculate the exact amount of sugar for bottling your homebrew beer based on volume, temperature and style.';
+const description = 'Calculate the exact grams of Dextrose, Table Sugar or DME (Dry Malt Extract) for bottling your homebrew. Enter your volume, fermentation temperature and style for a perfect priming.';
 
 const ui: CarbonationUI = {
   parametersTitle: 'Parameters',
@@ -34,7 +34,7 @@ const bibliographyTitle = 'Bibliography & Sources';
 const faq: CarbonationLocaleContent['faq'] = [
   {
     question: "Why does temperature matter for carbonation?",
-    answer: "The residual CO2 in your beer depends on the highest temperature reached after fermentation. Cold liquid holds more dissolved gas than warm liquid.",
+    answer: "The residual CO2 in your beer depends on the highest temperature reached after fermentation: cold liquid holds more dissolved gas than warm liquid. If you enter a temperature lower than the actual one, the calculator assumes more residual CO2 than is really there and gives you less sugar than needed. Enter it too high and the opposite happens — you add more sugar than necessary and push your batch into bottle bomb territory, where excess pressure causes bottles to rupture or caps to blow off violently.",
   },
   {
     question: "What sugar is best for priming?",
@@ -44,6 +44,10 @@ const faq: CarbonationLocaleContent['faq'] = [
     question: "What happens if I add too much priming sugar?",
     answer: "Over-priming generates excess CO2 pressure inside the bottle. Standard glass bottles fail at approximately 3.5-4.0 volumes of CO2. Beyond this point, the bottle can rupture or the cap can blow off violently. This is why precision matters — even 5 extra grams per liter can push a batch into the danger zone.",
   },
+  {
+    question: "How long does beer take to carbonate after bottling?",
+    answer: "Between 2 and 3 weeks at room temperature (18-22°C) is the typical range for yeast to fully ferment the added sugar and for CO2 to integrate into the liquid. Opening a bottle before the process is complete always gives a misleading result: the beer will seem under-carbonated even though carbonation is still developing. With DME the process can be slightly slower due to the complexity of its fermentable sugars.",
+  },
 ];
 
 const howTo: CarbonationLocaleContent['howTo'] = [
@@ -64,11 +68,11 @@ const howTo: CarbonationLocaleContent['howTo'] = [
 const bibliography: CarbonationLocaleContent['bibliography'] = [
   {
     name: "How to Brew: Carbonation Tables - John Palmer",
-    url: "http://howtobrew.com/book/section-1/priming-and-bottling/priming-solutions",
+    url: "https://howtobrew.com/section-1/chapter-11/",
   },
   {
     name: "BJCP Style Guidelines: Carbonation Levels",
-    url: "https://www.bjcp.org/stylecenter.php",
+    url: "https://www.bjcp.org/style/2021/beer/",
   },
 ];
 

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

@@ -3,7 +3,7 @@ import type { CarbonationUI, CarbonationLocaleContent } from '../index';
 
 const slug = 'calculadora-carbonatacion';
 const title = 'Calculadora de Carbonatación y Priming';
-const description = 'Calcula la cantidad exacta de azúcar para embotellar tu cerveza casera según el volumen, la temperatura y el estilo.';
+const description = 'Calcula los gramos exactos de Dextrosa, Azúcar de Mesa o DME (Extracto de Malta Seco) para embotellar tu cerveza casera. Introduce el volumen, la temperatura de fermentación y el estilo para un priming perfecto.';
 
 const ui: CarbonationUI = {
   parametersTitle: 'Parámetros',
@@ -34,7 +34,7 @@ const bibliographyTitle = 'Bibliografía y Fuentes';
 const faq: CarbonationLocaleContent['faq'] = [
   {
     question: "¿Por qué influye la temperatura en el cálculo?",
-    answer: "El CO2 residual que ya tiene tu cerveza depende de la temperatura máxima alcanzada tras la fermentación. El líquido frío retiene más gas disuelto que el caliente.",
+    answer: "El CO2 residual que ya tiene tu cerveza depende de la temperatura máxima alcanzada tras la fermentación: el líquido frío retiene más gas disuelto que el caliente. Si introduces una temperatura más baja de la real, la calculadora asumirá más residual del que hay y te dará menos azúcar del necesario. Si la introduces más alta, ocurre lo contrario: añadirás más azúcar de la cuenta y entrarás en la zona de peligro de las bombas de botella — botellas que explotan por exceso de presión.",
   },
   {
     question: "¿Qué azúcar es mejor para el priming?",
@@ -44,6 +44,10 @@ const faq: CarbonationLocaleContent['faq'] = [
     question: "¿Qué pasa si añado demasiado azúcar de priming?",
     answer: "Un exceso de azúcar genera una presión de CO2 excesiva dentro de la botella. Las botellas de vidrio estándar fallan a partir de 3.5-4.0 volúmenes de CO2. Por encima de este punto, la botella puede romperse violentamente o el tapón puede saltar disparado. Por eso la precisión es crítica — incluso 5 gramos extra por litro pueden llevar un lote a la zona de peligro.",
   },
+  {
+    question: "¿Cuánto tiempo tarda la cerveza en carbonatarse tras el embotellado?",
+    answer: "Entre 2 y 3 semanas a temperatura ambiente (18-22°C) es el rango habitual para que la levadura fermente completamente el azúcar añadido y el CO2 se integre en el líquido. Abrir una botella antes de que el proceso termine da siempre una lectura engañosa: la cerveza parecerá poco carbonatada aunque el proceso siga en marcha. Con el DME el proceso puede ser ligeramente más lento por la complejidad de sus azúcares fermentables.",
+  },
 ];
 
 const howTo: CarbonationLocaleContent['howTo'] = [
@@ -64,11 +68,11 @@ const howTo: CarbonationLocaleContent['howTo'] = [
 const bibliography: CarbonationLocaleContent['bibliography'] = [
   {
     name: "How to Brew: Carbonation Tables - John Palmer",
-    url: "http://howtobrew.com/book/section-1/priming-and-bottling/priming-solutions",
+    url: "https://howtobrew.com/section-1/chapter-11/",
   },
   {
     name: "BJCP Style Guidelines: Carbonation Levels",
-    url: "https://www.bjcp.org/stylecenter.php",
+    url: "https://www.bjcp.org/style/2021/beer/",
   },
 ];
 

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

@@ -3,7 +3,7 @@ import type { CarbonationUI, CarbonationLocaleContent } from '../index';
 
 const slug = 'calculateur-carbonatation-biere';
 const title = 'Calculateur de Carbonatation et Priming';
-const description = 'Calculez la quantité exacte de sucre pour embouteiller votre bière artisanale selon le volume, la température et le style.';
+const description = 'Calculez les grammes exacts de Dextrose, Sucre de Table ou DME (Extrait de Malt Sec) pour embouteiller votre bière artisanale. Entrez le volume, la température de fermentation et le style pour un priming parfait.';
 
 const ui: CarbonationUI = {
   parametersTitle: 'Paramètres',
@@ -34,7 +34,7 @@ const bibliographyTitle = 'Bibliographie & Sources';
 const faq: CarbonationLocaleContent['faq'] = [
   {
     question: "Pourquoi la température influence-t-elle le calcul ?",
-    answer: "Le CO2 résiduel déjà présent dans votre bière dépend de la température maximale atteinte après la fermentation. Un liquide froid retient plus de gaz dissous qu'un liquide chaud.",
+    answer: "Le CO2 résiduel dans votre bière dépend de la température maximale atteinte après la fermentation : un liquide froid retient plus de gaz dissous qu'un liquide chaud. Si vous entrez une température inférieure à la réalité, le calculateur suppose plus de CO2 résiduel qu'il n'en existe et vous donne moins de sucre que nécessaire. À l'inverse, une température trop haute vous pousse à ajouter trop de sucre et fait basculer votre lot dans la zone de danger des bombes de bouteilles — des bouteilles qui explosent sous l'excès de pression.",
   },
   {
     question: "Quel sucre est le meilleur pour le priming ?",
@@ -44,6 +44,10 @@ const faq: CarbonationLocaleContent['faq'] = [
     question: "Que se passe-t-il si j'ajoute trop de sucre de priming ?",
     answer: "Un excès de sucre génère une pression de CO2 excessive à l'intérieur de la bouteille. Les bouteilles en verre standard cèdent à environ 3,5-4,0 volumes de CO2. Au-delà, la bouteille peut se rompre violemment ou le bouchon peut sauter. C'est pourquoi la précision est essentielle — même 5 grammes de plus par litre peuvent faire basculer un lot dans la zone de danger.",
   },
+  {
+    question: "Combien de temps faut-il pour que la bière se carbonate après la mise en bouteille ?",
+    answer: "Entre 2 et 3 semaines à température ambiante (18-22°C) est la plage habituelle pour que la levure fermente complètement le sucre ajouté et que le CO2 s'intègre au liquide. Ouvrir une bouteille avant la fin du processus donne toujours un résultat trompeur : la bière semblera peu carbonatée alors que la carbonatation est toujours en cours. Avec le DME, le processus peut être légèrement plus lent en raison de la complexité de ses sucres fermentescibles.",
+  },
 ];
 
 const howTo: CarbonationLocaleContent['howTo'] = [
@@ -64,11 +68,11 @@ const howTo: CarbonationLocaleContent['howTo'] = [
 const bibliography: CarbonationLocaleContent['bibliography'] = [
   {
     name: "How to Brew: Carbonation Tables - John Palmer",
-    url: "http://howtobrew.com/book/section-1/priming-and-bottling/priming-solutions",
+    url: "https://howtobrew.com/section-1/chapter-11/",
   },
   {
     name: "BJCP Style Guidelines: Carbonation Levels",
-    url: "https://www.bjcp.org/stylecenter.php",
+    url: "https://www.bjcp.org/style/2021/beer/",
   },
 ];
 

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

@@ -88,11 +88,11 @@ const howTo: CocktailBalancerLocaleContent['howTo'] = [
 const bibliography: CocktailBalancerLocaleContent['bibliography'] = [
   {
     name: "Liquid Intelligence: The Art and Science of the Perfect Cocktail",
-    url: "http://www.cookingissues.com/index.html%3Fp=4587.html",
+    url: "https://www.indigo.ca/en-ca/liquid-intelligence-the-art-and-science-of-the-perfect-cocktail/9780393089035.html",
   },
   {
-    name: "The Bar Book: Elements of Cocktail Technique - Jeffrey Morgenthaler",
-    url: "https://jeffreymorgenthaler.com/the-bar-book/",
+    name: "Cocktails: The Science of Shaking",
+    url: "https://cookingissues.com/2009/07/22/cocktails-the-science-of-shaking/",
   },
   {
     name: "Cocktail Balance - Difford's Guide",

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

@@ -88,11 +88,11 @@ const howTo: CocktailBalancerLocaleContent['howTo'] = [
 const bibliography: CocktailBalancerLocaleContent['bibliography'] = [
   {
     name: "Liquid Intelligence: The Art and Science of the Perfect Cocktail",
-    url: "http://www.cookingissues.com/index.html%3Fp=4587.html",
+    url: "https://www.indigo.ca/en-ca/liquid-intelligence-the-art-and-science-of-the-perfect-cocktail/9780393089035.html",
   },
   {
-    name: "The Bar Book: Elements of Cocktail Technique - Jeffrey Morgenthaler",
-    url: "https://jeffreymorgenthaler.com/the-bar-book/",
+    name: "Cocktails: The Science of Shaking",
+    url: "https://cookingissues.com/2009/07/22/cocktails-the-science-of-shaking/",
   },
   {
     name: "Cocktail Balance - Difford's Guide",

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

@@ -88,11 +88,11 @@ const howTo: CocktailBalancerLocaleContent['howTo'] = [
 const bibliography: CocktailBalancerLocaleContent['bibliography'] = [
   {
     name: "Liquid Intelligence: The Art and Science of the Perfect Cocktail",
-    url: "http://www.cookingissues.com/index.html%3Fp=4587.html",
+    url: "https://www.indigo.ca/en-ca/liquid-intelligence-the-art-and-science-of-the-perfect-cocktail/9780393089035.html",
   },
   {
-    name: "The Bar Book: Elements of Cocktail Technique - Jeffrey Morgenthaler",
-    url: "https://jeffreymorgenthaler.com/the-bar-book/",
+    name: "Cocktails: The Science of Shaking",
+    url: "https://cookingissues.com/2009/07/22/cocktails-the-science-of-shaking/",
   },
   {
     name: "Cocktail Balance - Difford's Guide",

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

@@ -2,8 +2,8 @@ import type { WithContext, SoftwareApplication } from 'schema-dts';
 import type { PartyKegUI, PartyKegLocaleContent } from '../index';
 
 const slug = 'party-stock-calculator';
-const title = 'Party Beer & Ice Calculator';
-const description = 'Calculate how much alcohol and how many bags of ice you need for your party based on guests, duration and temperature.';
+const title = 'Party Beer Calculator: Amount Per Person for Weddings & Birthdays';
+const description = 'Free tool to calculate how much beer and ice you need based on guests, duration and temperature. Perfect for weddings, birthdays and outdoor events.';
 
 const ui: PartyKegUI = {
   calcStockTitle: 'Stock Calculator',
@@ -36,12 +36,16 @@ const faq: PartyKegLocaleContent['faq'] = [
   },
   {
     question: "How much ice do I need for 100 beers?",
-    answer: "You will need approximately 15-20 kilos of ice (7-10 bags). The general rule is 1kg of ice for every liter of drink if it's hot (>25°C).",
+    answer: "You will need approximately 15-20 kilos of ice (7-10 bags). The practical rule is 0.75kg of ice per liter of drink under normal conditions. In summer or outdoors above 25°C, raise that to 1kg per liter: ambient heat accelerates melting and you will run out much sooner than expected.",
   },
   {
     question: "What is the difference between a standard keg and a party keg?",
     answer: "A standard commercial keg holds 50 liters, which yields approximately 200 servings (250ml each). A party keg (mini-keg) typically holds 5 liters — about 20 servings. Knowing these sizes helps you translate the calculator's liter output into the number of containers to purchase.",
   },
+  {
+    question: "Why do I need so much ice if the beers are already cold?",
+    answer: "Because cooling and maintaining are two separate processes. Bringing a can from 25°C to 4°C consumes the latent heat of fusion of the ice: around 334 kJ/kg. Once cold, ice keeps working to offset ambient heat. On a summer day at 35°C, heat transfer into the cooler can melt 1kg of ice per liter of drink every 2-3 hours. That is why pre-chilling your drinks before the party cuts your total ice consumption in half.",
+  },
 ];
 
 const howTo: PartyKegLocaleContent['howTo'] = [
@@ -62,11 +66,11 @@ const howTo: PartyKegLocaleContent['howTo'] = [
 const bibliography: PartyKegLocaleContent['bibliography'] = [
   {
     name: "Event Planning: Alcohol & Bar Calculations - Spruce Eats",
-    url: "https://www.thespruceeats.com/how-much-alcohol-for-a-party-1191060",
+    url: "https://www.thespruceeats.com/stock-your-bar-for-a-party-760394",
   },
   {
     name: "Thermodynamics of Ice Melting - Engineering Toolbox",
-    url: "https://www.engineeringtoolbox.com/ice-thermal-properties-d_156.html",
+    url: "https://www.engineeringtoolbox.com/saturated-ice-steam-d_970.html",
   },
 ];
 

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

@@ -2,8 +2,8 @@ import type { WithContext, SoftwareApplication } from 'schema-dts';
 import type { PartyKegUI, PartyKegLocaleContent } from '../index';
 
 const slug = 'calculadora-barriles-fiesta';
-const title = 'Calculadora de Cerveza y Hielo para Eventos';
-const description = 'Calcula cuánto alcohol y cuántas bolsas de hielo necesitas para tu fiesta según los invitados, la duración y la temperatura.';
+const title = 'Calculadora de Cerveza para Fiestas: Cantidad por Persona, Boda o Cumpleaños';
+const description = 'Herramienta gratuita para calcular cuánta cerveza y hielo necesitas según los invitados, la duración y la temperatura. Perfecta para bodas, cumpleaños y eventos al aire libre.';
 
 const ui: PartyKegUI = {
   calcStockTitle: 'Calculadora de Stock',
@@ -36,12 +36,16 @@ const faq: PartyKegLocaleContent['faq'] = [
   },
   {
     question: "¿Cuánto hielo necesito para 100 cervezas?",
-    answer: "Necesitarás aproximadamente 15-20 kilos de hielo (7-10 bolsas). La regla general es 1kg de hielo por cada litro de bebida si hace calor (>25°C).",
+    answer: "Necesitarás aproximadamente 15-20 kilos de hielo (7-10 bolsas). La regla práctica es 0.75kg de hielo por cada litro de bebida en condiciones normales. En verano o en exteriores con más de 25°C, sube a 1kg por litro: el calor ambiental acelera la fusión y te quedas sin hielo mucho antes de lo esperado.",
   },
   {
     question: "¿Cuál es la diferencia entre un barril estándar y un barril de fiesta?",
     answer: "Un barril comercial estándar contiene 50 litros, lo que equivale a unas 200 raciones de 250ml. Un barril de fiesta (mini-barril) suele contener 5 litros — unas 20 raciones. Conocer estos volúmenes te ayuda a convertir la salida en litros de la calculadora al número de envases que debes comprar.",
   },
+  {
+    question: "¿Por qué necesito tanto hielo si las cervezas ya están frías?",
+    answer: "Porque enfriar y mantener son dos procesos distintos. Llevar una lata de 25°C a 4°C consume el calor latente de fusión del hielo: unos 334 kJ/kg. Una vez fría, el hielo sigue trabajando para compensar el calor del ambiente. En un día de verano a 35°C, la transferencia de calor al recipiente puede fundir 1kg de hielo por litro de bebida cada 2-3 horas. Por eso pre-enfriar las bebidas antes de la fiesta reduce el consumo de hielo a la mitad.",
+  },
 ];
 
 const howTo: PartyKegLocaleContent['howTo'] = [
@@ -62,11 +66,11 @@ const howTo: PartyKegLocaleContent['howTo'] = [
 const bibliography: PartyKegLocaleContent['bibliography'] = [
   {
     name: "Event Planning: Alcohol & Bar Calculations - Spruce Eats",
-    url: "https://www.thespruceeats.com/how-much-alcohol-for-a-party-1191060",
+    url: "https://www.thespruceeats.com/stock-your-bar-for-a-party-760394",
   },
   {
     name: "Thermodynamics of Ice Melting - Engineering Toolbox",
-    url: "https://www.engineeringtoolbox.com/ice-thermal-properties-d_156.html",
+    url: "https://www.engineeringtoolbox.com/saturated-ice-steam-d_970.html",
   },
 ];
 

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

@@ -2,8 +2,8 @@ import type { WithContext, SoftwareApplication } from 'schema-dts';
 import type { PartyKegUI, PartyKegLocaleContent } from '../index';
 
 const slug = 'calculateur-fete-fût';
-const title = 'Calculateur de Bière et Glace pour Événements';
-const description = 'Calculez la quantité d\'alcool et de sacs de glace dont vous avez besoin pour votre fête selon les invités, la durée et la température.';
+const title = 'Calculateur de Bière pour Fêtes : Quantité par Personne, Mariage ou Anniversaire';
+const description = 'Outil gratuit pour calculer la quantité de bière et de glace selon les invités, la durée et la température. Idéal pour les mariages, anniversaires et événements en plein air.';
 
 const ui: PartyKegUI = {
   calcStockTitle: 'Calculateur de Stock',
@@ -35,13 +35,17 @@ const faq: PartyKegLocaleContent['faq'] = [
     answer: "En moyenne, on compte 1 à 1,5 bière par heure par personne pour une fête standard. Pour un événement plus intense comme un Beer Pong, cela peut monter à 2 ou plus.",
   },
   {
-    question: "Pourquoi ai-je besoin de tant de glace ?",
-    answer: "La glace ne sert pas seulement à refroidir, mais à compenser la perte thermique. Dans un environnement chaud, jusqu'à 30% de la glace peut fondre avant même le début de l'événement.",
+    question: "Combien de glace faut-il pour 100 bières ?",
+    answer: "Il vous faudra environ 15 à 20 kilos de glace (7 à 10 sacs). La règle pratique est de 0,75 kg de glace par litre de boisson dans des conditions normales. En été ou en extérieur à plus de 25°C, montez à 1 kg par litre : la chaleur ambiante accélère la fonte et vous manquerez de glace bien plus tôt que prévu.",
   },
   {
     question: "Quelle est la différence entre un fût standard et un mini-fût ?",
     answer: "Un fût commercial standard contient 50 litres, soit environ 200 portions de 250ml. Un mini-fût de fête contient généralement 5 litres — environ 20 portions. Connaître ces volumes vous aide à convertir la sortie en litres du calculateur en nombre de contenants à acheter.",
   },
+  {
+    question: "Pourquoi ai-je besoin d'autant de glace si les bières sont déjà froides ?",
+    answer: "Parce que refroidir et maintenir sont deux processus distincts. Amener une canette de 25°C à 4°C consomme la chaleur latente de fusion de la glace : environ 334 kJ/kg. Une fois froide, la glace continue de travailler pour compenser la chaleur ambiante. Par une journée d'été à 35°C, les transferts thermiques peuvent faire fondre 1 kg de glace par litre de boisson toutes les 2 à 3 heures. C'est pourquoi pré-refroidir les boissons avant la fête réduit la consommation de glace de moitié.",
+  },
 ];
 
 const howTo: PartyKegLocaleContent['howTo'] = [
@@ -61,12 +65,12 @@ const howTo: PartyKegLocaleContent['howTo'] = [
 
 const bibliography: PartyKegLocaleContent['bibliography'] = [
   {
-    name: "Event Planning: Beverage Calculation Guide",
-    url: "https://www.thespruceeats.com/how-much-alcohol-for-a-party-4158434",
+    name: "Event Planning: Alcohol & Bar Calculations - Spruce Eats",
+    url: "https://www.thespruceeats.com/stock-your-bar-for-a-party-760394",
   },
   {
-    name: "Ice Melt Rates and Cooling Efficiency",
-    url: "https://www.engineeringtoolbox.com/ice-melting-water-d_1594.html",
+    name: "Thermodynamics of Ice Melting - Engineering Toolbox",
+    url: "https://www.engineeringtoolbox.com/saturated-ice-steam-d_970.html",
   },
 ];
 

package/src/types.ts

@@ -66,7 +66,7 @@ export interface AlcoholCategoryEntry {
 export interface ToolDefinition {
   entry: AlcoholToolEntry<Record<string, string>>;
   Component: unknown;
-  SEOComponent?: unknown;
-  BibliographyComponent?: unknown;
+  SEOComponent: unknown;
+  BibliographyComponent: unknown;
 }