@jjlmoya/utils-alcohol 1.1.0

package/src/tool/cocktailBalancer/data/IngredientRepository.ts

@@ -0,0 +1,83 @@
+import type { Ingredient } from '../domain/Ingredient';
+
+export const INGREDIENTS_DB: Ingredient[] = [
+  { id: 'gin_std', name: 'Ginebra (London Dry)', type: 'spirit', abv: 40, sugar: 0, acid: 0, bitterness: 2, complexity: 5, color: '#e0f2fe' },
+  { id: 'gin_old_tom', name: 'Ginebra Old Tom', type: 'spirit', abv: 40, sugar: 2.0, acid: 0, bitterness: 1, complexity: 6, color: '#e0f2fe' },
+  { id: 'gin_plymouth', name: 'Ginebra Plymouth', type: 'spirit', abv: 41.2, sugar: 0, acid: 0, bitterness: 1, complexity: 5, color: '#e0f2fe' },
+  { id: 'vodka_std', name: 'Vodka', type: 'spirit', abv: 40, sugar: 0, acid: 0, bitterness: 0, complexity: 0, color: '#ffffff' },
+  { id: 'rum_white', name: 'Ron Blanco (Ligero)', type: 'spirit', abv: 40, sugar: 0, acid: 0, bitterness: 0, complexity: 2, color: '#ffffff' },
+  { id: 'rum_aged', name: 'Ron Añejo (5+ años)', type: 'spirit', abv: 40, sugar: 0.5, acid: 0, bitterness: 1, complexity: 7, color: '#d97706' },
+  { id: 'rum_overproof', name: 'Ron Overproof (69%)', type: 'spirit', abv: 69, sugar: 0, acid: 0, bitterness: 2, complexity: 4, color: '#fef3c7' },
+  { id: 'rum_agricole', name: 'Rhum Agricole Blanc', type: 'spirit', abv: 50, sugar: 0, acid: 0, bitterness: 1, complexity: 8, color: '#ffffff' },
+  { id: 'tequila_blanco', name: 'Tequila Blanco', type: 'spirit', abv: 40, sugar: 0, acid: 0, bitterness: 1, complexity: 5, color: '#ffffff' },
+  { id: 'tequila_reposado', name: 'Tequila Reposado', type: 'spirit', abv: 40, sugar: 0.3, acid: 0, bitterness: 1, complexity: 6, color: '#fcd34d' },
+  { id: 'mezcal', name: 'Mezcal Espadín', type: 'spirit', abv: 45, sugar: 0, acid: 0, bitterness: 2, complexity: 9, color: '#ffffff' },
+  { id: 'whiskey_bourbon', name: 'Bourbon Whiskey', type: 'spirit', abv: 45, sugar: 0, acid: 0, bitterness: 2, complexity: 7, color: '#b45309' },
+  { id: 'rye_whiskey', name: 'Rye Whiskey', type: 'spirit', abv: 50, sugar: 0, acid: 0, bitterness: 3, complexity: 7, color: '#b45309' },
+  { id: 'scotch_blended', name: 'Scotch Blended', type: 'spirit', abv: 40, sugar: 0, acid: 0, bitterness: 2, complexity: 6, color: '#d97706' },
+  { id: 'scotch_islay', name: 'Islay Scotch (Ahumado)', type: 'spirit', abv: 43, sugar: 0, acid: 0, bitterness: 4, complexity: 10, color: '#fcd34d' },
+  { id: 'brandy_cognac', name: 'Cognac VSOP', type: 'spirit', abv: 40, sugar: 0.8, acid: 0, bitterness: 1, complexity: 8, color: '#92400e' },
+  { id: 'pisco_quebranta', name: 'Pisco Quebranta', type: 'spirit', abv: 40, sugar: 1, acid: 0, bitterness: 1, complexity: 6, color: '#ffffff' },
+  { id: 'cachaca', name: 'Cachaça', type: 'spirit', abv: 40, sugar: 1, acid: 0, bitterness: 1, complexity: 6, color: '#ffffff' },
+  { id: 'absinthe', name: 'Absenta', type: 'spirit', abv: 60, sugar: 0, acid: 0, bitterness: 5, complexity: 9, color: '#bef264' },
+  { id: 'juice_lime', name: 'Zumo de Lima (Fresco)', type: 'citrus', abv: 0, sugar: 1.5, acid: 6.0, bitterness: 1, complexity: 2, color: '#d9f99d' },
+  { id: 'juice_lemon', name: 'Zumo de Limón', type: 'citrus', abv: 0, sugar: 2.0, acid: 6.0, bitterness: 0.5, complexity: 1, color: '#fef08a' },
+  { id: 'juice_grapefruit', name: 'Zumo de Pomelo', type: 'citrus', abv: 0, sugar: 7.0, acid: 2.0, bitterness: 3, complexity: 3, color: '#fecaca' },
+  { id: 'juice_orange', name: 'Zumo de Naranja', type: 'citrus', abv: 0, sugar: 9.0, acid: 0.8, bitterness: 0, complexity: 2, color: '#fdba74' },
+  { id: 'juice_yuzu', name: 'Zumo de Yuzu', type: 'citrus', abv: 0, sugar: 1.5, acid: 4.5, bitterness: 2, complexity: 6, color: '#fef08a' },
+  { id: 'juice_pineapple', name: 'Zumo de Piña', type: 'citrus', abv: 0, sugar: 10.0, acid: 0.8, bitterness: 0, complexity: 3, color: '#fde047' },
+  { id: 'acid_solution_citric', name: 'Solución Ácido Cítrico (6%)', type: 'citrus', abv: 0, sugar: 0, acid: 6.0, bitterness: 0, complexity: 0, color: '#ffffff' },
+  { id: 'acid_solution_malic', name: 'Solución Ácido Málico (20%)', type: 'citrus', abv: 0, sugar: 0, acid: 20.0, bitterness: 1, complexity: 0, color: '#ffffff' },
+  { id: 'syrup_simple_11', name: 'Jarabe Simple (1:1)', type: 'syrup', abv: 0, sugar: 61.5, acid: 0, bitterness: 0, complexity: 0, color: '#ffffff' },
+  { id: 'syrup_rich_21', name: 'Jarabe Rico (2:1)', type: 'syrup', abv: 0, sugar: 80.0, acid: 0, bitterness: 0, complexity: 0, color: '#ffffff' },
+  { id: 'syrup_honey', name: 'Jarabe de Miel (3:1)', type: 'syrup', abv: 0, sugar: 75.0, acid: 0.1, bitterness: 0, complexity: 4, color: '#fcd34d' },
+  { id: 'syrup_agave', name: 'Sirope de Agave', type: 'syrup', abv: 0, sugar: 70.0, acid: 0, bitterness: 0, complexity: 3, color: '#fde047' },
+  { id: 'syrup_demerara', name: 'Sirope Demerara', type: 'syrup', abv: 0, sugar: 65.0, acid: 0, bitterness: 1, complexity: 3, color: '#d97706' },
+  { id: 'syrup_grenadine', name: 'Granadina (Real)', type: 'syrup', abv: 0, sugar: 65.0, acid: 0.5, bitterness: 0, complexity: 2, color: '#dc2626' },
+  { id: 'syrup_orgeat', name: 'Orgeat (Almendra)', type: 'syrup', abv: 0, sugar: 60.0, acid: 0, bitterness: 0, complexity: 5, color: '#f1f5f9' },
+  { id: 'syrup_falernum', name: 'Falernum (Sin Alcohol)', type: 'syrup', abv: 0, sugar: 50.0, acid: 0.2, bitterness: 2, complexity: 7, color: '#fef3c7' },
+  { id: 'syrup_ginger', name: 'Sirope de Jengibre', type: 'syrup', abv: 0, sugar: 60.0, acid: 0.1, bitterness: 2, complexity: 3, color: '#fef9c3' },
+  { id: 'syrup_passion', name: 'Sirope de Maracuyá', type: 'syrup', abv: 0, sugar: 60.0, acid: 2.0, bitterness: 0, complexity: 4, color: '#fbbf24' },
+  { id: 'cordial_lime', name: 'Cordial de Lima (Rose\'s)', type: 'syrup', abv: 0, sugar: 50.0, acid: 2.5, bitterness: 1, complexity: 1, color: '#d9f99d' },
+  { id: 'maple_syrup', name: 'Sirope de Arce (Grado A)', type: 'syrup', abv: 0, sugar: 66.0, acid: 0, bitterness: 1, complexity: 5, color: '#92400e' },
+  { id: 'liq_cointreau', name: 'Cointreau / Triple Sec', type: 'liqueur', abv: 40, sugar: 25.0, acid: 0, bitterness: 1, complexity: 3, color: '#ffffff' },
+  { id: 'liq_curacao', name: 'Dry Curaçao (Pierre Ferrand)', type: 'liqueur', abv: 40, sugar: 20.0, acid: 0, bitterness: 2, complexity: 6, color: '#fbbf24' },
+  { id: 'liq_blue_curacao', name: 'Blue Curaçao', type: 'liqueur', abv: 20, sugar: 30.0, acid: 0, bitterness: 1, complexity: 2, color: '#2563eb' },
+  { id: 'liq_maraschino', name: 'Licor Maraschino', type: 'liqueur', abv: 32, sugar: 35.0, acid: 0, bitterness: 0, complexity: 5, color: '#ffffff' },
+  { id: 'liq_campari', name: 'Campari', type: 'bitter', abv: 25, sugar: 24.0, acid: 0, bitterness: 9, complexity: 8, color: '#dc2626' },
+  { id: 'liq_aperol', name: 'Aperol', type: 'bitter', abv: 11, sugar: 25.0, acid: 0, bitterness: 6, complexity: 5, color: '#f97316' },
+  { id: 'liq_cynar', name: 'Cynar', type: 'bitter', abv: 16.5, sugar: 20.0, acid: 0, bitterness: 8, complexity: 8, color: '#3f2c22' },
+  { id: 'liq_fernet', name: 'Fernet Branca', type: 'bitter', abv: 39, sugar: 8.0, acid: 0, bitterness: 10, complexity: 9, color: '#1a1006' },
+  { id: 'vermouth_sweet', name: 'Vermut Rojo (Dulce)', type: 'liqueur', abv: 16, sugar: 16.0, acid: 0.4, bitterness: 3, complexity: 6, color: '#7f1d1d' },
+  { id: 'vermouth_dry', name: 'Vermut Dry (Seco)', type: 'liqueur', abv: 18, sugar: 3.0, acid: 0.5, bitterness: 2, complexity: 5, color: '#fefce8' },
+  { id: 'vermouth_bianco', name: 'Vermut Bianco', type: 'liqueur', abv: 16, sugar: 14.0, acid: 0.4, bitterness: 2, complexity: 5, color: '#fefce8' },
+  { id: 'sherry_fino', name: 'Jerez Fino/Manzanilla', type: 'liqueur', abv: 15, sugar: 0, acid: 0.4, bitterness: 1, complexity: 7, color: '#fefce8' },
+  { id: 'sherry_px', name: 'Jerez Pedro Ximénez', type: 'liqueur', abv: 17, sugar: 40.0, acid: 0.4, bitterness: 0, complexity: 9, color: '#3f2c22' },
+  { id: 'chartreuse_green', name: 'Chartreuse Verde', type: 'liqueur', abv: 55, sugar: 25.0, acid: 0, bitterness: 4, complexity: 10, color: '#84cc16' },
+  { id: 'chartreuse_yellow', name: 'Chartreuse Amarillo', type: 'liqueur', abv: 40, sugar: 28.0, acid: 0, bitterness: 2, complexity: 9, color: '#facc15' },
+  { id: 'liq_coffee', name: 'Licor de Café (Kahlúa)', type: 'liqueur', abv: 20, sugar: 40.0, acid: 0.1, bitterness: 3, complexity: 4, color: '#3f2c21' },
+  { id: 'liq_amaretto', name: 'Amaretto', type: 'liqueur', abv: 28, sugar: 30.0, acid: 0, bitterness: 1, complexity: 3, color: '#d97706' },
+  { id: 'liq_stgermain', name: 'St. Germain (Sauco)', type: 'liqueur', abv: 20, sugar: 25.0, acid: 0, bitterness: 0, complexity: 5, color: '#fef9c3' },
+  { id: 'liq_benedictine', name: 'Bénédictine', type: 'liqueur', abv: 40, sugar: 32.0, acid: 0, bitterness: 1, complexity: 8, color: '#b45309' },
+  { id: 'liq_baileys', name: 'Crema Irlandesa (Baileys)', type: 'liqueur', abv: 17, sugar: 20.0, acid: 0, bitterness: 0, complexity: 3, color: '#d6d3d1' },
+  { id: 'mix_soda', name: 'Agua con Gas / Soda', type: 'mixer', abv: 0, sugar: 0, acid: 0, bitterness: 0, complexity: 0, color: '#ffffff' },
+  { id: 'mix_tonic', name: 'Tónica', type: 'mixer', abv: 0, sugar: 9.0, acid: 0.5, bitterness: 4, complexity: 2, color: '#ffffff' },
+  { id: 'mix_cola', name: 'Cola', type: 'mixer', abv: 0, sugar: 10.6, acid: 0.1, bitterness: 1, complexity: 3, color: '#3f2c22' },
+  { id: 'mix_gingerbeer', name: 'Ginger Beer', type: 'mixer', abv: 0, sugar: 12.0, acid: 0.1, bitterness: 3, complexity: 3, color: '#fef08a' },
+  { id: 'mix_gingerale', name: 'Ginger Ale', type: 'mixer', abv: 0, sugar: 9.0, acid: 0.1, bitterness: 1, complexity: 1, color: '#fefce8' },
+  { id: 'mix_coconut_water', name: 'Agua de Coco', type: 'mixer', abv: 0, sugar: 4.0, acid: 0, bitterness: 0, complexity: 2, color: '#ffffff' },
+  { id: 'mix_coffee', name: 'Café Espresso', type: 'mixer', abv: 0, sugar: 0, acid: 1.0, bitterness: 6, complexity: 6, color: '#1a1006' },
+  { id: 'mix_cream', name: 'Nata Líquida', type: 'mixer', abv: 0, sugar: 3.0, acid: 0, bitterness: 0, complexity: 1, color: '#ffffff' },
+  { id: 'egg_white', name: 'Clara de Huevo', type: 'mixer', abv: 0, sugar: 0, acid: 0, bitterness: 0, complexity: 0, color: '#ffffff' },
+  { id: 'bitter_angostura', name: 'Angostura Bitters', type: 'bitter', abv: 44.7, sugar: 0, acid: 0, bitterness: 10, complexity: 10, color: '#7f1d1d' },
+  { id: 'bitter_orange', name: 'Orange Bitters', type: 'bitter', abv: 39, sugar: 5.0, acid: 0, bitterness: 8, complexity: 8, color: '#f97316' },
+  { id: 'bitter_peychaud', name: 'Peychaud\'s Bitters', type: 'bitter', abv: 35, sugar: 10.0, acid: 0, bitterness: 7, complexity: 8, color: '#ef4444' },
+];
+
+export function getAllIngredients(): Ingredient[] {
+  return [...INGREDIENTS_DB].sort((a, b) => a.name.localeCompare(b.name));
+}
+
+export function getIngredientById(id: string): Ingredient | undefined {
+  return INGREDIENTS_DB.find((i) => i.id === id);
+}

