@jjlmoya/utils-cooking 1.2.0

package/src/tool/egg-timer/i18n/es.ts

@@ -0,0 +1,222 @@
+import type { ToolLocaleContent } from "../../../types";
+
+export const content: ToolLocaleContent = {
+  slug: "huevos",
+  title: "Cronómetro de Huevos Científico",
+  description:
+    "Calculadora termodinámica para la cocción perfecta de huevos según altitud, temperatura y tamaño.",
+  faqTitle: "Preguntas Frecuentes",
+  bibliographyTitle: "Referencias Científicas",
+  ui: {
+    parameters: "Parámetros",
+    initial_temperature: "Temperatura Inicial",
+    fridge: "Nevera",
+    ambient: "Ambiente",
+    egg_size: "Tamaño del Huevo",
+    altitude: "Altitud",
+    use_location: "Usar mi ubicación",
+    altitude_help:
+      "El agua hierve a menor temperatura a mayor altitud, afectando el tiempo de cocción.",
+    sea_level: "Mar",
+    soft_cooked: "Clara Cuajada",
+    soft_description: "Yema líquida, clara blanca y suave.",
+    mollet: "Mollet",
+    mollet_description: "Yema cremosa, clara firme.",
+    hard_cooked: "Duro",
+    hard_description: "Totalmente cocido, yema firme.",
+  },
+  faq: [
+    {
+      question: "¿Por qué importa la altitud al cocer huevos?",
+      answer:
+        "El agua no siempre hierve a 100°C. A mayor altitud, menor presión atmosférica, y el agua hierve a menor temperatura. En Madrid (600m) hierve a 98°C, requiriendo más tiempo que a nivel del mar. En el Everest (70°C) es imposible cocer un huevo duro.",
+    },
+    {
+      question: "¿Huevo de nevera o temperatura ambiente?",
+      answer:
+        "Huevo de nevera (4°C) necesita más tiempo que uno a temperatura ambiente (20°C). La diferencia puede ser de 2-3 minutos. Esta calculadora ajusta el tiempo automáticamente según la temperatura inicial.",
+    },
+    {
+      question: "¿Por qué aparece un anillo verde en la yema?",
+      answer:
+        "Es sulfuro ferroso, resultado de sobrecocción. Cuando superas 80°C por mucho tiempo, el azufre de la clara reacciona con el hierro de la yema. No es tóxico, pero indica que te pasaste de tiempo. Usa baño de hielo inmediato para evitarlo.",
+    },
+    {
+      question: "¿Cómo pelo un huevo fácilmente?",
+      answer:
+        "Usa huevos de 1-2 semanas (no frescos del día), empieza con agua hirviendo (no fría), y sumerge en agua helada inmediatamente al terminar. El choque térmico contrae el huevo y facilita el pelado.",
+    },
+  ],
+  bibliography: [
+    {
+      name: "The Science of Boiling an Egg - Charles D. H. Williams",
+      url: "https://newton.ex.ac.uk/teaching/CDHW/Egg/",
+    },
+    {
+      name: "The Food Lab: The Science of the Best Hard Boiled Eggs - J. Kenji López-Alt",
+      url: "https://www.seriouseats.com/the-food-lab-hard-boiled-eggs-recipe",
+    },
+    {
+      name: "The Food Lab: Perfect Soft Boiled Eggs",
+      url: "https://www.seriouseats.com/soft-boiled-eggs-recipe",
+    },
+  ],
+  howTo: [
+    {
+      name: "Selecciona la temperatura inicial",
+      text: "Elige si tu huevo está en nevera (4°C) o a temperatura ambiente (20°C). Esta es la temperatura interna del huevo, no la del aire.",
+    },
+    {
+      name: "Elige el tamaño del huevo",
+      text: "S (pequeño, 53g), M (mediano, 58g), L (grande, 63g), o XL (muy grande, 73g). El tamaño determina cuánto tiempo tarda el calor en alcanzar el centro.",
+    },
+    {
+      name: "Especifica tu altitud",
+      text: "Introduce manualmente, usa el botón Mar para nivel del mar (0m), Madrid para 600m, o geoposiciona tu ubicación. Cada 300m baja 1°C el punto de ebullición del agua.",
+    },
+    {
+      name: "Aplica choque térmico",
+      text: "Cuando el temporizador suene, sumerge inmediatamente en agua con hielo. Esto detiene la cocción y facilita el pelado. El choque térmico es crítico para la precisión.",
+    },
+  ],
+	seo: [
+		{
+			type: 'title',
+			text: 'Guía Maestro para la Cocción Perfecta del Huevo',
+			level: 2,
+		},
+		{
+			type: 'paragraph',
+			html: 'Cocer un huevo es un ejercicio de <strong>termodinámica aplicada</strong>. La precisión en la temperatura inicial, el tamaño del huevo y la altitud geográfica determina si obtendrás una yema líquida sedosa o un sólido sobrecocido con el indeseado anillo verde.',
+		},
+		{
+			type: 'stats',
+			columns: 4,
+			items: [
+				{
+					value: '62°C',
+					label: 'Coagulación Clara',
+					icon: 'mdi:egg-outline',
+				},
+				{
+					value: '68°C',
+					label: 'Coagulación Yema',
+					icon: 'mdi:egg-fried',
+				},
+				{
+					value: '-1°C',
+					label: 'Ebullición / 300m',
+					icon: 'mdi:mountain',
+				},
+				{
+					value: '0s',
+					label: 'Error Tolerado',
+					icon: 'mdi:timer-check-outline',
+				},
+			],
+		},
+		{
+			type: 'title',
+			text: 'Comparativa de Estados de Cocción',
+			level: 3,
+		},
+		{
+			type: 'comparative',
+			columns: 3,
+			items: [
+				{
+					title: 'Huevo Pasado por Agua',
+					icon: 'mdi:coffee-outline',
+					description: 'Clara parcialmente cuajada y yema totalmente líquida.',
+					points: [
+						'Textura muy delicada',
+						'Ideal para mojar pan',
+						'Cocción rápida (3-4 min)',
+						'Difícil de pelar',
+					],
+				},
+				{
+					title: 'Huevo Mollet / Ceroso',
+					icon: 'mdi:water-percent',
+					description: 'Clara firme y yema cremosa, densa pero no sólida.',
+					highlight: true,
+					points: [
+						'El estándar gourmet',
+						'Yema con textura de miel',
+						'Piel elástica y firme',
+						'Perfecto para ensaladas',
+					],
+				},
+				{
+					title: 'Huevo Duro / Cocido',
+					icon: 'mdi:circle-slice-8',
+					description: 'Totalmente sólido pero tierno, sin anillo verde.',
+					points: [
+						'Yema opaca y firme',
+						'Fácil transporte y pelado',
+						'Ideal para rellenar',
+						'Requiere enfriado rápido',
+					],
+				},
+			],
+		},
+		{
+			type: 'title',
+			text: 'Punto de Ebullición según la Altitud',
+			level: 3,
+		},
+		{
+			type: 'table',
+			headers: ['Ciudad / Altitud', 'Metros (msnm)', 'Ebullición (°C)', 'Tiempo Extra'],
+			rows: [
+				['Nivel del Mar (Cádiz)', '0m', '100°C', '0s'],
+				['Madrid', '650m', '97.8°C', '+25s'],
+				['Ciudad de México', '2240m', '92.6°C', '+75s'],
+				['La Paz (Bolivia)', '3640m', '88.1°C', '+140s'],
+			],
+		},
+		{
+			type: 'diagnostic',
+			variant: 'warning',
+			title: '¿Yema con Anillo Verde o Difícil de Pelar?',
+			html: 'El anillo verde es <strong>sulfuro ferroso</strong> caused por sobrecocción (reacción del azufre de la clara con el hierro de la yema). Si el huevo no se pela bien, es por ser demasiado fresco; el pH bajo hace que la clara se pegue a la membrana. Usa huevos de 1 semana y choque térmico en hielo.',
+		},
+		{
+			type: 'title',
+			text: 'Glosario de Ciencias del Huevo',
+			level: 3,
+		},
+		{
+			type: 'glossary',
+			items: [
+				{
+					term: 'Ovotransferrina',
+					definition: 'Proteína de la clara que coagula primero (62°C), dando la estructura blanca inicial.',
+				},
+				{
+					term: 'Ovalbúmina',
+					definition: 'Proteína mayoritaria que requiere más calor (80°C) para una firmeza total.',
+				},
+				{
+					term: 'Presión Atmosférica',
+					definition: 'Factor que determina la temperatura del agua hirviendo; a menor presión, menor temperatura.',
+				},
+				{
+					term: 'Choque Térmico',
+					definition: 'Inmersión en agua helada para detener la cocción residual de forma instantánea.',
+				},
+			],
+		},
+		{
+			type: 'tip',
+			title: 'El truco del Vinagre',
+			html: 'Añade un chorro de vinagre al agua. Si la cáscara se agrieta, el ácido ayudará a coagular la clara que escape rápidamente, sellando la grieta y salvando el huevo.',
+		},
+		{
+			type: 'paragraph',
+			html: 'Nuestra calculadora utiliza la ecuación de Charles Williams para ajustar cada segundo según tu ubicación exacta y el estado de tu nevera.',
+		},
+	],
+
+  schemas: [],
+};

