@jjlmoya/utils-alcohol 1.1.0

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

@@ -0,0 +1,162 @@
+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 ui: PartyKegUI = {
+  calcStockTitle: 'Stock Calculator',
+  beerIceSub: 'Beer & Ice for Events',
+  guestsLabel: 'Guests',
+  durationLabel: 'Duration',
+  hoursUnit: 'Hours',
+  intensityLabel: 'Intensity',
+  chillLabel: 'Chill',
+  standardLabel: 'Standard',
+  partyLabel: 'Party',
+  tempLabel: 'Temperature',
+  estimatedVolLabel: 'Estimated Volume',
+  kegsLabel: 'Kegs',
+  iceRequiredLabel: 'Ice Required',
+  bagsLabel: 'Bags',
+  visualizationTitle: 'Stock Visualization',
+  optimalMsg: 'Optimal Conditions',
+  highMeltMsg: 'High Melt Detected',
+  highEfficiencyMsg: 'Cold / High Efficiency'
+};
+
+const faqTitle = 'Frequently Asked Questions';
+const bibliographyTitle = 'Bibliography & Sources';
+
+const faq: PartyKegLocaleContent['faq'] = [
+  {
+    question: "How many beers does a person drink in 4 hours?",
+    answer: "On average, calculate 5 beers per person for a 4-hour event. This assumes 2 drinks the first hour and 1 for each remaining hour.",
+  },
+  {
+    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).",
+  },
+  {
+    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.",
+  },
+];
+
+const howTo: PartyKegLocaleContent['howTo'] = [
+  {
+    name: "Estimate the number of guests",
+    text: "Define how many people will attend. Our calculator adjusts the quantities based on statistical consumption averages.",
+  },
+  {
+    name: "Define duration and intensity",
+    text: "Indicate how many hours the event will last and the 'flow' of the party (chill, standard, or intense).",
+  },
+  {
+    name: "Adjust for ambient temperature",
+    text: "Outdoor temperature is key for ice calculation. The hotter it is, the higher the melt rate we must compensate for.",
+  },
+];
+
+const bibliography: PartyKegLocaleContent['bibliography'] = [
+  {
+    name: "Event Planning: Alcohol & Bar Calculations - Spruce Eats",
+    url: "https://www.thespruceeats.com/how-much-alcohol-for-a-party-1191060",
+  },
+  {
+    name: "Thermodynamics of Ice Melting - Engineering Toolbox",
+    url: "https://www.engineeringtoolbox.com/ice-thermal-properties-d_156.html",
+  },
+];
+
+const seo: PartyKegLocaleContent['seo'] = [
+  {
+    type: 'title',
+    text: 'How Much Beer and Ice do I need for my Party?',
+    level: 2
+  },
+  {
+    type: 'paragraph',
+    html: 'The million-dollar question when organizing any event: <strong>How many liters of beer should I buy?</strong> Running short is a disaster, but overbuying is an unnecessary expense. This tool helps you calculate the exact amount of alcohol and, most importantly, <strong>how many bags of ice</strong> you need to keep it cold. Professional caterers and event planners use statistical consumption models — and now you can too, for free.'
+  },
+  {
+    type: 'title',
+    text: 'The Consumption Formula by Person',
+    level: 2
+  },
+  {
+    type: 'paragraph',
+    html: 'To estimate the alcohol needed, professional caterers use a formula based on the "Hourly Consumption Rate". It is not an exact science, but statistics show that at a standard party, approximately 1.5 units are consumed per hour per person. Factors like ambient temperature, food availability, and the social energy of the event all shift this baseline number.'
+  },
+  {
+    type: 'stats',
+    items: [
+      { label: 'Chill Consumption', value: '1 drink/hour', icon: 'mdi:tea-outline' },
+      { label: 'Standard Party', value: '1.5 drinks/hour', icon: 'mdi:glass-mug-variant' },
+      { label: 'Wedding / Festival', value: '2.5+ drinks/hour', icon: 'mdi:fire' }
+    ],
+    columns: 3
+  },
+  {
+    type: 'diagnostic',
+    title: 'The Physics of Ice',
+    icon: 'mdi:snowflake-thermometer',
+    variant: 'warning',
+    badge: 'Thermodynamics',
+    html: 'Calculating ice is where most hosts fail. Ice serves two functions: Cooling (bringing beer from 25°C to 4°C) and Maintaining (fighting ambient heat). At temperatures above 30°C, the melt rate doubles. A full bag of ice in direct sun can be gone in under 20 minutes, leaving your beverages warm before the party peaks.'
+  },
+  {
+    type: 'tip',
+    title: 'Professional Tip to Save Ice',
+    html: 'Keep kegs and cans in the shade before adding ice. If drinks are warm in the sun, the first 50% of your ice bag will die within 10 minutes simply exchanging latent heat. Start with pre-chilled beverages to dramatically reduce how much ice you actually need to buy.'
+  },
+  {
+    type: 'title',
+    text: 'Reference Data for Logistics',
+    level: 2
+  },
+  {
+    type: 'paragraph',
+    html: 'A standard 50L keg yields around 200 servings. A typical bag of ice weighs 2kg. Knowing these figures, you can plan the transport and storage needed for your event without last-minute surprises. Account for ice melt during transport — a 30-minute drive in summer can cost you one full bag before the party even starts.'
+  },
+  {
+    type: 'summary',
+    title: 'Who is this tool for?',
+    items: [
+      'Private Party Hosts: Stop guessing and confidently buy exactly what you need for your next celebration.',
+      'Event Planners: Use accurate consumption models to quote clients and plan bar logistics professionally.',
+      'Venue Managers: Standardize stock calculations across recurring events with different guest counts.'
+    ]
+  },
+  {
+    type: 'paragraph',
+    html: 'One often-overlooked variable is <strong>guest dropout rate</strong>. In most parties, 10-15% of guests leave early and 10% may not drink at all. The calculator applies a conservative buffer so that you are never caught short, but also not left with an enormous surplus. Understanding these adjustments helps you fine-tune the estimate for your specific crowd and context. Always round up when purchasing, since returning opened kegs is generally not possible. A small surplus is always preferable to running dry mid-party.'
+  }
+];
+
+const schemas: PartyKegLocaleContent['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: PartyKegLocaleContent = {
+  slug,
+  title,
+  description,
+  ui,
+  seo,
+  faqTitle,
+  faq,
+  bibliographyTitle,
+  bibliography,
+  howTo,
+  schemas,
+};

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

