@jjlmoya/utils-home 1.1.0 → 1.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jjlmoya/utils-home",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "type": "module",
   "main": "./src/index.ts",
   "types": "./src/index.ts",

package/src/category/i18n/en.ts

@@ -1,24 +1,105 @@
 import type { CategoryLocaleContent } from '../../types';
 
 export const content: CategoryLocaleContent = {
-  slug: 'template-category',
-  title: 'Template Category',
-  description: 'Category description.',
+  slug: 'home',
+  title: 'Home Calculators and Utilities',
+  description: 'Optimize your home with real data. Free tools to calculate energy savings, compare electricity tariffs, size solar panels, prevent condensation, and plan your audiovisual setup.',
   seo: [
     {
-      type: 'summary',
-      title: 'Summary',
-      items: ['Point 1', 'Point 2', 'Point 3'],
+      type: 'title',
+      text: 'Why calculate before making home decisions?',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Most home decisions are made on gut feeling: "I think these solar panels will be enough", "switching bulbs should save something". The truth is that a five-minute calculation can save you hundreds of euros a year or spare you an expensive renovation. Our tools are based on <strong>real physics</strong>: solar irradiation by latitude, measured wattage consumption, moist air psychrometry, projection optics.',
+    },
+    {
+      type: 'paragraph',
+      html: 'An efficient home is not a luxury — it is a technical decision. The difference between a household with a spiralling electricity bill and one with controlled consumption is rarely the tariff price: it is knowing exactly how much each device consumes, when it makes sense to self-generate energy, and where the losses occur.',
     },
     {
       type: 'title',
-      text: 'Section title',
+      text: 'Residential solar energy: beyond the marketing',
       level: 2,
     },
     {
       type: 'paragraph',
-      html: 'Category SEO content.',
+      html: 'Residential photovoltaic installations have a real return on investment that depends on three variables: the irradiation at your location, the tilt angle of the panels, and your hourly consumption. A panel tilted 10° below optimal can lose <strong>15–20% of annual output</strong>. Our solar calculator gives you the exact angle and monthly generation estimate.',
+    },
+    {
+      type: 'paragraph',
+      html: 'The optimal orientation and tilt of a solar panel vary with latitude. In continental Europe, the ideal angle ranges between 30° and 40° depending on the season. Optimising for total annual output is not the same as optimising for winter months, when electricity demand is highest.',
+    },
+    {
+      type: 'title',
+      text: 'Real energy savings: LED bulbs and electricity tariffs',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Switching from halogens to LED is not simply "using fewer watts". It means understanding that a 9 W LED replaces a 60 W halogen while delivering the same luminous flux (800 lumens), achieving an <strong>85% reduction in consumption</strong>. Multiplied by annual hours of use and the price per kWh, savings can be quantified to the cent. Our calculator does exactly that.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Choosing the right electricity tariff is equally important. Fixed-price market contracts can be advantageous for consumers with regular habits; indexed tariffs fluctuate with the wholesale market and reward those who shift consumption to off-peak hours. Comparing both options with your actual consumption data can make a difference of <strong>100–300 € per year</strong>.',
+    },
+    {
+      type: 'title',
+      text: 'Humidity and condensation: the silent problem',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Sustained relative humidity above 70% leads to condensation at thermal bridges, mould growth, and structural deterioration. The dew point temperature — the value at which water vapour in the air condenses — is the key metric. If your interior wall surface is below that point, condensation will form regardless of whether you can see it.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Knowing the dew point of your environment lets you act before mould appears: ventilate at the right moment, adjust heating, or identify cold spots in the home where condensation is inevitable without additional insulation.',
+    },
+    {
+      type: 'title',
+      text: 'Audiovisual installations: calculating throw distance',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'A projector is not placed "wherever it fits". The throw ratio — the relationship between projection distance and image width — determines exactly how far back you need to position the unit to achieve the desired screen size. A 50 cm positioning error can mean an image 20 cm smaller, or force a digital zoom that reduces effective resolution.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Our projector calculator gives you the exact distance based on your model\'s throw ratio, the target screen size, and the image ratio (16:9, 4:3, 2.35:1). Ideal for planning the installation before drilling walls or purchasing the mount.',
+    },
+    {
+      type: 'title',
+      text: 'Connectivity and digital utilities for the modern home',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'The modern home integrates technology at every level: Wi-Fi networks, IoT devices, QR-code-based access. The QR code generator lets you create shortcuts to your home Wi-Fi, contact cards, smart device URLs, or any information you want to share easily with guests or between devices — no typing required.',
+    },
+    {
+      type: 'list',
+      items: [
+        '<strong>Quantifiable savings:</strong> Each tool returns concrete numbers — euros saved per year, kWh generated per month, optimal tilt degrees. No vague estimates.',
+        '<strong>No installation needed:</strong> Online calculators that run directly in the browser, no apps or accounts required.',
+        '<strong>Based on technical standards:</strong> Psychrometric formulas (ASHRAE), projection optics, solar radiation by latitude, and relevant electrical regulations.',
+        '<strong>Useful before you buy:</strong> Validate purchasing decisions before committing. Do solar panels pay off on your roof? How much do LEDs actually save? Calculate first.',
+      ],
+    },
+    {
+      type: 'title',
+      text: 'The efficient home: an investment with measurable returns',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Home energy efficiency improvements have a concrete ROI. A well-sized photovoltaic installation can pay for itself in 6–9 years at current electricity prices. A full LED retrofit in an average home pays back in under 2 years. A well-chosen tariff saves money from the first month. The starting point is always the same: <strong>measure before you act</strong>.',
+    },
+    {
+      type: 'paragraph',
+      html: 'These tools were built from the need to make home decisions with the same rigour applied to professional ones. The physics of a home are no different from those of industry: same laws, same formulas, same potential for optimisation. The difference is having access to the calculations.',
     },
   ],
 };
