@jjlmoya/utils-astronomy 1.1.0

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

@@ -0,0 +1,168 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { TelescopeResolutionUI, TelescopeResolutionLocaleContent } from '../index';
+
+const slug = 'telescope-resolution-calculator';
+const title = 'Telescope Resolution Calculator (Dawes Limit)';
+const description = 'Calculate the resolving power of your telescope with the Dawes Limit and Rayleigh Criterion. Discover the maximum useful magnification and the impact of atmospheric seeing.';
+
+const ui: TelescopeResolutionUI = {
+  toolTitle: 'Telescope Resolution',
+  apertureLabel: 'Telescope Aperture',
+  unitLabel: 'Unit',
+  mmUnit: 'Millimeters (mm)',
+  inUnit: 'Inches (in)',
+  presetsLabel: 'Common Models',
+  presetsPlaceholder: '-- Select Preset --',
+  seeingLabel: 'Sky Quality (Seeing)',
+  dawesLabel: 'Useful Resolution (Dawes)',
+  arcsecUnit: 'arcseconds',
+  rayleighLabel: 'Rayleigh Limit',
+  maxMagLabel: 'Max. Useful Magnification',
+  seeingAlertPrefix: 'Atmosphere limited: Today\'s seeing',
+  seeingAlertSuffix: 'will prevent you from seeing your telescope\'s full potential',
+  simLabel: 'Simulation: Binary Stars',
+  simExplanation: 'Dawes separates point stars; Rayleigh defines planetary details.',
+};
+
+const faq: TelescopeResolutionLocaleContent['faq'] = [
+  {
+    question: 'What is the Dawes Limit?',
+    answer: 'The Dawes Limit is an empirical criterion for the angular resolution of a telescope, calculated as 116/D (where D is the diameter in mm). It represents the minimum separation in arcseconds between two stars of similar magnitude that an experienced observer can distinguish as two separate points. It was proposed by British astronomer William Dawes in the 19th century.',
+  },
+  {
+    question: 'What is the difference between Dawes and Rayleigh?',
+    answer: 'The Dawes Limit (116/D) is empirical and based on human vision for double stars. The Rayleigh Criterion (138/D) is physical, based on the wave nature of light. Rayleigh is more stringent and applies better to details on planetary surfaces (Jupiter\'s bands, lunar craters). Dawes is more useful for separating binary stars.',
+  },
+  {
+    question: 'What is seeing and how does it affect me?',
+    answer: 'Seeing is the measure of atmospheric turbulence that distorts light passing through the air. On an average night, seeing limits resolution to 1-2 arcseconds, meaning telescopes larger than ~115mm cannot exceed this atmospheric limit. Excellent seeing (0.5") is rare and occurs in high-altitude locations with little thermal activity.',
+  },
+  {
+    question: 'What is the maximum useful magnification of a telescope?',
+    answer: 'The golden rule is 2x the aperture in mm (or 50x per inch). A 150mm telescope has a useful maximum of 300x. Exceeding this limit makes the image larger but without more detail, only darker and blurrier. Seeing frequently limits this value to 100-150x on average nights.',
+  },
+];
+
+const howTo: TelescopeResolutionLocaleContent['howTo'] = [
+  { name: '1. Enter the aperture', text: 'Type the diameter of your telescope\'s main mirror or lens. You can select a preset from common models.' },
+  { name: '2. Adjust seeing', text: 'Move the seeing slider to simulate the atmospheric turbulence on your observation night.' },
+  { name: '3. Interpret results', text: 'Observe the Dawes and Rayleigh limits in arcseconds. The lower the value, the higher the resolution.' },
+  { name: '4. Check if seeing limits you', text: 'If the seeing alert appears, the atmosphere is limiting your telescope\'s performance that night.' },
+];
+
+const bibliography: TelescopeResolutionLocaleContent['bibliography'] = [
+  { name: 'Sky & Telescope - Telescope Resolution Explained', url: 'https://skyandtelescope.org/stargazing-and-observing/celestial-objects-to-watch/telescope-calculator/' },
+  { name: 'British Astronomical Association - Seeing Scale', url: 'https://www.britastro.org/' },
+  { name: 'Astronomical Seeing (Wikipedia)', url: 'https://en.wikipedia.org/wiki/Astronomical_seeing' },
+];
+
+const seo: TelescopeResolutionLocaleContent['seo'] = [
+  {
+    type: 'summary',
+    title: 'Key Points of Telescopic Resolution',
+    items: [
+      'The Dawes Limit (116/D mm) determines the minimum separation between resolvable binary stars.',
+      'The Rayleigh Criterion (138/D mm) defines the minimum visible detail on planetary surfaces.',
+      'Atmospheric seeing (1-2" typical) usually exceeds the theoretical limit of telescopes larger than 115mm.',
+      'Maximum useful magnification is 2x aperture in mm; exceeding this only darkens the image.',
+    ],
+  },
+  { type: 'title', text: 'Astronomical Resolution: Guide to the Dawes Limit and Rayleigh', level: 2 },
+  {
+    type: 'paragraph',
+    html: 'The power of a telescope is not measured by how much it can magnify an image, but by how much detail it can resolve. This capability, known as <strong>resolving power</strong>, depends almost exclusively on the diameter of its aperture. The larger the mirror or main lens, the smaller the details it can separate.',
+  },
+  {
+    type: 'paragraph',
+    html: 'There are two main criteria for quantifying this resolution. The <strong>Dawes Limit</strong> (116/D arcsec) is empirical, defined by astronomer William Dawes based on double star observations. The <strong>Rayleigh Criterion</strong> (138/D arcsec) is theoretical, derived from the wave physics of light diffraction. Both agree that aperture is the decisive factor.',
+  },
+  { type: 'title', text: 'Seeing: The Atmospheric Barrier', level: 2 },
+  {
+    type: 'paragraph',
+    html: 'You can have the world\'s largest telescope, but if the atmosphere is unstable, you won\'t see fine details. <strong>Seeing</strong> is the measure of atmospheric turbulence. On an average night, the atmosphere limits resolution to approximately 1-1.5 arcseconds. For telescopes larger than 115mm, seeing is the bottleneck, not the optics.',
+  },
+  {
+    type: 'table',
+    headers: ['Aperture', 'Dawes (arcsec)', 'Rayleigh (arcsec)', 'Max. Mag', 'Required Seeing'],
+    rows: [
+      ['70mm', '1.66"', '1.97"', '140x', '< 1.7"'],
+      ['100mm', '1.16"', '1.38"', '200x', '< 1.2"'],
+      ['150mm', '0.77"', '0.92"', '300x', '< 0.8"'],
+      ['200mm', '0.58"', '0.69"', '400x', '< 0.6"'],
+      ['300mm', '0.39"', '0.46"', '600x', '< 0.4"'],
+      ['400mm', '0.29"', '0.35"', '800x', '< 0.3"'],
+    ],
+  },
+  {
+    type: 'tip',
+    title: 'Thermal Acclimatization: The Secret to Detail',
+    html: 'The greatest enemy of resolution is not external seeing, but <strong>local seeing</strong> inside the telescope tube. The warm air remaining inside when moving the telescope from indoors creates convection currents that destroy detail. Allow your telescope to acclimatize to outdoor temperature for at least 30-60 minutes before observing at high magnification.',
+  },
+  { type: 'title', text: 'Collimation: The Alignment that Unlocks Potential', level: 2 },
+  {
+    type: 'paragraph',
+    html: 'A poorly collimated telescope (with misaligned mirrors) will never perform at the Dawes limit, regardless of aperture. <strong>Collimation</strong> is the process of perfectly aligning the secondary and primary mirrors with the focuser. For reflecting telescopes (Newtonians, Dobsonians), collimation is an essential periodic task. Practice using the "star test" technique on a bright star.',
+  },
+  { type: 'title', text: 'Practical Tips to Maximize Resolution', level: 2 },
+  {
+    type: 'paragraph',
+    html: 'Beyond aperture and collimation, several observational habits dramatically improve the resolution you achieve in practice. Always wait for the telescope to reach thermal equilibrium with outdoor air — this takes 30-60 minutes for most instruments. Avoid observing over rooftops, parking lots, or any surface that radiates stored heat. Choose nights after cold fronts pass, which tend to bring more stable atmospheric layers. Use the highest magnification that still gives a steady image — if the image is "boiling", drop to a lower power eyepiece and wait for a steadier moment to push higher. Finally, <strong>dark adaptation</strong> matters even for planetary work: give your eyes 20 minutes of complete darkness to maximize cone sensitivity for color detail on planets like Mars or Jupiter.',
+  },
+  {
+    type: 'stats',
+    columns: 2,
+    items: [
+      { label: 'Dawes 150mm', value: '0.77"', icon: 'mdi:flare' },
+      { label: 'Dawes 300mm', value: '0.39"', icon: 'mdi:flare' },
+      { label: 'Good Seeing', value: '0.5 - 1.0"', icon: 'mdi:weather-windy' },
+      { label: 'Average Seeing', value: '1.0 - 2.0"', icon: 'mdi:weather-cloudy' },
+    ],
+  },
+];
+
+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: TelescopeResolutionLocaleContent = {
+  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/telescopeResolution/i18n/es.ts

@@ -0,0 +1,163 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { TelescopeResolutionUI, TelescopeResolutionLocaleContent } from '../index';
+
+const slug = 'calculadora-resolucion-telescopio';
+const title = 'Calculadora de Resolución de Telescopio (Límite de Dawes)';
+const description = 'Calcula el poder de resolución de tu telescopio con el Límite de Dawes y el Criterio de Rayleigh. Descubre el aumento máximo útil y el impacto del seeing atmosférico.';
+
+const ui: TelescopeResolutionUI = {
+  toolTitle: 'Resolución del Telescopio',
+  apertureLabel: 'Apertura del Telescopio',
+  unitLabel: 'Unidad de Medida',
+  mmUnit: 'Milímetros (mm)',
+  inUnit: 'Pulgadas (in)',
+  presetsLabel: 'Modelos Comunes',
+  presetsPlaceholder: '-- Seleccionar Preset --',
+  seeingLabel: 'Calidad del Cielo (Seeing)',
+  dawesLabel: 'Resolución Útil (Dawes)',
+  arcsecUnit: 'arcosegundos',
+  rayleighLabel: 'Límite Rayleigh',
+  maxMagLabel: 'Aumento Máx. Útil',
+  seeingAlertPrefix: 'Atmósfera limitada: El seeing de hoy',
+  seeingAlertSuffix: 'impedirá que veas el potencial de tu telescopio',
+  simLabel: 'Simulación: Estrellas Binarias',
+  simExplanation: 'Dawes separa estrellas puntuales; Rayleigh define detalles planetarios.',
+};
+
+const faq: TelescopeResolutionLocaleContent['faq'] = [
+  {
+    question: '¿Qué es el Límite de Dawes?',
+    answer: 'El Límite de Dawes es un criterio empírico para la resolución angular de un telescopio, calculado como 116/D (donde D es el diámetro en mm). Representa la separación mínima en arcosegundos entre dos estrellas de similar magnitud que un observador experimentado puede distinguir como dos puntos separados. Fue propuesto por el astrónomo británico William Dawes en el siglo XIX.',
+  },
+  {
+    question: '¿Cuál es la diferencia entre Dawes y Rayleigh?',
+    answer: 'El Límite de Dawes (116/D) es empírico y basado en la visión humana para estrellas dobles. El Criterio de Rayleigh (138/D) es físico, basado en la naturaleza ondulatoria de la luz. Rayleigh es más estricto y se aplica mejor para detalles en superficies planetarias (bandas de Júpiter, cráteres de la Luna). Dawes es más útil para separar estrellas binarias.',
+  },
+  {
+    question: '¿Qué es el seeing y cómo me afecta?',
+    answer: 'El seeing es la medida de la turbulencia atmosférica que distorsiona la luz que pasa a través del aire. En una noche promedio, el seeing limita la resolución a 1-2 arcosegundos, lo que significa que telescopios mayores de ~115mm no pueden superar este límite atmosférico. El seeing excelente (0.5") es raro y se da en zonas altas y con poca actividad térmica.',
+  },
+  {
+    question: '¿Cuál es el aumento máximo útil de un telescopio?',
+    answer: 'La regla de oro es 2x la apertura en mm (o 50x por pulgada). Un telescopio de 150mm tiene un máximo útil de 300x. Pasar de este límite hace la imagen más grande pero sin más detalle, solo más oscura y borrosa. El seeing frecuentemente limita este valor a 100-150x en noches medias.',
+  },
+];
+
+const howTo: TelescopeResolutionLocaleContent['howTo'] = [
+  { name: '1. Introduce la apertura', text: 'Escribe el diámetro del espejo o lente principal de tu telescopio. Puedes seleccionar un preset de modelos comunes.' },
+  { name: '2. Ajusta el seeing', text: 'Mueve el slider de seeing para simular la turbulencia atmosférica de tu noche de observación.' },
+  { name: '3. Interpreta los resultados', text: 'Observa los límites de Dawes y Rayleigh en arcosegundos. Cuanto menor, mayor resolución.' },
+  { name: '4. Verifica si el seeing te limita', text: 'Si aparece la alerta de seeing, tu atmósfera está limitando el rendimiento de tu telescopio esa noche.' },
+];
+
+const bibliography: TelescopeResolutionLocaleContent['bibliography'] = [
+  { name: 'Sky & Telescope - Telescope Resolution Explained', url: 'https://skyandtelescope.org/stargazing-and-observing/celestial-objects-to-watch/telescope-calculator/' },
+  { name: 'British Astronomical Association - Seeing Scale', url: 'https://www.britastro.org/' },
+  { name: 'Atmospheric Dispersion and Seeing (Astronomia)', url: 'https://en.wikipedia.org/wiki/Astronomical_seeing' },
+];
+
+const seo: TelescopeResolutionLocaleContent['seo'] = [
+  {
+    type: 'summary',
+    title: 'Claves de la Resolución Telescópica',
+    items: [
+      'El Límite de Dawes (116/D mm) determina la separación mínima entre estrellas binarias resolvibles.',
+      'El Criterio de Rayleigh (138/D mm) define el detalle mínimo visible en superficies planetarias.',
+      'El seeing atmosférico (1-2" típico) suele superar el límite teórico de telescopios mayores de 115mm.',
+      'El aumento máximo útil es 2x la apertura en mm; superarlo solo oscurece la imagen.',
+    ],
+  },
+  { type: 'title', text: 'Resolución Astronómica: Guía del Límite de Dawes y Rayleigh', level: 2 },
+  {
+    type: 'paragraph',
+    html: 'La potencia de un telescopio no se mide por cuánto puede ampliar una imagen, sino por cuánto detalle es capaz de resolver. Esta capacidad, conocida como <strong>poder de resolución</strong>, depende casi exclusivamente del diámetro de su apertura. Cuanto mayor es el espejo o la lente principal, más pequeños son los detalles que puede separar.',
+  },
+  {
+    type: 'paragraph',
+    html: 'Existen dos criterios principales para cuantificar esta resolución. El <strong>Límite de Dawes</strong> (116/D arcsec) es empírico, definido por el astrónomo William Dawes en base a observaciones de estrellas dobles. El <strong>Criterio de Rayleigh</strong> (138/D arcsec) es teórico, derivado de la física ondulatoria de la difracción de la luz. Ambos concuerdan en que la apertura es el factor decisivo.',
+  },
+  { type: 'title', text: 'El Seeing: La Barrera Atmosférica', level: 2 },
+  {
+    type: 'paragraph',
+    html: 'Puedes tener el telescopio más grande del mundo, pero si la atmósfera está inestable, no verás detalles finos. El <strong>seeing</strong> es la medida de la turbulencia atmosférica. En una noche media, la atmósfera limita la resolución a aproximadamente 1-1.5 arcosegundos. Para un telescopio de 115mm con Dawes = 1.01", el seeing promedio no permite ver más detalle del teórico. Para telescopios más grandes, el seeing es el cuello de botella.',
+  },
+  {
+    type: 'table',
+    headers: ['Apertura', 'Dawes (arcsec)', 'Rayleigh (arcsec)', 'Max. Aumento', 'Seeing necesario'],
+    rows: [
+      ['70mm', '1.66"', '1.97"', '140x', '< 1.7"'],
+      ['100mm', '1.16"', '1.38"', '200x', '< 1.2"'],
+      ['150mm', '0.77"', '0.92"', '300x', '< 0.8"'],
+      ['200mm', '0.58"', '0.69"', '400x', '< 0.6"'],
+      ['300mm', '0.39"', '0.46"', '600x', '< 0.4"'],
+      ['400mm', '0.29"', '0.35"', '800x', '< 0.3"'],
+    ],
+  },
+  {
+    type: 'tip',
+    title: 'Aclimatación Térmica: El Secreto del Detalle',
+    html: 'El mayor enemigo de la resolución no es el seeing externo, sino el <strong>seeing local</strong> dentro del tubo del telescopio. El aire caliente que queda dentro al trasladar el telescopio del interior al exterior crea corrientes de convección que destruyen el detalle. Deja que tu telescopio se aclimate a temperatura exterior durante al menos 30-60 minutos antes de observar a altos aumentos.',
+  },
+  { type: 'title', text: 'Colimación: La Alineación que Libera el Potencial', level: 2 },
+  {
+    type: 'paragraph',
+    html: 'Un telescopio mal colimado (con los espejos desalineados) nunca rendirá al límite de Dawes, independientemente de la apertura. La <strong>colimación</strong> es el proceso de alinear perfectamente los espejos secundario y primario con el portaocular. Para telescopios reflectores (Newtonianos, Dobsonianos), la colimación es una tarea periódica imprescindible. Practica la colimación en la estrella artificial de Polaris o en una estrella brillante usando la técnica del "star test".',
+  },
+  {
+    type: 'stats',
+    columns: 2,
+    items: [
+      { label: 'Dawes 150mm', value: '0.77"', icon: 'mdi:flare' },
+      { label: 'Dawes 300mm', value: '0.39"', icon: 'mdi:flare' },
+      { label: 'Seeing Bueno', value: '0.5 - 1.0"', icon: 'mdi:weather-windy' },
+      { label: 'Seeing Medio', value: '1.0 - 2.0"', icon: 'mdi:weather-cloudy' },
+    ],
+  },
+];
+
+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: TelescopeResolutionLocaleContent = {
+  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/telescopeResolution/i18n/fr.ts

@@ -0,0 +1,168 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { TelescopeResolutionUI, TelescopeResolutionLocaleContent } from '../index';
+
+const slug = 'calculateur-resolution-telescope';
+const title = 'Calculateur de Résolution du Télescope (Limite de Dawes)';
+const description = 'Calculez le pouvoir de résolution de votre télescope avec la Limite de Dawes et le Critère de Rayleigh. Découvrez le grossissement maximum utile et l\'impact du seeing atmosphérique.';
+
+const ui: TelescopeResolutionUI = {
+  toolTitle: 'Résolution du Télescope',
+  apertureLabel: 'Ouverture du Télescope',
+  unitLabel: 'Unité',
+  mmUnit: 'Millimètres (mm)',
+  inUnit: 'Pouces (in)',
+  presetsLabel: 'Modèles Courants',
+  presetsPlaceholder: '-- Sélectionner un Modèle --',
+  seeingLabel: 'Qualité du Ciel (Seeing)',
+  dawesLabel: 'Résolution Utile (Dawes)',
+  arcsecUnit: 'arcsecondes',
+  rayleighLabel: 'Limite de Rayleigh',
+  maxMagLabel: 'Grossissement Max. Utile',
+  seeingAlertPrefix: 'Atmosphère limitée: Le seeing d\'aujourd\'hui',
+  seeingAlertSuffix: 'vous empêchera de voir le potentiel complet de votre télescope',
+  simLabel: 'Simulation: Étoiles Binaires',
+  simExplanation: 'Dawes sépare les étoiles ponctuelles; Rayleigh définit les détails planétaires.',
+};
+
+const faq: TelescopeResolutionLocaleContent['faq'] = [
+  {
+    question: 'Qu\'est-ce que la Limite de Dawes?',
+    answer: 'La Limite de Dawes est un critère empirique pour la résolution angulaire d\'un télescope, calculée comme 116/D (où D est le diamètre en mm). Elle représente la séparation minimale en arcsecondes entre deux étoiles de magnitude similaire qu\'un observateur expérimenté peut distinguer comme deux points séparés. Elle a été proposée par l\'astronome britannique William Dawes au XIXe siècle.',
+  },
+  {
+    question: 'Quelle est la différence entre Dawes et Rayleigh?',
+    answer: 'La Limite de Dawes (116/D) est empirique et basée sur la vision humaine pour les étoiles doubles. Le Critère de Rayleigh (138/D) est physique, basé sur la nature ondulatoire de la lumière. Rayleigh est plus strict et s\'applique mieux aux détails sur les surfaces planétaires (bandes de Jupiter, cratères lunaires). Dawes est plus utile pour séparer les étoiles binaires.',
+  },
+  {
+    question: 'Qu\'est-ce que le seeing et comment m\'affecte-t-il?',
+    answer: 'Le seeing est la mesure de la turbulence atmosphérique qui distord la lumière traversant l\'air. Par nuit moyenne, le seeing limite la résolution à environ 1-2 arcsecondes, ce qui signifie que les télescopes plus grands que ~115mm ne peuvent pas dépasser cette limite atmosphérique. Un excellent seeing (0.5") est rare et se produit dans des zones de haute altitude avec peu d\'activité thermique.',
+  },
+  {
+    question: 'Quel est le grossissement maximum utile d\'un télescope?',
+    answer: 'La règle d\'or est 2x l\'ouverture en mm (ou 50x par pouce). Un télescope de 150mm a un maximum utile de 300x. Dépasser cette limite rend l\'image plus grande mais sans plus de détail, seulement plus sombre et plus floue. Le seeing limite fréquemment cette valeur à 100-150x par nuit moyenne.',
+  },
+];
+
+const howTo: TelescopeResolutionLocaleContent['howTo'] = [
+  { name: '1. Entrez l\'ouverture', text: 'Tapez le diamètre du miroir ou de la lentille principale de votre télescope. Vous pouvez sélectionner un modèle prédéfini.' },
+  { name: '2. Ajustez le seeing', text: 'Déplacez le curseur de seeing pour simuler la turbulence atmosphérique de votre nuit d\'observation.' },
+  { name: '3. Interprétez les résultats', text: 'Observez les limites de Dawes et Rayleigh en arcsecondes. Plus la valeur est faible, plus la résolution est élevée.' },
+  { name: '4. Vérifiez si le seeing vous limite', text: 'Si l\'alerte de seeing apparaît, l\'atmosphère limite les performances de votre télescope cette nuit.' },
+];
+
+const bibliography: TelescopeResolutionLocaleContent['bibliography'] = [
+  { name: 'Sky & Telescope - Résolution du Télescope', url: 'https://skyandtelescope.org/stargazing-and-observing/celestial-objects-to-watch/telescope-calculator/' },
+  { name: 'British Astronomical Association - Échelle de Seeing', url: 'https://www.britastro.org/' },
+  { name: 'Turbulence Atmosphérique (Wikipedia)', url: 'https://en.wikipedia.org/wiki/Astronomical_seeing' },
+];
+
+const seo: TelescopeResolutionLocaleContent['seo'] = [
+  {
+    type: 'summary',
+    title: 'Points Clés de la Résolution Télescopique',
+    items: [
+      'La Limite de Dawes (116/D mm) détermine la séparation minimale entre étoiles binaires résolvables.',
+      'Le Critère de Rayleigh (138/D mm) définit le détail minimal visible sur les surfaces planétaires.',
+      'Le seeing atmosphérique (1-2" typique) dépasse généralement la limite théorique des télescopes > 115mm.',
+      'Le grossissement maximum utile est 2x l\'ouverture en mm; le dépasser obscurcit seulement l\'image.',
+    ],
+  },
+  { type: 'title', text: 'Résolution Astronomique: Guide de la Limite de Dawes et Rayleigh', level: 2 },
+  {
+    type: 'paragraph',
+    html: 'La puissance d\'un télescope ne se mesure pas à combien il peut agrandir une image, mais à combien de détails il peut résoudre. Cette capacité, connue sous le nom de <strong>pouvoir de résolution</strong>, dépend presque exclusivement du diamètre de son ouverture. Plus le miroir ou la lentille principale est grand, plus les détails qu\'il peut séparer sont petits.',
+  },
+  {
+    type: 'paragraph',
+    html: 'Il existe deux critères principaux pour quantifier cette résolution. La <strong>Limite de Dawes</strong> (116/D arcsecondes) est empirique, définie par l\'astronome William Dawes sur la base d\'observations d\'étoiles doubles. Le <strong>Critère de Rayleigh</strong> (138/D arcsecondes) est théorique, dérivé de la physique ondulatoire de la diffraction de la lumière. Les deux s\'accordent à dire que l\'ouverture est le facteur décisif.',
+  },
+  { type: 'title', text: 'Le Seeing: La Barrière Atmosphérique', level: 2 },
+  {
+    type: 'paragraph',
+    html: 'Vous pouvez avoir le plus grand télescope du monde, mais si l\'atmosphère est instable, vous ne verrez pas de détails fins. Le <strong>seeing</strong> est la mesure de la turbulence atmosphérique. Par nuit moyenne, l\'atmosphère limite la résolution à environ 1-1.5 arcseconde. Pour les télescopes de plus de 115mm, le seeing est le goulot d\'étranglement, pas l\'optique.',
+  },
+  {
+    type: 'table',
+    headers: ['Ouverture', 'Dawes (arcsec)', 'Rayleigh (arcsec)', 'Grossissement Max', 'Seeing requis'],
+    rows: [
+      ['70mm', '1.66"', '1.97"', '140x', '< 1.7"'],
+      ['100mm', '1.16"', '1.38"', '200x', '< 1.2"'],
+      ['150mm', '0.77"', '0.92"', '300x', '< 0.8"'],
+      ['200mm', '0.58"', '0.69"', '400x', '< 0.6"'],
+      ['300mm', '0.39"', '0.46"', '600x', '< 0.4"'],
+      ['400mm', '0.29"', '0.35"', '800x', '< 0.3"'],
+    ],
+  },
+  {
+    type: 'tip',
+    title: 'Acclimatation Thermique: Le Secret du Détail',
+    html: 'Le plus grand ennemi de la résolution n\'est pas le seeing externe, mais le <strong>seeing local</strong> à l\'intérieur du tube du télescope. L\'air chaud restant à l\'intérieur lors du déplacement du télescope de l\'intérieur crée des courants de convection qui détruisent le détail. Laissez votre télescope s\'acclimater à la température extérieure pendant au moins 30-60 minutes avant d\'observer à forts grossissements.',
+  },
+  { type: 'title', text: 'Collimation: L\'Alignement qui Libère le Potentiel', level: 2 },
+  {
+    type: 'paragraph',
+    html: 'Un télescope mal collimaté (avec des miroirs désalignés) n\'atteindra jamais la limite de Dawes, quelle que soit l\'ouverture. La <strong>collimation</strong> est le processus d\'alignement parfait des miroirs secondaire et primaire avec le porte-oculaire. Pour les télescopes réflecteurs (Newtoniens, Dobsoniens), la collimation est une tâche périodique indispensable.',
+  },
+  { type: 'title', text: 'Conseils Pratiques pour Maximiser la Résolution', level: 2 },
+  {
+    type: 'paragraph',
+    html: 'Au-delà de l\'ouverture et de la collimation, plusieurs habitudes d\'observation améliorent considérablement la résolution obtenue en pratique. Attendez toujours que le télescope atteigne l\'équilibre thermique avec l\'air extérieur — cela prend 30 à 60 minutes pour la plupart des instruments. Évitez d\'observer au-dessus des toits, parkings ou toute surface qui rayonne la chaleur emmagasinée. Choisissez des nuits après le passage de fronts froids, qui tendent à apporter des couches atmosphériques plus stables. Utilisez le grossissement maximum qui donne encore une image stable — si l\'image "bout", passez à un oculaire de plus faible grossissement. Enfin, l\'<strong>adaptation à l\'obscurité</strong> est importante même pour le travail planétaire: laissez vos yeux 20 minutes dans l\'obscurité complète pour maximiser la sensibilité aux détails colorés sur des planètes comme Mars ou Jupiter.',
+  },
+  {
+    type: 'stats',
+    columns: 2,
+    items: [
+      { label: 'Dawes 150mm', value: '0.77"', icon: 'mdi:flare' },
+      { label: 'Dawes 300mm', value: '0.39"', icon: 'mdi:flare' },
+      { label: 'Bon Seeing', value: '0.5 - 1.0"', icon: 'mdi:weather-windy' },
+      { label: 'Seeing Moyen', value: '1.0 - 2.0"', icon: 'mdi:weather-cloudy' },
+    ],
+  },
+];
+
+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: TelescopeResolutionLocaleContent = {
+  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/telescopeResolution/index.ts

@@ -0,0 +1,52 @@
+import type { AstronomyToolEntry, ToolLocaleContent, ToolDefinition } from '../../types';
+import TelescopeResolutionComponent from './component.astro';
+import TelescopeResolutionSEO from './seo.astro';
+import TelescopeResolutionBibliography from './bibliography.astro';
+
+export interface TelescopeResolutionUI {
+  [key: string]: string;
+  toolTitle: string;
+  apertureLabel: string;
+  unitLabel: string;
+  mmUnit: string;
+  inUnit: string;
+  presetsLabel: string;
+  presetsPlaceholder: string;
+  seeingLabel: string;
+  dawesLabel: string;
+  arcsecUnit: string;
+  rayleighLabel: string;
+  maxMagLabel: string;
+  seeingAlertPrefix: string;
+  seeingAlertSuffix: string;
+  simLabel: string;
+  simExplanation: string;
+}
+
+export type TelescopeResolutionLocaleContent = ToolLocaleContent<TelescopeResolutionUI>;
+
+import { content as es } from './i18n/es';
+import { content as en } from './i18n/en';
+import { content as fr } from './i18n/fr';
+
+export const telescopeResolution: AstronomyToolEntry<TelescopeResolutionUI> = {
+  id: 'telescope-resolution',
+  icons: {
+    bg: 'mdi:telescope',
+    fg: 'mdi:flare',
+  },
+  i18n: {
+    es: async () => es,
+    en: async () => en,
+    fr: async () => fr,
+  },
+};
+
+export { TelescopeResolutionComponent, TelescopeResolutionSEO, TelescopeResolutionBibliography };
+
+export const TELESCOPE_RESOLUTION_TOOL: ToolDefinition = {
+  entry: telescopeResolution,
+  Component: TelescopeResolutionComponent,
+  SEOComponent: TelescopeResolutionSEO,
+  BibliographyComponent: TelescopeResolutionBibliography,
+};

package/src/tool/telescopeResolution/logic.ts

@@ -0,0 +1,39 @@
+export interface ResolutionResult {
+  dawes: number;
+  rayleigh: number;
+  maxMagnification: number;
+  apertureMm: number;
+  seeingLimited: boolean;
+}
+
+export function calculateResolution(apertureMm: number, seeing: number): ResolutionResult {
+  const dawes = 116 / apertureMm;
+  const rayleigh = 138 / apertureMm;
+  const maxMagnification = apertureMm * 2;
+  const seeingLimited = dawes < seeing;
+
+  return {
+    dawes,
+    rayleigh,
+    maxMagnification,
+    apertureMm,
+    seeingLimited,
+  };
+}
+
+export function inchesToMm(inches: number): number {
+  return inches * 25.4;
+}
+
+export function mmToInches(mm: number): number {
+  return mm / 25.4;
+}
+
+export const TELESCOPE_PRESETS: { label: string; mm: number }[] = [
+  { label: '70mm (Refractor - Iniciación)', mm: 70 },
+  { label: '114mm (4.5") Newtonian', mm: 114 },
+  { label: '150mm (6") Dobson', mm: 150 },
+  { label: '200mm (8") Dobson', mm: 200 },
+  { label: '254mm (10") Dobson', mm: 254 },
+  { label: '304mm (12") Profesional', mm: 304 },
+];

package/src/tool/telescopeResolution/seo.astro

@@ -0,0 +1,61 @@
+---
+import {
+  SEOTitle,
+  SEOTable,
+  SEOTip,
+  SEOCard,
+  SEOStats,
+  SEOGlossary,
+  SEOProsCons,
+  SEOSummary,
+  SEODiagnostic,
+  SEOArticle
+} from '@jjlmoya/utils-shared';
+import { telescopeResolution } from './index';
+import type { KnownLocale } from '../../types';
+
+interface Props {
+  locale?: KnownLocale;
+}
+
+const { locale = 'es' } = Astro.props;
+const content = await telescopeResolution.i18n[locale]?.();
+if (!content) return null;
+
+const { seo } = content;
+---
+
+<SEOArticle>
+  {seo.map((section: any) => {
+    switch (section.type) {
+      case 'summary':
+        return <SEOSummary title={section.title} items={section.items} />;
+      case 'title':
+        return <SEOTitle title={section.text} level={section.level || 2} />;
+      case 'paragraph':
+        return <p set:html={section.html} />;
+      case 'stats':
+        return <SEOStats stats={section.items} columns={section.columns} />;
+      case 'card':
+        return <SEOCard title={section.title} icon={section.icon}><Fragment set:html={section.html} /></SEOCard>;
+      case 'tip':
+        return <SEOTip title={section.title}><Fragment set:html={section.html} /></SEOTip>;
+      case 'table':
+        return (
+          <SEOTable headers={section.headers}>
+            {section.rows.map((row: string[]) => (
+              <tr>{row.map((cell: string) => <td set:html={cell} />)}</tr>
+            ))}
+          </SEOTable>
+        );
+      case 'proscons':
+        return <SEOProsCons title={section.title} items={section.items} />;
+      case 'diagnostic':
+        return <SEODiagnostic title={section.title} icon={section.icon} type={section.variant} badge={section.badge}><Fragment set:html={section.html} /></SEODiagnostic>;
+      case 'glossary':
+        return <SEOGlossary items={section.items} />;
+      default:
+        return null;
+    }
+  })}
+</SEOArticle>