@jjlmoya/utils-health 1.1.0

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

@@ -0,0 +1,225 @@
+import type { WithContext, SoftwareApplication, FAQPage, HowToThing } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { ScreenDecompressionTimeUI } from '../ui';
+
+const slug = 'calculateur-decompression-oculaire';
+const title = 'Calculateur de Décompression Oculaire';
+const description =
+  "Calculez les minutes de repos visuel dont vous avez besoin en fonction de vos heures d'écran quotidiennes. Règle 20-20-20 personnalisée pour prévenir la fatigue visuelle numérique.";
+
+const faqData = [
+  {
+    question: "Qu'est-ce que la règle 20-20-20 et pourquoi fonctionne-t-elle?",
+    answer:
+      "La règle 20-20-20 stipule que toutes les 20 minutes de travail sur écran, vous devez regarder un objet à 20 pieds (environ 6 mètres) pendant au moins 20 secondes. Cet intervalle permet au muscle ciliaire — responsable de la mise au point — de se détendre complètement après la contraction soutenue exigée par la vision de près.",
+  },
+  {
+    question: "Combien de minutes de repos me faut-il pour 8 heures de travail sur ordinateur?",
+    answer:
+      "Pour 8 heures d'exposition à l'écran, la calculatrice recommande environ 16 minutes de repos visuel réparties tout au long de la journée, avec des pauses de 30 secondes toutes les 20 minutes. Une pause supplémentaire de 10 à 15 minutes en milieu de session est également recommandée.",
+  },
+  {
+    question: "Pourquoi les yeux se fatiguent-ils devant les écrans?",
+    answer:
+      "Les écrans obligent le muscle ciliaire à maintenir une contraction soutenue pour maintenir la mise au point sur un point proche. Ils réduisent également la fréquence de clignement de 17 à seulement 7 fois par minute, provoquant une sécheresse. La lumière bleue haute énergie (380-500 nm) ajoute un stress oxydatif supplémentaire à la rétine.",
+  },
+  {
+    question: "Les lunettes anti-lumière bleue sont-elles nécessaires?",
+    answer:
+      "Les preuves scientifiques sur les filtres anti-lumière bleue sont mitigées pour la fatigue générale, mais ils sont particulièrement utiles au-delà de 6 à 8 heures d'écran quotidiennes. Leur bénéfice le mieux documenté est la réduction de la suppression nocturne de la mélatonine, améliorant la qualité du sommeil des utilisateurs intensifs.",
+  },
+  {
+    question: "Quand consulter un ophtalmologue pour la fatigue visuelle numérique?",
+    answer:
+      "Consultez un spécialiste si vous présentez une vision floue persistant plus de 30 minutes après avoir quitté l'écran, des maux de tête frontaux ou occipitaux fréquents, une vision double, une sensation persistante de corps étranger ou des changements soudains de l'acuité visuelle. Ces symptômes peuvent indiquer des erreurs réfractives non corrigées ou une pathologie oculaire.",
+  },
+];
+
+const howToData = [
+  {
+    name: "Saisissez vos heures d'écran",
+    text: "Utilisez le curseur ou le champ numérique pour indiquer combien d'heures par jour vous passez devant les écrans (ordinateur, téléphone, tablette). La plage va de 0 à 16 heures.",
+  },
+  {
+    name: 'Obtenez votre plan personnalisé',
+    text: "La calculatrice affiche instantanément les minutes de repos recommandées, le niveau de fatigue oculaire, l'intervalle optimal entre les pauses et la distance de travail idéale.",
+  },
+  {
+    name: 'Appliquez les recommandations dynamiques',
+    text: "Lisez les 4 cartes de recommandations adaptées à vos heures: gestion des pauses, posture ergonomique, fréquence de clignement et protection contre la lumière bleue.",
+  },
+  {
+    name: 'Visualisez votre journée idéale',
+    text: "Le graphique chronologique montre comment votre journée devrait être distribuée entre temps de travail sur écran, pauses visuelles et activités sans écran.",
+  },
+];
+
+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: 'HealthApplication',
+  operatingSystem: 'Web',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+};
+
+export const content: ToolLocaleContent<ScreenDecompressionTimeUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: "Questions fréquentes sur la fatigue visuelle et les écrans",
+  faq: faqData,
+  bibliographyTitle: 'Références scientifiques',
+  bibliography: [
+    {
+      name: "Organisation Mondiale de la Santé — Santé oculaire",
+      url: 'https://www.who.int/es/news-room/fact-sheets/detail/blindness-and-visual-impairment',
+    },
+    {
+      name: 'American Optometric Association — Computer Vision Syndrome',
+      url: 'https://www.aoa.org/healthy-eyes/eye-and-vision-conditions/computer-vision-syndrome',
+    },
+    {
+      name: "Mayo Clinic — Fatigue oculaire",
+      url: 'https://www.mayoclinic.org/diseases-conditions/eyestrain/symptoms-causes/syc-20372397',
+    },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  ui: {
+    labelHours: "Heures d'écran par jour",
+    presetLow: 'Peu',
+    presetNormal: 'Normal',
+    presetHigh: 'Beaucoup',
+    resultUnit: 'minutes de repos',
+    resultPer: 'par jour',
+    statInterval: 'Intervalle',
+    statBreaks: 'Pauses/jour',
+    statDistance: 'Distance idéale',
+    timelineTitle: 'Votre Journée Visuelle Idéale',
+    timelineWork: 'Travail',
+    timelineRest: 'Repos',
+    timelineOther: 'Autres',
+    fatigueLow: 'Faible',
+    fatigueMod: 'Modérée',
+    fatigueHigh: 'Élevée',
+    fatigueCritical: 'Critique',
+    recBreaksTitle: 'Pauses',
+    recBreaksText: 'Faites une pause visuelle toutes les {0} minutes de travail continu.',
+    recPostureTitle: 'Posture',
+    recPostureLow: "Gardez l'écran à 60-70 cm. Ajustez la hauteur au niveau des yeux.",
+    recPostureMod: "Augmentez la distance à 70-80 cm. Utilisez un moniteur d'au moins 24 pouces.",
+    recPostureHigh: "Distance minimale 80-100 cm. Envisagez un projecteur ou un grand écran.",
+    recBlinkTitle: 'Clignement',
+    recBlinkText: 'Clignez consciemment {0}+ fois par heure. Les écrans réduisent le clignement de 66%.',
+    recLightTitle: 'Lumière Bleue',
+    recLightLow: "Activez le mode nuit du système d'exploitation à partir de 20h.",
+    recLightMod: "Utilisez des lunettes avec filtre ou activez f.lux/Night Shift sur tous vos appareils.",
+    recLightHigh: "Filtre lumière bleue + lunettes spécialisées + mode sombre INDISPENSABLES.",
+    unitMin: 'min',
+  },
+  seo: [
+    {
+      type: 'summary',
+      title: 'Calculateur de Décompression Oculaire',
+      items: [
+        "<strong>Formule personnalisée</strong>: 2 minutes de repos par heure d'exposition à l'écran.",
+        '<strong>4 niveaux de fatigue</strong>: Faible, Modérée, Élevée et Critique avec des recommandations adaptées.',
+        "<strong>Règle 20-20-20</strong>: intervalles de pause calculés selon vos heures d'utilisation réelles.",
+        '<strong>Chronologie</strong>: visualisation de votre journée idéale avec blocs de travail et de repos.',
+      ],
+    },
+    {
+      type: 'title',
+      text: "Fatigue Visuelle Numérique: Le Coût Caché du Travail sur Écran",
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: "Plus de <strong>60% des travailleurs numériques</strong> ressentent quotidiennement des symptômes de fatigue visuelle numérique: yeux irrités, vision floue, maux de tête frontaux ou sensation de lourdeur oculaire. Ce syndrome, cliniquement connu sous le nom de <em>Computer Vision Syndrome</em> (CVS), est la conséquence directe de soumettre le système visuel à un effort de mise au point de proximité soutenu sans les repos que la physiologie oculaire exige.",
+    },
+    {
+      type: 'title',
+      text: "La Règle 20-20-20: Base Scientifique et Application Pratique",
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: "La règle 20-20-20 a été popularisée par le Dr Jeff Anshel comme méthode mnémotechnique pour mettre en œuvre des pauses visuelles. Toutes les <strong>20 minutes</strong> de travail sur écran, regardez un objet à <strong>20 pieds</strong> (≈6 mètres) pendant <strong>20 secondes</strong>. Cet intervalle suffit pour que le muscle ciliaire atteigne son état de relaxation complète, équivalent à la vision infinie.",
+    },
+    {
+      type: 'table',
+      headers: ["Heures d'écran", 'Niveau de risque', 'Symptômes fréquents', 'Repos recommandé'],
+      rows: [
+        ['0-2 h', 'Faible', 'Pratiquement aucun', '4 min/jour'],
+        ['2-4 h', 'Faible-Modéré', 'Légère sécheresse occasionnelle', '6-8 min/jour'],
+        ['4-8 h', 'Modéré', 'Sécheresse, céphalée, flou vespéral', '10-16 min/jour'],
+        ['8-12 h', 'Élevé', 'Fatigue marquée, diplopie transitoire', '18-24 min/jour'],
+        ['>12 h', 'Critique', 'Symptômes persistants, risque pathologique', '>24 min/jour'],
+      ],
+    },
+    {
+      type: 'tip',
+      title: 'Le Clignement: La Variable Oubliée',
+      html: "Dans des conditions normales, nous clignons <strong>17 fois par minute</strong>, distribuant le film lacrymal sur la cornée. Devant un écran, ce taux tombe à <strong>7 fois par minute</strong> — une réduction de 59%. Le résultat est une évaporation accélérée des larmes, une sécheresse et une irritation accrue. Cligner consciemment toutes les quelques minutes est aussi important que les pauses visuelles.",
+    },
+    {
+      type: 'title',
+      text: "Lumière Bleue: Effets sur le Système Visuel et le Sommeil",
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: "Les écrans LED émettent dans la plage <strong>380-500 nm</strong> (lumière bleue haute énergie). Ce spectre a deux effets documentés: il stimule les cellules ganglionnaires rétiniennes qui régulent le rythme circadien, supprimant la sécrétion nocturne de <strong>mélatonine</strong>; et génère un stress oxydatif dans l'épithélium pigmentaire rétinien avec une exposition chronique et cumulée.",
+    },
+    {
+      type: 'title',
+      text: "Ergonomie Visuelle: Posture et Distance de Travail",
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: "La distance de travail n'est pas une donnée arbitraire: à <strong>60 cm</strong> le muscle ciliaire travaille à 50% de sa capacité d'accommodation maximale; à <strong>90 cm</strong> l'effort tombe à presque zéro. Pour les utilisateurs intensifs (>8h), augmenter la distance de travail et utiliser une police plus grande réduit significativement la charge ciliaire quotidienne cumulée.",
+    },
+    {
+      type: 'title',
+      text: "Quand Consulter un Ophtalmologue",
+      level: 2,
+    },
+    {
+      type: 'list',
+      items: [
+        "Vision floue <strong>persistant plus de 30 minutes</strong> après avoir quitté l'écran.",
+        "Maux de tête frontaux ou occipitaux <strong>fréquents</strong> associés au travail numérique.",
+        'Vision double transitoire ou difficulté à changer la mise au point entre les distances.',
+        "<strong>Persistante</strong> sensation de corps étranger, démangeaisons ou picotements.",
+        "Changements soudains de l'acuité visuelle sans lien avec la fatigue.",
+        "Symptômes qui <strong>ne s'améliorent pas</strong> avec les mesures préventives standard.",
+      ],
+    },
+  ],
+};

