@jjlmoya/utils-health 1.1.0

package/package.json

@@ -0,0 +1,60 @@
+{
+    "name": "@jjlmoya/utils-health",
+    "version": "1.1.0",
+    "type": "module",
+    "main": "./src/index.ts",
+    "types": "./src/index.ts",
+    "exports": {
+        ".": "./src/index.ts",
+        "./data": "./src/data.ts"
+    },
+    "files": [
+        "src"
+    ],
+    "publishConfig": {
+        "access": "public"
+    },
+    "scripts": {
+        "dev": "astro dev",
+        "start": "astro dev",
+        "build": "astro build",
+        "preview": "astro preview",
+        "astro": "astro",
+        "lint": "eslint src/ --max-warnings 0 && stylelint \"src/**/*.{css,astro}\"",
+        "check": "astro check",
+        "type-check": "astro check",
+        "test": "vitest run",
+        "preversion": "npm run lint && npm run test",
+        "postversion": "git push && git push --tags",
+        "patch": "npm version patch",
+        "minor": "npm version minor",
+        "major": "npm version major"
+    },
+    "lint-staged": {
+        "*.{ts,tsx,astro}": [
+            "eslint --fix"
+        ]
+    },
+    "dependencies": {
+        "@iconify-json/mdi": "^1.2.3",
+        "@jjlmoya/utils-shared": "^1.2.0",
+        "astro": "^6.1.2",
+        "astro-icon": "^1.1.0"
+    },
+    "devDependencies": {
+        "@astrojs/check": "^0.9.8",
+        "eslint": "^9.39.4",
+        "eslint-plugin-astro": "^1.6.0",
+        "eslint-plugin-no-comments": "^1.1.10",
+        "husky": "^9.1.7",
+        "lint-staged": "^16.4.0",
+        "postcss-html": "^1.8.1",
+        "schema-dts": "^1.1.2",
+        "stylelint": "^17.6.0",
+        "stylelint-config-standard": "^40.0.0",
+        "stylelint-declaration-strict-value": "^1.11.1",
+        "typescript": "^5.4.0",
+        "typescript-eslint": "^8.58.0",
+        "vitest": "^4.1.2"
+    }
+}

package/src/category/i18n/en.ts