@@ -0,0 +1,166 @@
+import type { WithContext, SoftwareApplication } from 'schema-dts';
+import type { PartyKegUI, PartyKegLocaleContent } from '../index';
+
+const slug = 'calculadora-fiesta-barril';
+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 ui: PartyKegUI = {
+  calcStockTitle: 'Calculadora de Stock',
+  beerIceSub: 'Cerveza y Hielo para Eventos',
+  guestsLabel: 'Invitados',
+  durationLabel: 'Duración',
+  hoursUnit: 'Horas',
+  intensityLabel: 'Intensidad',
+  chillLabel: 'Chill',
+  standardLabel: 'Standard',
+  partyLabel: 'Party',
+  tempLabel: 'Temperatura',
+  estimatedVolLabel: 'Volumen Estimado',
+  kegsLabel: 'Barriles',
+  iceRequiredLabel: 'Hielo Requerido',
+  bagsLabel: 'Bolsas',
+  visualizationTitle: 'Visualización de Stock',
+  optimalMsg: 'Condiciones Óptimas',
+  highMeltMsg: 'Alto Deshielo Detectado',
+  highEfficiencyMsg: 'Ambiente Frío / Eficiencia Alta'
+};
+
+const faqTitle = 'Preguntas Frecuentes';
+const bibliographyTitle = 'Bibliografía y Fuentes';
+
+const faq: PartyKegLocaleContent['faq'] = [
+  {
+    question: "¿Cuántas cervezas bebe una persona en 4 horas?",
+    answer: "De media, calcula 5 cervezas por persona para un evento de 4 horas. Esto asume 2 bebidas la primera hora y 1 por cada hora restante.",
+  },
+  {
+    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).",
+  },
+  {
+    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.",
+  },
+];
+
+const howTo: PartyKegLocaleContent['howTo'] = [
+  {
+    name: "Estimar el número de invitados",
+    text: "Define cuántas personas asistirán. Nuestra calculadora ajusta las cantidades basándose en promedios estadísticos de consumo.",
+  },
+  {
+    name: "Definir la duración y la intensidad",
+    text: "Indica cuántas horas durará el evento y el 'ritmo' de la fiesta (tranquilo, estándar o intenso).",
+  },
+  {
+    name: "Ajustar por temperatura ambiente",
+    text: "La temperatura exterior es clave para el cálculo del hielo. A más calor, mayor será la tasa de deshielo que debemos compensar.",
+  },
+];
+
+const bibliography: PartyKegLocaleContent['bibliography'] = [
+  {
+    name: "Event Planning: Alcohol & Bar Calculations - Spruce Eats",
+    url: "https://www.thespruceeats.com/how-much-alcohol-for-a-party-1191060",
+  },
+  {
+    name: "Thermodynamics of Ice Melting - Engineering Toolbox",
+    url: "https://www.engineeringtoolbox.com/ice-thermal-properties-d_156.html",
+  },
+];
+
+const seo: PartyKegLocaleContent['seo'] = [
+  {
+    type: 'title',
+    text: '¿Cuánta Cerveza y Hielo necesito para mi Fiesta?',
+    level: 2
+  },
+  {
+    type: 'paragraph',
+    html: 'La pregunta del millón al organizar cualquier evento: <strong>¿Cuántos litros de cerveza debo comprar?</strong> Quedarse corto es un desastre, pero comprar de más es un gasto innecesario. Esta herramienta te ayuda a calcular la cantidad exacta de alcohol y, lo más importante, <strong>cuántas bolsas de hielo</strong> necesitas para mantenerlo frío.'
+  },
+  {
+    type: 'title',
+    text: 'Fórmula de Consumo por Persona',
+    level: 2
+  },
+  {
+    type: 'paragraph',
+    html: 'Para estimar el alcohol necesario, los caterings profesionales utilizan una fórmula basada en la "Tasa de Consumo por Hora". No es una ciencia exacta, pero las estadísticas nos dicen que en una fiesta estándar se beben unas 1.5 unidades/hora por persona.'
+  },
+  {
+    type: 'stats',
+    items: [
+      { label: 'Consumo Chill', value: '1 bebida/hora', icon: 'mdi:tea-outline' },
+      { label: 'Fiesta Estándar', value: '1.5 bebidas/hora', icon: 'mdi:glass-mug-variant' },
+      { label: 'Boda / Festival', value: '2.5+ bebidas/hora', icon: 'mdi:fire' }
+    ],
+    columns: 3
+  },
+  {
+    type: 'diagnostic',
+    title: 'La Física del Hielo',
+    icon: 'mdi:snowflake-thermometer',
+    variant: 'warning',
+    badge: 'Termodinámica',
+    html: 'Calcular el hielo es donde la mayoría falla. El hielo cumple dos funciones: Enfriar (de 25°C a 4°C) y Mantener (luchar contra el calor ambiental). Si la temperatura supera los 30°C, la velocidad de fusión se duplica.'
+  },
+  {
+    type: 'tip',
+    title: 'Consejo Profesional para Ahorrar Hielo',
+    html: 'Mantén los barriles o latas a la sombra antes de ponerles el hielo. Si las bebidas están calientes al sol, el 50% de tu primera bolsa de hielo morirá en 10 minutos solo intercambiando calor latente. Comienza siempre con bebidas pre-enfriadas para reducir drásticamente la cantidad de hielo que realmente necesitas comprar.'
+  },
+  {
+    type: 'title',
+    text: 'Datos de Referencia para Logística',
+    level: 2
+  },
+  {
+    type: 'paragraph',
+    html: 'Un barril estándar de 50L rinde unas 200 cañas. Una bolsa de hielo típica pesa 2kg. Conociendo estos datos, puedes planificar el transporte y el almacenamiento necesario para tu evento sin sorpresas de última hora. Ten también en cuenta el deshielo durante el transporte: un trayecto de 30 minutos en verano puede costarte una bolsa entera antes de que empiece la fiesta.'
+  },
+  {
+    type: 'paragraph',
+    html: 'Una variable que a menudo se pasa por alto es la <strong>tasa de abandono de invitados</strong>. En la mayoría de fiestas, el 10-15% de los invitados se van antes y el 10% puede que no beban en absoluto. La calculadora aplica un margen de seguridad conservador para que nunca te quedes corto, sin que tampoco te sobre demasiado. Entender estos ajustes te ayuda a afinar la estimación para tu grupo y contexto específicos.'
+  },
+  {
+    type: 'summary',
+    title: '¿Para quién es esta herramienta?',
+    items: [
+      'Anfitriones de fiestas privadas: Compra exactamente lo que necesitas sin quedarte corto ni malgastar.',
+      'Organizadores de eventos: Usa modelos de consumo precisos para planificar la logística del bar profesionalmente.',
+      'Gestores de locales: Estandariza los cálculos de stock para eventos recurrentes con diferentes aforos.'
+    ]
+  },
+  {
+    type: 'paragraph',
+    html: 'Redondea siempre al alza cuando compres, ya que devolver barriles abiertos generalmente no es posible. Un pequeño exceso es siempre preferible a quedarse sin bebida a mitad de fiesta — es mejor que sobren unas cañas a que la velada termine prematuramente por falta de stock.'
+  }
+];
+
+const schemas: PartyKegLocaleContent['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: PartyKegLocaleContent = {
+  slug,
+  title,
+  description,
+  ui,
+  seo,
+  faqTitle,
+  faq,
+  bibliographyTitle,
+  bibliography,
+  howTo,
+  schemas,
+};

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

