@jjlmoya/utils-home 1.1.0

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

@@ -0,0 +1,183 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { DewPointCalculatorUI } from '../ui';
+
+const slug = 'punto-de-rocio';
+const title = 'Calculadora de Punto de Rocío';
+const description =
+  'Calcula la temperatura de condensación en tus paredes usando la humedad y temperatura ambiente. Una herramienta vital para prevenir humedades y proteger la salud estructural de tu hogar.';
+
+const faqData = [
+  {
+    question: '¿Qué es exactamente el punto de rocío?',
+    answer:
+      'Es la temperatura a la que el aire debe enfriarse para que el vapor de agua se condense en agua líquida. Cuanto más alta es la humedad relativa, más cerca está el punto de rocío de la temperatura actual.',
+  },
+  {
+    question: '¿Por qué aparece moho en las esquinas de mi casa?',
+    answer:
+      'Las esquinas suelen ser puentes térmicos donde la pared está más fría. Si la temperatura de esa superficie baja del punto de rocío, se forma agua líquida. El moho necesita esa humedad constante para crecer.',
+  },
+  {
+    question: '¿Cómo puedo bajar la humedad en casa?',
+    answer:
+      'La forma más efectiva es ventilar (especialmente después de ducharse o cocinar) y usar deshumidificadores. Mantener una temperatura constante también ayuda a que el aire pueda retener más vapor sin condensar.',
+  },
+  {
+    question: '¿Es peligroso el moho por condensación?',
+    answer:
+      'Sí. El moho libera esporas que pueden causar problemas respiratorios, alergias y asma. Detectar el riesgo de condensación con esta calculadora es el primer paso para una casa saludable.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Medir temperatura y humedad',
+    text: 'Usa un termómetro e higrómetro para conocer los valores actuales de la estancia.',
+  },
+  {
+    name: 'Introducir valores',
+    text: 'Ajusta la temperatura en grados Celsius y el porcentaje de humedad en la calculadora.',
+  },
+  {
+    name: 'Obtener temperatura crítica',
+    text: 'La herramienta te dirá a qué temperatura exacta empezará a condensar el agua en las superficies.',
+  },
+  {
+    name: 'Verificar superficies',
+    text: 'Si tienes un termómetro láser, mide la temperatura de las paredes. Si es igual o menor al resultado, necesitas ventilar o aislar.',
+  },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faqData.map((item) => ({
+    '@type': 'Question',
+    name: item.question,
+    acceptedAnswer: { '@type': 'Answer', text: item.answer },
+  })),
+};
+
+const howToSchema: WithContext<HowTo> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: title,
+  description,
+  step: howToData.map((step) => ({
+    '@type': 'HowToStep',
+    name: step.name,
+    text: step.text,
+  })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description,
+  applicationCategory: 'UtilityApplication',
+  operatingSystem: 'All',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  inLanguage: 'es',
+};
+
+export const content: ToolLocaleContent<DewPointCalculatorUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Preguntas Frecuentes',
+  faq: faqData,
+  bibliographyTitle: 'Bibliografía',
+  bibliography: [
+    {
+      name: 'Magnus Approximation of the Dew-Point — Meteorological Applications (2011)',
+      url: 'https://es.scribd.com/document/331352069/dew-point',
+    },
+    {
+      name: 'Guide to Meteorological Instruments and Methods of Observation — WMO (2021)',
+      url: 'https://community.wmo.int/site/knowledge-hub/programmes-and-initiatives/instruments-and-methods-of-observation-programme-imop/guide-instruments-and-methods-of-observation-wmo-no-8',
+    },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: '¿Qué es el Punto de Rocío y por qué importa en tu hogar?',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'El punto de rocío es la temperatura a la cual el aire debe enfriarse para que el vapor de agua se condense en agua líquida. En el contexto de una vivienda, este concepto marca la frontera entre una casa sana y una con problemas estructurales de humedad. Cuando la temperatura de una superficie (como una pared mal aislada) cae por debajo del punto de rocío, aparecen gotas de agua — el caldo de cultivo ideal para el <em>Aspergillus</em> y otros hongos nocivos.',
+    },
+    {
+      type: 'stats',
+      items: [
+        { value: '> 5°C', label: 'Diferencia Segura', icon: 'mdi:shield-check' },
+        { value: '40–60%', label: 'Humedad Ideal', icon: 'mdi:water-percent' },
+        { value: '< 1°C', label: 'Peligro Extremo', icon: 'mdi:alert' },
+      ],
+      columns: 3,
+    },
+    {
+      type: 'comparative',
+      items: [
+        {
+          title: 'La Fórmula de Magnus-Tetens',
+          description: 'Para calcular el punto de rocío con precisión científica utilizamos la aproximación de Magnus-Tetens, con constantes b=17.625 y c=243.04°C recomendadas por la Organización Meteorológica Mundial para temperaturas entre 0°C y 50°C.',
+          icon: 'mdi:calculator',
+          points: ['Precisión científica validada por la OMM', 'Válida para rangos de temperatura habitacional'],
+        },
+        {
+          title: 'Puentes Térmicos y Moho',
+          description: 'Las esquinas de habitaciones, los marcos de ventanas y las paredes exteriores mal aisladas son los puntos más fríos. Si su temperatura cae por debajo del punto de rocío, la condensación y el moho son inevitables.',
+          icon: 'mdi:home-thermometer',
+          points: ['Las esquinas son los puntos más vulnerables', 'El aislamiento térmico previene la condensación'],
+        },
+      ],
+      columns: 2,
+    },
+    {
+      type: 'title',
+      text: 'Niveles de Riesgo',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: '<strong>Riesgo Bajo (diferencia &gt; 5°C):</strong> El aire está lejos de saturarse. Tus paredes están seguras. <strong>Riesgo Medio (3–5°C):</strong> Vigila las esquinas y los puentes térmicos. <strong>Riesgo Alto (1–3°C):</strong> Condensación probable en cristales y zonas frías — ventila inmediatamente. <strong>Peligro Extremo (&lt; 1°C):</strong> Condensación activa con riesgo inmediato de proliferación de moho negro.',
+    },
+    {
+      type: 'diagnostic',
+      variant: 'warning',
+      title: 'La Regla de Oro',
+      icon: 'mdi:thermometer-alert',
+      badge: 'Consejo Clave',
+      html: '<p>Si la temperatura de tu pared está a menos de <strong>3°C del punto de rocío</strong>, tienes un riesgo inminente de condensación. Ventila, usa extractores en baños y cocinas, y mantén la humedad relativa entre el 40% y el 60%.</p>',
+    },
+    {
+      type: 'summary',
+      title: 'Cómo Prevenir la Condensación',
+      items: [
+        'Ventila diariamente, especialmente tras ducharte o cocinar.',
+        'Mantén la humedad relativa entre el 40% y el 60%.',
+        'Usa extractores en baños y cocinas para evacuar el vapor.',
+        'No seques ropa dentro de casa sin ventilación.',
+        'Aísla térmicamente las paredes para evitar superficies frías.',
+      ],
+    },
+  ],
+  ui: {
+    labelTemperature: 'Temperatura Ambiente',
+    labelHumidity: 'Humedad Relativa',
+    labelDewPoint: 'Punto de Rocío',
+    riskLow: 'Riesgo Bajo',
+    riskMedium: 'Riesgo Medio',
+    riskHigh: 'Riesgo Alto',
+    riskExtreme: 'Peligro Extremo',
+    riskLowDesc: 'Diferencia > 5°C. Superficies seguras.',
+    riskMediumDesc: 'Diferencia 3–5°C. Vigila las esquinas.',
+    riskHighDesc: 'Diferencia 1–3°C. Ventila inmediatamente.',
+    riskExtremeDesc: 'Diferencia < 1°C. Condensación activa.',
+  },
+};

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

