@jjlmoya/utils-alcohol 1.1.0

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

@@ -0,0 +1,175 @@
+import type { WithContext, SoftwareApplication } from 'schema-dts';
+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 ui: CarbonationUI = {
+  parametersTitle: 'Parameters',
+  metricBtn: 'Metric',
+  imperialBtn: 'Imperial',
+  volumeLabel: 'Beer Volume',
+  maxTempLabel: 'Maximum Temperature',
+  litersUnit: 'Liters',
+  celsiusUnit: '°C',
+  gallonsUnit: 'Gallons',
+  fahrenheitUnit: '°F',
+  desiredCo2Label: 'Desired Carbonation',
+  volUnit: 'CO2 Vol',
+  resultsTitle: 'Priming Results',
+  tableSugarLabel: 'Table Sugar',
+  cornSugarLabel: 'Corn Sugar (Dextrose)',
+  dmeLabel: 'Dry Malt Extract (DME)',
+  safetyTitle: 'EXPLOSION DANGER!',
+  lowCarbonation: 'LOW CARBONATION',
+  optimalCarbonation: 'OPTIMAL CARBONATION',
+  highEffervescence: 'HIGH EFFERVESCENCE',
+  bubblingVisualizationLabel: 'Approximate bubble visualization'
+};
+
+const faqTitle = 'Frequently Asked Questions';
+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.",
+  },
+  {
+    question: "What sugar is best for priming?",
+    answer: "Dextrose (corn sugar) is preferred because it is neutral and dissolves quickly. Table sugar works well but requires about 10% less weight.",
+  },
+  {
+    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.",
+  },
+];
+
+const howTo: CarbonationLocaleContent['howTo'] = [
+  {
+    name: "Measure real volume",
+    text: "Indicate how many liters (or gallons) of beer you have ready for bottling after fermentation is complete.",
+  },
+  {
+    name: "Define fermentation temperature",
+    text: "Enter the highest temperature the beer reached during or after active fermentation.",
+  },
+  {
+    name: "Choose style or CO2 volume",
+    text: "Select the desired carbonation level. Styles vary from 1.5 (Stouts) to 4.5 (Wheat Beers).",
+  },
+];
+
+const bibliography: CarbonationLocaleContent['bibliography'] = [
+  {
+    name: "How to Brew: Carbonation Tables - John Palmer",
+    url: "http://howtobrew.com/book/section-1/priming-and-bottling/priming-solutions",
+  },
+  {
+    name: "BJCP Style Guidelines: Carbonation Levels",
+    url: "https://www.bjcp.org/stylecenter.php",
+  },
+];
+
+const seo: CarbonationLocaleContent['seo'] = [
+  {
+    type: 'title',
+    text: 'Ultimate Guide to Carbonation and Priming',
+    level: 2
+  },
+  {
+    type: 'paragraph',
+    html: 'Master the art of priming and transform your homebrew from a flat experiment into a professional effervescent experience. Priming involves adding a precise amount of sugar so residual yeast in the bottle generates natural CO2 during a secondary fermentation. Too little sugar yields flat beer; too much creates dangerous pressure that can shatter bottles. The difference between the two is a few grams — which is why this calculator exists.'
+  },
+  {
+    type: 'proscons',
+    title: 'Critical Success Factors',
+    items: [
+      { pro: 'Temperature: Residual CO2 depends on the post-fermentation temperature peak.', con: '' },
+      { pro: 'Precision: 5 extra grams per liter can be the difference between perfect carbonation and a geyser.', con: '' },
+      { pro: '', con: 'Oxidation: Avoid splashing the liquid when transferring to mix the priming sugar.' }
+    ]
+  },
+  {
+    type: 'title',
+    text: 'CO2 Volumes by Beer Style',
+    level: 2
+  },
+  {
+    type: 'stats',
+    items: [
+      { label: 'British Stouts', value: '1.5 - 2.0 Vol', icon: 'mdi:beer' },
+      { label: 'IPAs & Ales', value: '2.2 - 2.6 Vol', icon: 'mdi:hops' },
+      { label: 'German Wheat', value: '3.3 - 4.5 Vol', icon: 'mdi:barley' }
+    ],
+    columns: 3
+  },
+  {
+    type: 'card',
+    title: 'Which Sugar Should You Choose?',
+    icon: 'mdi:corn',
+    html: '<strong>Dextrose</strong> is neutral and professional — the industry standard. <strong>Table Sugar</strong> is economical and effective (use 10% less by weight than dextrose). <strong>DME (Dry Malt Extract)</strong> is the purist\'s choice but harder to predict accurately because its fermentability varies by brand and malt composition.'
+  },
+  {
+    type: 'diagnostic',
+    title: 'Safety Warning',
+    icon: 'mdi:alert-decagram',
+    variant: 'error',
+    badge: 'Danger',
+    html: 'Standard glass bottles fail at 3.5-4.0 volumes of CO2. Do not attempt to carbonate Belgian-style or wheat beers in thin glass. Always use bottles rated for sparkling drinks, and never use recycled commercial bottles that may have microscopic structural damage from previous use.'
+  },
+  {
+    type: 'tip',
+    title: 'Pro Tip: Dissolve the Sugar Properly',
+    html: 'Always boil your priming sugar solution (sugar dissolved in approximately 250ml of water per 20L batch) for 10 minutes before adding it to the beer. Boiling sanitizes the solution and ensures the sugar is fully dissolved and evenly distributed throughout the batch, preventing hot spots that cause uneven carbonation between bottles.'
+  },
+  {
+    type: 'summary',
+    title: 'Who is this tool for?',
+    items: [
+      'Homebrewers: Get the exact priming sugar calculation for any batch size, style and fermentation temperature.',
+      'Craft Beer Enthusiasts: Understand the science behind why commercial beers have different carbonation levels.',
+      'Professional Brewers: Cross-check hand calculations before bottling large commercial batches.'
+    ]
+  },
+  {
+    type: 'title',
+    text: 'Carbonation Science: Henry\'s Law',
+    level: 2
+  },
+  {
+    type: 'paragraph',
+    html: 'At its core, carbonation is governed by <strong>Henry\'s Law</strong>: the amount of gas dissolved in a liquid is proportional to the partial pressure of that gas above the liquid. When you prime a bottle and seal it, the yeast consumes the sugar and produces CO2 in a sealed environment. As pressure builds, the gas is forced back into solution. The temperature at which this equilibrium occurs determines the final carbonation level — which is why the fermentation temperature is the most critical variable in this calculator.'
+  },
+  {
+    type: 'paragraph',
+    html: 'The residual CO2 in your beer before priming is not zero. Every beer holds dissolved CO2 from the fermentation process, and the amount retained depends on the highest temperature the beer reached. A beer fermented at 22°C holds significantly less residual CO2 than one that fermented at 16°C, even if both are now chilled. Failing to account for this residual leads to systematic over-carbonation — one of the most common mistakes among beginning homebrewers.'
+  }
+];
+
+const schemas: CarbonationLocaleContent['schemas'] = [
+  {
+    '@context': 'https://schema.org',
+    '@type': 'SoftwareApplication',
+    name: title,
+    description: description,
+    applicationCategory: 'UtilityApplication',
+    operatingSystem: 'Web',
+    offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  } as WithContext<SoftwareApplication>,
+];
+
+export const content: CarbonationLocaleContent = {
+  slug,
+  title,
+  description,
+  ui,
+  seo,
+  faqTitle,
+  faq,
+  bibliographyTitle,
+  bibliography,
+  howTo,
+  schemas,
+};

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

