@jjlmoya/utils-astronomy 1.1.0

package/src/tool/bortleVisualizer/i18n/en.ts

@@ -0,0 +1,153 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { BortleVisualizerUI, BortleVisualizerLocaleContent } from '../index';
+
+const slug = 'dark-sky-simulator';
+const title = 'Dark Sky Simulator (Bortle Scale)';
+const description = 'Interactively visualize the 9 levels of the Bortle Scale and discover how light pollution erases the starry night sky.';
+
+const ui: BortleVisualizerUI = {
+  toolTitle: 'Dark Sky Simulator',
+  sliderLabel: 'Drag to adjust light pollution level',
+  classLabel: 'Bortle Class',
+  nelmLabel: 'NELM',
+  sqmLabel: 'SQM',
+};
+
+const faq: BortleVisualizerLocaleContent['faq'] = [
+  {
+    question: 'What is the Bortle Scale?',
+    answer: 'It is a 9-point numerical scale that measures the brightness of the night sky at a given location. It was created by amateur astronomer John E. Bortle in 2001 and published in Sky & Telescope. Level 1 represents the darkest possible sky (remote deserts) and Level 9 the most light-polluted (city centers).',
+  },
+  {
+    question: 'What is the minimum Bortle level to see the Milky Way?',
+    answer: 'The Milky Way begins to be clearly visible from Bortle 4 (rural/suburban zone). At levels 1 and 2 it is spectacular, with detailed structure even capable of casting faint shadows. From Bortle 6 onwards it is practically invisible to the naked eye.',
+  },
+  {
+    question: 'What do NELM and SQM mean?',
+    answer: 'NELM (Naked Eye Limiting Magnitude) is the magnitude of the faintest star visible to the naked eye under those conditions. SQM (Sky Quality Meter) measures sky brightness in magnitudes per square arcsecond, being the objective scientific standard.',
+  },
+  {
+    question: 'How can I find darker skies near me?',
+    answer: 'Use light pollution maps like lightpollutionmap.info to find Bortle 3 or darker zones within a few hours\' drive. National parks, high mountain areas, and designated dark sky reserves offer the best conditions.',
+  },
+];
+
+const howTo: BortleVisualizerLocaleContent['howTo'] = [
+  { name: '1. Adjust the Bortle level', text: 'Drag the slider to simulate how light pollution increases from level 1 (desert) to level 9 (city center).' },
+  { name: '2. Observe the visual effects', text: 'Notice how faint stars disappear, the Milky Way fades, and the sky takes on an orange or grey tone with each level.' },
+  { name: '3. Identify your current level', text: 'Compare what you see from your usual observing spot with the simulations to identify your local Bortle level.' },
+];
+
+const bibliography: BortleVisualizerLocaleContent['bibliography'] = [
+  { name: 'Original Bortle Article (Sky & Telescope, 2001)', url: 'https://skyandtelescope.org/astronomy-resources/light-pollution-and-astronomy-the-bortle-dark-sky-scale/' },
+  { name: 'Light Pollution Map - World Map', url: 'https://www.lightpollutionmap.info/' },
+  { name: 'International Dark-Sky Association', url: 'https://www.darksky.org/' },
+  { name: 'Globe at Night - Citizen Science', url: 'https://www.globeatnight.org/' },
+];
+
+const seo: BortleVisualizerLocaleContent['seo'] = [
+  {
+    type: 'summary',
+    title: 'Bortle Scale Key Points',
+    items: [
+      'Bortle 1-2: Reference dark sky, Milky Way casts shadows, NELM > 7.5.',
+      'Bortle 3-4: Optimal rural sky, Milky Way visible in detail but horizon contaminated.',
+      'Bortle 5-6: Suburban, faint or invisible Milky Way, good for planets and moon.',
+      'Bortle 7-9: Urban sky, only bright objects visible to naked eye.',
+    ],
+  },
+  { type: 'title', text: 'The Bortle Scale: Measuring Sky Darkness', level: 2 },
+  {
+    type: 'paragraph',
+    html: 'The <strong>Bortle Scale</strong> is the international standard system used by amateur astronomers worldwide to quantify the quality of the night sky. Created by John E. Bortle, a veteran observer of comets and deep-sky objects from New York, it was published in 2001 in Sky & Telescope magazine with the goal of providing an objective and reproducible scale for communicating observing conditions.',
+  },
+  {
+    type: 'paragraph',
+    html: 'The scale ranges from <strong>level 1</strong> (the darkest possible sky, found only in remote deserts and high mountains far from any civilization) to <strong>level 9</strong> (the interior of large cities, where the sky glows with a permanent orange or whitish brightness and only the Moon and brightest planets are visible). Each level has specific descriptors that allow identification without instrumentation.',
+  },
+  { type: 'title', text: 'Light Pollution: A Silent Global Crisis', level: 2 },
+  {
+    type: 'paragraph',
+    html: 'The growth of light pollution is one of the least discussed but most widespread environmental problems. According to recent studies, more than <strong>80% of the world\'s population</strong> lives under light-polluted skies, and in Europe and North America the percentage exceeds 99%. The consequences go beyond astronomy: artificial light at night disrupts the circadian rhythms of humans and animals, disorients migratory birds, affects sea turtle reproduction, and suppresses melatonin production in mammals.',
+  },
+  {
+    type: 'table',
+    headers: ['Bortle Class', 'NELM', 'SQM (mag/arcsec²)', 'Milky Way', 'Key Feature'],
+    rows: [
+      ['1 - Excellent', '8.0', '21.99 - 22.0', 'Casts shadows', 'M33 visible naked eye'],
+      ['2 - Typical Dark', '7.5', '21.89 - 21.99', 'Very structured', 'Clouds = black holes'],
+      ['3 - Rural', '7.0', '21.69 - 21.89', 'Complex', 'Some horizon glow'],
+      ['4 - Rural/Suburban', '6.5', '20.49 - 21.69', 'Visible', 'Light domes on horizon'],
+      ['5 - Suburban', '6.0', '19.50 - 20.49', 'Faint', 'Greyish sky'],
+      ['6 - Bright Sub.', '5.5', '18.94 - 19.50', 'Invisible', 'M31 barely visible'],
+      ['7 - Sub/Urban', '5.0', '18.38 - 18.94', 'Absent', 'Light grey sky'],
+      ['8 - Urban', '4.5', '< 18.38', 'Absent', 'Main constellations only'],
+      ['9 - Inner City', '4.0', '< 18.00', 'Absent', 'Moon and planets only'],
+    ],
+  },
+  {
+    type: 'tip',
+    title: 'Objective Measurement: The Sky Quality Meter',
+    html: 'For precise and reproducible measurements, astronomers use the <strong>Sky Quality Meter (SQM)</strong>, a device that measures sky luminance in magnitudes per square arcsecond (mag/arcsec²). An SQM of 22.0 corresponds to an excellent Bortle 1 sky, while a value of 18.0 indicates a Bortle 8-9 sky. You can check real-time measurements on the Globe at Night network.',
+  },
+  { type: 'title', text: 'Finding Dark Sky Sanctuaries Near You', level: 2 },
+  {
+    type: 'paragraph',
+    html: 'Despite widespread light pollution, dark sky sanctuaries still exist. National parks, designated dark sky reserves, and remote highland areas offer Bortle 2-4 conditions accessible within hours of most major cities. The IDA (International Dark-Sky Association) maintains a global registry of certified dark sky places, from small parks to entire island reserves. Planning a night trip to a darker location will transform your astronomical experience more than any equipment upgrade.',
+  },
+  {
+    type: 'diagnostic',
+    variant: 'success',
+    title: 'Planning Tool',
+    icon: 'mdi:map-marker-star',
+    badge: 'Pro Tip',
+    html: 'Before any observation outing, check the light pollution map at lightpollutionmap.info to identify Bortle 3 or darker zones within a 1-2 hour radius. Combine this with astronomical weather forecasts from Clear Outside or Meteoblue Astro to choose the perfect night.',
+  },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faq.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: howTo.map((step) => ({
+    '@type': 'HowToStep',
+    name: step.name,
+    text: step.text,
+  })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description,
+  applicationCategory: 'UtilitiesApplication',
+  operatingSystem: 'Web',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  inLanguage: 'en',
+};
+
+export const content: BortleVisualizerLocaleContent = {
+  slug,
+  title,
+  description,
+  ui,
+  seo,
+  faq,
+  faqTitle: 'Frequently Asked Questions',
+  bibliography,
+  bibliographyTitle: 'Bibliographic References',
+  howTo,
+  schemas: [faqSchema as any, howToSchema as any, appSchema],
+};

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

@@ -0,0 +1,161 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { BortleVisualizerUI, BortleVisualizerLocaleContent } from '../index';
+
+const slug = 'simulador-cielo-oscuro';
+const title = 'Simulador de Cielo Oscuro (Escala de Bortle)';
+const description = 'Visualiza interactivamente los 9 niveles de la Escala de Bortle y descubre cómo la contaminación lumínica borra el cielo nocturno estrellado.';
+
+const ui: BortleVisualizerUI = {
+  toolTitle: 'Simulador de Cielo Oscuro',
+  sliderLabel: 'Desliza para ajustar la contaminación lumínica',
+  classLabel: 'Clase Bortle',
+  nelmLabel: 'NELM',
+  sqmLabel: 'SQM',
+};
+
+const faq: BortleVisualizerLocaleContent['faq'] = [
+  {
+    question: '¿Qué es la Escala de Bortle?',
+    answer: 'Es una escala numérica de 9 puntos que mide el brillo del cielo nocturno en un lugar determinado. Fue creada por el astrónomo aficionado John E. Bortle en 2001 y publicada en Sky & Telescope. El Nivel 1 representa el cielo más oscuro posible (desiertos remotos) y el Nivel 9 el más contaminado (centros de ciudades).',
+  },
+  {
+    question: '¿Cuál es el nivel de Bortle mínimo para ver la Vía Láctea?',
+    answer: 'La Vía Láctea empieza a ser claramente visible a partir de Bortle 4 (zona rural/suburbana). En niveles 1 y 2 es espectacular, con estructura detallada y capaz de proyectar sombras tenues. En Bortle 6 en adelante es prácticamente invisible a simple vista.',
+  },
+  {
+    question: '¿Qué significa NELM y SQM?',
+    answer: 'NELM (Naked Eye Limiting Magnitude) es la magnitud de la estrella más tenue visible a simple vista bajo esas condiciones. SQM (Sky Quality Meter) mide el brillo del cielo en magnitudes por segundo de arco al cuadrado, siendo el estándar científico objetivo.',
+  },
+  {
+    question: '¿Cómo puedo mejorar el Bortle de mi zona de observación?',
+    answer: 'El Bortle de tu zona es fijo, pero puedes mejorar tu experiencia desplazándote. Consulta mapas de contaminación lumínica como lightpollutionmap.info para encontrar zonas Bortle 3 o menos a pocas horas. En España, zonas como Sierra Morena, Montsec o La Palma tienen certificación Starlight.',
+  },
+];
+
+const howTo: BortleVisualizerLocaleContent['howTo'] = [
+  { name: '1. Ajusta el nivel de Bortle', text: 'Arrastra el slider para simular cómo aumenta la contaminación lumínica desde nivel 1 (desierto) hasta nivel 9 (centro ciudad).' },
+  { name: '2. Observa los efectos visuales', text: 'Fíjate cómo desaparecen las estrellas tenues, la Vía Láctea se desvanece y el cielo adquiere un tono anaranjado o grisáceo con cada nivel.' },
+  { name: '3. Identifica tu nivel actual', text: 'Compara lo que ves desde tu lugar habitual de observación con las simulaciones para identificar tu Bortle local.' },
+];
+
+const bibliography: BortleVisualizerLocaleContent['bibliography'] = [
+  { name: 'Artículo Original de John E. Bortle (Sky & Telescope, 2001)', url: 'https://skyandtelescope.org/astronomy-resources/light-pollution-and-astronomy-the-bortle-dark-sky-scale/' },
+  { name: 'Light Pollution Map - Mapa Mundial', url: 'https://www.lightpollutionmap.info/' },
+  { name: 'Fundación Starlight - Reservas de Cielo Oscuro', url: 'https://fundacionstarlight.org/' },
+  { name: 'International Dark-Sky Association', url: 'https://www.darksky.org/' },
+];
+
+const seo: BortleVisualizerLocaleContent['seo'] = [
+  {
+    type: 'summary',
+    title: 'Claves de la Escala de Bortle',
+    items: [
+      'Bortle 1-2: Cielo oscuro de referencia, Vía Láctea proyecta sombras, NELM > 7.5.',
+      'Bortle 3-4: Cielo rural óptimo, Vía Láctea visible con detalle pero horizonte contaminado.',
+      'Bortle 5-6: Suburbano, Vía Láctea débil o invisible, bueno para planetas y luna.',
+      'Bortle 7-9: Cielo urbano, solo objetos brillantes visibles a simple vista.',
+    ],
+  },
+  { type: 'title', text: 'La Escala de Bortle: Medir la Oscuridad del Cielo', level: 2 },
+  {
+    type: 'paragraph',
+    html: 'La <strong>Escala de Bortle</strong> es el sistema estándar internacional utilizado por astrónomos aficionados de todo el mundo para cuantificar la calidad del cielo nocturno. Creada por John E. Bortle, un observador veterano de cometas y objetos de cielo profundo de Nueva York, fue publicada en 2001 en la revista Sky & Telescope con el objetivo de proporcionar una escala objetiva y reproducible para comunicar las condiciones de observación.',
+  },
+  {
+    type: 'paragraph',
+    html: 'La escala va del <strong>nivel 1</strong> (el cielo más oscuro posible, encontrado solo en desiertos remotos y alta montaña alejados de toda civilización) al <strong>nivel 9</strong> (el interior de grandes ciudades, donde el cielo brilla con un resplandor anaranjado o blanquecino permanente y solo la Luna y los planetas más brillantes son visibles). Cada nivel tiene descriptores específicos que permiten identificarlo sin instrumentación.',
+  },
+  { type: 'title', text: 'Contaminación Lumínica: Una Crisis Global Silenciosa', level: 2 },
+  {
+    type: 'paragraph',
+    html: 'El crecimiento de la contaminación lumínica es uno de los problemas medioambientales menos discutidos pero más extendidos. Según estudios recientes, más del <strong>80% de la población mundial</strong> vive bajo cielos contaminados lumínicamente, y en Europa y Norteamérica el porcentaje supera el 99%. En España, la situación varía enormemente: desde las ciudades costeras con Bortle 8-9 hasta las zonas protegidas de la España interior con Bortle 2-3.',
+  },
+  {
+    type: 'paragraph',
+    html: 'Las consecuencias van más allá de la astronomía. La <strong>luz artificial nocturna</strong> altera los ritmos circadianos de humanos y animales, desorienta a aves migratorias, afecta a la reproducción de tortugas marinas y suprime la producción de melatonina en mamíferos. La IDA (International Dark-Sky Association) trabaja para designar Reservas de Cielo Oscuro en todo el mundo, y en España el programa Starlight ha certificado varias zonas de excelencia astronómica.',
+  },
+  {
+    type: 'table',
+    headers: ['Clase Bortle', 'NELM', 'SQM (mag/arcsec²)', 'Vía Láctea', 'Característica Clave'],
+    rows: [
+      ['1 - Excelente', '8.0', '21.99 - 22.0', 'Proyecta sombras', 'M33 visible a simple vista'],
+      ['2 - Oscuro Típico', '7.5', '21.89 - 21.99', 'Muy estructurada', 'Nubes = agujeros negros'],
+      ['3 - Rural', '7.0', '21.69 - 21.89', 'Compleja', 'Algo de luz en horizonte'],
+      ['4 - Rural/Suburbano', '6.5', '20.49 - 21.69', 'Visible', 'Domos de luz en horizonte'],
+      ['5 - Suburbano', '6.0', '19.50 - 20.49', 'Tenue', 'Cielo grisáceo'],
+      ['6 - Sub. Brillante', '5.5', '18.94 - 19.50', 'Invisible', 'M31 apenas visible'],
+      ['7 - Sub/Urbano', '5.0', '18.38 - 18.94', 'Ausente', 'Cielo gris claro'],
+      ['8 - Urbano', '4.5', '< 18.38', 'Ausente', 'Solo constelaciones principales'],
+      ['9 - Urbano Interior', '4.0', '< 18.00', 'Ausente', 'Solo Luna y planetas'],
+    ],
+  },
+  {
+    type: 'tip',
+    title: 'Medición Objetiva: El Sky Quality Meter',
+    html: 'Para mediciones precisas y reproducibles, los astrónomos utilizan el <strong>Sky Quality Meter (SQM)</strong>, un dispositivo que mide la luminancia del cielo en magnitudes por segundo de arco al cuadrado (mag/arcsec²). Un SQM de 22.0 corresponde a un cielo Bortle 1 excelente, mientras que un valor de 18.0 indica un cielo Bortle 8-9. Puedes consultar mediciones en tiempo real en la red Globe at Night.',
+  },
+  {
+    type: 'title',
+    text: 'Santuarios de Oscuridad: Las Mejores Zonas para Observar en España',
+    level: 2,
+  },
+  {
+    type: 'paragraph',
+    html: 'España cuenta con algunos de los mejores cielos oscuros de Europa. La combinación de geografía (alta meseta, relieves montañosos, islas volcánicas) y zonas despobladas hace que encontrar cielos Bortle 2-3 sea posible a pocas horas de cualquier ciudad. Las Reservas Starlight de Sierra Morena (la más grande del mundo con más de 400km²), Montsec en Lleida, el Valle del Jerte en Extremadura y toda la isla de La Palma (sede del Gran Telescopio Canarias) son destinos de referencia internacional para el astroturismo.',
+  },
+  {
+    type: 'diagnostic',
+    variant: 'success',
+    title: 'Herramienta de Planificación',
+    icon: 'mdi:map-marker-star',
+    badge: 'Pro Tip',
+    html: 'Antes de cualquier salida de observación, consulta el mapa de contaminación lumínica en lightpollutionmap.info para identificar zonas Bortle 3 o menores en un radio de 1-2 horas. Combínalo con las previsiones meteorológicas de Clear Outside o Meteoblue Astro para elegir la noche perfecta.',
+  },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faq.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: howTo.map((step) => ({
+    '@type': 'HowToStep',
+    name: step.name,
+    text: step.text,
+  })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description,
+  applicationCategory: 'UtilitiesApplication',
+  operatingSystem: 'Web',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  inLanguage: 'es',
+};
+
+export const content: BortleVisualizerLocaleContent = {
+  slug,
+  title,
+  description,
+  ui,
+  seo,
+  faq,
+  faqTitle: 'Preguntas Frecuentes',
+  bibliography,
+  bibliographyTitle: 'Referencias Bibliográficas',
+  howTo,
+  schemas: [faqSchema as any, howToSchema as any, appSchema],
+};

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

@@ -0,0 +1,153 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { BortleVisualizerUI, BortleVisualizerLocaleContent } from '../index';
+
+const slug = 'simulateur-ciel-sombre';
+const title = 'Simulateur de Ciel Sombre (Échelle de Bortle)';
+const description = 'Visualisez interactivement les 9 niveaux de l\'Échelle de Bortle et découvrez comment la pollution lumineuse efface le ciel nocturne étoilé.';
+
+const ui: BortleVisualizerUI = {
+  toolTitle: 'Simulateur de Ciel Sombre',
+  sliderLabel: 'Faites glisser pour ajuster la pollution lumineuse',
+  classLabel: 'Classe Bortle',
+  nelmLabel: 'NELM',
+  sqmLabel: 'SQM',
+};
+
+const faq: BortleVisualizerLocaleContent['faq'] = [
+  {
+    question: 'Qu\'est-ce que l\'Échelle de Bortle?',
+    answer: 'C\'est une échelle numérique à 9 points qui mesure la luminosité du ciel nocturne à un endroit donné. Elle a été créée par l\'astronome amateur John E. Bortle en 2001 et publiée dans Sky & Telescope. Le niveau 1 représente le ciel le plus sombre possible (déserts isolés) et le niveau 9 le plus pollué (centres-villes).',
+  },
+  {
+    question: 'Quel est le niveau de Bortle minimum pour voir la Voie Lactée?',
+    answer: 'La Voie Lactée commence à être clairement visible à partir de Bortle 4 (zone rurale/suburbaine). Aux niveaux 1 et 2, elle est spectaculaire, avec une structure détaillée capable de projeter de faibles ombres. À partir de Bortle 6, elle est pratiquement invisible à l\'oeil nu.',
+  },
+  {
+    question: 'Que signifient NELM et SQM?',
+    answer: 'NELM (Naked Eye Limiting Magnitude) est la magnitude de l\'étoile la plus faible visible à l\'oeil nu dans ces conditions. SQM (Sky Quality Meter) mesure la luminosité du ciel en magnitudes par seconde d\'arc au carré, étant le standard scientifique objectif.',
+  },
+  {
+    question: 'Comment trouver des ciels plus sombres près de chez moi?',
+    answer: 'Utilisez des cartes de pollution lumineuse comme lightpollutionmap.info pour trouver des zones Bortle 3 ou moins à quelques heures de route. Les parcs nationaux, les zones de haute montagne et les réserves de ciel étoilé offrent les meilleures conditions.',
+  },
+];
+
+const howTo: BortleVisualizerLocaleContent['howTo'] = [
+  { name: '1. Ajustez le niveau de Bortle', text: 'Faites glisser le curseur pour simuler comment la pollution lumineuse augmente du niveau 1 (désert) au niveau 9 (centre-ville).' },
+  { name: '2. Observez les effets visuels', text: 'Notez comment les étoiles faibles disparaissent, la Voie Lactée s\'estompe et le ciel prend une teinte orange ou grise à chaque niveau.' },
+  { name: '3. Identifiez votre niveau actuel', text: 'Comparez ce que vous voyez depuis votre lieu d\'observation habituel avec les simulations pour identifier votre niveau de Bortle local.' },
+];
+
+const bibliography: BortleVisualizerLocaleContent['bibliography'] = [
+  { name: 'Article Original de John E. Bortle (Sky & Telescope, 2001)', url: 'https://skyandtelescope.org/astronomy-resources/light-pollution-and-astronomy-the-bortle-dark-sky-scale/' },
+  { name: 'Carte de Pollution Lumineuse Mondiale', url: 'https://www.lightpollutionmap.info/' },
+  { name: 'Association Internationale Ciel Sombre (IDA)', url: 'https://www.darksky.org/' },
+  { name: 'Globe at Night - Science Citoyenne', url: 'https://www.globeatnight.org/' },
+];
+
+const seo: BortleVisualizerLocaleContent['seo'] = [
+  {
+    type: 'summary',
+    title: 'Points Clés de l\'Échelle de Bortle',
+    items: [
+      'Bortle 1-2: Ciel sombre de référence, la Voie Lactée projette des ombres, NELM > 7.5.',
+      'Bortle 3-4: Ciel rural optimal, Voie Lactée visible en détail mais horizon contaminé.',
+      'Bortle 5-6: Suburbain, Voie Lactée faible ou invisible, bon pour planètes et lune.',
+      'Bortle 7-9: Ciel urbain, seuls les objets brillants visibles à l\'oeil nu.',
+    ],
+  },
+  { type: 'title', text: 'L\'Échelle de Bortle: Mesurer l\'Obscurité du Ciel', level: 2 },
+  {
+    type: 'paragraph',
+    html: 'L\'<strong>Échelle de Bortle</strong> est le système standard international utilisé par les astronomes amateurs du monde entier pour quantifier la qualité du ciel nocturne. Créée par John E. Bortle, un observateur vétéran de comètes et d\'objets du ciel profond de New York, elle a été publiée en 2001 dans le magazine Sky & Telescope avec l\'objectif de fournir une échelle objective et reproductible pour communiquer les conditions d\'observation.',
+  },
+  {
+    type: 'paragraph',
+    html: 'L\'échelle va du <strong>niveau 1</strong> (le ciel le plus sombre possible, trouvé seulement dans des déserts isolés et en haute montagne loin de toute civilisation) au <strong>niveau 9</strong> (l\'intérieur des grandes villes, où le ciel brille d\'une lueur orange ou blanchâtre permanente et seule la Lune et les planètes les plus brillantes sont visibles). Chaque niveau possède des descripteurs spécifiques qui permettent son identification sans instrumentation.',
+  },
+  { type: 'title', text: 'Pollution Lumineuse: Une Crise Mondiale Silencieuse', level: 2 },
+  {
+    type: 'paragraph',
+    html: 'La croissance de la pollution lumineuse est l\'un des problèmes environnementaux les moins discutés mais les plus répandus. Selon des études récentes, plus de <strong>80% de la population mondiale</strong> vit sous des ciels pollués lumineusement, et en Europe et en Amérique du Nord le pourcentage dépasse 99%. Les conséquences vont au-delà de l\'astronomie: la lumière artificielle nocturne perturbe les rythmes circadiens des humains et des animaux, désoriente les oiseaux migrateurs et supprime la production de mélatonine chez les mammifères.',
+  },
+  {
+    type: 'table',
+    headers: ['Classe Bortle', 'NELM', 'SQM (mag/arcsec²)', 'Voie Lactée', 'Caractéristique'],
+    rows: [
+      ['1 - Excellent', '8.0', '21.99 - 22.0', 'Projette des ombres', 'M33 visible à l\'oeil nu'],
+      ['2 - Sombre Typique', '7.5', '21.89 - 21.99', 'Très structurée', 'Nuages = trous noirs'],
+      ['3 - Rural', '7.0', '21.69 - 21.89', 'Complexe', 'Quelque lumière à l\'horizon'],
+      ['4 - Rural/Suburbain', '6.5', '20.49 - 21.69', 'Visible', 'Dômes de lumière à l\'horizon'],
+      ['5 - Suburbain', '6.0', '19.50 - 20.49', 'Faible', 'Ciel grisâtre'],
+      ['6 - Sub. Brillant', '5.5', '18.94 - 19.50', 'Invisible', 'M31 à peine visible'],
+      ['7 - Sub/Urbain', '5.0', '18.38 - 18.94', 'Absente', 'Ciel gris clair'],
+      ['8 - Urbain', '4.5', '< 18.38', 'Absente', 'Constellations principales seulement'],
+      ['9 - Centre-Ville', '4.0', '< 18.00', 'Absente', 'Lune et planètes seulement'],
+    ],
+  },
+  {
+    type: 'tip',
+    title: 'Mesure Objective: le Sky Quality Meter',
+    html: 'Pour des mesures précises et reproductibles, les astronomes utilisent le <strong>Sky Quality Meter (SQM)</strong>, un dispositif qui mesure la luminance du ciel en magnitudes par seconde d\'arc au carré (mag/arcsec²). Un SQM de 22.0 correspond à un excellent ciel Bortle 1, tandis qu\'une valeur de 18.0 indique un ciel Bortle 8-9.',
+  },
+  { type: 'title', text: 'Trouver des Sanctuaires de Ciel Sombre', level: 2 },
+  {
+    type: 'paragraph',
+    html: 'Malgré la pollution lumineuse généralisée, des sanctuaires de ciel sombre existent encore. Les parcs nationaux, les réserves de ciel étoilé certifiées et les zones de haute montagne isolées offrent des conditions Bortle 2-4 accessibles en quelques heures depuis la plupart des grandes villes. L\'IDA maintient un registre mondial des lieux de ciel sombre certifiés, des petits parcs aux réserves insulaires entières. Planifier une sortie nocturne vers un endroit plus sombre transformera votre expérience astronomique plus que n\'importe quel achat d\'équipement.',
+  },
+  {
+    type: 'diagnostic',
+    variant: 'success',
+    title: 'Outil de Planification',
+    icon: 'mdi:map-marker-star',
+    badge: 'Conseil Pro',
+    html: 'Avant toute sortie d\'observation, consultez la carte de pollution lumineuse sur lightpollutionmap.info pour identifier les zones Bortle 3 ou moins dans un rayon de 1-2 heures. Combinez cela avec les prévisions météo astronomiques de Clear Outside ou Meteoblue Astro pour choisir la nuit parfaite.',
+  },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faq.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: howTo.map((step) => ({
+    '@type': 'HowToStep',
+    name: step.name,
+    text: step.text,
+  })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description,
+  applicationCategory: 'UtilitiesApplication',
+  operatingSystem: 'Web',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  inLanguage: 'fr',
+};
+
+export const content: BortleVisualizerLocaleContent = {
+  slug,
+  title,
+  description,
+  ui,
+  seo,
+  faq,
+  faqTitle: 'Questions Fréquentes',
+  bibliography,
+  bibliographyTitle: 'Références Bibliographiques',
+  howTo,
+  schemas: [faqSchema as any, howToSchema as any, appSchema],
+};

package/src/tool/bortleVisualizer/index.ts

@@ -0,0 +1,41 @@
+import type { AstronomyToolEntry, ToolLocaleContent, ToolDefinition } from '../../types';
+import BortleVisualizerComponent from './component.astro';
+import BortleVisualizerSEO from './seo.astro';
+import BortleVisualizerBibliography from './bibliography.astro';
+
+export interface BortleVisualizerUI {
+  [key: string]: string;
+  toolTitle: string;
+  sliderLabel: string;
+  classLabel: string;
+  nelmLabel: string;
+  sqmLabel: string;
+}
+
+export type BortleVisualizerLocaleContent = ToolLocaleContent<BortleVisualizerUI>;
+
+import { content as es } from './i18n/es';
+import { content as en } from './i18n/en';
+import { content as fr } from './i18n/fr';
+
+export const bortleVisualizer: AstronomyToolEntry<BortleVisualizerUI> = {
+  id: 'bortle-visualizer',
+  icons: {
+    bg: 'mdi:weather-night',
+    fg: 'mdi:telescope',
+  },
+  i18n: {
+    es: async () => es,
+    en: async () => en,
+    fr: async () => fr,
+  },
+};
+
+export { BortleVisualizerComponent, BortleVisualizerSEO, BortleVisualizerBibliography };
+
+export const BORTLE_VISUALIZER_TOOL: ToolDefinition = {
+  entry: bortleVisualizer,
+  Component: BortleVisualizerComponent,
+  SEOComponent: BortleVisualizerSEO,
+  BibliographyComponent: BortleVisualizerBibliography,
+};

package/src/tool/bortleVisualizer/logic.ts

@@ -0,0 +1,118 @@
+export interface BortleClass {
+  level: number;
+  title: string;
+  description: string;
+  nelm: number;
+  sqm: string;
+  starsVisible: boolean;
+  milkyWayVisible: boolean;
+  cloudsLit: boolean;
+  skyBrightness: number;
+}
+
+export const BORTLE_SCALE: Record<number, BortleClass> = {
+  1: {
+    level: 1,
+    title: 'Cielo Oscuro Excelente',
+    description: 'El nirvana astronómico. La Vía Láctea proyecta sombras. La luz zodiacal es visible y colorida. M33 es visible a simple vista.',
+    nelm: 8.0,
+    sqm: '21.99 - 22.0',
+    starsVisible: true,
+    milkyWayVisible: true,
+    cloudsLit: false,
+    skyBrightness: 0.0,
+  },
+  2: {
+    level: 2,
+    title: 'Cielo Oscuro Típico',
+    description: 'Sitios realmente oscuros. La Vía Láctea es muy estructurada. Nubes solo visibles como agujeros negros en el cielo.',
+    nelm: 7.5,
+    sqm: '21.89 - 21.99',
+    starsVisible: true,
+    milkyWayVisible: true,
+    cloudsLit: false,
+    skyBrightness: 0.1,
+  },
+  3: {
+    level: 3,
+    title: 'Cielo Rural',
+    description: 'Vía Láctea compleja. Alguna contaminación lumínica en el horizonte. Las nubes están iluminadas cerca del horizonte pero oscuras arriba.',
+    nelm: 7.0,
+    sqm: '21.69 - 21.89',
+    starsVisible: true,
+    milkyWayVisible: true,
+    cloudsLit: true,
+    skyBrightness: 0.2,
+  },
+  4: {
+    level: 4,
+    title: 'Transición Rural/Suburbana',
+    description: 'La Vía Láctea pierde detalle pero se ve. Domos de luz en el horizonte. Las nubes están iluminadas por abajo.',
+    nelm: 6.5,
+    sqm: '20.49 - 21.69',
+    starsVisible: true,
+    milkyWayVisible: true,
+    cloudsLit: true,
+    skyBrightness: 0.35,
+  },
+  5: {
+    level: 5,
+    title: 'Cielo Suburbano',
+    description: 'La Vía Láctea es muy débil o invisible cerca del horizonte. Luz zodiacal rara vez visible. El cielo se ve grisáceo, no negro.',
+    nelm: 6.0,
+    sqm: '19.50 - 20.49',
+    starsVisible: true,
+    milkyWayVisible: true,
+    cloudsLit: true,
+    skyBrightness: 0.5,
+  },
+  6: {
+    level: 6,
+    title: 'Cielo Suburbano Brillante',
+    description: 'Vía Láctea invisible. El cielo es gris brillante. Nubes muy brillantes. M31 (Andrómeda) apenas visible.',
+    nelm: 5.5,
+    sqm: '18.94 - 19.50',
+    starsVisible: true,
+    milkyWayVisible: false,
+    cloudsLit: true,
+    skyBrightness: 0.65,
+  },
+  7: {
+    level: 7,
+    title: 'Transición Suburbana/Urbana',
+    description: 'Fondo del cielo gris claro. Fuentes de luz fuertes en todas direcciones. Solo las estrellas más brillantes son visibles.',
+    nelm: 5.0,
+    sqm: '18.38 - 18.94',
+    starsVisible: true,
+    milkyWayVisible: false,
+    cloudsLit: true,
+    skyBrightness: 0.8,
+  },
+  8: {
+    level: 8,
+    title: 'Cielo Urbano',
+    description: 'El cielo es gris blanquecino o naranja. Se pueden leer titulares de periódico. Solo se ven constelaciones principales.',
+    nelm: 4.5,
+    sqm: '< 18.38',
+    starsVisible: true,
+    milkyWayVisible: false,
+    cloudsLit: true,
+    skyBrightness: 0.9,
+  },
+  9: {
+    level: 9,
+    title: 'Cielo Urbano Interior',
+    description: 'El cielo es muy brillante, incluso en el cenit. Solo se ven la Luna, planetas y un puñado de estrellas brillantes.',
+    nelm: 4.0,
+    sqm: '< 18.00',
+    starsVisible: false,
+    milkyWayVisible: false,
+    cloudsLit: true,
+    skyBrightness: 1.0,
+  },
+};
+
+export function getBortleData(level: number): BortleClass {
+  const safeLevel = Math.max(1, Math.min(9, Math.floor(level)));
+  return BORTLE_SCALE[safeLevel]!;
+}