package/src/tool/cocktailBalancer/data/Presets.ts

@@ -0,0 +1,122 @@
+export interface PresetRecipe {
+  id: string;
+  name: string;
+  icon: string;
+  ingredients: { id: string; vol: number }[];
+  description?: string;
+}
+
+export const COCKTAIL_PRESETS: PresetRecipe[] = [
+  {
+    id: "daiquiri",
+    name: "Daiquiri Clásico",
+    icon: "mdi:glass-cocktail",
+    description: "El estándar de oro del equilibrio Sour.",
+    ingredients: [
+      { id: "rum_white", vol: 60 },
+      { id: "juice_lime", vol: 30 },
+      { id: "syrup_simple_11", vol: 22.5 },
+    ],
+  },
+  {
+    id: "margarita_tommys",
+    name: "Tommy's Margarita",
+    icon: "mdi:glass-cocktail",
+    description: "Versión moderna resaltando el agave.",
+    ingredients: [
+      { id: "tequila_blanco", vol: 60 },
+      { id: "juice_lime", vol: 30 },
+      { id: "syrup_agave", vol: 15 },
+    ],
+  },
+  {
+    id: "whiskey_sour",
+    name: "Whiskey Sour",
+    icon: "mdi:glass-cocktail",
+    description: "Cuerpo, acidez y carácter.",
+    ingredients: [
+      { id: "whiskey_bourbon", vol: 60 },
+      { id: "juice_lemon", vol: 30 },
+      { id: "syrup_simple_11", vol: 22.5 },
+    ],
+  },
+  {
+    id: "gimlet",
+    name: "Gimlet (Fresco)",
+    icon: "mdi:glass-cocktail",
+    description: "Gin y lima, afilado y refrescante.",
+    ingredients: [
+      { id: "gin_std", vol: 60 },
+      { id: "juice_lime", vol: 30 },
+      { id: "syrup_simple_11", vol: 22.5 },
+    ],
+  },
+  {
+    id: "negroni",
+    name: "Negroni",
+    icon: "mdi:glass-cocktail",
+    description: "El rey del aperitivo. Amargo y dulce.",
+    ingredients: [
+      { id: "gin_std", vol: 30 },
+      { id: "vermouth_sweet", vol: 30 },
+      { id: "liq_campari", vol: 30 },
+    ],
+  },
+  {
+    id: "mai_tai",
+    name: "Mai Tai Tradicional",
+    icon: "mdi:palm-tree",
+    description: "Complejidad tropical tiki.",
+    ingredients: [
+      { id: "rum_aged", vol: 60 },
+      { id: "juice_lime", vol: 30 },
+      { id: "liq_curacao", vol: 15 },
+      { id: "syrup_orgeat", vol: 7.5 },
+      { id: "syrup_rich_21", vol: 7.5 },
+    ],
+  },
+  {
+    id: "pisco_sour",
+    name: "Pisco Sour",
+    icon: "mdi:glass-cocktail",
+    description: "El clásico peruano.",
+    ingredients: [
+      { id: "pisco_quebranta", vol: 60 },
+      { id: "juice_lime", vol: 30 },
+      { id: "syrup_simple_11", vol: 22.5 },
+    ],
+  },
+  {
+    id: "tom_collins",
+    name: "Tom Collins",
+    icon: "mdi:glass-cocktail",
+    description: "Limonada de adultos.",
+    ingredients: [
+      { id: "gin_std", vol: 60 },
+      { id: "juice_lemon", vol: 30 },
+      { id: "syrup_simple_11", vol: 15 },
+      { id: "mix_soda", vol: 60 },
+    ],
+  },
+  {
+    id: "old_fashioned",
+    name: "Old Fashioned",
+    icon: "mdi:glass-cocktail",
+    description: "El cóctel original.",
+    ingredients: [
+      { id: "whiskey_bourbon", vol: 60 },
+      { id: "syrup_simple_11", vol: 7.5 },
+    ],
+  },
+  {
+    id: "boulevardier",
+    name: "Boulevardier",
+    icon: "mdi:glass-cocktail",
+    description: "El primo rico del Negroni.",
+    ingredients: [
+      { id: "whiskey_bourbon", vol: 45 },
+      { id: "vermouth_sweet", vol: 30 },
+      { id: "liq_campari", vol: 30 },
+    ],
+  },
+];