@@ -0,0 +1,183 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { DewPointCalculatorUI } from '../ui';
+
+const slug = 'calculateur-point-de-rosee';
+const title = 'Calculateur de Point de Rosée';
+const description =
+  "Calculez la température de condensation sur vos murs à partir de l'humidité ambiante et de la température. Un outil essentiel pour prévenir l'humidité et protéger la santé structurale de votre domicile.";
+
+const faqData = [
+  {
+    question: "Qu'est-ce que le point de rosée exactement ?",
+    answer:
+      "C'est la température à laquelle l'air doit refroidir pour que la vapeur d'eau se condense en eau liquide. Plus l'humidité relative est élevée, plus le point de rosée est proche de la température actuelle.",
+  },
+  {
+    question: "Pourquoi de la moisissure apparaît-elle dans les coins de mon logement ?",
+    answer:
+      "Les coins sont souvent des ponts thermiques où le mur est plus froid. Si la température de cette surface descend sous le point de rosée, de l'eau liquide se forme. La moisissure a besoin de cette humidité constante pour se développer.",
+  },
+  {
+    question: "Comment puis-je réduire l'humidité chez moi ?",
+    answer:
+      "La méthode la plus efficace est la ventilation — surtout après la douche ou la cuisine — et l'utilisation de déshumidificateurs. Maintenir une température constante aide aussi l'air à retenir plus de vapeur sans condenser.",
+  },
+  {
+    question: "La moisissure par condensation est-elle dangereuse ?",
+    answer:
+      "Oui. La moisissure libère des spores qui peuvent provoquer des problèmes respiratoires, des allergies et de l'asthme. Détecter le risque de condensation avec cette calculatrice est la première étape vers un logement sain.",
+  },
+];
+
+const howToData = [
+  {
+    name: "Mesurer la température et l'humidité",
+    text: "Utilisez un thermomètre et un hygromètre pour connaître les valeurs actuelles de la pièce.",
+  },
+  {
+    name: 'Saisir les valeurs',
+    text: "Ajustez la température en degrés Celsius et le pourcentage d'humidité dans la calculatrice.",
+  },
+  {
+    name: 'Obtenir la température critique',
+    text: "L'outil vous indiquera à quelle température exacte l'eau commencera à se condenser sur les surfaces.",
+  },
+  {
+    name: 'Vérifier les surfaces',
+    text: "Si vous disposez d'un thermomètre laser, mesurez la température de vos murs. Si elle est égale ou inférieure au résultat, vous devez ventiler ou isoler.",
+  },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faqData.map((item) => ({
+    '@type': 'Question',
+    name: item.question,
+    acceptedAnswer: { '@type': 'Answer', text: item.answer },
+  })),
+};
+
+const howToSchema: WithContext<HowTo> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: title,
+  description,
+  step: howToData.map((step) => ({
+    '@type': 'HowToStep',
+    name: step.name,
+    text: step.text,
+  })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description,
+  applicationCategory: 'UtilityApplication',
+  operatingSystem: 'All',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  inLanguage: 'fr',
+};
+
+export const content: ToolLocaleContent<DewPointCalculatorUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Questions Fréquentes',
+  faq: faqData,
+  bibliographyTitle: 'Bibliographie',
+  bibliography: [
+    {
+      name: "Magnus Approximation of the Dew-Point — Meteorological Applications (2011)",
+      url: 'https://es.scribd.com/document/331352069/dew-point',
+    },
+    {
+      name: "Guide to Meteorological Instruments and Methods of Observation — WMO (2021)",
+      url: 'https://community.wmo.int/site/knowledge-hub/programmes-and-initiatives/instruments-and-methods-of-observation-programme-imop/guide-instruments-and-methods-of-observation-wmo-no-8',
+    },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: "Qu'est-ce que le Point de Rosée et Pourquoi est-il Important ?",
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: "Le point de rosée est la température à laquelle l'air doit refroidir pour que la vapeur d'eau se condense en eau liquide. Dans un logement, ce concept marque la frontière entre une maison saine et une maison avec des problèmes structurels d'humidité. Lorsque la température d'une surface (comme un mur mal isolé) descend sous le point de rosée, des gouttelettes d'eau apparaissent — le terrain idéal pour l'<em>Aspergillus</em> et autres champignons nocifs.",
+    },
+    {
+      type: 'stats',
+      items: [
+        { value: '> 5°C', label: 'Différence Sûre', icon: 'mdi:shield-check' },
+        { value: '40–60%', label: 'Humidité Idéale', icon: 'mdi:water-percent' },
+        { value: '< 1°C', label: 'Danger Extrême', icon: 'mdi:alert' },
+      ],
+      columns: 3,
+    },
+    {
+      type: 'comparative',
+      items: [
+        {
+          title: 'La Formule de Magnus-Tetens',
+          description: "Pour calculer le point de rosée avec précision scientifique, nous utilisons l'approximation de Magnus-Tetens, avec les constantes b=17,625 et c=243,04°C recommandées par l'Organisation Météorologique Mondiale pour des températures entre 0°C et 50°C.",
+          icon: 'mdi:calculator',
+          points: ["Précision scientifique validée par l'OMM", 'Valide pour les plages de température résidentielles'],
+        },
+        {
+          title: 'Ponts Thermiques et Moisissures',
+          description: "Les coins de pièces, les cadres de fenêtres et les murs extérieurs mal isolés sont les points les plus froids. Si leur température descend sous le point de rosée, la condensation et les moisissures sont inévitables.",
+          icon: 'mdi:home-thermometer',
+          points: ['Les coins sont les points les plus vulnérables', "L'isolation thermique prévient la condensation"],
+        },
+      ],
+      columns: 2,
+    },
+    {
+      type: 'title',
+      text: 'Niveaux de Risque',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: "<strong>Risque Faible (différence &gt; 5°C) :</strong> L'air est loin de la saturation. Vos murs sont sûrs. <strong>Risque Moyen (3–5°C) :</strong> Surveillez les coins et les ponts thermiques. <strong>Risque Élevé (1–3°C) :</strong> Condensation probable sur les vitres et les zones froides — ventilez immédiatement. <strong>Danger Extrême (&lt; 1°C) :</strong> Condensation active avec risque imminent de prolifération de moisissures noires.",
+    },
+    {
+      type: 'diagnostic',
+      variant: 'warning',
+      title: 'La Règle d\'Or',
+      icon: 'mdi:thermometer-alert',
+      badge: 'Conseil Clé',
+      html: "<p>Si la température de votre mur est à moins de <strong>3°C du point de rosée</strong>, vous faites face à un risque imminent de condensation. Ventilez, utilisez des extracteurs dans les salles de bain et les cuisines, et maintenez l'humidité relative entre 40% et 60%.</p>",
+    },
+    {
+      type: 'summary',
+      title: 'Comment Prévenir la Condensation',
+      items: [
+        'Ventilez quotidiennement, surtout après la douche ou la cuisine.',
+        "Maintenez l'humidité relative entre 40% et 60%.",
+        'Utilisez des extracteurs dans les salles de bain et les cuisines.',
+        "Ne faites pas sécher le linge à l'intérieur sans ventilation.",
+        'Isolez thermiquement les murs pour éviter les surfaces froides.',
+      ],
+    },
+  ],
+  ui: {
+    labelTemperature: 'Température Ambiante',
+    labelHumidity: 'Humidité Relative',
+    labelDewPoint: 'Point de Rosée',
+    riskLow: 'Risque Faible',
+    riskMedium: 'Risque Moyen',
+    riskHigh: 'Risque Élevé',
+    riskExtreme: 'Danger Extrême',
+    riskLowDesc: 'Différence > 5°C. Surfaces sûres.',
+    riskMediumDesc: 'Différence 3–5°C. Surveillez les coins.',
+    riskHighDesc: 'Différence 1–3°C. Ventilez immédiatement.',
+    riskExtremeDesc: 'Différence < 1°C. Condensation active.',
+  },
+};