@@ -0,0 +1,60 @@
+import type { CategoryLocaleContent } from '../../types';
+
+export const content: CategoryLocaleContent = {
+  slug: 'health',
+  title: 'Online Health Tools',
+  description:
+    'Free health calculators and utilities: BMI, body fat percentage, calories, hydration and more. Based on international medical standards.',
+  seo: [
+    {
+      type: 'summary',
+      title: 'What you will find in this category',
+      items: [
+        'BMI calculator with visual scale and WHO categories',
+        'Results based on verified medical algorithms',
+        'Completely free, no registration or tracking cookies',
+        'Full privacy: calculations happen on your device',
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Science-Based Health Tools',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Personal health is one of the areas where precise information makes a real difference. Our collection of <strong>online health utilities</strong> is designed to provide objective data, based on the standards of the World Health Organization (WHO) and other internationally recognized medical institutions.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Unlike mobile apps that require access to personal data or device sensors, all these tools work directly in the browser. <strong>No health data leaves your device</strong>. No servers, no storage, no user profiles.',
+    },
+    {
+      type: 'title',
+      text: 'Why a number is not everything',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Health calculators offer an <strong>indicative reference</strong>, not a diagnosis. The Body Mass Index, for example, is a useful statistical screening tool for the general population, but it does not differentiate between muscle tissue and body fat. An elite athlete may have a technically elevated BMI without presenting any metabolic health problems.',
+    },
+    {
+      type: 'tip',
+      title: 'Important medical disclaimer',
+      html: 'All tools in this category are informational and educational in nature. They do not replace the judgment of a healthcare professional under any circumstances. If you have concerns about your health, always consult your doctor or specialist.',
+    },
+    {
+      type: 'title',
+      text: 'Fundamentals of Health Metrics',
+      level: 2,
+    },
+    {
+      type: 'list',
+      items: [
+        '<strong>BMI (Body Mass Index):</strong> Weight/height ratio. WHO screening indicator to classify nutritional status in adults.',
+        '<strong>Privacy by design:</strong> Calculations performed exclusively on the client. No telemetry, no tracking cookies, no personal data analysis.',
+        '<strong>International standards:</strong> The ranges and thresholds used correspond to guidelines published by the WHO and reference medical bodies.',
+      ],
+    },
+  ],
+};

package/src/category/i18n/es.ts

@@ -0,0 +1,60 @@
+import type { CategoryLocaleContent } from '../../types';
+
+export const content: CategoryLocaleContent = {
+  slug: 'salud',
+  title: 'Herramientas de Salud Online',
+  description:
+    'Calculadoras y utilidades de salud gratuitas: IMC, porcentaje de grasa, calorías, hidratación y más. Basadas en estándares médicos internacionales.',
+  seo: [
+    {
+      type: 'summary',
+      title: 'Qué encontrarás en esta categoría',
+      items: [
+        'Calculadora de IMC con escala visual y categorías según la OMS',
+        'Resultados basados en algoritmos médicos verificados',
+        'Totalmente gratuito, sin registro ni cookies de seguimiento',
+        'Privacidad total: los cálculos ocurren en tu dispositivo',
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Herramientas de Salud Basadas en Ciencia',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'La salud personal es uno de los ámbitos donde la información precisa marca la diferencia. Nuestra colección de <strong>utilidades de salud online</strong> está diseñada para proporcionar datos objetivos, basados en los estándares de la Organización Mundial de la Salud (OMS) y otras instituciones médicas de referencia internacional.',
+    },
+    {
+      type: 'paragraph',
+      html: 'A diferencia de las aplicaciones móviles que requieren acceso a datos personales o sensores del dispositivo, todas estas herramientas funcionan directamente en el navegador. <strong>Ningún dato de salud abandona tu dispositivo</strong>. No hay servidores, no hay almacenamiento, no hay perfiles de usuario.',
+    },
+    {
+      type: 'title',
+      text: 'Por qué un número no lo es todo',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Las calculadoras de salud ofrecen una <strong>referencia orientativa</strong>, no un diagnóstico. El Índice de Masa Corporal, por ejemplo, es una herramienta de cribado estadístico útil para la población general, pero no diferencia entre tejido muscular y grasa corporal. Un deportista de élite puede tener un IMC técnicamente elevado sin presentar ningún problema de salud metabólico.',
+    },
+    {
+      type: 'tip',
+      title: 'Aviso médico importante',
+      html: 'Todas las herramientas de esta categoría son de carácter informativo y educativo. No sustituyen en ningún caso el criterio de un profesional sanitario. Si tienes preocupaciones sobre tu salud, consulta siempre con tu médico o especialista.',
+    },
+    {
+      type: 'title',
+      text: 'Fundamentos de las Métricas de Salud',
+      level: 2,
+    },
+    {
+      type: 'list',
+      items: [
+        '<strong>IMC (Índice de Masa Corporal):</strong> Relación peso/altura. Indicador de cribado de la OMS para clasificar el estado nutricional en adultos.',
+        '<strong>Privacidad por diseño:</strong> Cálculos realizados exclusivamente en el cliente. Sin telemetría, sin cookies de seguimiento, sin análisis de datos personales.',
+        '<strong>Estándares internacionales:</strong> Los rangos y umbrales utilizados corresponden a las guías publicadas por la OMS y organismos médicos de referencia.',
+      ],
+    },
+  ],
+};

package/src/category/i18n/fr.ts

@@ -0,0 +1,60 @@
+import type { CategoryLocaleContent } from '../../types';
+
+export const content: CategoryLocaleContent = {
+  slug: 'sante',
+  title: 'Outils de Santé en Ligne',
+  description:
+    "Calculatrices et utilitaires de santé gratuits : IMC, pourcentage de graisse, calories, hydratation et plus. Basés sur les normes médicales internationales.",
+  seo: [
+    {
+      type: 'summary',
+      title: 'Ce que vous trouverez dans cette catégorie',
+      items: [
+        "Calculatrice d'IMC avec échelle visuelle et catégories OMS",
+        'Résultats basés sur des algorithmes médicaux vérifiés',
+        'Totalement gratuit, sans inscription ni cookies de suivi',
+        'Confidentialité totale : les calculs se font sur votre appareil',
+      ],
+    },
+    {
+      type: 'title',
+      text: "Outils de Santé Basés sur la Science",
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: "La santé personnelle est l'un des domaines où une information précise fait vraiment la différence. Notre collection d'<strong>utilitaires de santé en ligne</strong> est conçue pour fournir des données objectives, basées sur les normes de l'Organisation Mondiale de la Santé (OMS) et d'autres institutions médicales internationales de référence.",
+    },
+    {
+      type: 'paragraph',
+      html: "Contrairement aux applications mobiles qui nécessitent l'accès aux données personnelles ou aux capteurs de l'appareil, tous ces outils fonctionnent directement dans le navigateur. <strong>Aucune donnée de santé ne quitte votre appareil</strong>. Pas de serveurs, pas de stockage, pas de profils utilisateur.",
+    },
+    {
+      type: 'title',
+      text: "Pourquoi un chiffre ne fait pas tout",
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: "Les calculatrices de santé offrent une <strong>référence indicative</strong>, pas un diagnostic. L'Indice de Masse Corporelle, par exemple, est un outil de dépistage statistique utile pour la population générale, mais ne différencie pas entre le tissu musculaire et la graisse corporelle. Un athlète d'élite peut avoir un IMC techniquement élevé sans présenter aucun problème de santé métabolique.",
+    },
+    {
+      type: 'tip',
+      title: 'Avis médical important',
+      html: "Tous les outils de cette catégorie sont de nature informative et éducative. Ils ne remplacent en aucun cas le jugement d'un professionnel de santé. Si vous avez des préoccupations concernant votre santé, consultez toujours votre médecin ou spécialiste.",
+    },
+    {
+      type: 'title',
+      text: 'Fondamentaux des Métriques de Santé',
+      level: 2,
+    },
+    {
+      type: 'list',
+      items: [
+        "<strong>IMC (Indice de Masse Corporelle) :</strong> Rapport poids/taille. Indicateur de dépistage de l'OMS pour classer l'état nutritionnel chez les adultes.",
+        '<strong>Confidentialité par conception :</strong> Calculs effectués exclusivement côté client. Sans télémétrie, sans cookies de suivi, sans analyse de données personnelles.',
+        "<strong>Normes internationales :</strong> Les plages et seuils utilisés correspondent aux recommandations publiées par l'OMS et les organismes médicaux de référence.",
+      ],
+    },
+  ],
+};

package/src/category/index.ts

@@ -0,0 +1,22 @@
+import type { HealthCategoryEntry } from '../types';
+import { bmiCalculator } from '../tool/bmiCalculator';
+import { daltonismSimulator } from '../tool/daltonismSimulator';
+import { tinnitusReliever } from '../tool/tinnitusReliever';
+import { breathingVisualizer } from '../tool/breathingVisualizer';
+import { caffeineTracker } from '../tool/caffeineTracker';
+import { waterPurifier } from '../tool/waterPurifier';
+import { digestionStopwatch } from '../tool/digestionStopwatch';
+import { binauralTuner } from '../tool/binauralTuner';
+import { pelliRobsonTest } from '../tool/pelliRobsonTest';
+import { peripheralVisionTrainer } from '../tool/peripheralVisionTrainer';
+import { epworthSleepinessScale } from '../tool/epworthSleepinessScale';
+
+export const healthCategory: HealthCategoryEntry = {
+  icon: 'mdi:heart-pulse',
+  tools: [bmiCalculator, daltonismSimulator, tinnitusReliever, breathingVisualizer, caffeineTracker, waterPurifier, digestionStopwatch, binauralTuner, pelliRobsonTest, peripheralVisionTrainer, epworthSleepinessScale],
+  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),
+  },
+};