@@ -0,0 +1,179 @@
+import type { WithContext, SoftwareApplication } from 'schema-dts';
+import type { CarbonationUI, CarbonationLocaleContent } from '../index';
+
+const slug = 'calculadora-carbonatacion-cerveza';
+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 ui: CarbonationUI = {
+  parametersTitle: 'Parámetros',
+  metricBtn: 'Métrico',
+  imperialBtn: 'Imperial',
+  volumeLabel: 'Volumen de Cerveza',
+  maxTempLabel: 'Temperatura Máxima',
+  litersUnit: 'Litros',
+  celsiusUnit: '°C',
+  gallonsUnit: 'Galones',
+  fahrenheitUnit: '°F',
+  desiredCo2Label: 'Carbonatación Deseada',
+  volUnit: 'Vol CO2',
+  resultsTitle: 'Resultados de Priming',
+  tableSugarLabel: 'Azúcar de Mesa',
+  cornSugarLabel: 'Dextrosa (Maíz)',
+  dmeLabel: 'Extracto Seco (DME)',
+  safetyTitle: '¡PELIGRO EXPLOSIÓN!',
+  lowCarbonation: 'BAJA CARBONATACIÓN',
+  optimalCarbonation: 'CARBONATACIÓN ÓPTIMA',
+  highEffervescence: 'ALTA EFERVESCENCIA',
+  bubblingVisualizationLabel: 'Visualización aproximada de burbujas'
+};
+
+const faqTitle = 'Preguntas Frecuentes';
+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.",
+  },
+  {
+    question: "¿Qué azúcar es mejor para el priming?",
+    answer: "La dextrosa (azúcar de maíz) es la preferida por ser neutra y disolverse rápido. El azúcar de mesa funciona bien pero requiere un 10% menos de peso.",
+  },
+  {
+    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.",
+  },
+];
+
+const howTo: CarbonationLocaleContent['howTo'] = [
+  {
+    name: "Medir el volumen real",
+    text: "Indica cuántos litros (o galones) de cerveza tienes listos para embotellar una vez terminada la fermentación.",
+  },
+  {
+    name: "Definir la temperatura de fermentación",
+    text: "Introduce la temperatura más alta que alcanzó la cerveza durante o después de la fermentación activa.",
+  },
+  {
+    name: "Elegir el estilo o volumen de CO2",
+    text: "Selecciona el nivel de carbonatación deseado. Los estilos varían desde 1.5 (Stouts) hasta 4.5 (Wheat Beers).",
+  },
+];
+
+const bibliography: CarbonationLocaleContent['bibliography'] = [
+  {
+    name: "How to Brew: Carbonation Tables - John Palmer",
+    url: "http://howtobrew.com/book/section-1/priming-and-bottling/priming-solutions",
+  },
+  {
+    name: "BJCP Style Guidelines: Carbonation Levels",
+    url: "https://www.bjcp.org/stylecenter.php",
+  },
+];
+
+const seo: CarbonationLocaleContent['seo'] = [
+  {
+    type: 'title',
+    text: 'Guía Definitiva de Carbonatación y Priming',
+    level: 2
+  },
+  {
+    type: 'paragraph',
+    html: 'Domina el arte del "priming" y transforma tu cerveza casera de un experimento plano a una experiencia profesional efervescente. El cebado consiste en añadir azúcar para que la levadura genere CO2 natural dentro de la botella.'
+  },
+  {
+    type: 'proscons',
+    title: 'Factores Críticos de Éxito',
+    items: [
+      { pro: 'Temperatura: El CO2 residual depende del pico térmico post-fermentación.', con: '' },
+      { pro: 'Precisión: 5 gramos pueden ser la diferencia entre una buena cerveza y un géiser.', con: '' },
+      { pro: '', con: 'Oxidación: Evita chapotear el líquido al trasvasar para mezclar el azúcar.' }
+    ]
+  },
+  {
+    type: 'title',
+    text: 'Volúmenes de CO2 por Estilo',
+    level: 2
+  },
+  {
+    type: 'stats',
+    items: [
+      { label: 'British Stouts', value: '1.5 - 2.0 Vol', icon: 'mdi:beer' },
+      { label: 'IPAs & Ales', value: '2.2 - 2.6 Vol', icon: 'mdi:hops' },
+      { label: 'German Wheat', value: '3.3 - 4.5 Vol', icon: 'mdi:barley' }
+    ],
+    columns: 3
+  },
+  {
+    type: 'card',
+    title: '¿Qué azúcar elegir?',
+    icon: 'mdi:corn',
+    html: 'La <strong>Dextrosa</strong> es neutra y profesional. El <strong>Azúcar de Mesa</strong> es económica y efectiva (usa un 10% menos). El <strong>DME</strong> es el purista pero más difícil de predecir.'
+  },
+  {
+    type: 'diagnostic',
+    title: 'Advertencia de Seguridad',
+    icon: 'mdi:alert-decagram',
+    variant: 'error',
+    badge: 'Peligro',
+    html: 'Las botellas de vidrio estándar fallan a partir de 3.5-4.0 volúmenes de CO2. No intentes carbonatar estilos belgas o de trigo en vidrio fino. Utiliza siempre botellas homologadas para bebidas con gas, y nunca reutilices botellas comerciales que puedan tener daños estructurales microscópicos por usos anteriores.'
+  },
+  {
+    type: 'tip',
+    title: 'Consejo Pro: Disuelve el Azúcar Correctamente',
+    html: 'Hierve siempre la solución de azúcar de priming (azúcar disuelto en unos 250ml de agua por cada 20L de lote) durante 10 minutos antes de añadirla a la cerveza. La ebullición sanea la solución y garantiza una distribución homogénea en todo el lote, evitando puntos calientes que causan una carbonatación desigual entre botellas.'
+  },
+  {
+    type: 'summary',
+    title: '¿Para quién es esta herramienta?',
+    items: [
+      'Cerveceros Caseros: Obtén el cálculo exacto de azúcar de priming para cualquier volumen, estilo y temperatura.',
+      'Aficionados a la Cerveza Artesanal: Entiende la ciencia detrás de los distintos niveles de carbonatación.',
+      'Cerveceros Profesionales: Verifica cálculos manuales antes de embotellar lotes comerciales importantes.'
+    ]
+  },
+  {
+    type: 'title',
+    text: 'La Ciencia de la Carbonatación: Ley de Henry',
+    level: 2
+  },
+  {
+    type: 'paragraph',
+    html: 'En su esencia, la carbonatación está gobernada por la <strong>Ley de Henry</strong>: la cantidad de gas disuelto en un líquido es proporcional a la presión parcial de ese gas sobre el líquido. Cuando primeas una botella y la sellas, la levadura consume el azúcar y produce CO2 en un entorno cerrado. La presión aumenta y el gas es forzado a disolverse de nuevo en el líquido. La temperatura a la que se produce este equilibrio determina el nivel de carbonatación final — por eso la temperatura de fermentación es la variable más crítica en esta calculadora.'
+  },
+  {
+    type: 'paragraph',
+    html: 'El CO2 residual en tu cerveza antes del priming no es cero. Cada cerveza retiene CO2 disuelto del proceso de fermentación, y la cantidad retenida depende de la temperatura más alta que alcanzó la cerveza. Una cerveza fermentada a 22°C retiene significativamente menos CO2 residual que una fermentada a 16°C, aunque ambas estén ahora frías. No tener en cuenta este residual lleva a una sobre-carbonatación sistemática — uno de los errores más comunes entre los cerveceros principiantes.'
+  },
+  {
+    type: 'paragraph',
+    html: 'El tiempo de condicionamiento también importa. Tras el embotellado con azúcar de priming, la cerveza necesita entre 2 y 3 semanas a temperatura ambiente (18-22°C) para que la levadura fermente completamente el azúcar añadido y el CO2 se integre en el líquido. Una carbonatación prematura — probar la cerveza antes de que el proceso termine — siempre dará una falsa lectura de subida de carbonatación.'
+  }
+];
+
+const schemas: CarbonationLocaleContent['schemas'] = [
+  {
+    '@context': 'https://schema.org',
+    '@type': 'SoftwareApplication',
+    name: title,
+    description: description,
+    applicationCategory: 'UtilityApplication',
+    operatingSystem: 'Web',
+    offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  } as WithContext<SoftwareApplication>,
+];
+
+export const content: CarbonationLocaleContent = {
+  slug,
+  title,
+  description,
+  ui,
+  seo,
+  faqTitle,
+  faq,
+  bibliographyTitle,
+  bibliography,
+  howTo,
+  schemas,
+};

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