package/src/tool/cocktailBalancer/domain/Ingredient.ts

@@ -0,0 +1,29 @@
+export interface Ingredient {
+  id: string;
+  name: string;
+  type: 'spirit' | 'citrus' | 'syrup' | 'liqueur' | 'bitter' | 'mixer' | 'other';
+  abv: number;
+  sugar: number;
+  acid: number;
+  bitterness?: number;
+  complexity?: number;
+  color?: string;
+}
+
+export interface CocktailComponent {
+  ingredient: Ingredient;
+  volumeMl: number;
+}
+
+export interface CocktailStats {
+  totalVolumeMl: number;
+  finalAbv: number;
+  totalSugarGrams: number;
+  totalAcidGrams: number;
+  sugarConcentration: number;
+  acidConcentration: number;
+  balanceRatio: number;
+  bitternessIndex: number;
+  complexityIndex: number;
+  finalColor: string;
+}

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

@@ -0,0 +1,193 @@
+import type { WithContext, SoftwareApplication } from 'schema-dts';
+import type { CocktailBalancerUI, CocktailBalancerLocaleContent } from '../index';
+
+const slug = 'cocktail-balancer';
+const title = 'Cocktail Balancer - The Sour Law';
+const description = 'Calculate the perfect balance between sweet and sour for your cocktails. Master the golden ratio of mixology.';
+
+const ui: CocktailBalancerUI = {
+  title: 'Cocktail Balancer',
+  presetsBtn: 'Recipes',
+  saveBtn: 'Save',
+  resetBtn: 'Reset',
+  emptyStateTitle: 'Your Workbench is Empty',
+  emptyStateDescription: 'Add ingredients to analyze your cocktail balance in real-time.',
+  addBtn: 'Add Ingredient',
+  addMoreBtn: 'Add Another Ingredient',
+  flavorProfileTitle: 'Flavor Profile',
+  volLabel: 'Volume',
+  sugarLabel: 'Sugar',
+  colorLabel: 'Color',
+  sourLawTitle: 'Sour Law',
+  acidDryLabel: 'Acid (Dry)',
+  balanceLabel: 'Balance',
+  sweetLabel: 'Sweet',
+  aiSuggestionTitle: 'AI Suggestion',
+  addIngredientTitle: 'Add Ingredient',
+  searchPlaceholder: 'Search rum, lime, syrup...',
+  presetsTitle: 'Recipes & Presets',
+  savedSectionTitle: 'My Saved',
+  classicsSectionTitle: 'Classics',
+  confirmDeleteTitle: 'Delete everything?',
+  confirmDeleteText: 'This will remove all ingredients from your workbench. This action cannot be undone.',
+  cancelBtn: 'Cancel',
+  deleteBtn: 'Delete',
+  verdictSpiritSeco: 'Spirituous / Dry',
+  verdictSoloDulce: 'Sweet Only (Old Fashioned)',
+  verdictMuyAcido: 'Too Acidic / Bone Dry',
+  verdictAcido: 'Acidic / Tart',
+  verdictEquilibrado: 'Balanced (Sour)',
+  verdictDulce: 'Sweet / Commercial',
+  verdictEmpalagoso: 'Cloying',
+  fixAddBitters: 'Missing Bitterness',
+  fixAddSugar: 'Too Acidic',
+  fixAddAcid: 'Too Sweet'
+};
+
+const faqTitle = 'Frequently Asked Questions';
+const bibliographyTitle = 'Bibliography & Sources';
+
+const faq: CocktailBalancerLocaleContent['faq'] = [
+  {
+    question: "What is the 'Sour Law'?",
+    answer: "It is the golden ratio of mixology that balances three elements: the strong base (spirit), the sour (citrus), and the sweet (syrups). A classic recipe usually follows the 2:1:1 ratio (Strong:Sour:Sweet), although this varies depending on strength and density.",
+  },
+  {
+    question: "How does dilution affect cocktail balance?",
+    answer: "Ice doesn't just cool; it adds water (dilution) which opens up the spirit's aromas and softens the peaks of acidity and sweetness. A balanced cocktail in the shaker can become unbalanced if left too long with ice in the glass.",
+  },
+  {
+    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.",
+  },
+];
+
+const howTo: CocktailBalancerLocaleContent['howTo'] = [
+  {
+    name: "Select the alcoholic base",
+    text: "Choose the main spirit (Gin, Rum, Whiskey) from our database to know its body and alcohol contribution.",
+  },
+  {
+    name: "Enter the acidic agent",
+    text: "Add the volume of lemon, lime, or grapefruit juice. The calculator will analyze the pH impact on the mix.",
+  },
+  {
+    name: "Adjust the sweet component",
+    text: "Enter the type of syrup (simple, 2:1, agave) and watch the balance indicator move in real-time.",
+  },
+];
+
+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",
+  },
+  {
+    name: "The Bar Book: Elements of Cocktail Technique - Jeffrey Morgenthaler",
+    url: "https://jeffreymorgenthaler.com/the-bar-book/",
+  },
+  {
+    name: "Cocktail Balance - Difford's Guide",
+    url: "https://www.diffordsguide.com/encyclopedia/1066/cocktails/cocktail-balance",
+  },
+];
+
+const seo: CocktailBalancerLocaleContent['seo'] = [
+  {
+    type: 'title',
+    text: 'Molecular Engineering & Liquid Balance',
+    level: 2
+  },
+  {
+    type: 'paragraph',
+    html: 'Welcome to the digital laboratory where intuition meets mathematics. This tool is not a simple recipe book; it is an <strong>advanced physical-chemical simulator</strong> designed to deconstruct and analyze the molecular structure of your cocktails in real-time. Every drop of citrus, every measure of spirit, every gram of syrup interacts according to immutable chemical laws that determine whether your drink will be a masterpiece or a disappointing failure.'
+  },
+  {
+    type: 'stats',
+    items: [
+      { label: 'Lime', value: '~6% Acid', icon: 'mdi:fruit-citrus' },
+      { label: 'Lemon', value: '~6% Acid', icon: 'mdi:fruit-citrus' },
+      { label: 'Grapefruit', value: '~1-2% Acid', icon: 'mdi:fruit-citrus' }
+    ],
+    columns: 3
+  },
+  {
+    type: 'card',
+    title: 'The Science of Acid',
+    icon: 'mdi:fruit-citrus',
+    html: 'Acidity is not just a flavor; it is the structural backbone of any balanced cocktail. Without the correct acidity, a drink becomes flat, one-dimensional, and forgettable. Our algorithm distinguishes the titratable acidity of a Persian lime versus a Eureka lemon, accounting for seasonal variations in citrus pH that can shift your recipe by an entire balance point on the palate.'
+  },
+  {
+    type: 'card',
+    title: 'Brix Control (Sweetness)',
+    icon: 'mdi:spoon-sugar',
+    html: 'The body and texture of your cocktail depends entirely on dissolved sugar. A Simple Syrup (1:1) behaves very differently from a Rich Syrup (2:1), honey, or agave nectar. Each sweetener has a different Brix degree and viscosity that affects how the drink coats the tongue. Our calculator computes the exact grams of dissolved sugar to predict final mouthfeel and sweetness perception.'
+  },
+  {
+    type: 'card',
+    title: 'Thermodynamics and Dilution',
+    icon: 'mdi:water-percent',
+    html: 'A shaken cocktail dilutes by 25-40% depending on the ice temperature, shaking technique, and duration. This water addition is not a flaw; it is an essential ingredient that opens aromas and softens the alcohol edge. Our calculator estimates the Final ABV after dilution, so you can engineer drinks with precisely the intended strength and flavour balance.'
+  },
+  {
+    type: 'title',
+    text: 'Beyond the Basic Ratio',
+    level: 2
+  },
+  {
+    type: 'paragraph',
+    html: 'Many bartenders learn the classic 2:1:1 rule (2 parts spirit, 1 part sour, 1 part sweet) and treat it as universal truth. However, <strong>chemistry is far more nuanced</strong>. A lemon from Sicily contains different acidity than a lime from Mexico. A triple sec like Cointreau behaves radically differently from a blue Curaçao. The same recipe can taste perfectly balanced one week and brutally acidic the next, simply due to seasonal fruit variation.'
+  },
+  {
+    type: 'paragraph',
+    html: 'This balancer breaks through those simplistic barriers. By entering your specific ingredients, you consult a living database that dynamically adjusts acidity and sweetness vectors to offer a precise sensory map of your creation. Stop guessing and start engineering your cocktails with the same scientific rigour that bartenders at world-class establishments use every single service.'
+  },
+  {
+    type: 'summary',
+    title: 'Who is this tool for?',
+    items: [
+      'Professional Bartenders: Standardize recipes and create signature menus with reproducible consistency.',
+      'Home Enthusiasts: Stop guessing and start understanding why your cocktails succeed or fail.',
+      'Beverage Developers: Rapidly prototype new flavour concepts before expensive production runs.'
+    ]
+  },
+  {
+    type: 'diagnostic',
+    title: 'The Golden Zone',
+    icon: 'mdi:star',
+    variant: 'success',
+    badge: 'Goal',
+    html: 'This is the ultimate objective: a controlled pH where sugar neutralizes the aggression of acid without masking the essential oils and aromatic compounds of the base spirit. This precise balance is where immortal classics live — the Daiquiri, the Margarita, the Sidecar — drinks that have survived decades because they obey the fundamental laws of flavour chemistry.'
+  },
+  {
+    type: 'tip',
+    title: 'Expert Tip: Always Use Fresh Citrus',
+    html: 'Always squeeze citrus at the last moment. Lemon and lime juice oxidizes quickly, losing live acidity within 20-30 minutes of juicing. A cocktail made with truly fresh juice will always have a brightness and vibrancy on the palate that no bottled product can replicate. Use fruit at room temperature to maximize juice yield.'
+  }
+];
+
+const schemas: CocktailBalancerLocaleContent['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: CocktailBalancerLocaleContent = {
+  slug,
+  title,
+  description,
+  ui,
+  seo,
+  faqTitle,
+  faq,
+  bibliographyTitle,
+  bibliography,
+  howTo,
+  schemas,
+};

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