package/src/tool/screenDecompressionTime/index.ts

@@ -0,0 +1,27 @@
+import type { HealthToolEntry, ToolDefinition } from '../../types';
+import ScreenDecompressionTimeComponent from './component.astro';
+import ScreenDecompressionTimeSEO from './seo.astro';
+import ScreenDecompressionTimeBibliography from './bibliography.astro';
+import type { ScreenDecompressionTimeUI } from './ui';
+
+export const screenDecompressionTime: HealthToolEntry<ScreenDecompressionTimeUI> = {
+  id: 'screenDecompressionTime',
+  icons: {
+    bg: 'mdi:eye-outline',
+    fg: 'mdi:monitor',
+  },
+  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 { ScreenDecompressionTimeComponent, ScreenDecompressionTimeSEO, ScreenDecompressionTimeBibliography };
+
+export const SCREEN_DECOMPRESSION_TIME_TOOL: ToolDefinition = {
+  entry: screenDecompressionTime,
+  Component: ScreenDecompressionTimeComponent,
+  SEOComponent: ScreenDecompressionTimeSEO,
+  BibliographyComponent: ScreenDecompressionTimeBibliography,
+};

package/src/tool/screenDecompressionTime/seo.astro

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

package/src/tool/screenDecompressionTime/ui.ts

@@ -0,0 +1,32 @@
+export interface ScreenDecompressionTimeUI extends Record<string, string> {
+  labelHours: string;
+  presetLow: string;
+  presetNormal: string;
+  presetHigh: string;
+  resultUnit: string;
+  resultPer: string;
+  statInterval: string;
+  statBreaks: string;
+  statDistance: string;
+  timelineTitle: string;
+  timelineWork: string;
+  timelineRest: string;
+  timelineOther: string;
+  fatigueLow: string;
+  fatigueMod: string;
+  fatigueHigh: string;
+  fatigueCritical: string;
+  recBreaksTitle: string;
+  recBreaksText: string;
+  recPostureTitle: string;
+  recPostureLow: string;
+  recPostureMod: string;
+  recPostureHigh: string;
+  recBlinkTitle: string;
+  recBlinkText: string;
+  recLightTitle: string;
+  recLightLow: string;
+  recLightMod: string;
+  recLightHigh: string;
+  unitMin: string;
+}

package/src/tool/tinnitusReliever/bibliography.astro

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