-

package/src/category/i18n/es.ts

@@ -1,24 +1,105 @@
 import type { CategoryLocaleContent } from '../../types';
 
 export const content: CategoryLocaleContent = {
-  slug: 'categoria-template',
-  title: 'Categoría Template',
-  description: 'Descripción de la categoría.',
+  slug: 'hogar',
+  title: 'Calculadoras y Herramientas para el Hogar',
+  description: 'Optimiza tu hogar con datos reales. Herramientas gratuitas para calcular el ahorro energético, comparar tarifas de luz, dimensionar placas solares, evitar condensaciones y planificar tu instalación audiovisual.',
   seo: [
     {
-      type: 'summary',
-      title: 'Resumen',
-      items: ['Punto 1', 'Punto 2', 'Punto 3'],
+      type: 'title',
+      text: '¿Por qué calcular antes de actuar en casa?',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'La mayoría de decisiones domésticas se toman por intuición: "creo que con estas placas solares me llega", "cambiando las bombillas debería ahorrar algo". La realidad es que un cálculo de cinco minutos puede ahorrarte cientos de euros al año o evitarte una reforma cara. Nuestras herramientas están basadas en <strong>física real</strong>: irradiación solar por latitud, consumo medido en watios, psicrometría del aire húmedo, óptica de proyección.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Un hogar eficiente no es un lujo; es una decisión técnica. La diferencia entre una casa con factura de luz desbocada y una con consumo controlado no suele ser el precio de la tarifa: es saber exactamente cuánto consume cada dispositivo, cuándo conviene generar energía propia y dónde se producen las pérdidas.',
     },
     {
       type: 'title',
-      text: 'Título de sección',
+      text: 'Energía solar en casa: más allá del marketing',
       level: 2,
     },
     {
       type: 'paragraph',
-      html: 'Contenido SEO de la categoría.',
+      html: 'Las instalaciones fotovoltaicas residenciales tienen un retorno de inversión real que depende de tres variables: la irradiación de tu ubicación, el ángulo de inclinación de los paneles y tu consumo horario. Un panel inclinado 10° menos de lo óptimo puede perder un <strong>15-20% de producción anual</strong>. Nuestra calculadora solar te da el ángulo exacto y la estimación de generación mensual.',
+    },
+    {
+      type: 'paragraph',
+      html: 'La orientación y la inclinación óptima de un panel solar varían con la latitud. En España peninsular, el ángulo ideal oscila entre 30° y 40° según la estación. No es lo mismo optimizar para producción anual total que para los meses de invierno, cuando la demanda eléctrica es mayor.',
+    },
+    {
+      type: 'title',
+      text: 'Ahorro energético real: bombillas LED y tarifas eléctricas',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Cambiar de halógenos a LED no es simplemente "usar menos vatios". Es entender que una bombilla LED de 9 W sustituye a una halógena de 60 W manteniendo el mismo flujo luminoso (800 lúmenes), con una <strong>reducción del 85% en consumo</strong>. Multiplicado por las horas de uso anuales y el precio por kWh, el ahorro se puede cuantificar al céntimo. Nuestra calculadora hace exactamente eso.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Elegir bien la tarifa eléctrica es igualmente importante. El mercado libre ofrece precios fijos que pueden ser ventajosos para consumidores de hábitos regulares; el PVPC (precio voluntario para el pequeño consumidor) fluctúa con el mercado mayorista y premia a quienes desplazan consumo a horas valle. Comparar ambas opciones con datos reales de tu consumo puede suponer una diferencia de <strong>100-300 € anuales</strong>.',
+    },
+    {
+      type: 'title',
+      text: 'Humedad y condensación: el problema silencioso',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'La humedad relativa por encima del 70% sostenida en el tiempo genera condensación en puentes térmicos, formación de moho y deterioro de estructuras. La temperatura de punto de rocío —el valor al que el vapor de agua del aire se condensa— es la métrica clave. Si tu pared interior está por debajo de ese punto, habrá condensación, independientemente de si lo notas a simple vista.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Conocer el punto de rocío de tu ambiente permite actuar antes de que aparezca el moho: ventilar en el momento adecuado, ajustar la calefacción, o identificar zonas frías de la vivienda donde la condensación es inevitable sin aislamiento adicional.',
+    },
+    {
+      type: 'title',
+      text: 'Instalaciones audiovisuales: cálculo de distancias de proyección',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Un proyector no se coloca "donde quepa". El <em>throw ratio</em> —relación entre distancia de proyección y ancho de imagen— determina exactamente la distancia necesaria para conseguir el tamaño de pantalla deseado. Un error de 50 cm en la posición puede significar una imagen 20 cm más pequeña o forzar un zoom digital que reduce resolución efectiva.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Nuestra calculadora de proyector te da la distancia exacta según el throw ratio de tu modelo, el tamaño de pantalla objetivo y las proporciones de imagen (16:9, 4:3, 2.35:1). Ideal para planificar la instalación antes de perforar paredes o adquirir el soporte.',
+    },
+    {
+      type: 'title',
+      text: 'Conectividad y utilidades digitales para el hogar moderno',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'El hogar moderno integra tecnología en cada rincón: redes WiFi, dispositivos IoT, accesos con código QR. El generador de códigos QR permite crear accesos directos a redes WiFi del hogar, fichas de contacto, URLs de dispositivos inteligentes o cualquier información que quieras compartir fácilmente con visitas o entre dispositivos, sin necesidad de teclear.',
+    },
+    {
+      type: 'list',
+      items: [
+        '<strong>Ahorro cuantificable:</strong> Cada herramienta devuelve cifras concretas: euros ahorrados al año, kWh generados al mes, grados de inclinación óptimos. No estimaciones vagas.',
+        '<strong>Sin instalación:</strong> Calculadoras online que funcionan directamente en el navegador, sin apps ni registros.',
+        '<strong>Basadas en estándares técnicos:</strong> Fórmulas de psicrometría (ASHRAE), óptica de proyección, radiación solar por latitud y normativa eléctrica española.',
+        '<strong>Útiles antes de comprar:</strong> Valida tus decisiones de compra antes de invertir. ¿Compensan las placas solares en tu tejado? ¿Cuánto ahorras realmente con LED? Calcula primero.',
+      ],
+    },
+    {
+      type: 'title',
+      text: 'El hogar eficiente: una inversión con retorno medible',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Las mejoras de eficiencia energética en el hogar tienen un ROI concreto. Una instalación fotovoltaica bien dimensionada puede amortizarse en 6-9 años con los precios actuales de la luz. El cambio completo a LED en una vivienda media se amortiza en menos de 2 años. Una tarifa bien elegida ahorra dinero desde el primer mes. El punto de partida es siempre el mismo: <strong>medir antes de actuar</strong>.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Estas herramientas nacieron de la necesidad de tomar decisiones domésticas con la misma rigor que se aplica a decisiones profesionales. La física del hogar no es diferente de la física industrial: mismas leyes, mismas fórmulas, mismas posibilidades de optimización. La diferencia es tener acceso a los cálculos.',
     },
   ],
 };