@@ -0,0 +1,175 @@
+import type { WithContext, SoftwareApplication } from 'schema-dts';
+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 ui: CarbonationUI = {
+  parametersTitle: 'Paramètres',
+  metricBtn: 'Métrique',
+  imperialBtn: 'Impérial',
+  volumeLabel: 'Volume de Bière',
+  maxTempLabel: 'Température Maximale',
+  litersUnit: 'Litres',
+  celsiusUnit: '°C',
+  gallonsUnit: 'Gallons',
+  fahrenheitUnit: '°F',
+  desiredCo2Label: 'Carbonatation Souhaitée',
+  volUnit: 'Vol CO2',
+  resultsTitle: 'Résultats de Priming',
+  tableSugarLabel: 'Sucre de Table',
+  cornSugarLabel: 'Dextrose (Maïs)',
+  dmeLabel: 'Extrait de Malt Sec (DME)',
+  safetyTitle: 'DANGER EXPLOSION !',
+  lowCarbonation: 'FAIBLE CARBONATATION',
+  optimalCarbonation: 'CARBONATATION OPTIMALE',
+  highEffervescence: 'HAUTE EFFERVESCENCE',
+  bubblingVisualizationLabel: 'Visualisation approximative des bulles'
+};
+
+const faqTitle = 'Foire Aux Questions';
+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.",
+  },
+  {
+    question: "Quel sucre est le meilleur pour le priming ?",
+    answer: "Le dextrose (sucre de maïs) est préféré car il est neutre et se dissout rapidement. Le sucre de table fonctionne bien mais nécessite environ 10 % de poids en moins.",
+  },
+  {
+    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.",
+  },
+];
+
+const howTo: CarbonationLocaleContent['howTo'] = [
+  {
+    name: "Mesurer le volume réel",
+    text: "Indiquez combien de litres (ou gallons) de bière vous avez prêts à être embouteillés une fois la fermentation terminée.",
+  },
+  {
+    name: "Définir la température de fermentation",
+    text: "Entrez la température la plus élevée atteinte par la bière pendant ou après la fermentation active.",
+  },
+  {
+    name: "Choisir le style ou le volume de CO2",
+    text: "Sélectionnez le niveau de carbonatation souhaité. Les styles varient de 1,5 (Stouts) à 4,5 (Wheat Beers).",
+  },
+];
+
+const bibliography: CarbonationLocaleContent['bibliography'] = [
+  {
+    name: "How to Brew: Carbonation Tables - John Palmer",
+    url: "http://howtobrew.com/book/section-1/priming-and-bottling/priming-solutions",
+  },
+  {
+    name: "BJCP Style Guidelines: Carbonation Levels",
+    url: "https://www.bjcp.org/stylecenter.php",
+  },
+];
+
+const seo: CarbonationLocaleContent['seo'] = [
+  {
+    type: 'title',
+    text: 'Guide Ultime de Carbonatation et Priming',
+    level: 2
+  },
+  {
+    type: 'paragraph',
+    html: 'Maîtrisez l\'art du "priming" et transformez votre bière artisanale d\'une expérience plate en une expérience effervescente professionnelle. Le priming consiste à ajouter une quantité précise de sucre pour que la levure résiduelle dans la bouteille génère du CO2 naturel lors d\'une fermentation secondaire. Trop peu de sucre donne une bière plate ; trop en génère une pression dangereuse qui peut briser les bouteilles. La différence tient à quelques grammes — voilà pourquoi ce calculateur existe.'
+  },
+  {
+    type: 'proscons',
+    title: 'Facteurs Critiques de Succès',
+    items: [
+      { pro: 'Température : Le CO2 résiduel dépend du pic thermique post-fermentation.', con: '' },
+      { pro: 'Précision : 5 grammes supplémentaires par litre peuvent faire la différence entre une bonne bière et un geyser.', con: '' },
+      { pro: '', con: 'Oxydation : Évitez de faire gicler le liquide lors du transfert pour mélanger le sucre de priming.' }
+    ]
+  },
+  {
+    type: 'title',
+    text: 'Volumes de CO2 par Style de Bière',
+    level: 2
+  },
+  {
+    type: 'stats',
+    items: [
+      { label: 'British Stouts', value: '1,5 - 2,0 Vol', icon: 'mdi:beer' },
+      { label: 'IPAs & Ales', value: '2,2 - 2,6 Vol', icon: 'mdi:hops' },
+      { label: 'German Wheat', value: '3,3 - 4,5 Vol', icon: 'mdi:barley' }
+    ],
+    columns: 3
+  },
+  {
+    type: 'card',
+    title: 'Quel Sucre Choisir ?',
+    icon: 'mdi:corn',
+    html: 'Le <strong>Dextrose</strong> est neutre et professionnel — le standard de l\'industrie. Le <strong>Sucre de Table</strong> est économique et efficace (utilisez 10% de moins en poids). Le <strong>DME (Extrait de Malt Sec)</strong> est le choix du puriste mais plus difficile à prédire avec précision car sa fermentabilité varie selon la marque et la composition du malt.'
+  },
+  {
+    type: 'diagnostic',
+    title: 'Avertissement de Sécurité',
+    icon: 'mdi:alert-decagram',
+    variant: 'error',
+    badge: 'Danger',
+    html: 'Les bouteilles en verre standard cèdent à 3,5-4,0 volumes de CO2. N\'essayez pas de carbonater des styles belges ou de blé dans du verre mince. Utilisez toujours des bouteilles homologuées pour les boissons pétillantes, et n\'utilisez jamais des bouteilles commerciales recyclées qui peuvent présenter des dommages structurels microscopiques.'
+  },
+  {
+    type: 'tip',
+    title: 'Conseil Pro : Dissoudre Correctement le Sucre',
+    html: 'Faites toujours bouillir votre solution de sucre de priming (sucre dissous dans environ 250ml d\'eau pour 20L de bière) pendant 10 minutes avant de l\'ajouter à la bière. L\'ébullition assainit la solution et garantit une distribution homogène dans tout le lot, évitant les points chauds qui causent une carbonatation inégale entre les bouteilles.'
+  },
+  {
+    type: 'summary',
+    title: 'À qui s\'adresse cet outil ?',
+    items: [
+      'Brasseurs Amateurs : Obtenez le calcul exact de sucre de priming pour toute taille de lot, style et température.',
+      'Passionnés de Bière Artisanale : Comprenez la science derrière les différents niveaux de carbonatation des bières commerciales.',
+      'Brasseurs Professionnels : Vérifiez les calculs manuels avant d\'embouteiller des lots commerciaux importants.'
+    ]
+  },
+  {
+    type: 'title',
+    text: 'La Science de la Carbonatation : Loi de Henry',
+    level: 2
+  },
+  {
+    type: 'paragraph',
+    html: 'Au fond, la carbonatation est régie par la <strong>Loi de Henry</strong> : la quantité de gaz dissous dans un liquide est proportionnelle à la pression partielle de ce gaz au-dessus du liquide. Quand vous primez une bouteille et la scellez, la levure consomme le sucre et produit du CO2 dans un environnement fermé. La pression augmente et le gaz est forcé de se redissoudre dans le liquide. La température à laquelle cet équilibre se produit détermine le niveau de carbonatation final — c\'est pourquoi la température de fermentation est la variable la plus critique dans ce calculateur.'
+  },
+  {
+    type: 'paragraph',
+    html: 'Le CO2 résiduel dans votre bière avant le priming n\'est pas nul. Chaque bière retient du CO2 dissous issu de la fermentation, et la quantité retenue dépend de la température maximale atteinte par la bière. Une bière fermentée à 22°C retient beaucoup moins de CO2 résiduel qu\'une fermentée à 16°C, même si elles sont maintenant toutes deux refroidies. Ne pas en tenir compte entraîne une sur-carbonatation systématique — l\'une des erreurs les plus courantes des brasseurs débutants.'
+  }
+];
+
+const schemas: CarbonationLocaleContent['schemas'] = [
+  {
+    '@context': 'https://schema.org',
+    '@type': 'SoftwareApplication',
+    name: title,
+    description: description,
+    applicationCategory: 'UtilityApplication',
+    operatingSystem: 'Web',
+    offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  } as WithContext<SoftwareApplication>,
+];
+
+export const content: CarbonationLocaleContent = {
+  slug,
+  title,
+  description,
+  ui,
+  seo,
+  faqTitle,
+  faq,
+  bibliographyTitle,
+  bibliography,
+  howTo,
+  schemas,
+};

