@jjlmoya/utils-cooking 1.2.0

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

@@ -0,0 +1,289 @@
+import type { ToolLocaleContent } from "../../../types";
+
+export const content: ToolLocaleContent = {
+  slug: "pizza",
+  title: "Calculadora de Masa Pizza Napolitana",
+  description:
+    "Calcula las proporciones exactas de harina, agua, sal y levadura para preparar la auténtica pizza napolitana en casa.",
+  faqTitle: "Preguntas Frecuentes",
+  bibliographyTitle: "Referencias",
+  ui: {
+    parameters: "Parámetros",
+    quantity: "Cantidad",
+    pizzas: "pizzas",
+    weight: "Peso por bola",
+    small: "Pequeña (180g)",
+    standard: "Estándar (260g)",
+    large: "Grande (350g)",
+    hydration: "Hidratación",
+    classic: "Clásica (55-60%)",
+    modern: "Moderna (65-70%)",
+    high: "Alta (75%+)",
+    salt: "Sal",
+    fermentation_tip_title: "Tip de Fermentación",
+    fermentation_tip:
+      "Para una masa más digerible y sabrosa, deja fermentar la masa en bloque durante 24h en nevera (4°C) usando <strong>0.3g</strong> de levadura fresca por cada 100g de harina.",
+    your_recipe: "Tu Receta",
+    fresh_yeast: "Levadura Fresca",
+    dry_yeast: "Seca",
+    flour: "Harina (W260-300)",
+    water: "Agua",
+    salt_label: "Sal Marina",
+    yeast: "Levadura",
+    yeast_note: "Para 8h a T.A. (20°C)",
+    total_weight: "Peso Total Masa",
+    approx: "aprox.",
+    visual_note:
+      "El tamaño visual representa el diámetro aproximado de la pizza estirada según el peso de la bola.",
+  },
+  faq: [
+    {
+      question: "¿Cuál es la hidratación ideal para la pizza napolitana?",
+      answer:
+        "Según el protocolo AVPN, la hidratación estándar es 63-67%. Para principiantes, 60-62% es más manejable. Para pizzeros avanzados con harina fuerte (W300+), 70-75% produce masas extraordinarias pero requiere técnica.",
+    },
+    {
+      question: "¿Cuánto tiempo debe fermentar la masa?",
+      answer:
+        "Mínimo 24 horas en nevera (4°C) para activar las enzimas. El óptimo es 48-72 horas. Más allá de 72 horas, necesitas harina muy fuerte (W300+) o la masa se vuelve ácida.",
+    },
+    {
+      question: "¿Se puede hacer con levadura seca?",
+      answer:
+        "Sí. La levadura seca equivale a 0.4x la fresca (1g seca = 2.5g fresca). La calidad es similar, pero la fresca aporta un sabor más completo.",
+    },
+    {
+      question: "¿Puedo hacer pizza napolitana en horno doméstico?",
+      answer:
+        "Sí, pero con adaptaciones. Precalienta a máximo (250-280°C) con piedra refractaria 45-60 minutos. La cocción durará 5-7 minutos en lugar de 60-90 segundos, pero el resultado es aceptable.",
+    },
+    {
+      question: "¿Qué harina debo usar?",
+      answer:
+        "Ideal: Caputo Pizzeria (W260-280) o Manitoba (W350-400). Alternativa: cualquier harina con 11-13g de proteína por 100g. Evita harinas débiles (W130-160) para fermentaciones largas.",
+    },
+    {
+      question: "¿La masa se rompe al estirar?",
+      answer:
+        "El gluten no está relajado. Deja reposar la bola 2-3 horas a temperatura ambiente. Si repites el error, el amasado fue insuficiente o la harina es muy débil.",
+    },
+  ],
+  howTo: [
+    {
+      name: "Calcula las proporciones",
+      text: "Usa esta calculadora para obtener los gramos exactos de cada ingrediente según el número de pizzas y el peso de cada bola.",
+    },
+    {
+      name: "Mezcla la masa",
+      text: "Combina la harina con agua tibia (22-25°C), sal (disuelta primero) y levadura. Amasa 8-10 minutos con amasadora o 15-20 minutos a mano.",
+    },
+    {
+      name: "Fermenta en bloque",
+      text: "Deja fermentar la masa entera 1-2 horas a temperatura ambiente (20-25°C) hasta que doble volumen.",
+    },
+    {
+      name: "Divide en bolas",
+      text: "Divide la masa en porciones del peso indicado. Deja reposar 15-20 minutos antes de formar bolas.",
+    },
+    {
+      name: "Fermentación larga",
+      text: "Coloca las bolas en recipiente hermético en nevera (4°C) durante 24-72 horas. Éste es el paso crítico que genera sabor y digestibilidad.",
+    },
+    {
+      name: "Estira y hornea",
+      text: "Saca del frío 30 minutos antes. Estira desde el centro hacia afuera. Hornea a máxima temperatura 60-90 segundos (leña) o 5-7 minutos (doméstico).",
+    },
+  ],
+  bibliography: [
+    {
+      name: "Associazione Verace Pizza Napoletana",
+      url: "https://www.pizzanapoletana.org/",
+    },
+    {
+      name: "The Pizza Bible - Tony Gemignani",
+      url: "https://www.amazon.es/Pizza-Bible-Everything-Need-Perfect/dp/0393634039/",
+    },
+    {
+      name: "Franco Pepe - Pepe in Grani",
+      url: "https://www.pepeingranitalia.com/",
+    },
+    {
+      name: "Harina Caputo",
+      url: "https://www.caputoprepara.com/",
+    },
+  ],
+	seo: [
+		{
+			type: 'title',
+			text: 'Guía Maestro para la Masa de Pizza Napolitana Auténtica',
+			level: 2,
+		},
+		{
+			type: 'paragraph',
+			html: 'La <strong>pizza napolitana</strong> es mucho más que una receta: es un legado cultural protegido que exige precisión milimétrica. La base del éxito no reside solo en los ingredientes, sino en entender la interacción de las variables de tiempo, temperatura e hidratación.',
+		},
+		{
+			type: 'stats',
+			columns: 4,
+			items: [
+				{
+					value: '480°C',
+					label: 'Temp. Cocción Ideal',
+					icon: 'mdi:fire',
+				},
+				{
+					value: '60-90s',
+					label: 'Tiempo en Horno',
+					icon: 'mdi:clock-fast',
+				},
+				{
+					value: '65%',
+					label: 'Hidratación Estándar',
+					icon: 'mdi:water-percent',
+				},
+				{
+					value: 'W280',
+					label: 'Fuerza de Harina',
+					icon: 'mdi:grain',
+				},
+			],
+		},
+		{
+			type: 'title',
+			text: 'La Importancia Crucial de la Hidratación',
+			level: 3,
+		},
+		{
+			type: 'paragraph',
+			html: 'La hidratación (porcentaje de agua respecto al peso de la harina) determina la textura del <strong>cornicione</strong>. Dominar este parámetro es lo que separa a un aficionado de un maestro pizzero.',
+		},
+		{
+			type: 'comparative',
+			columns: 3,
+			items: [
+				{
+					title: 'Hidratación 55-60%',
+					icon: 'mdi:water-minus',
+					description: 'Masa muy manejable, ideal para principiantes y hornos domésticos de baja temperatura.',
+					points: [
+						'Formación fácil de la malla de gluten',
+						'Masa menos pegajosa',
+						'Corteza crujiente y firme',
+					],
+				},
+				{
+					title: 'Hidratación 63-67%',
+					icon: 'mdi:water',
+					description: 'El estándar de la AVPN. Equilibrio perfecto para una masa ligera con alveolatura visible.',
+					highlight: true,
+					points: [
+						'Textura elástica tradicional',
+						'Ideal para hornos de leña',
+						'Requiere técnica de amasado media',
+					],
+				},
+				{
+					title: 'Hidratación 70%+',
+					icon: 'mdi:water-plus',
+					description: 'Pizzas contemporáneas con bordes gigantes. Muy difícil de manejar sin técnica avanzada.',
+					points: [
+						'Alvéolos extremadamente grandes',
+						'Masa muy ligera y digestible',
+						'Necesita harinas de gran fuerza',
+					],
+				},
+			],
+		},
+		{
+			type: 'title',
+			text: 'Tipos de Levadura y Cuál Elegir',
+			level: 3,
+		},
+		{
+			type: 'comparative',
+			columns: 2,
+			items: [
+				{
+					title: 'Levadura Fresca Prensada',
+					icon: 'mdi:bread-slice-outline',
+					description: 'La opción tradicional preferida por los maestros pizzeros. Aporta un perfil de sabor más complejo.',
+					points: [
+						'Sabor más profundo y limpio',
+						'Acción enzimática más equilibrada',
+						'Se disuelve fácilmente en agua tibia',
+						'Caducidad corta (requiere frescura)',
+					],
+				},
+				{
+					title: 'Levadura Seca Instantánea',
+					icon: 'mdi:shaker-outline',
+					description: 'Mucho más estable y fácil de almacenar. Ideal para tener siempre disponible en la despensa.',
+					points: [
+						'Larga conservación (hasta 2 años)',
+						'No necesita rehidratación previa',
+						'Tres veces más potente que la fresca',
+						'Sabor ligeramente más neutro',
+					],
+				},
+			],
+		},
+		{
+			type: 'title',
+			text: 'Guía de Harinas por su Índice de Fuerza W',
+			level: 3,
+		},
+		{
+			type: 'table',
+			headers: ['Tipo de Harina', 'Fuerza (W)', 'Tiempo de Fermentación', 'Uso Recomendado'],
+			rows: [
+				['Harina Débil', 'W130-180', '4-8 horas', 'Repostería rápida'],
+				['Media Fuerza', 'W200-240', '8-24 horas', 'Pizza rápida o pan simple'],
+				['Harina de Fuerza', 'W260-320', '24-72 horas', 'Auténtica Pizza Napolitana'],
+				['Gran Fuerza', 'W350+', '72+ horas', 'Panettones o masas de alta hidratación'],
+			],
+		},
+		{
+			type: 'diagnostic',
+			variant: 'warning',
+			title: 'Control de Temperatura de Amasado',
+			html: 'La masa no debe superar los 24°C al terminar el amasado. El calor excesivo de la fricción degrada el gluten y acelera la fermentación erráticamente.',
+		},
+		{
+			type: 'title',
+			text: 'Glosario para el Futuro Maestro Pizzero',
+			level: 3,
+		},
+		{
+			type: 'glossary',
+			items: [
+				{
+					term: 'Cornicione',
+					definition: 'El borde elevado y aireado de la pizza. Debe estar lleno de alvéolos y no tener miga compacta.',
+				},
+				{
+					term: 'Maduración',
+					definition: 'Proceso enzimático distinto a la fermentación donde las proteínas y azúcares se descomponen para mejorar sabor y digestibilidad.',
+				},
+				{
+					term: 'Punto de Pasta',
+					definition: 'Momento en que la masa alcanza su elasticidad y resistencia óptima sin ser pegajosa.',
+				},
+				{
+					term: 'Autólisis',
+					definition: 'Reposo tras mezclar solo harina y agua que facilita el desarrollo del gluten sin esfuerzo mecánico.',
+				},
+			],
+		},
+		{
+			type: 'tip',
+			title: 'El truco de la Nevera',
+			html: 'La fermentación en bloque de 24 horas a 4°C no solo facilita el manejo de la masa, sino que crea sabores complejos imposibles de obtener a temperatura ambiente.',
+		},
+		{
+			type: 'paragraph',
+			html: 'Nuestra calculadora automatiza las proporciones para que puedas centrarte en lo más importante: la técnica y el amor por el producto final.',
+		},
+	],
+
+  schemas: [],
+};

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

