@jjlmoya/utils-nature 1.1.0

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

@@ -0,0 +1,235 @@
+import type { WithContext, FAQPage, HowToThing, SoftwareApplication } from 'schema-dts';
+import type { DigitalCarbonLocaleContent } from '../index';
+
+const slug = 'calculateur-empreinte-carbone-numerique';
+const title = 'Calculateur d\'empreinte carbone numérique';
+const description = 'Analysez l\'impact environnemental de toute page web. Estimez la consommation d\'énergie et les émissions de CO₂ par visite.';
+
+const faqData = [
+  {
+    question: 'Qu\'est-ce que l\'empreinte carbone d\'une page web ?',
+    answer: 'C\'est la quantité de gaz à effet de serre, principalement le CO₂, émise dans l\'atmosphère à la suite de l\'énergie consommée par les serveurs, les réseaux de transmission et l\'appareil de l\'utilisateur pour charger et afficher une page web.',
+  },
+  {
+    question: 'Comment mesure-t-on l\'impact d\'un site web ?',
+    answer: 'Il est généralement mesuré en grammes de CO₂ équivalent (gCO₂e) par visite. Un site web efficace émet moins de 0,2 g de CO₂, tandis qu\'une page peu optimisée puede dépasser 2 ou 3 g par chargement.',
+  },
+  {
+    question: 'Pourquoi internet pollue-t-il ?',
+    answer: 'Parce que toute l\'infrastructure nécessaire (centres de données, câbles sous-marins, routeurs WiFi, smartphones) fonctionne à l\'électricité qui, dans une grande partie du monde, provient encore de la combustion du charbon ou du gaz.',
+  },
+  {
+    question: 'Comment réduire le CO₂ de mon site web ?',
+    answer: 'Le moyen le plus efficace est de réduire le poids de la page : optimisez les images (WebP), minimisez les fichiers CSS y JS, utilisez le chargement différé (lazy loading) y choisissez un hébergeur utilisant des énergies renouvelables.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Saisir l\'URL',
+    text: 'Tapez l\'adresse web de la page que vous souhaitez analyser dans le champ de saisie.',
+  },
+  {
+    name: 'Lancer l\'analyse',
+    text: 'Cliquez sur le bouton d\'analyse pour que notre outil estime le poids des ressources de la page.',
+  },
+  {
+    name: 'Consulter votre évaluation',
+    text: 'Obtenez une note de A+ à F basée sur l\'efficacité énergétique du site web analysé.',
+  },
+  {
+    name: 'Appliquer les améliorations',
+    text: 'Utilisez la liste de conseils personnalisés pour réduire le poids de votre site et son impact environnemental.',
+  },
+];
+
+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<HowToThing> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: title,
+  description,
+  step: howToData.map((step, i) => ({
+    '@type': 'HowToStep',
+    position: i + 1,
+    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: DigitalCarbonLocaleContent = {
+  slug,
+  title,
+  description,
+  ui: {
+    headInputs: 'Analyseur d\'URL',
+    headResults: 'Résultat de l\'impact',
+    headTips: 'Conseils d\'optimisation',
+    labelUrl: 'URL de la page',
+    btnAnalyze: 'Analyser le site',
+    btnAnalyzing: 'Analyse en cours...',
+    placeholderUrl: 'https://exemple.fr',
+    errorInvalidUrl: 'Veuillez saisir une URL valide.',
+    errorFetchFailed: 'Impossible d\'analyser le site. Essayez une autre URL.',
+    
+    resultTitle: 'Empreinte carbone numérique',
+    resultSubtitle: 'Efficacité estimée de la page',
+    co2PerVisit: 'CO₂ par visite',
+    energyPerVisit: 'Énergie consommée',
+    co2Annual: 'CO₂ annuel (100k visites)',
+    impactTitle: 'Impact réel annuel',
+    impactTrees: 'Arbres nécessaires',
+    impactKm: 'Km en voiture (approx.)',
+    treesLabel: 'Arbres',
+    kmLabel: 'Kilomètres',
+    
+    ratingExcellent: 'Excellent. Cette page consomme très peu d\'énergie par rapport à la moyenne mondiale.',
+    ratingVeryGood: 'Très bonne efficacité. La page est bien optimisée et a un impact minimal.',
+    ratingGood: 'Efficacité acceptable. Il y a de la marge pour s\'améliorer mais c\'est en dessous de la moyenne.',
+    ratingAverage: 'Dans la moyenne. La page consomme ce qui est attendu sur le web actuel.',
+    ratingPoor: 'Au-dessus de la moyenne. Pensez à optimiser les images, les scripts et les polices.',
+    ratingVeryPoor: 'Impact élevé. Le poids de la page est significatif et devrait être réduit.',
+    ratingCritical: 'Impact très élevé. Il y a une grande opportunité de réduire la taille de la page.',
+    
+    tipImages: 'Convertissez les images en WebP ou AVIF pour réduire leur poids jusqu\'à 70%.',
+    tipCompression: 'Activez Brotli ou GZIP sur le serveur pour compresser les ressources.',
+    tipLazyLoading: 'Utilisez le lazy loading pour les images et vidéos hors champ.',
+    tipHosting: 'Choisissez un hébergement avec énergie renouvelable (Cloudflare, Netlify, Vercel).',
+    tipThirdParty: 'Supprimez les scripts d\'analyse et les widgets tiers inutiles.',
+    tipFonts: 'Ne chargez que les graisses typographiques que vous utilisez réellement.',
+    tipCache: 'Configurez les en-têtes de cache HTTP pour éviter les re-téléchargements.',
+  },
+  faqTitle: 'Questions Fréquemment Posées',
+  faq: faqData,
+  howTo: howToData,
+  bibliographyTitle: 'Références sur la durabilité du web',
+  seo: [
+    {
+      type: 'title',
+      text: 'Calculateur d\'empreinte carbone numérique : Quel est le CO₂ généré par votre site',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Découvrez l\'impact environnemental réel de n\'importe quelle page web. Analysez son poids, estimez les grammes de CO₂ par visite et apprenez à réduire la pollution numérique de vos projets.',
+    },
+    {
+      type: 'title',
+      text: 'Qu\'est-ce que l\'empreinte carbone numérique d\'un site web ?',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Chaque fois que vous ouvrez une page web, votre appareil, votre routeur, les câbles sous-marins et les serveurs à l\'autre bout du monde consomment de l\'électricité. Cette électricité est encore largement générée par la combustion d\'énergies fossiles. Résultat : une quantité réelle de <strong>CO₂ émise dans l\'atmosphère à chaque visite</strong>.',
+    },
+    {
+      type: 'paragraph',
+      html: 'L\'<strong>empreinte carbone numérique</strong> d\'un site web se mesure en grammes de CO₂ équivalent (gCO₂e) par visite. Un site web moyen génère environ 0,5 g de CO₂ par chargement. Bien que cela semble insignifiant, un site avec 100 000 visites mensuelles peut émettre plus de 600 kg de CO₂ par an, l\'équivalent de conduire une voiture à essence sur plus de 3 000 km.',
+    },
+    {
+      type: 'title',
+      text: 'Comment est calculé le CO₂ d\'une page web ?',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Le modèle de calcul utilisé est basé sur les standards du <strong>Sustainable Web Design Model</strong>, qui divise la consommation d\'énergie en quatre segments principaux :',
+    },
+    {
+      type: 'card',
+      title: 'Transfert de données',
+      html: 'Le poids total de la page détermine le nombre de gigaoctets transférés. Le standard considère <code>0,81 kWh/Go</code> pour l\'infrastructure réseau.',
+    },
+    {
+      type: 'card',
+      title: 'Appareil utilisateur',
+      html: 'L\'ordinateur ou le mobile recevant la page consomme de l\'énergie. Elle est estimée à <code>0,52 kWh/Go</code> de données traitées.',
+    },
+    {
+      type: 'card',
+      title: 'Intensité carbone',
+      html: 'On utilise la valeur de référence mondiale de <code>442 gCO₂/kWh</code> pour convertir la consommation d\'énergie en émissions réelles.',
+    },
+    {
+      type: 'card',
+      title: 'Facteur de cache',
+      html: 'Le modèle applique un facteur de <code>0,75</code> en supposant que 25 % des utilisateurs ont déjà des ressources en cache.',
+    },
+    {
+      type: 'title',
+      text: 'Que signifie l\'évaluation de l\'efficacité ?',
+      level: 2,
+    },
+    {
+      type: 'list',
+      items: [
+        '<strong>A+ et A :</strong> Moins de 0,2 g de CO₂. Sites très légers et optimisés.',
+        '<strong>B :</strong> Entre 0,2 et 0,5 g. En dessous de la moyenne mondiale.',
+        '<strong>C :</strong> Entre 0,5 et 1 g. La moyenne du web actuel.',
+        '<strong>D et E :</strong> Entre 1 et 4 g. Pages lourdes avec un impact important.',
+        '<strong>F :</strong> Plus de 4 g par visite. Impact très élevé.',
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Comment réduire l\'empreinte carbone de votre site',
+      level: 2,
+    },
+    {
+      type: 'card',
+      title: 'Optimisation des images',
+      html: 'Utilisez des formats comme <strong>WebP ou AVIF</strong> pour réduire la taille jusqu\'à 80 % sans perte de qualité visible.',
+    },
+    {
+      type: 'card',
+      title: 'Compression du serveur',
+      html: 'L\'activation de <strong>Brotli ou GZIP</strong> réduit la taille des fichiers texte jusqu\'à 70 %.',
+    },
+    {
+      type: 'card',
+      title: 'Hébergement durable',
+      html: 'Choisir un fournisseur avec des <strong>énergies renouvelables certifiées</strong> peut réduire l\'impact de près de 100 %.',
+    },
+    {
+      type: 'card',
+      title: 'Cache et CDN',
+      html: 'Configurez des <strong>en-têtes de cache longs</strong> pour éviter les téléchargements inutiles.',
+    },
+    {
+      type: 'title',
+      text: 'L\'impact réel d\'Internet sur le climat',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Internet représente entre <strong>2% et 4% des émissions mondiales de CO₂</strong>, un chiffre comparable à l\'industrie aéronautique. Chaque kilo-octet éliminé ne rend pas seulement votre site plus rapide : il réduit de manière mesurable la pollution numérique.',
+    },
+  ],
+  bibliography: [
+    { name: 'Sustainable Web Design Model', url: 'https://sustainablewebdesign.org/' },
+    { name: 'Website Carbon Calculator', url: 'https://www.websitecarbon.com/' },
+    { name: 'The Green Web Foundation', url: 'https://www.thegreenwebfoundation.org/' },
+    { name: 'W3C - Web Sustainability Guidelines', url: 'https://w3c.github.io/sustyweb/' },
+  ],
+  schemas: [faqSchema, howToSchema, appSchema],
+};

package/src/tool/digitalCarbon/index.ts

@@ -0,0 +1,33 @@
+import type { NatureToolEntry, ToolLocaleContent, ToolDefinition } from '../../types';
+import DigitalCarbonComponent from './component.astro';
+import DigitalCarbonSEO from './seo.astro';
+import DigitalCarbonBibliography from './bibliography.astro';
+import type { DigitalCarbonUI } from './ui';
+
+export type DigitalCarbonLocaleContent = ToolLocaleContent<DigitalCarbonUI>;
+
+import { content as es } from './i18n/es';
+import { content as en } from './i18n/en';
+import { content as fr } from './i18n/fr';
+
+export const digitalCarbon: NatureToolEntry<DigitalCarbonUI> = {
+  id: 'digital-carbon',
+  icons: {
+    bg: 'mdi:leaf',
+    fg: 'mdi:monitor',
+  },
+  i18n: {
+    es: async () => es,
+    en: async () => en,
+    fr: async () => fr,
+  },
+};
+
+export { DigitalCarbonComponent, DigitalCarbonSEO, DigitalCarbonBibliography };
+
+export const DIGITAL_CARBON_TOOL: ToolDefinition = {
+  entry: digitalCarbon,
+  Component: DigitalCarbonComponent,
+  SEOComponent: DigitalCarbonSEO,
+  BibliographyComponent: DigitalCarbonBibliography,
+};

package/src/tool/digitalCarbon/logic.ts

@@ -0,0 +1,107 @@
+export interface DCFRating {
+  label: string;
+  color: string;
+  pct: number;
+  descKey: string;
+}
+
+export interface DCFResult {
+  url: string;
+  bytes: number;
+  co2g: number;
+  energyWh: number;
+  co2Year: number;
+  trees: string;
+  km: string;
+  pageSize: string;
+  rating: DCFRating;
+  tipKeys: string[];
+}
+
+const NET_KWH_PER_GB = 0.81;
+const DEVICE_KWH_PER_GB = 0.52;
+const CARBON_G_PER_KWH = 442;
+const RETURN_RATIO = 0.75;
+
+export function formatBytes(bytes: number): string {
+  if (bytes < 1024) return `${bytes} B`;
+  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
+  return `${(bytes / (1024 * 1024)).toFixed(2)} MB`;
+}
+
+function calcCO2(bytes: number): { co2g: number; energyWh: number } {
+  const gb = (bytes / 1e9) * RETURN_RATIO;
+  const energyKwh = (NET_KWH_PER_GB + DEVICE_KWH_PER_GB) * gb;
+  return { co2g: energyKwh * CARBON_G_PER_KWH, energyWh: energyKwh * 1000 };
+}
+
+function getRating(co2g: number): DCFRating {
+  if (co2g < 0.1) return { label: 'A+', color: '#10b981', pct: 5, descKey: 'ratingExcellent' };
+  if (co2g < 0.2) return { label: 'A', color: '#22c55e', pct: 15, descKey: 'ratingVeryGood' };
+  if (co2g < 0.5) return { label: 'B', color: '#84cc16', pct: 35, descKey: 'ratingGood' };
+  if (co2g < 1.0) return { label: 'C', color: '#f59e0b', pct: 58, descKey: 'ratingAverage' };
+  if (co2g < 2.0) return { label: 'D', color: '#f97316', pct: 72, descKey: 'ratingPoor' };
+  if (co2g < 4.0) return { label: 'E', color: '#ef4444', pct: 88, descKey: 'ratingVeryPoor' };
+  return { label: 'F', color: '#dc2626', pct: 98, descKey: 'ratingCritical' };
+}
+
+function getTipKeys(bytes: number): string[] {
+  const keys: string[] = [];
+  const kb = bytes / 1024;
+  if (kb > 500) keys.push('tipImages');
+  if (kb > 200) keys.push('tipCompression');
+  if (kb > 300) keys.push('tipLazyLoading');
+  keys.push('tipHosting');
+  keys.push('tipThirdParty');
+  if (kb > 1000) keys.push('tipFonts');
+  keys.push('tipCache');
+  return keys;
+}
+
+function extractHtml(text: string): string {
+  try {
+    const json = JSON.parse(text) as Record<string, unknown>;
+    return (json.contents ?? json.body ?? text) as string;
+  } catch {
+    return text;
+  }
+}
+
+export async function estimatePageSize(url: string): Promise<number> {
+  const encoded = encodeURIComponent(url);
+  const proxies = [
+    `https://api.allorigins.win/get?url=${encoded}`,
+    `https://corsproxy.io/?${encoded}`,
+    `https://api.codetabs.com/v1/proxy/?quest=${encoded}`,
+  ];
+  
+  for (const proxy of proxies) {
+    try {
+      const resp = await fetch(proxy, { signal: AbortSignal.timeout(10000) });
+      if (!resp.ok) continue;
+      const html = extractHtml(await resp.text());
+      if (!html || html.length < 100) continue;
+      return Math.round(new TextEncoder().encode(html).length * 5.5);
+    } catch {
+      continue;
+    }
+  }
+  throw new Error('fetch_failed');
+}
+
+export function buildResult(url: string, bytes: number): DCFResult {
+  const { co2g, energyWh } = calcCO2(bytes);
+  const co2Year = (co2g * 100000) / 1000;
+  return {
+    url,
+    bytes,
+    co2g,
+    energyWh,
+    co2Year,
+    trees: (co2Year / 21).toFixed(1),
+    km: (co2Year / 0.21).toFixed(0),
+    pageSize: formatBytes(bytes),
+    rating: getRating(co2g),
+    tipKeys: getTipKeys(bytes),
+  };
+}

package/src/tool/digitalCarbon/seo.astro

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

package/src/tool/digitalCarbon/ui.ts

@@ -0,0 +1,38 @@
+export interface DigitalCarbonUI extends Record<string, string> {
+  headInputs: string;
+  headResults: string;
+  headTips: string;
+  labelUrl: string;
+  btnAnalyze: string;
+  btnAnalyzing: string;
+  placeholderUrl: string;
+  errorInvalidUrl: string;
+  errorFetchFailed: string;
+  
+  resultTitle: string;
+  resultSubtitle: string;
+  co2PerVisit: string;
+  energyPerVisit: string;
+  co2Annual: string;
+  impactTitle: string;
+  impactTrees: string;
+  impactKm: string;
+  treesLabel: string;
+  kmLabel: string;
+  
+  ratingExcellent: string;
+  ratingVeryGood: string;
+  ratingGood: string;
+  ratingAverage: string;
+  ratingPoor: string;
+  ratingVeryPoor: string;
+  ratingCritical: string;
+  
+  tipImages: string;
+  tipCompression: string;
+  tipLazyLoading: string;
+  tipHosting: string;
+  tipThirdParty: string;
+  tipFonts: string;
+  tipCache: string;
+}

package/src/tool/rainHarvester/bibliography.astro

@@ -0,0 +1,9 @@
+---
+import { Bibliography as SharedBibliography } from '@jjlmoya/utils-shared';
+import { rainHarvester } from './index';
+
+const { locale = 'es' } = Astro.props;
+const content = await rainHarvester.i18n[locale as keyof typeof rainHarvester.i18n]?.();
+---
+
+{content && <SharedBibliography links={content.bibliography} />}