package/src/tool/dewPointCalculator/index.ts

@@ -0,0 +1,34 @@
+import type { HomeToolEntry, ToolLocaleContent, ToolDefinition } from '../../types';
+import DewPointCalculatorComponent from './component.astro';
+import DewPointCalculatorSEO from './seo.astro';
+import DewPointCalculatorBibliography from './bibliography.astro';
+
+import type { DewPointCalculatorUI } from './ui';
+
+export type DewPointCalculatorLocaleContent = ToolLocaleContent<DewPointCalculatorUI>;
+
+import { content as es } from './i18n/es';
+import { content as en } from './i18n/en';
+import { content as fr } from './i18n/fr';
+
+export const dewPointCalculator: HomeToolEntry<DewPointCalculatorUI> = {
+  id: 'dew-point-calculator',
+  icons: {
+    bg: 'mdi:water-thermometer',
+    fg: 'mdi:home-thermometer',
+  },
+  i18n: {
+    es: async () => es,
+    en: async () => en,
+    fr: async () => fr,
+  },
+};
+
+export { DewPointCalculatorComponent, DewPointCalculatorSEO, DewPointCalculatorBibliography };
+
+export const DEW_POINT_CALCULATOR_TOOL: ToolDefinition = {
+  entry: dewPointCalculator,
+  Component: DewPointCalculatorComponent,
+  SEOComponent: DewPointCalculatorSEO,
+  BibliographyComponent: DewPointCalculatorBibliography,
+};