@@ -0,0 +1,193 @@
+import type { WithContext, SoftwareApplication } from 'schema-dts';
+import type { CocktailBalancerUI, CocktailBalancerLocaleContent } from '../index';
+
+const slug = 'equilibrador-cocteles';
+const title = 'Equilibrador de Cócteles - La Ley del Sour';
+const description = 'Calcula el equilibrio perfecto entre dulce y ácido para tus cócteles. Domina la proporción áurea de la mixología.';
+
+const ui: CocktailBalancerUI = {
+  title: 'Cocktail Balancer',
+  presetsBtn: 'Recetas',
+  saveBtn: 'Guardar',
+  resetBtn: 'Reset',
+  emptyStateTitle: 'Tu Mesa de Trabajo está Vacía',
+  emptyStateDescription: 'Añade ingredientes para analizar el equilibrio de tu cóctel en tiempo real.',
+  addBtn: 'Añadir Ingrediente',
+  addMoreBtn: 'Añadir Otro Ingrediente',
+  flavorProfileTitle: 'Perfil de Sabor',
+  volLabel: 'Volumen',
+  sugarLabel: 'Azúcar',
+  colorLabel: 'Color',
+  sourLawTitle: 'Ley del Sour',
+  acidDryLabel: 'Ácido (Dry)',
+  balanceLabel: 'Equilibrio',
+  sweetLabel: 'Dulce (Sweet)',
+  aiSuggestionTitle: 'Sugerencia de la IA',
+  addIngredientTitle: 'Añadir Ingrediente',
+  searchPlaceholder: 'Buscar ron, lima, sirope...',
+  presetsTitle: 'Recetas & Presets',
+  savedSectionTitle: 'Mis Guardadas',
+  classicsSectionTitle: 'Clásicos',
+  confirmDeleteTitle: '¿Borrar todo?',
+  confirmDeleteText: 'Esta acción eliminará todos los ingredientes de tu mesa de trabajo. No se puede deshacer.',
+  cancelBtn: 'Cancelar',
+  deleteBtn: 'Borrar',
+  verdictSpiritSeco: 'Espirituoso / Seco',
+  verdictSoloDulce: 'Solo Dulce (Old Fashioned)',
+  verdictMuyAcido: 'Muy Ácido / Bone Dry',
+  verdictAcido: 'Ácido / Tart',
+  verdictEquilibrado: 'Equilibrado (Sour)',
+  verdictDulce: 'Dulce / Comercial',
+  verdictEmpalagoso: 'Empalagoso',
+  fixAddBitters: 'Falta Amargor',
+  fixAddSugar: 'Muy Ácido',
+  fixAddAcid: 'Muy Dulce'
+};
+
+const faqTitle = 'Preguntas Frecuentes';
+const bibliographyTitle = 'Bibliografía y Fuentes';
+
+const faq: CocktailBalancerLocaleContent['faq'] = [
+  {
+    question: "¿Qué es la 'Ley del Sour'?",
+    answer: "Es la proporción áurea de la coctelería que equilibra tres elementos: la base fuerte (destilado), lo ácido (cítricos) y lo dulce (siropes). Una receta clásica suele seguir el ratio 2:1:1 (Fuerte:Ácido:Dulce), aunque este varía según la graduación y densidad.",
+  },
+  {
+    question: "¿Cómo afecta la dilución al equilibrio del cóctel?",
+    answer: "El hielo no solo enfría; aporta agua (dilución) que abre los aromas del destilado y suaviza los picos de acidez y dulzor. Un cóctel equilibrado en la coctelera puede descompensarse si se deja demasiado tiempo con hielo en el vaso.",
+  },
+  {
+    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.",
+  },
+];
+
+const howTo: CocktailBalancerLocaleContent['howTo'] = [
+  {
+    name: "Seleccionar la base alcohólica",
+    text: "Elige el destilado principal (Gin, Ron, Whisky) de nuestra base de datos para conocer su aporte de cuerpo y alcohol.",
+  },
+  {
+    name: "Introducir el agente ácido",
+    text: "Añade el volumen de zumo de limón, lima o pomelo. La calculadora analizará el impacto del pH en la mezcla.",
+  },
+  {
+    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.",
+  },
+];
+
+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",
+  },
+  {
+    name: "The Bar Book: Elements of Cocktail Technique - Jeffrey Morgenthaler",
+    url: "https://jeffreymorgenthaler.com/the-bar-book/",
+  },
+  {
+    name: "Cocktail Balance - Difford's Guide",
+    url: "https://www.diffordsguide.com/encyclopedia/1066/cocktails/cocktail-balance",
+  },
+];
+
+const seo: CocktailBalancerLocaleContent['seo'] = [
+  {
+    type: 'title',
+    text: 'Ingeniería Molecular & Equilibrio Líquido',
+    level: 2
+  },
+  {
+    type: 'paragraph',
+    html: 'Bienvenido al laboratorio digital donde la intuición se encuentra con la matemática. Esta herramienta no es un simple recetario; es un <strong>simulador físico-químico avanzado</strong> diseñado para deconstruir y analizar la estructura molecular de tus cócteles en tiempo real, garantizando la perfección en cada copa.'
+  },
+  {
+    type: 'stats',
+    items: [
+      { label: 'Lima', value: '~6% Ácido', icon: 'mdi:fruit-citrus' },
+      { label: 'Limón', value: '~6% Ácido', icon: 'mdi:fruit-citrus' },
+      { label: 'Pomelo', value: '~1-2% Ácido', icon: 'mdi:fruit-citrus' }
+    ],
+    columns: 3
+  },
+  {
+    type: 'card',
+    title: 'La Ciencia del Ácido',
+    icon: 'mdi:fruit-citrus',
+    html: 'La acidez no es solo sabor; es estructura. Un cóctel sin la acidez correcta es plano y aburrido. Nuestro algoritmo distingue la potencia titulerable de una lima persa frente a un limón eureka o una naranja dulce.'
+  },
+  {
+    type: 'card',
+    title: 'Control de Brix (Dulzura)',
+    icon: 'mdi:spoon-sugar',
+    html: 'El "cuerpo" de tu bebida depende del azúcar. No es lo mismo usar un Jarabe Simple (1:1) que un Rich Syrup (2:1) o miel. Calculamos los gramos exactos de azúcar disuelta para predecir la textura final.'
+  },
+  {
+    type: 'card',
+    title: 'Termodinámica y Dilución',
+    icon: 'mdi:water-percent',
+    html: 'Un cóctel agitado se diluye entre un 25-40% dependiendo del hielo y la técnica. Nuestra calculadora estima el ABV Final antes de que agites la coctelera, permitiéndote diseñar bebidas con la potencia exacta deseada.'
+  },
+  {
+    type: 'title',
+    text: 'Más allá de la "Regla de Tres"',
+    level: 2
+  },
+  {
+    type: 'paragraph',
+    html: 'Muchos bartenders aprenden fórmulas básicas como la regla 2:1:1 (2 partes de alcohol, 1 de acido, 1 de dulce). Sin embargo, <strong>la química es caprichosa</strong>. Un limón de Sicilia no tiene la misma acidez que una lima de Brasil. Un licor de naranja como el Cointreau se comporta radicalmente distinto a un Curaçao.'
+  },
+  {
+    type: 'paragraph',
+    html: 'Este equilibrador rompe esas barreras simplistas. Al introducir ingredientes en nuestro sistema, estás consultando una base de datos viva que ajusta los vectores de acidez y dulzor para ofrecerte un mapa sensorial preciso de tu creación antes de gastar una sola gota de licor caro.'
+  },
+  {
+    type: 'summary',
+    title: '¿Para quién es esta herramienta?',
+    items: [
+      'Bartenders Profesionales: Para estandarizar recetas y crear menús de autor.',
+      'Entusiastas del Hogar: Para dejar de adivinar y empezar a entender los fallos.',
+      'Desarrolladores de Bebidas: Para prototipar rápidamente conceptos de sabor.'
+    ]
+  },
+  {
+    type: 'diagnostic',
+    title: 'La Zona Dorada',
+    icon: 'mdi:star',
+    variant: 'success',
+    badge: 'Objetivo',
+    html: 'Este es el objetivo final: un pH controlado donde el azúcar neutraliza la agresión del ácido sin enmascarar los aceites esenciales y los compuestos aromáticos del alcohol base. Aquí viven los clásicos inmortales: el Daiquiri, la Margarita, el Sidecar. Bebidas que han sobrevivido décadas porque obedecen las leyes fundamentales de la química del sabor.'
+  },
+  {
+    type: 'tip',
+    title: 'Consejo Experto: Usa Siempre Cítricos Frescos',
+    html: 'Exprime siempre los cítricos en el último momento. El zumo de limón y lima se oxida rápidamente, perdiendo su acidez viva en 20-30 minutos tras la extracción. Un cóctel elaborado con zumo verdaderamente fresco siempre tendrá una brillantez y vivacidad en el paladar que ningún producto embotellado puede replicar. Usa fruta a temperatura ambiente para maximizar el rendimiento del zumo.'
+  }
+];
+
+const schemas: CocktailBalancerLocaleContent['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: CocktailBalancerLocaleContent = {
+  slug,
+  title,
+  description,
+  ui,
+  seo,
+  faqTitle,
+  faq,
+  bibliographyTitle,
+  bibliography,
+  howTo,
+  schemas,
+};