package/src/tool/egg-timer/i18n/fr.ts

@@ -0,0 +1,121 @@
+import type { ToolLocaleContent } from "../../../types";
+
+export const content: ToolLocaleContent = {
+  slug: "minuteur-oeuf-parfait-calculatrice-altitude",
+  title: "Minuteur Scientifique Précis pour Œufs et Calculatrice d'Altitude",
+  description:
+    "Maîtrisez la thermodynamique de l'œuf parfait. Calculez le temps d'ébullition exact en fonction de votre altitude, de la taille de l'œuf et de la température initiale.",
+  ui: {
+    parameters: "Paramètres de Cuisson",
+    initial_temperature: "Température Initiale",
+    fridge: "Frigo (4°C)",
+    ambient: "Ambiante (20°C)",
+    egg_size: "Taille de l'Œuf",
+    altitude: "Votre Altitude",
+    use_location: "Détecter la Localisation",
+    altitude_help:
+      "La pression atmosphérique plus basse en altitude réduit le point d'ébullition de l'eau.",
+    sea_level: "0m",
+    soft_cooked: "Œuf Mollet",
+    soft_description: "Jaune coulant, blancs juste figés.",
+    mollet: "Mollet (Crémeuse)",
+    mollet_description: "Jaune crémeux, blancs fermes.",
+    hard_cooked: "Œuf Dur",
+    hard_description: "Jaune solide, blancs entièrement figés.",
+  },
+  faqTitle: "Questions Fréquemment Posées",
+  faq: [
+    {
+      question: "Pourquoi l'altitude affecte-t-elle le temps de cuisson des œufs?",
+      answer:
+        "À une altitude plus élevée, la pression atmosphérique est plus basse, ce qui réduit le point d'ébullition de l'eau. Par exemple, au niveau de la mer, l'eau bout à 100°C, mais à 1500m d'altitude, elle bout à seulement 95°C. Cela signifie que la cuisson prend plus de temps.",
+    },
+    {
+      question: "Quelle est la différence entre un œuf mollet et un œuf dur?",
+      answer:
+        "Un œuf mollet a un jaune crémeux et coulant au centre, tandis que les blancs sont fermes. Un œuf dur a complètement cuit le jaune et les blancs. La différence réside principalement dans le temps de cuisson et la température atteinte.",
+    },
+    {
+      question: "Comment puis-je obtenir des œufs durs parfaits?",
+      answer:
+        "Utilisez des œufs à température ambiante si possible, portez l'eau à ébullition, puis plongez les œufs et laissez-les cuire selon votre altitude. Refroidissez-les immédiatement dans de l'eau glacée pour arrêter la cuisson. Notre calculateur vous donne le temps exact pour votre localisation.",
+    },
+    {
+      question: "Pourquoi dois-je refroidir les œufs après la cuisson?",
+      answer:
+        "Refroidir les œufs rapidement dans de l'eau glacée arrête le processus de cuisson et facilite l'épluchage. Cela empêche la cuisson excessive du jaune qui pourrait créer une bordure grisâtre.",
+    },
+    {
+      question: "Quel est l'âge idéal des œufs pour les faire bouillir?",
+      answer:
+        "Les œufs plus anciens (au moins une semaine) sont plus faciles à éplucher car l'albumine se sépare plus facilement de la coquille. Les œufs très frais peuvent être plus difficiles à éplucher.",
+    },
+  ],
+  bibliographyTitle: "Bibliographie",
+  bibliography: [
+    {
+      name: "The Science of Boiling an Egg - Charles D. H. Williams",
+      url: "https://newton.ex.ac.uk/teaching/CDHW/Egg/",
+    },
+    {
+      name: "The Food Lab: The Science of the Best Hard Boiled Eggs - J. Kenji López-Alt",
+      url: "https://www.seriouseats.com/",
+    },
+    {
+      name: "The Food Lab: Perfect Soft Boiled Eggs",
+      url: "https://www.seriouseats.com/",
+    },
+  ],
+  howTo: [
+    {
+      name: "Sélectionnez Vos Paramètres",
+      text: "Choisissez la température initiale de l'œuf, sa taille, et votre altitude. Notre calculateur déterminera automatiquement le temps de cuisson optimal.",
+    },
+    {
+      name: "Portez l'Eau à Ébullition",
+      text: "Utilisez une casserole avec suffisamment d'eau pour couvrir les œufs d'environ 2-3cm. Portez à ébullition complète.",
+    },
+    {
+      name: "Plongez et Laissez Cuire",
+      text: "Plongez délicatement les œufs dans l'eau bouillante et commencez le minuteur selon le temps recommandé. La précision est essentielle pour le résultat parfait.",
+    },
+    {
+      name: "Refroidissez Immédiatement",
+      text: "Quand le temps est écoulé, plongez les œufs dans de l'eau glacée pendant au moins 5 minutes pour arrêter la cuisson et faciliter l'épluchage.",
+    },
+  ],
+  seo: [
+    {
+      type: "title",
+      text: "Thermodynamique de la Cuisson Parfaite d'Œufs",
+      level: 2,
+    },
+    {
+      type: "paragraph",
+      text: "La cuisson d'un œuf est un processus thermodynamique délicat. Les protéines se dénaturent à différentes températures, créant des textures distinctes du blanc et du jaune.",
+    },
+    {
+      type: "title",
+      text: "Impact de l'Altitude sur la Cuisson",
+      level: 3,
+    },
+    {
+      type: "paragraph",
+      text: "Au niveau de la mer, l'eau bout à 100°C. À 1000m d'altitude, elle bout à 96°C. À 2000m, à seulement 93°C. Cette différence affecte significativement les temps de cuisson.",
+    },
+    {
+      type: "title",
+      text: "Types d'Œufs Cuits",
+      level: 3,
+    },
+    {
+      type: "list",
+      items: [
+        "Mollet (6-7 minutes): Jaune crémeux, blancs fermes",
+        "Dur (10-12 minutes): Complètement cuit, légèrement collet gris si non refroidi",
+        "Jammy (8-9 minutes): Équilibre parfait entre coulant et figé",
+      ],
+    },
+  ],
+  schemas: [],
+};