package/src/tool/dewPointCalculator/logic.ts

@@ -0,0 +1,16 @@
+export type MoldRisk = 'low' | 'medium' | 'high' | 'extreme';
+
+export function calculateDewPoint(temp: number, humidity: number): number {
+  const b = 17.625;
+  const c = 243.04;
+  const alpha = Math.log(humidity / 100) + (b * temp) / (c + temp);
+  return (c * alpha) / (b - alpha);
+}
+
+export function getMoldRisk(temp: number, dewPoint: number): MoldRisk {
+  const diff = temp - dewPoint;
+  if (diff > 5) return 'low';
+  if (diff > 3) return 'medium';
+  if (diff > 1) return 'high';
+  return 'extreme';
+}

package/src/tool/dewPointCalculator/seo.astro

@@ -0,0 +1,14 @@
+---
+import { SEORenderer } from '@jjlmoya/utils-shared';
+import { dewPointCalculator } from './index';
+import type { KnownLocale } from '../../types';
+
+interface Props {
+  locale?: KnownLocale;
+}
+
+const { locale = 'es' } = Astro.props;
+const content = await dewPointCalculator.i18n[locale]?.();
+if (!content) return null;
+---
+<SEORenderer content={{ locale: locale as string, sections: content.seo }} />

package/src/tool/dewPointCalculator/ui.ts

@@ -0,0 +1,13 @@
+export interface DewPointCalculatorUI extends Record<string, string> {
+  labelTemperature: string;
+  labelHumidity: string;
+  labelDewPoint: string;
+  riskLow: string;
+  riskMedium: string;
+  riskHigh: string;
+  riskExtreme: string;
+  riskLowDesc: string;
+  riskMediumDesc: string;
+  riskHighDesc: string;
+  riskExtremeDesc: string;
+}

package/src/tool/ledSavingCalculator/bibliography.astro

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