@@ -0,0 +1,162 @@
+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 ui: PartyKegUI = {
+  calcStockTitle: 'Calculateur de Stock',
+  beerIceSub: 'Bière et Glace pour Événements',
+  guestsLabel: 'Invités',
+  durationLabel: 'Durée',
+  hoursUnit: 'Heures',
+  intensityLabel: 'Intensité',
+  chillLabel: 'Chill',
+  standardLabel: 'Standard',
+  partyLabel: 'Party',
+  tempLabel: 'Température',
+  estimatedVolLabel: 'Volume Estimé',
+  kegsLabel: 'Fûts',
+  iceRequiredLabel: 'Glace Requise',
+  bagsLabel: 'Sacs',
+  visualizationTitle: 'Visualisation du Stock',
+  optimalMsg: 'Conditions Optimales',
+  highMeltMsg: 'Fonte Élevée Détectée',
+  highEfficiencyMsg: 'Environnement Froid'
+};
+
+const faqTitle = 'Foire Aux Questions';
+const bibliographyTitle = 'Bibliographie & Sources';
+
+const faq: PartyKegLocaleContent['faq'] = [
+  {
+    question: "Combien de bières une personne boit-elle en 4 heures ?",
+    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: "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.",
+  },
+];
+
+const howTo: PartyKegLocaleContent['howTo'] = [
+  {
+    name: "Saisir le nombre d'invités",
+    text: "Entrez le nombre total de personnes attendues pour l'événement.",
+  },
+  {
+    name: "Définir la durée et l'intensité",
+    text: "Indiquez combien de temps durera la fête et quel est le 'vibe' (tranquille, standard ou fête intense).",
+  },
+  {
+    name: "Ajuster la température ambiante",
+    text: "La température extérieure influence directement la quantité de glace nécessaire pour garder les fûts au frais.",
+  },
+];
+
+const bibliography: PartyKegLocaleContent['bibliography'] = [
+  {
+    name: "Event Planning: Beverage Calculation Guide",
+    url: "https://www.thespruceeats.com/how-much-alcohol-for-a-party-4158434",
+  },
+  {
+    name: "Ice Melt Rates and Cooling Efficiency",
+    url: "https://www.engineeringtoolbox.com/ice-melting-water-d_1594.html",
+  },
+];
+
+const seo: PartyKegLocaleContent['seo'] = [
+  {
+    type: 'title',
+    text: 'Combien de Bière et de Glace pour ma Fête ?',
+    level: 2
+  },
+  {
+    type: 'paragraph',
+    html: 'Planifier un événement demande de la précision. Trop peu de bière et la fête s\'arrête avant l\'heure ; trop peu de glace et les boissons deviennent tièdes et imbuvables. Notre calculateur utilise des modèles de consommation basés sur des données réelles pour vous donner une estimation fiable, que vous organisiez une soirée intime ou un festival en plein air.'
+  },
+  {
+    type: 'title',
+    text: 'La Formule de Consommation par Personne',
+    level: 2
+  },
+  {
+    type: 'paragraph',
+    html: 'Pour estimer l\'alcool nécessaire, les traiteurs professionnels utilisent une formule basée sur le "Taux de Consommation Horaire". Ce n\'est pas une science exacte, mais les statistiques montrent qu\'à une fête standard, on consomme environ 1,5 unité par heure par personne. La chaleur ambiante, la disponibilité de nourriture et l\'ambiance générale influencent ce chiffre de base.'
+  },
+  {
+    type: 'stats',
+    items: [
+      { label: 'Consommation Chill', value: '1 boisson/heure', icon: 'mdi:tea-outline' },
+      { label: 'Fête Standard', value: '1,5 boisson/heure', icon: 'mdi:glass-mug-variant' },
+      { label: 'Mariage / Festival', value: '2,5+ boissons/heure', icon: 'mdi:fire' }
+    ],
+    columns: 3
+  },
+  {
+    type: 'diagnostic',
+    title: 'La Physique de la Glace',
+    icon: 'mdi:snowflake-thermometer',
+    variant: 'warning',
+    badge: 'Thermodynamique',
+    html: 'Calculer la glace est l\'erreur la plus courante des organisateurs de fêtes. La glace remplit deux fonctions : Refroidir (amener la bière de 25°C à 4°C) et Maintenir (lutter contre la chaleur ambiante). À des températures supérieures à 30°C, la vitesse de fonte double. Un sac de glace complet en plein soleil peut disparaître en moins de 20 minutes.'
+  },
+  {
+    type: 'tip',
+    title: 'Conseil Professionnel pour Économiser la Glace',
+    html: 'Gardez les fûts et les canettes à l\'ombre avant d\'ajouter de la glace. Si les boissons sont chaudes au soleil, les 50% de votre premier sac de glace disparaîtront en 10 minutes uniquement en échangeant la chaleur latente. Commencez avec des boissons pré-refroidies pour réduire drastiquement la quantité de glace nécessaire.'
+  },
+  {
+    type: 'title',
+    text: 'Données de Référence pour la Logistique',
+    level: 2
+  },
+  {
+    type: 'paragraph',
+    html: 'Un fût standard de 50L donne environ 200 portions. Un sac de glace typique pèse 2kg. En connaissant ces chiffres, vous pouvez planifier le transport et le stockage nécessaires à votre événement sans mauvaises surprises de dernière minute. Comptez également la fonte pendant le transport — un trajet de 30 minutes en été peut vous coûter un sac entier avant même le début de la fête.'
+  },
+  {
+    type: 'summary',
+    title: 'À qui s\'adresse cet outil ?',
+    items: [
+      'Hôtes de fêtes privées : Achetez exactement ce dont vous avez besoin pour votre prochaine célébration.',
+      'Organisateurs d\'événements : Utilisez des modèles de consommation précis pour planifier la logistique du bar.',
+      'Gérants de lieux : Standardisez les calculs de stock pour des événements récurrents avec des nombres d\'invités variables.'
+    ]
+  },
+  {
+    type: 'paragraph',
+    html: 'Une variable souvent négligée est le <strong>taux d\'abandon des invités</strong>. Dans la plupart des fêtes, 10 à 15 % des invités partent tôt et 10 % peuvent ne pas boire du tout. Le calculateur applique une marge de sécurité conservatrice pour que vous ne soyez jamais à court, sans pour autant vous retrouver avec un surplus énorme. Comprendre ces ajustements vous aide à affiner l\'estimation pour votre groupe et contexte spécifiques.'
+  }
+];
+
+const schemas: PartyKegLocaleContent['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: PartyKegLocaleContent = {
+  slug,
+  title,
+  description,
+  ui,
+  seo,
+  faqTitle,
+  faq,
+  bibliographyTitle,
+  bibliography,
+  howTo,
+  schemas,
+};