-

package/src/category/i18n/fr.ts

@@ -1,24 +1,105 @@
 import type { CategoryLocaleContent } from '../../types';
 
 export const content: CategoryLocaleContent = {
-  slug: 'categorie-template',
-  title: 'Catégorie Template',
-  description: 'Description de la catégorie.',
+  slug: 'maison',
+  title: 'Calculatrices et Outils pour la Maison',
+  description: 'Optimisez votre maison avec des données réelles. Outils gratuits pour calculer les économies d\'énergie, comparer les tarifs électriques, dimensionner vos panneaux solaires, prévenir la condensation et planifier votre installation audiovisuelle.',
   seo: [
     {
-      type: 'summary',
-      title: 'Résumé',
-      items: ['Point 1', 'Point 2', 'Point 3'],
+      type: 'title',
+      text: 'Pourquoi calculer avant d\'agir à la maison ?',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'La plupart des décisions domestiques se prennent à l\'intuition : "je pense que ces panneaux solaires suffiront", "changer les ampoules devrait faire des économies". La réalité, c\'est qu\'un calcul de cinq minutes peut vous faire économiser des centaines d\'euros par an ou vous éviter des travaux coûteux. Nos outils reposent sur de la <strong>physique réelle</strong> : irradiation solaire par latitude, consommation mesurée en watts, psychrométrie de l\'air humide, optique de projection.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Un logement efficace n\'est pas un luxe, c\'est une décision technique. La différence entre un foyer avec une facture d\'électricité incontrôlée et un autre avec une consommation maîtrisée tient rarement au prix du tarif : elle tient à savoir exactement combien consomme chaque appareil, quand il est rentable de produire sa propre énergie, et où se situent les pertes.',
     },
     {
       type: 'title',
-      text: 'Titre de section',
+      text: 'Énergie solaire résidentielle : au-delà du marketing',
       level: 2,
     },
     {
       type: 'paragraph',
-      html: 'Contenu SEO de la catégorie.',
+      html: 'Le retour sur investissement d\'une installation photovoltaïque résidentielle dépend de trois variables : l\'irradiation de votre emplacement, l\'angle d\'inclinaison des panneaux et votre consommation horaire. Un panneau incliné 10° en dessous de l\'optimum peut perdre <strong>15 à 20 % de production annuelle</strong>. Notre calculateur solaire vous donne l\'angle exact et l\'estimation mensuelle de production.',
+    },
+    {
+      type: 'paragraph',
+      html: 'L\'orientation et l\'inclinaison optimales d\'un panneau solaire varient selon la latitude. En Europe continentale, l\'angle idéal se situe entre 30° et 40° selon la saison. Optimiser pour la production annuelle totale n\'est pas la même chose qu\'optimiser pour les mois d\'hiver, quand la demande électrique est la plus forte.',
+    },
+    {
+      type: 'title',
+      text: 'Économies d\'énergie réelles : ampoules LED et tarifs électriques',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Passer des halogènes aux LED, ce n\'est pas simplement "utiliser moins de watts". C\'est comprendre qu\'une ampoule LED de 9 W remplace un halogène de 60 W en produisant le même flux lumineux (800 lumens), avec une <strong>réduction de 85 % de la consommation</strong>. Multiplié par les heures d\'utilisation annuelles et le prix du kWh, l\'économie se calcule au centime. Notre calculateur fait exactement cela.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Bien choisir son tarif électrique est tout aussi important. Les offres à prix fixe peuvent être avantageuses pour les consommateurs aux habitudes régulières ; les tarifs indexés fluctuent avec le marché de gros et récompensent ceux qui décalent leur consommation aux heures creuses. Comparer les deux options avec vos données réelles de consommation peut représenter une différence de <strong>100 à 300 € par an</strong>.',
+    },
+    {
+      type: 'title',
+      text: 'Humidité et condensation : le problème silencieux',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Une humidité relative supérieure à 70 % maintenue dans le temps provoque de la condensation aux ponts thermiques, le développement de moisissures et la dégradation des structures. La température de point de rosée — valeur à laquelle la vapeur d\'eau de l\'air se condense — est la métrique clé. Si la surface de votre mur intérieur est en dessous de ce seuil, il y aura condensation, que vous la voyez ou non.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Connaître le point de rosée de votre environnement permet d\'agir avant l\'apparition des moisissures : ventiler au bon moment, ajuster le chauffage, ou identifier les zones froides du logement où la condensation est inévitable sans isolation supplémentaire.',
+    },
+    {
+      type: 'title',
+      text: 'Installations audiovisuelles : calculer la distance de projection',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Un projecteur ne se place pas "là où ça rentre". Le <em>throw ratio</em> — rapport entre la distance de projection et la largeur de l\'image — détermine exactement la distance nécessaire pour obtenir la taille d\'écran souhaitée. Une erreur de 50 cm dans le positionnement peut se traduire par une image 20 cm plus petite, ou imposer un zoom numérique qui réduit la résolution effective.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Notre calculateur de projecteur vous donne la distance exacte selon le throw ratio de votre modèle, la taille d\'écran cible et le format d\'image (16:9, 4:3, 2.35:1). Idéal pour planifier l\'installation avant de percer les murs ou d\'acheter le support.',
+    },
+    {
+      type: 'title',
+      text: 'Connectivité et outils numériques pour la maison moderne',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'La maison moderne intègre la technologie à tous les niveaux : réseaux Wi-Fi, appareils IoT, accès par QR code. Le générateur de QR codes vous permet de créer des raccourcis vers votre réseau Wi-Fi domestique, des fiches de contact, des URL d\'appareils connectés, ou toute information à partager facilement avec des invités ou entre appareils — sans saisie manuelle.',
+    },
+    {
+      type: 'list',
+      items: [
+        '<strong>Économies quantifiables :</strong> Chaque outil retourne des chiffres concrets — euros économisés par an, kWh produits par mois, degrés d\'inclinaison optimaux. Pas d\'estimations vagues.',
+        '<strong>Sans installation :</strong> Calculatrices en ligne qui fonctionnent directement dans le navigateur, sans application ni inscription.',
+        '<strong>Basées sur des normes techniques :</strong> Formules psychrométriques (ASHRAE), optique de projection, rayonnement solaire par latitude et réglementation électrique en vigueur.',
+        '<strong>Utiles avant d\'acheter :</strong> Validez vos décisions d\'achat avant d\'investir. Les panneaux solaires sont-ils rentables sur votre toit ? Combien économisez-vous vraiment avec les LED ? Calculez d\'abord.',
+      ],
+    },
+    {
+      type: 'title',
+      text: 'La maison efficiente : un investissement au retour mesurable',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Les améliorations de l\'efficacité énergétique à la maison ont un ROI concret. Une installation photovoltaïque bien dimensionnée peut s\'amortir en 6 à 9 ans aux prix actuels de l\'électricité. Le remplacement complet des ampoules par des LED dans un logement moyen est amorti en moins de 2 ans. Un tarif bien choisi fait économiser de l\'argent dès le premier mois. Le point de départ est toujours le même : <strong>mesurer avant d\'agir</strong>.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Ces outils sont nés du besoin de prendre des décisions domestiques avec la même rigueur que les décisions professionnelles. La physique d\'un logement n\'est pas différente de celle de l\'industrie : mêmes lois, mêmes formules, mêmes possibilités d\'optimisation. La différence, c\'est d\'avoir accès aux calculs.',
     },
   ],
 };
-