@jjlmoya/utils-alcohol 1.7.0 → 1.8.0

package/package.json

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

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

@@ -1,7 +1,7 @@
 import type { WithContext, SoftwareApplication } from 'schema-dts';
 import type { AlcoholClearanceUI, AlcoholClearanceLocaleContent } from '../index';
 
-const slug = 'calculadora-eliminacion-alcohol';
+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.';
 

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

@@ -2,8 +2,8 @@ import type { WithContext, SoftwareApplication } from 'schema-dts';
 import type { BeerCoolerUI, BeerCoolerLocaleContent } from '../index';
 
 const slug = 'beer-cooler';
-const title = 'Beer Cooling Calculator';
-const description = 'Calculate how long it takes for your beer to cool down in the fridge or freezer based on its container.';
+const title = "Beer Cooling Calculator with Newton's Law";
+const description = "Calculate with real thermodynamics — Newton's Law of Cooling — exactly how long your beer needs to reach the perfect serving temperature in the fridge or freezer.";
 
 const ui: BeerCoolerUI = {
   step1Title: 'What are you cooling?',
@@ -34,16 +34,24 @@ const bibliographyTitle = 'Bibliography & Sources';
 
 const faq: BeerCoolerLocaleContent['faq'] = [
   {
-    question: "Does beer 'burn' if cooled too fast?",
-    answer: "No. The myth of beer 'burning' from heat shock is false. What can affect it is repeated freezing and thawing, which breaks proteins and clouds the liquid, or leaving it in the sun (UV rays).",
+    question: "How does this tool calculate cooling time?",
+    answer: "It applies Newton's Law of Cooling: T(t) = T_env + (T₀ - T_env) × e^(-kt). The constant k varies by container material and cooling medium. An aluminum can in a fridge has a very different k than a glass bottle in a freezer. The values used here are calibrated against real-world experiments for each combination.",
   },
   {
-    question: "Why does foam spray out if the beer is warm?",
-    answer: "Henry's Law. The solubility of CO2 decreases as temperature increases. In a warm beer, the gas is 'desperate' to escape. When opened, the pressure drops and the gas expands violently.",
+    question: "Does the wet paper towel trick with salt actually work?",
+    answer: "Yes, and quite noticeably. Wrapping the container in a damp paper towel with salt speeds cooling for two reasons: water evaporation draws out additional heat (evaporative cooling), and salt lowers the water's freezing point, keeping the moist contact active longer. You can gain an extra 2–4°C drop in the first few minutes compared to placing a dry can in the freezer.",
   },
   {
     question: "What is the ideal serving temperature for different beer styles?",
-    answer: "It depends on the style. Lagers and Pilsners are best served between 3°C and 7°C. IPAs and Pale Ales shine at 7°C to 10°C. Stouts, Porters and complex ales should be served warmer, around 10°C to 13°C, so their aromatic compounds can fully open up.",
+    answer: "It depends on the style. Lagers and Pilsners are best served between 3°C and 7°C. IPAs and Pale Ales shine at 7°C to 10°C. Stouts, Porters and complex ales should be served warmer, between 12°C and 14°C, so their aromatic compounds — coffee, chocolate, nuts — can express themselves fully.",
+  },
+  {
+    question: "Can my beer explode if I leave it in the freezer?",
+    answer: "Yes. Alcohol and dissolved sugars lower beer's freezing point below that of pure water: a standard 5% lager freezes around -3°C. As the water crystallizes, the volume increases and dissolved CO2 raises internal pressure until the container gives way. More than 60 minutes in the freezer — especially glass bottles — is a real danger zone. Use this calculator to avoid it.",
+  },
+  {
+    question: "Does beer 'burn' if cooled too quickly?",
+    answer: "No. The 'heat shock' myth that ruins beer is false. What can genuinely affect it is repeated freezing and thawing — which breaks proteins and clouds the liquid — or direct UV light exposure. A quick chill in the freezer or ice water does not harm the flavour.",
   },
 ];
 
@@ -105,7 +113,7 @@ const seo: BeerCoolerLocaleContent['seo'] = [
     items: [
       { label: 'Pilsner & Lager', value: '3°C - 7°C', icon: 'mdi:snowflake' },
       { label: 'IPA & Pale Ale', value: '7°C - 10°C', icon: 'mdi:hops' },
-      { label: 'Stout & Porter', value: '10°C - 13°C', icon: 'mdi:beer' }
+      { label: 'Stout & Porter', value: '12°C - 14°C', icon: 'mdi:beer' }
     ],
     columns: 3
   },
@@ -145,8 +153,8 @@ const schemas: BeerCoolerLocaleContent['schemas'] = [
   {
     '@context': 'https://schema.org',
     '@type': 'SoftwareApplication',
-    name: title,
-    description: description,
+    name: "Beer Cooling Calculator – Newton's Law of Cooling",
+    description: 'Applied thermodynamics tool that uses Newton\'s Law of Cooling to calculate the exact time for your beer to reach the ideal serving temperature in a fridge or freezer.',
     applicationCategory: 'UtilityApplication',
     operatingSystem: 'Web',
     offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },

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

@@ -1,9 +1,9 @@
 import type { WithContext, SoftwareApplication } from 'schema-dts';
 import type { BeerCoolerUI, BeerCoolerLocaleContent } from '../index';
 
-const slug = 'enfriador-cerveza';
-const title = 'Calculadora de Enfriamiento de Cerveza';
-const description = 'Calcula cuánto tiempo tarda tu cerveza en enfriarse en la nevera o el congelador según el envase.';
+const slug = 'calculadora-enfriamiento-cerveza';
+const title = 'Calculadora de Enfriamiento de Cerveza con la Ley de Newton';
+const description = 'Calcula con termodinámica real —la Ley de Enfriamiento de Newton— cuánto tarda tu cerveza en alcanzar la temperatura perfecta en nevera o congelador.';
 
 const ui: BeerCoolerUI = {
   step1Title: '¿Qué vas a enfriar?',
@@ -34,16 +34,24 @@ const bibliographyTitle = 'Bibliografía y Fuentes';
 
 const faq: BeerCoolerLocaleContent['faq'] = [
   {
-    question: "¿La cerveza se 'quema' si se enfría muy rápido?",
-    answer: "No. El mito de 'quemar' la cerveza por choque térmico es falso. Lo que sí puede afectarla es congelarla y descongelarla repetidamente, lo que rompe las proteínas y enturbia el líquido, o dejarla al sol (UV).",
+    question: "¿Cómo calcula esta herramienta el tiempo de enfriamiento?",
+    answer: "Aplica la Ley de Enfriamiento de Newton: T(t) = T_env + (T₀ - T_env) × e^(-kt). La constante k varía según el material del envase y el medio de enfriado. Una lata de aluminio en nevera tiene un k muy diferente al de una botella de vidrio en congelador. Los valores que usamos están calibrados con experimentos reales para cada combinación.",
   },
   {
-    question: "¿Por qué la espuma sale disparada si está caliente?",
-    answer: "Ley de Henry. La solubilidad del CO2 disminuye al aumentar la temperatura. En una cerveza caliente, el gas está 'desesperado' por escapar. Al abrirla, la presión baja y el gas se expande violentamente.",
+    question: "¿Funciona el truco del papel húmedo con sal en el congelador?",
+    answer: "Sí, y de forma notable. Envolver el envase en papel mojado con sal acelera el enfriamiento por dos razones: la evaporación del agua extrae calor adicional (enfriamiento evaporativo) y la sal baja el punto de congelación del agua, manteniendo el contacto húmedo más tiempo. Puedes bajar entre 2°C y 4°C extra en los primeros minutos respecto a meter la lata seca.",
   },
   {
     question: "¿Cuál es la temperatura de servicio ideal según el estilo de cerveza?",
-    answer: "Depende del estilo. Las Lagers y Pilsners están mejor entre 3°C y 7°C. Las IPAs y Pale Ales brillan entre 7°C y 10°C. Las Stouts, Porters y ales complejas deben servirse más cálidas, entre 10°C y 13°C, para que sus compuestos aromáticos se abran completamente.",
+    answer: "Depende del estilo. Las Lagers y Pilsners están mejor entre 3°C y 7°C. Las IPAs y Pale Ales brillan entre 7°C y 10°C. Las Stouts, Porters y ales complejas deben servirse más cálidas, entre 12°C y 14°C, para que sus compuestos aromáticos —café, chocolate, frutos secos— se expresen con plenitud.",
+  },
+  {
+    question: "¿Puede explotar mi cerveza si la dejo en el congelador?",
+    answer: "Sí. El alcohol y los azúcares bajan el punto de congelación de la cerveza respecto al agua pura: una Lager al 5% se congela en torno a los -3°C. Al cristalizarse el agua, el volumen aumenta y el CO2 disuelto eleva la presión interna hasta que el envase cede. Más de 60 minutos en el congelador con envases de vidrio es zona de riesgo real. Usa esta calculadora para no pasarte.",
+  },
+  {
+    question: "¿La cerveza se 'quema' si se enfría muy rápido?",
+    answer: "No. El mito del 'choque térmico' que arruina la cerveza es falso. Lo que sí puede afectarla negativamente es congelarla y descongelarla repetidamente —rompe proteínas y enturbia el líquido— o exponerla a luz UV directa. Un enfriamiento rápido en congelador o agua con hielo no daña el sabor.",
   },
 ];
 
@@ -158,8 +166,8 @@ const schemas: BeerCoolerLocaleContent['schemas'] = [
   {
     '@context': 'https://schema.org',
     '@type': 'SoftwareApplication',
-    name: title,
-    description: description,
+    name: 'Calculadora de Enfriamiento de Cerveza – Ley de Newton',
+    description: 'Herramienta de termodinámica aplicada que calcula con la Ley de Enfriamiento de Newton el tiempo exacto para que tu cerveza alcance la temperatura de servicio ideal en nevera o congelador.',
     applicationCategory: 'UtilityApplication',
     operatingSystem: 'Web',
     offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },

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

@@ -2,8 +2,8 @@ import type { WithContext, SoftwareApplication } from 'schema-dts';
 import type { BeerCoolerUI, BeerCoolerLocaleContent } from '../index';
 
 const slug = 'refroidisseur-biere';
-const title = 'Calculateur de Refroidissement de Bière';
-const description = 'Calculez combien de temps il faut pour que votre bière refroidisse dans le frigo ou le congélateur selon son contenant.';
+const title = 'Calculateur de Refroidissement de Bière avec la Loi de Newton';
+const description = 'Calculez avec la thermodynamique réelle — la Loi du Refroidissement de Newton — combien de temps votre bière met à atteindre la température de service idéale au frigo ou au congélateur.';
 
 const ui: BeerCoolerUI = {
   step1Title: 'Que voulez-vous refroidir ?',
@@ -34,16 +34,24 @@ const bibliographyTitle = 'Bibliographie & Sources';
 
 const faq: BeerCoolerLocaleContent['faq'] = [
   {
-    question: "La bière 'brûle'-t-elle si elle est refroidie trop vite ?",
-    answer: "Non. Le mythe de la bière 'brûlée' par choc thermique est faux. Ce qui peut l'affecter, c'est la congélation et la décongélation répétées, ce qui brise les protéines et trouble le liquide, ou l'exposition au soleil (UV).",
+    question: "Comment cet outil calcule-t-il le temps de refroidissement ?",
+    answer: "Il applique la Loi du Refroidissement de Newton : T(t) = T_env + (T₀ - T_env) × e^(-kt). La constante k varie selon le matériau du contenant et le milieu de refroidissement. Une canette en aluminium dans un frigo a un k très différent d'une bouteille en verre dans un congélateur. Les valeurs utilisées sont calibrées sur des expériences réelles pour chaque combinaison.",
   },
   {
-    question: "Pourquoi la mousse jaillit-elle si la bière est chaude ?",
-    answer: "Loi de Henry. La solubilité du CO2 diminue à mesure que la température augmente. Dans une bière chaude, le gaz est 'désespéré' de s'échapper. À l'ouverture, la pression chute et le gaz se dilate violemment.",
+    question: "L'astuce du papier mouillé avec du sel fonctionne-t-elle vraiment ?",
+    answer: "Oui, et de façon notable. Envelopper le contenant dans du papier humide avec du sel accélère le refroidissement pour deux raisons : l'évaporation de l'eau extrait de la chaleur supplémentaire (refroidissement par évaporation) et le sel abaisse le point de congélation de l'eau, prolongeant le contact humide. Vous pouvez gagner 2 à 4°C supplémentaires dans les premières minutes par rapport à une canette sèche au congélateur.",
   },
   {
     question: "Quelle est la température de service idéale selon le style de bière ?",
-    answer: "Cela dépend du style. Les Lagers et Pilsners sont meilleures entre 3°C et 7°C. Les IPAs et Pale Ales s'épanouissent entre 7°C et 10°C. Les Stouts, Porters et ales complexes doivent être servis plus chauds, autour de 10°C à 13°C, pour que leurs composés aromatiques s'ouvrent pleinement.",
+    answer: "Cela dépend du style. Les Lagers et Pilsners sont meilleures entre 3°C et 7°C. Les IPAs et Pale Ales s'épanouissent entre 7°C et 10°C. Les Stouts, Porters et ales complexes doivent être servis plus chauds, entre 12°C et 14°C, pour que leurs composés aromatiques — café, chocolat, fruits secs — s'expriment pleinement.",
+  },
+  {
+    question: "Ma bière peut-elle exploser si je la laisse au congélateur ?",
+    answer: "Oui. L'alcool et les sucres dissous abaissent le point de congélation de la bière : une lager standard à 5% gèle vers -3°C. Lorsque l'eau se cristallise, le volume augmente et la pression interne du CO2 monte jusqu'à ce que le contenant cède. Plus de 60 minutes au congélateur — surtout en bouteille en verre — est une zone de risque réel. Utilisez ce calculateur pour l'éviter.",
+  },
+  {
+    question: "La bière 'brûle'-t-elle si elle est refroidie trop vite ?",
+    answer: "Non. Le mythe du 'choc thermique' qui abîme la bière est faux. Ce qui peut réellement l'affecter, c'est la congélation et la décongélation répétées — cela brise les protéines et trouble le liquide — ou l'exposition directe aux UV. Un refroidissement rapide au congélateur ou dans de l'eau glacée n'altère pas le goût.",
   },
 ];
 
@@ -105,7 +113,7 @@ const seo: BeerCoolerLocaleContent['seo'] = [
     items: [
       { label: 'Pilsner & Lager', value: '3°C - 7°C', icon: 'mdi:snowflake' },
       { label: 'IPA & Pale Ale', value: '7°C - 10°C', icon: 'mdi:hops' },
-      { label: 'Stout & Porter', value: '10°C - 13°C', icon: 'mdi:beer' }
+      { label: 'Stout & Porter', value: '12°C - 14°C', icon: 'mdi:beer' }
     ],
     columns: 3
   },
@@ -145,8 +153,8 @@ const schemas: BeerCoolerLocaleContent['schemas'] = [
   {
     '@context': 'https://schema.org',
     '@type': 'SoftwareApplication',
-    name: title,
-    description: description,
+    name: 'Calculateur de Refroidissement de Bière – Loi du Refroidissement de Newton',
+    description: 'Outil de thermodynamique appliquée qui utilise la Loi du Refroidissement de Newton pour calculer le temps exact nécessaire à votre bière pour atteindre la température de service idéale au frigo ou au congélateur.',
     applicationCategory: 'UtilityApplication',
     operatingSystem: 'Web',
     offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },

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

@@ -1,7 +1,7 @@
 import type { WithContext, SoftwareApplication } from 'schema-dts';
 import type { CarbonationUI, CarbonationLocaleContent } from '../index';
 
-const slug = 'calculadora-carbonatacion-cerveza';
+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.';
 

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

@@ -60,6 +60,10 @@ const faq: CocktailBalancerLocaleContent['faq'] = [
     question: "Why don't my home cocktails taste like those in a bar?",
     answer: "It's usually due to the lack of balance between sugar and the pH of the citrus. Lemons vary in acidity by season. Our calculator helps you adjust the exact amount of syrup based on the volume of juice used.",
   },
+  {
+    question: "What are Brix degrees and why do they matter in cocktails?",
+    answer: "Brix is a scale that measures the amount of dissolved sugar in a liquid. A simple syrup (1:1) sits around 50 °Brix; a Rich Syrup (2:1) exceeds 66 °Brix. The higher the Brix, the more body and sweetness it contributes per unit of volume. Knowing this lets you swap syrups in a recipe without breaking the balance.",
+  },
 ];
 
 const howTo: CocktailBalancerLocaleContent['howTo'] = [
@@ -75,6 +79,10 @@ const howTo: CocktailBalancerLocaleContent['howTo'] = [
     name: "Adjust the sweet component",
     text: "Enter the type of syrup (simple, 2:1, agave) and watch the balance indicator move in real-time.",
   },
+  {
+    name: "Perfect serving",
+    text: "Review the tool's final verdict: the Sour ratio, the estimated post-dilution ABV, and the correction suggestions. Serve with fresh ice and fine-tune the citrus or syrup to taste.",
+  },
 ];
 
 const bibliography: CocktailBalancerLocaleContent['bibliography'] = [

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

@@ -60,6 +60,10 @@ const faq: CocktailBalancerLocaleContent['faq'] = [
     question: "¿Por qué mis cócteles caseros no saben igual que los de un bar?",
     answer: "Suele ser por la falta de equilibrio entre el azúcar y el pH del cítrico. Los limones varían en acidez según la temporada. Nuestra calculadora te ayuda a ajustar la cantidad de sirope exacta según el volumen de zumo usado.",
   },
+  {
+    question: "¿Qué son los grados Brix y por qué importan en coctelería?",
+    answer: "El Brix es una escala que mide la cantidad de azúcar disuelta en un líquido. Un sirope simple (1:1) ronda los 50 °Brix; un Rich Syrup (2:1) supera los 66 °Brix. Cuanto mayor el Brix, más cuerpo y dulzor aportará al cóctel con menos volumen. Conocerlo te permite sustituir siropes entre sí sin romper el equilibrio de la receta.",
+  },
 ];
 
 const howTo: CocktailBalancerLocaleContent['howTo'] = [
@@ -75,6 +79,10 @@ const howTo: CocktailBalancerLocaleContent['howTo'] = [
     name: "Ajustar el componente dulce",
     text: "Introduce el tipo de sirope (simple, 2:1, agave) y observa cómo se desplaza el indicador de equilibrio en tiempo real.",
   },
+  {
+    name: "Perfecto servicio",
+    text: "Revisa el veredicto final de la herramienta: el ratio Sour, el ABV estimado tras la dilución y las sugerencias de corrección. Sirve con hielo fresco y ajusta el cítrico o el sirope al gusto.",
+  },
 ];
 
 const bibliography: CocktailBalancerLocaleContent['bibliography'] = [

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

@@ -60,6 +60,10 @@ const faq: CocktailBalancerLocaleContent['faq'] = [
     question: "Pourquoi mes cocktails maison n'ont-ils pas le même goût qu'au bar ?",
     answer: "C'est généralement dû au manque d'équilibre entre le sucre et le pH de l'agrume. Les citrons varient en acidité selon la saison. Notre calculateur vous aide à ajuster la quantité exacte de sirop en fonction du volume de jus utilisé.",
   },
+  {
+    question: "Qu'est-ce que les degrés Brix et pourquoi sont-ils importants en cocktail ?",
+    answer: "Le Brix est une échelle qui mesure la quantité de sucre dissous dans un liquide. Un sirop simple (1:1) tourne autour de 50 °Brix ; un Rich Syrup (2:1) dépasse les 66 °Brix. Plus le Brix est élevé, plus il apporte de corps et de douceur par unité de volume. Le connaître permet de substituer des sirops dans une recette sans rompre l'équilibre.",
+  },
 ];
 
 const howTo: CocktailBalancerLocaleContent['howTo'] = [
@@ -75,6 +79,10 @@ const howTo: CocktailBalancerLocaleContent['howTo'] = [
     name: "Ajuster le composant sucré",
     text: "Entrez le type de sirop (simple, 2:1, agave) et observez l'indicateur d'équilibre bouger en temps réel.",
   },
+  {
+    name: "Service parfait",
+    text: "Consultez le verdict final de l'outil : le ratio Sour, l'ABV estimé après dilution et les suggestions de correction. Servez avec de la glace fraîche et ajustez l'agrume ou le sirop selon votre goût.",
+  },
 ];
 
 const bibliography: CocktailBalancerLocaleContent['bibliography'] = [

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

@@ -1,7 +1,7 @@
 import type { WithContext, SoftwareApplication } from 'schema-dts';
 import type { PartyKegUI, PartyKegLocaleContent } from '../index';
 
-const slug = 'calculadora-fiesta-barril';
+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.';