package/src/tool/partyKeg/index.ts

@@ -0,0 +1,46 @@
+import type { AlcoholToolEntry, ToolLocaleContent, ToolDefinition } from '../../types';
+import PartyKegCalculator from './component.astro';
+
+export interface PartyKegUI {
+  [key: string]: string;
+  calcStockTitle: string;
+  beerIceSub: string;
+  guestsLabel: string;
+  durationLabel: string;
+  hoursUnit: string;
+  intensityLabel: string;
+  chillLabel: string;
+  standardLabel: string;
+  partyLabel: string;
+  tempLabel: string;
+  estimatedVolLabel: string;
+  kegsLabel: string;
+  iceRequiredLabel: string;
+  bagsLabel: string;
+  visualizationTitle: string;
+  optimalMsg: string;
+  highMeltMsg: string;
+  highEfficiencyMsg: string;
+}
+
+export type PartyKegLocaleContent = ToolLocaleContent<PartyKegUI>;
+
+export const partyKeg: AlcoholToolEntry<PartyKegUI> = {
+  id: 'party-keg',
+  icons: {
+    bg: 'mdi:party-popper',
+    fg: 'mdi:keg',
+  },
+  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 { PartyKegCalculator };
+
+export const PARTY_KEG_TOOL: ToolDefinition = {
+  entry: partyKeg as AlcoholToolEntry<Record<string, string>>,
+  Component: PartyKegCalculator,
+};

package/src/tool/partyKeg/logic.ts

@@ -0,0 +1,36 @@
+export interface PartyStats {
+  totalLiters: number;
+  kegs: number;
+  totalIce: number;
+  bags: number;
+  iceMsg: string;
+}
+
+export function calculatePartyStock(
+  guests: number,
+  duration: number,
+  temp: number,
+  drinkRate: number
+): PartyStats {
+  const totalDrinks = guests * (drinkRate * duration);
+  const totalLiters = Math.ceil(totalDrinks * 0.33);
+  const kegs = Math.ceil(totalLiters / 50);
+
+  const deltaT = temp - 4;
+  const massBeer = totalLiters;
+  const energyToRemove = massBeer * 4.18 * deltaT;
+  const iceForCooling = (energyToRemove / 334) * 1.5;
+
+  const ambientDelta = temp - 0;
+  const meltRate = (ambientDelta / 10) * 0.5;
+  const iceForMaintenance = meltRate * duration * (massBeer / 20);
+
+  const totalIce = Math.ceil(iceForCooling + iceForMaintenance);
+  const bags = Math.ceil(totalIce / 2);
+
+  let iceMsg = 'optimal';
+  if (temp > 30) iceMsg = 'highMelt';
+  else if (temp < 15) iceMsg = 'highEfficiency';
+
+  return { totalLiters, kegs, totalIce, bags, iceMsg };
+}

package/src/tools.ts

@@ -0,0 +1,14 @@
+import type { ToolDefinition } from './types';
+import { COCKTAIL_BALANCER_TOOL } from './tool/cocktailBalancer';
+import { BEER_COOLER_TOOL } from './tool/beerCooler';
+import { PARTY_KEG_TOOL } from './tool/partyKeg';
+import { CARBONATION_TOOL } from './tool/carbonationCalculator';
+import { ALCOHOL_CLEARANCE_TOOL } from './tool/alcoholClearance';
+
+export const ALL_TOOLS: ToolDefinition[] = [
+  COCKTAIL_BALANCER_TOOL,
+  BEER_COOLER_TOOL,
+  PARTY_KEG_TOOL,
+  CARBONATION_TOOL,
+  ALCOHOL_CLEARANCE_TOOL,
+];

package/src/types.ts

@@ -0,0 +1,72 @@
+import type { SEOSection } from '@jjlmoya/utils-shared';
+import type { WithContext, Thing } from 'schema-dts';
+
+export type { SEOSection };
+
+export type KnownLocale =
+  | 'ar' | 'da' | 'de' | 'en' | 'es' | 'fi'
+  | 'fr' | 'it' | 'ja' | 'ko' | 'nb' | 'nl'
+  | 'pl' | 'pt' | 'ru' | 'sv' | 'tr' | 'zh';
+
+export interface FAQItem {
+  question: string;
+  answer: string;
+}
+
+export interface BibliographyEntry {
+  name: string;
+  url: string;
+}
+
+export interface HowToStep {
+  name: string;
+  text: string;
+}
+
+export interface ToolLocaleContent<TUI extends Record<string, string> = Record<string, string>> {
+  slug: string;
+  title: string;
+  description: string;
+  ui: TUI;
+  seo: SEOSection[];
+  faqTitle: string;
+  faq: FAQItem[];
+  bibliographyTitle: string;
+  bibliography: BibliographyEntry[];
+  howTo: HowToStep[];
+  schemas: WithContext<Thing>[];
+}
+
+export interface CategoryLocaleContent {
+  slug: string;
+  title: string;
+  description: string;
+  seo: SEOSection[];
+}
+
+export type LocaleLoader<T> = () => Promise<T>;
+
+export type LocaleMap<T> = Partial<Record<KnownLocale, LocaleLoader<T>>>;
+
+export interface AlcoholToolEntry<TUI extends Record<string, string> = Record<string, string>> {
+  id: string;
+  icons: {
+    bg: string;
+    fg: string;
+  };
+  i18n: LocaleMap<ToolLocaleContent<TUI>>;
+}
+
+export interface AlcoholCategoryEntry {
+  icon: string;
+  tools: AlcoholToolEntry[];
+  i18n: LocaleMap<CategoryLocaleContent>;
+}
+
+export interface ToolDefinition {
+  entry: AlcoholToolEntry<Record<string, string>>;
+  Component: unknown;
+  SEOComponent?: unknown;
+  BibliographyComponent?: unknown;
+}
+