package/src/tool/carbonationCalculator/index.ts

@@ -0,0 +1,48 @@
+import type { AlcoholToolEntry, ToolLocaleContent, ToolDefinition } from '../../types';
+import CarbonationCalculator from './component.astro';
+
+export interface CarbonationUI {
+  [key: string]: string;
+  parametersTitle: string;
+  metricBtn: string;
+  imperialBtn: string;
+  volumeLabel: string;
+  maxTempLabel: string;
+  litersUnit: string;
+  celsiusUnit: string;
+  gallonsUnit: string;
+  fahrenheitUnit: string;
+  desiredCo2Label: string;
+  volUnit: string;
+  resultsTitle: string;
+  tableSugarLabel: string;
+  cornSugarLabel: string;
+  dmeLabel: string;
+  safetyTitle: string;
+  lowCarbonation: string;
+  optimalCarbonation: string;
+  highEffervescence: string;
+  bubblingVisualizationLabel: string;
+}
+
+export type CarbonationLocaleContent = ToolLocaleContent<CarbonationUI>;
+
+export const carbonationCalculator: AlcoholToolEntry<CarbonationUI> = {
+  id: 'carbonation-calculator',
+  icons: {
+    bg: 'mdi:bottle-soda-classic',
+    fg: 'mdi:water-opacity',
+  },
+  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 { CarbonationCalculator };
+
+export const CARBONATION_TOOL: ToolDefinition = {
+  entry: carbonationCalculator as AlcoholToolEntry<Record<string, string>>,
+  Component: CarbonationCalculator,
+};

package/src/tool/carbonationCalculator/logic.ts

@@ -0,0 +1,40 @@
+export interface PrimingSugarResults {
+  tableSugar: number;
+  cornSugar: number;
+  dme: number;
+  residualCO2: number;
+}
+
+export function calculatePrimingSugar(
+  volumeL: number,
+  co2Target: number,
+  tempC: number
+): PrimingSugarResults {
+  const residualCO2 = 3.0378 - 0.050062 * tempC + 0.00026555 * Math.pow(tempC, 2);
+  const co2Needed = Math.max(0, co2Target - residualCO2);
+
+  const cornSugar = volumeL * co2Needed * 4.4;
+  const tableSugar = cornSugar * 0.91;
+  const dme = cornSugar * 1.5;
+
+  return {
+    tableSugar: Math.round(tableSugar),
+    cornSugar: Math.round(cornSugar),
+    dme: Math.round(dme),
+    residualCO2
+  };
+}
+
+export function convertToImperial(liters: number, celsius: number) {
+  return {
+    gallons: liters * 0.264172,
+    fahrenheit: (celsius * 9) / 5 + 32
+  };
+}
+
+export function convertToMetric(gallons: number, fahrenheit: number) {
+  return {
+    liters: gallons / 0.264172,
+    celsius: ((fahrenheit - 32) * 5) / 9
+  };
+}

package/src/tool/cocktailBalancer/bibliography.astro

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