@@ -0,0 +1,288 @@
+import type { ToolLocaleContent } from "../../../types";
+
+export const content: ToolLocaleContent = {
+  slug: "calculateur-pate-pizza-napolitaine-proportions-authentiques",
+  title: "Calculateur de Pâte à Pizza Napolitaine",
+  description:
+    "Calculez les proportions exactes de farine, eau, sel et levure pour préparer une authentique pizza napolitaine maison avec des résultats professionnels.",
+  faqTitle: "Questions Fréquentes sur la Pâte à Pizza",
+  bibliographyTitle: "Références Scientifiques et Techniques",
+  ui: {
+    parameters: "Paramètres",
+    quantity: "Quantité",
+    pizzas: "pizzas",
+    weight: "Poids par boule",
+    small: "Petite (180g)",
+    standard: "Standard (260g)",
+    large: "Grande (350g)",
+    hydration: "Hydratation",
+    classic: "Classique (55-60%)",
+    modern: "Moderne (65-70%)",
+    high: "Haute (75%+)",
+    salt: "Sel",
+    fermentation_tip_title: "Conseil de Fermentation",
+    fermentation_tip:
+      "Pour une pâte plus digestible et savoureuse, laissez fermenter en bloc pendant 24h au réfrigérateur (4°C) avec <strong>0.3g</strong> de levure fraîche pour 100g de farine.",
+    your_recipe: "Votre Recette",
+    fresh_yeast: "Levure Fraîche",
+    dry_yeast: "Sèche",
+    flour: "Farine (W260-300)",
+    water: "Eau",
+    salt_label: "Sel Marin",
+    yeast: "Levure",
+    yeast_note: "Pour 8h à temp. ambiante (20°C)",
+    total_weight: "Poids Total de la Pâte",
+    approx: "env.",
+    visual_note:
+      "La taille visuelle représente le diamètre approximatif de la pizza étirée selon le poids de la boule.",
+  },
+  faq: [
+    {
+      question: "Quelle est l'hydratation idéale pour une pizza napolitaine ?",
+      answer:
+        "Selon le protocole AVPN, l'hydratation standard est de 63-67%. Pour les débutants, 60-62% est plus gérable. Pour les pizzaiolos avancés avec une farine forte (W300+), 70-75% produit des pâtes extraordinaires mais nécessite de la technique.",
+    },
+    {
+      question: "Combien de temps la pâte doit-elle fermenter ?",
+      answer:
+        "Minimum 24 heures au frigo (4°C) pour activer les enzymes. L'optimal est de 48-72 heures. Au-delà de 72 heures, il faut une farine très forte (W300+) sinon la pâte devient trop acide.",
+    },
+    {
+      question: "Puis-je utiliser de la levure sèche ?",
+      answer:
+        "Oui. La levure sèche équivaut à 0,4x la fraîche (1g sèche = 2,5g fraîche). La qualité est similaire, mais la levure fraîche apporte un profil aromatique plus complexe.",
+    },
+    {
+      question: "Peut-on faire une pizza napolitaine dans un four domestique ?",
+      answer:
+        "Oui, mais avec des adaptations. Préchauffez au maximum (250-280°C) avec une pierre réfractaire pendant 45-60 minutes. La cuisson prendra 5-7 minutes au lieu de 60-90 secondes, mais le résultat est acceptable.",
+    },
+    {
+      question: "Quelle farine dois-je utiliser ?",
+      answer:
+        "Idéal : Caputo Pizzeria (W260-280) ou Manitoba (W350-400). Alternative : toute farine avec 11-13g de protéines pour 100g. Évitez les farines faibles (W130-160) pour les longues fermentations.",
+    },
+    {
+      question: "Pourquoi la pâte se déchire-t-elle lors de l'étalage ?",
+      answer:
+        "Le gluten n'est pas détendu. Laissez la boule reposer 2 à 3 heures à température ambiante. Si cela se répète, le pétrissage était insuffisant ou la farine est trop faible.",
+    },
+  ],
+  howTo: [
+    {
+      name: "Calculez les proportions",
+      text: "Utilisez ce calculateur pour obtenir les grammes exacts de chaque ingrédient selon le nombre de pizzas et le poids de chaque boule.",
+    },
+    {
+      name: "Mélangez la pâte",
+      text: "Mélangez la farine avec de l'eau tiède (22-25°C), le sel (dissous en premier) et la levure. Pétrissez 8-10 minutes au batteur ou 15-20 minutes à la main.",
+    },
+    {
+      name: "Fermentation en bloc",
+      text: "Laissez la pâte entière fermenter 1 à 2 heures à température ambiante (20-25°C) jusqu'à ce qu'elle double de volume.",
+    },
+    {
+      name: "Divisez en boules",
+      text: "Divisez la pâte en portions du poids indiqué. Laissez reposer 15-20 minutes avant de former les boules.",
+    },
+    {
+      name: "Longue fermentation",
+      text: "Placez les boules dans un récipient hermétique au frigo (4°C) pendant 24-72 heures. C'est l'étape critique pour le goût et la digestibilité.",
+    },
+    {
+      name: "Étalez et enfournez",
+      text: "Sortez du froid 30 minutes avant. Étalez du centre vers l'extérieur. Enfournez à température maximale 60-90 secondes (bois) ou 5-7 minutes (maison).",
+    },
+  ],
+  bibliography: [
+    {
+      name: "Associazione Verace Pizza Napoletana",
+      url: "https://www.pizzanapoletana.org/",
+    },
+    {
+      name: "The Pizza Bible - Tony Gemignani",
+      url: "https://www.amazon.com/Pizza-Bible-Everything-Need-Perfect/dp/0393634039/",
+    },
+    {
+      name: "Franco Pepe - Pepe in Grani",
+      url: "https://www.pepeingranitalia.com/",
+    },
+    {
+      name: "Harina Caputo",
+      url: "https://www.caputoprepara.com/",
+    },
+  ],
+  seo: [
+    {
+      type: "title",
+      text: "Guide Maître pour la Pâte à Pizza Napolitaine Authentique",
+      level: 2,
+    },
+    {
+      type: "paragraph",
+      html: "La <strong>pizza napolitaine</strong> est bien plus qu'une recette : c'est un héritage culturel protégé qui exige une précision scientifique. Le succès dépend de la compréhension de l'interaction entre le temps, la température et l'hydratation.",
+    },
+    {
+      type: "stats",
+      columns: 4,
+      items: [
+        {
+          value: "480°C",
+          label: "Temp. de Cuisson Idéale",
+          icon: "mdi:fire",
+        },
+        {
+          value: "60-90s",
+          label: "Temps au Four",
+          icon: "mdi:clock-fast",
+        },
+        {
+          value: "65%",
+          label: "Hydratation Standard",
+          icon: "mdi:water-percent",
+        },
+        {
+          value: "W280",
+          label: "Force de la Farine",
+          icon: "mdi:grain",
+        },
+      ],
+    },
+    {
+      type: "title",
+      text: "L'Importance Cruciale de l'Hydratation",
+      level: 3,
+    },
+    {
+      type: "paragraph",
+      html: "L'hydratation (pourcentage d'eau par rapport au poids de la farine) détermine la texture du <strong>cornicione</strong>. Maîtriser ce paramètre sépare l'amateur du maître pizzaiolo.",
+    },
+    {
+      type: "comparative",
+      columns: 3,
+      items: [
+        {
+          title: "Hydratation 55-60%",
+          icon: "mdi:water-percent",
+          description: "Pâte très maniable, idéale pour les débutants et les fours domestiques à basse température.",
+          points: [
+            "Formation facile du réseau de gluten",
+            "Pâte moins collante",
+            "Croûte ferme et croustillante",
+          ],
+        },
+        {
+          title: "Hydratation 63-67%",
+          icon: "mdi:water",
+          description: "Le standard AVPN. Équilibre parfait pour une pâte légère avec un développement visible de la mie.",
+          highlight: true,
+          points: [
+            "Texture élastique traditionnelle",
+            "Idéal pour les fours à bois",
+            "Nécessite une technique de pétrissage moyenne",
+          ],
+        },
+        {
+          title: "Hydratation 70%+",
+          icon: "mdi:water-plus",
+          description: "Pizzas contemporaines aux bords géants. Très difficile à manipuler sans technique avancée.",
+          points: [
+            "Alvéoles extrêmement larges",
+            "Pâte très légère et digestible",
+            "Nécessite des farines de grande force",
+          ],
+        },
+      ],
+    },
+    {
+      type: "title",
+      text: "Types de Levure et Laquelle Choisir",
+      level: 3,
+    },
+    {
+      type: "comparative",
+      columns: 2,
+      items: [
+        {
+          title: "Levure Fraîche Pressée",
+          icon: "mdi:bread-slice-outline",
+          description: "Le choix traditionnel préféré des maîtres pizzaïolos. Fournit un profil aromatique plus complexe.",
+          points: [
+            "Goût plus profond et propre",
+            "Action enzymatique équilibrée",
+            "Se dissout facilement dans l'eau tiède",
+            "Conservation courte (exige la fraîcheur)",
+          ],
+        },
+        {
+          title: "Levure Sèche Instantanée",
+          icon: "mdi:shaker-outline",
+          description: "Beaucoup plus stable et facile à stocker. Idéal pour avoir toujours à disposition dans le placard.",
+          points: [
+            "Longue conservation (jusqu'à 2 ans)",
+            "Pas de réhydratation préalable nécessaire",
+            "Trois fois plus puissante que la fraîche",
+            "Goût légèrement plus neutre",
+          ],
+        },
+      ],
+    },
+    {
+      type: "title",
+      text: "Guide de Sélection des Farines par Index de Force W",
+      level: 3,
+    },
+    {
+      type: "table",
+      headers: ["Type de Farine", "Force (W)", "Temps de Fermentation", "Usage Recommandé"],
+      rows: [
+        ["Farine Faible", "W130-180", "4-8 heures", "Pâtisserie rapide"],
+        ["Force Moyenne", "W200-240", "8-24 heures", "Pizza rapide ou pain simple"],
+        ["Farine de Force", "W260-320", "24-72 heures", "Authentique Pizza Napolitaine"],
+        ["Grande Force", "W350+", "72+ heures", "Panettones ou pâtes très hydratées"],
+      ],
+    },
+    {
+      type: "diagnostic",
+      variant: "warning",
+      title: "Contrôle de la Température de Pétrissage",
+      html: "La pâte ne doit pas dépasser 24°C à la fin du pétrissage. La chaleur excessive due à la friction dégrade le gluten et provoque une fermentation erratique.",
+    },
+    {
+      type: "title",
+      text: "Glossaire pour le Futur Maître Pizzaïolo",
+      level: 3,
+    },
+    {
+      type: "glossary",
+      items: [
+        {
+          term: "Cornicione",
+          definition: "Le bord surélevé et aéré de la pizza. Il doit être rempli d'alvéoles et ne pas avoir de mie compacte.",
+        },
+        {
+          term: "Maturation",
+          definition: "Un processus enzymatique distinct de la fermentation où les protéines et les sucres se décomposent pour un meilleur goût et une digestibilité accrue.",
+        },
+        {
+          term: "Point de Pâte",
+          definition: "Le moment où la pâte atteint son élasticité et sa résistance optimales sans être collante.",
+        },
+        {
+          term: "Autolyse",
+          definition: "Un temps de repos après le mélange de la farine et de l'eau uniquement qui facilite le développement du gluten sans effort mécanique.",
+        },
+      ],
+    },
+    {
+      type: "tip",
+      title: "L'Astuce du Frigo",
+      html: "Le pointage (fermentation en bloc) pendant 24 heures à 4°C ne rend pas seulement la pâte plus facile à manipuler ; il crée des composés organiques complexes impossibles à obtenir à température ambiante.",
+    },
+    {
+      type: "paragraph",
+      html: "Notre calculateur automatise les proportions spécifiques pour que vous puissiez vous concentrer sur l'essentiel : la technique et la passion pour le produit final.",
+    },
+  ],
+  schemas: [],
+};

package/src/tool/pizza/index.ts

@@ -0,0 +1,27 @@
+import type { CookingToolEntry, ToolDefinition } from "../../types";
+import PizzaComponent from "./component.astro";
+import PizzaSEO from "./seo.astro";
+import PizzaBibliography from "./bibliography.astro";
+
+export const pizza: CookingToolEntry = {
+  id: "pizza",
+  icons: {
+    bg: "mdi:chef-hat",
+    fg: "mdi:pizza",
+  },
+  appSlug: "pizzametrics",
+  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 { PizzaComponent, PizzaSEO, PizzaBibliography };
+
+export const PIZZA_TOOL: ToolDefinition = {
+  entry: pizza,
+  Component: PizzaComponent,
+  SEOComponent: PizzaSEO,
+  BibliographyComponent: PizzaBibliography,
+};

package/src/tool/pizza/seo.astro

@@ -0,0 +1,8 @@
+---
+import { SEORenderer } from "@jjlmoya/utils-shared";
+import { content } from "./i18n/es";
+
+const locale = "es";
+---
+
+<SEORenderer content={{ sections: content.seo, locale }} />