package/src/category/seo.astro

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

package/src/components/PreviewNavSidebar.astro

@@ -0,0 +1,116 @@
+---
+interface NavItem {
+  id: string;
+  title: string;
+  href: string;
+  isActive?: boolean;
+}
+
+interface Props {
+  categoryTitle: string;
+  tools?: NavItem[];
+}
+
+const { categoryTitle, tools = [] } = Astro.props;
+---
+
+<nav class="preview-nav-sidebar">
+  <div class="sidebar-header">
+    <h3>{categoryTitle}</h3>
+  </div>
+
+  <ul class="tools-list">
+    {tools.map((tool) => (
+      <li>
+        <a
+          href={tool.href}
+          class:list={['tool-link', { active: tool.isActive }]}
+        >
+          <span class="tool-title">{tool.title}</span>
+        </a>
+      </li>
+    ))}
+  </ul>
+</nav>
+
+<style>
+  .preview-nav-sidebar {
+    display: flex;
+    flex-direction: column;
+    height: 100%;
+    background: var(--bg-surface, #0f172a);
+  }
+
+  .sidebar-header {
+    padding: 2rem 1.5rem 1.5rem;
+    border-bottom: 1px solid var(--border-color, #1e293b);
+  }
+
+  .sidebar-header h3 {
+    margin: 0;
+    font-size: 0.75rem;
+    font-weight: 900;
+    text-transform: uppercase;
+    letter-spacing: 0.1em;
+    color: var(--text-muted, #94a3b8);
+  }
+
+  .tools-list {
+    list-style: none;
+    margin: 0;
+    padding: 0.5rem 0;
+    display: flex;
+    flex-direction: column;
+    gap: 0.25rem;
+  }
+
+  .tools-list li {
+    margin: 0;
+  }
+
+  .tool-link {
+    display: flex;
+    align-items: center;
+    padding: 0.75rem 1.5rem;
+    color: var(--text-muted, #94a3b8);
+    text-decoration: none;
+    font-size: 0.9375rem;
+    font-weight: 500;
+    transition: all 0.15s cubic-bezier(0.4, 0, 0.2, 1);
+    border-left: 3px solid transparent;
+    position: relative;
+  }
+
+  .tool-link:hover {
+    color: var(--text-base, #f1f5f9);
+    background: rgba(255, 255, 255, 0.08);
+    padding-left: 1.75rem;
+  }
+
+  .tool-link.active {
+    color: var(--accent, #f43f5e);
+    background: rgba(244, 63, 94, 0.15);
+    border-left-color: var(--accent, #f43f5e);
+    font-weight: 600;
+  }
+
+  .tool-link.active::before {
+    content: '';
+    position: absolute;
+    left: 0;
+    top: 50%;
+    transform: translateY(-50%);
+    width: 3px;
+    height: 24px;
+    background: var(--accent, #f43f5e);
+    border-radius: 0 2px 2px 0;
+  }
+
+  .tool-title {
+    display: block;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+  }
+</style>
+

package/src/components/PreviewToolbar.astro

@@ -0,0 +1,143 @@
+---
+import type { KnownLocale } from '../types';
+
+interface Props {
+  currentLocale: KnownLocale;
+  localeUrls?: Partial<Record<KnownLocale, string>>;
+}
+
+const { currentLocale, localeUrls = {} } = Astro.props;
+
+const otherLocales = Object.entries(localeUrls).filter(([l]) => l !== currentLocale) as [
+  KnownLocale,
+  string,
+][];
+---
+
+<nav class="preview-toolbar">
+  {
+    otherLocales.length > 0 && (
+      <div class="locale-group">
+        <span class="locale-current">{currentLocale.toUpperCase()}</span>
+        {otherLocales.map(([locale, url]) => (
+          <a href={url} class="btn-locale">
+            {locale.toUpperCase()}
+          </a>
+        ))}
+      </div>
+    )
+  }
+
+  <button id="theme-toggle" class="btn-theme" aria-label="Toggle theme" title="Toggle theme">
+    <span class="theme-icon"></span>
+  </button>
+</nav>
+
+<script>
+  function initToolbar() {
+    const btn = document.getElementById('theme-toggle');
+    if (!btn) return;
+
+    const applyTheme = (theme: string) => {
+      document.documentElement.classList.remove('theme-light', 'theme-dark');
+      document.documentElement.classList.add(theme);
+      localStorage.setItem('theme', theme);
+    };
+
+    btn.addEventListener('click', () => {
+      const next = document.documentElement.classList.contains('theme-dark')
+        ? 'theme-light'
+        : 'theme-dark';
+      applyTheme(next);
+    });
+  }
+
+  initToolbar();
+  document.addEventListener('astro:after-swap', initToolbar);
+</script>
+
+<style>
+  .preview-toolbar {
+    position: fixed;
+    top: 1rem;
+    right: 1.5rem;
+    display: flex;
+    align-items: center;
+    gap: 0.5rem;
+    z-index: 1000;
+    background: var(--bg-surface);
+    padding: 0.4rem;
+    border-radius: 1rem;
+    border: 1px solid var(--border-color);
+    backdrop-filter: blur(12px);
+  }
+
+  .locale-group {
+    display: flex;
+    align-items: center;
+    gap: 0.25rem;
+    padding-right: 0.5rem;
+    border-right: 1px solid var(--border-color);
+  }
+
+  .locale-current {
+    font-size: 0.7rem;
+    font-weight: 900;
+    color: var(--text-muted);
+    padding: 0.4rem 0.6rem;
+    letter-spacing: 0.08em;
+  }
+
+  .btn-locale {
+    background: transparent;
+    border: 1px solid var(--border-color);
+    color: var(--text-main);
+    cursor: pointer;
+    padding: 0.4rem 0.7rem;
+    border-radius: 0.5rem;
+    font-weight: 700;
+    font-size: 0.7rem;
+    text-decoration: none;
+    letter-spacing: 0.08em;
+    transition: all 0.2s ease;
+  }
+
+  .btn-locale:hover {
+    border-color: var(--accent);
+    color: var(--accent);
+  }
+
+  .btn-theme {
+    background: transparent;
+    border: none;
+    cursor: pointer;
+    padding: 0.5rem;
+    border-radius: 0.6rem;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    transition: background 0.2s ease;
+  }
+
+  .btn-theme:hover {
+    background: rgba(255, 255, 255, 0.08);
+  }
+
+  .theme-icon {
+    display: block;
+    width: 16px;
+    height: 16px;
+    border-radius: 50%;
+  }
+
+  :global(.theme-light) .theme-icon {
+    background: #f59e0b;
+    box-shadow: 0 0 8px #fbbf24;
+  }
+
+  :global(.theme-dark) .theme-icon {
+    background: #94a3b8;
+    box-shadow: inset -4px -2px 0 #1e293b;
+  }
+</style>
+

package/src/data.ts

@@ -0,0 +1,28 @@
+export { bmiCalculator } from './tool/bmiCalculator';
+export { daltonismSimulator } from './tool/daltonismSimulator';
+export { tinnitusReliever } from './tool/tinnitusReliever';
+export { breathingVisualizer } from './tool/breathingVisualizer';
+export { caffeineTracker } from './tool/caffeineTracker';
+export { waterPurifier } from './tool/waterPurifier';
+export { digestionStopwatch } from './tool/digestionStopwatch';
+export { binauralTuner } from './tool/binauralTuner';
+export { pelliRobsonTest } from './tool/pelliRobsonTest';
+export { peripheralVisionTrainer } from './tool/peripheralVisionTrainer';
+export { epworthSleepinessScale } from './tool/epworthSleepinessScale';
+export { ubeCalculator } from './tool/ubeCalculator';
+export { screenDecompressionTime } from './tool/screenDecompressionTime';
+export { bloodUnitConverter } from './tool/bloodUnitConverter';
+export { readingDistanceCalculator } from './tool/readingDistanceCalculator';
+export { hydrationCalculator } from './tool/hydrationCalculator';
+
+export { healthCategory } from './category';
+
+export type {
+  KnownLocale,
+  ToolLocaleContent,
+  CategoryLocaleContent,
+  LocaleMap,
+  HealthToolEntry,
+  HealthCategoryEntry,
+} from './types';
+

package/src/env.d.ts

@@ -0,0 +1,5 @@
+declare module '*.astro' {
+  const Component: (_props: Record<string, unknown>) => unknown;
+  export default Component;
+}
+

package/src/index.ts

@@ -0,0 +1,36 @@
+export * from './tool/bmiCalculator';
+export * from './tool/daltonismSimulator';
+export * from './tool/tinnitusReliever';
+export * from './tool/breathingVisualizer';
+export * from './tool/caffeineTracker';
+export * from './tool/waterPurifier';
+export * from './tool/digestionStopwatch';
+export * from './tool/binauralTuner';
+export * from './tool/pelliRobsonTest';
+export * from './tool/peripheralVisionTrainer';
+export * from './tool/epworthSleepinessScale';
+export * from './tool/ubeCalculator';
+export * from './tool/screenDecompressionTime';
+export * from './tool/bloodUnitConverter';
+export * from './tool/readingDistanceCalculator';
+export * from './tool/hydrationCalculator';
+
+export { healthCategory } from './category';
+export { default as healthCategorySEO } from './category/seo.astro';
+
+export type {
+  KnownLocale,
+  FAQItem,
+  BibliographyEntry,
+  HowToStep,
+  ToolLocaleContent,
+  CategoryLocaleContent,
+  LocaleLoader,
+  LocaleMap,
+  HealthToolEntry,
+  HealthCategoryEntry,
+  ToolDefinition,
+} from './types';
+
+export { ALL_TOOLS } from './tools';
+