package/src/tool/egg-timer/index.ts

@@ -0,0 +1,27 @@
+import type { CookingToolEntry, ToolDefinition } from "../../types";
+import EggTimerComponent from "./component.astro";
+import EggTimerSEO from "./seo.astro";
+import EggTimerBibliography from "./bibliography.astro";
+
+export const eggTimer: CookingToolEntry = {
+  id: "egg-timer",
+  icons: {
+    bg: "mdi:chef-hat",
+    fg: "mdi:egg",
+  },
+  appSlug: "egg-timer",
+  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 { EggTimerComponent, EggTimerSEO, EggTimerBibliography };
+
+export const EGG_TIMER_TOOL: ToolDefinition = {
+  entry: eggTimer,
+  Component: EggTimerComponent,
+  SEOComponent: EggTimerSEO,
+  BibliographyComponent: EggTimerBibliography,
+};

package/src/tool/egg-timer/seo.astro

@@ -0,0 +1,39 @@
+---
+import { SEOArticle, SEOTitle, SEOList, SEOTip, SEOTable } from "@jjlmoya/utils-shared";
+import { eggTimer } from "./index";
+import type { KnownLocale } from "../../types";
+
+interface Props {
+  locale?: KnownLocale;
+}
+
+const { locale = "es" } = Astro.props;
+const content = await eggTimer.i18n[locale]?.();
+if (!content) return null;
+---
+
+<SEOArticle>
+  {content.seo.map((section: any) => {
+    if (section.type === "title") {
+      return <SEOTitle title={section.text} level={section.level || 2} />;
+    }
+    if (section.type === "paragraph") {
+      return <p set:html={section.html} />;
+    }
+    if (section.type === "list") {
+      return <SEOList items={section.items} />;
+    }
+    if (section.type === "code") {
+      return <pre><code set:text={section.text} /></pre>;
+    }
+    if (section.type === "table") {
+      return (
+        <SEOTable headers={section.headers} rows={section.rows} />
+      );
+    }
+    if (section.type === "tip") {
+      return <SEOTip title="Consejos">{section.html}</SEOTip>;
+    }
+    return null;
+  })}
+</SEOArticle>