@jjlmoya/utils-astronomy 1.4.0 → 1.6.0

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

@@ -0,0 +1,167 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { BortleVisualizerUI, BortleVisualizerLocaleContent } from '../index';
+
+const slug = 'dark-sky-simulator';
+const title = 'Symulator ciemnego nieba (Skala Bortle’a)';
+const description = 'Interaktywna wizualizacja 9 poziomów skali Bortle’a. Odkryj, jak zanieczyszczenie światłem wymazuje rozgwieżdżone nocne niebo.';
+
+const ui: BortleVisualizerUI = {
+  toolTitle: 'Symulator ciemnego nieba',
+  sliderLabel: 'Przesuń, aby dostosować poziom zanieczyszczenia światłem',
+  classLabel: 'Klasa Bortle’a',
+  nelmLabel: 'NELM',
+  sqmLabel: 'SQM',
+  classPrefix: 'KLASA',
+  bortleData: {
+    1: { title: 'Doskonale ciemne niebo', description: 'Raj dla astronomów. Droga Mleczna rzuca cienie. Światło zodiakalne widoczne i kolorowe. Galaktyka M33 widoczna gołym okiem.', nelm: 8.0, sqm: '21.99 - 22.0', starsVisible: true, milkyWayVisible: true, cloudsLit: false, skyBrightness: 0.0 },
+    2: { title: 'Prawdziwie ciemne niebo', description: 'Bardzo ciemne miejsca. Droga Mleczna jest mocno ustrukturyzowana. Chmury widoczne tylko jako czarne dziury na niebie.', nelm: 7.5, sqm: '21.89 - 21.99', starsVisible: true, milkyWayVisible: true, cloudsLit: false, skyBrightness: 0.1 },
+    3: { title: 'Wiejskie niebo', description: 'Złożona Droga Mleczna. Niewielkie zanieczyszczenie światłem na horyzoncie. Chmury oświetlone przy horyzoncie, ale ciemne nad głową.', nelm: 7.0, sqm: '21.69 - 21.89', starsVisible: true, milkyWayVisible: true, cloudsLit: true, skyBrightness: 0.2 },
+    4: { title: 'Niebo wiejskie/podmiejskie', description: 'Droga Mleczna traci szczegóły, ale jest widoczna. Kopuły światła na horyzoncie. Chmury oświetlone od dołu.', nelm: 6.5, sqm: '20.49 - 21.69', starsVisible: true, milkyWayVisible: true, cloudsLit: true, skyBrightness: 0.35 },
+    5: { title: 'Niebo podmiejskie', description: 'Droga Mleczna bardzo słaba lub niewidoczna przy horyzoncie. Światło zodiakalne rzadko widoczne. Niebo wydaje się szarawe.', nelm: 6.0, sqm: '19.50 - 20.49', starsVisible: true, milkyWayVisible: true, cloudsLit: true, skyBrightness: 0.5 },
+    6: { title: 'Jasne niebo podmiejskie', description: 'Droga Mleczna niewidoczna. Niebo jest jasnoszare. Chmury bardzo jasne. Galaktyka M31 ledwo widoczna.', nelm: 5.5, sqm: '18.94 - 19.50', starsVisible: true, milkyWayVisible: false, cloudsLit: true, skyBrightness: 0.65 },
+    7: { title: 'Niebo podmiejskie/miejskie', description: 'Niebo szaro-białe. Silne źródła światła we wszystkich kierunkach. Widoczne tylko najjaśniejsze gwiazdy.', nelm: 5.0, sqm: '18.38 - 18.94', starsVisible: true, milkyWayVisible: false, cloudsLit: true, skyBrightness: 0.8 },
+    8: { title: 'Miejskie niebo', description: 'Niebo jest szaro-białe lub pomarańczowe. Można czytać nagłówki gazet. Widoczne tylko główne gwiazdozbiory.', nelm: 4.5, sqm: '< 18.38', starsVisible: true, milkyWayVisible: false, cloudsLit: true, skyBrightness: 0.9 },
+    9: { title: 'Centrum miasta', description: 'Niebo jasne jak podczas zmierzchu. Księżyc widoczny, ale gwiazdozbiory nie. Widoczne tylko planety i Księżyc.', nelm: 4.0, sqm: '< 18.00', starsVisible: false, milkyWayVisible: false, cloudsLit: true, skyBrightness: 1.0 },
+  },
+};
+
+const faq: BortleVisualizerLocaleContent['faq'] = [
+  {
+    question: 'Czym jest skala Bortle’a?',
+    answer: 'To 9-punktowa skala numeryczna mierząca jasność nocnego nieba w danym miejscu. Została stworzona przez astronoma amatora Johna E. Bortle’a w 2001 roku i opublikowana w Sky & Telescope. Poziom 1 reprezentuje najciemniejsze możliwe niebo (odległe pustynie), a poziom 9 – najbardziej zanieczyszczone światłem (centra miast).',
+  },
+  {
+    question: 'Przy jakim poziomie Bortle’a widać Drogę Mleczną?',
+    answer: 'Droga Mleczna zaczyna być wyraźnie widoczna od poziomu Bortle 4 (strefa wiejska/podmiejska). Na poziomach 1 i 2 jest spektakularna, z wyraźną strukturą zdolną nawet rzucać słabe cienie. Od poziomu Bortle 6 jest praktycznie niewidoczna gołym okiem.',
+  },
+  {
+    question: 'Co oznaczają skróty NELM i SQM?',
+    answer: 'NELM (Naked Eye Limiting Magnitude) to magnitudo najsłabszej gwiazdy widocznej gołym okiem w danych warunkach. SQM (Sky Quality Meter) mierzy jasność nieba w magnitudo na sekundę łuku kwadratową, co jest obiektywnym standardem naukowym.',
+  },
+  {
+    question: 'Jak znaleźć ciemniejsze niebo w mojej okolicy?',
+    answer: 'Użyj map zanieczyszczenia światłem, takich jak lightpollutionmap.info, aby znaleźć strefy Bortle 3 lub ciemniejsze w zasięgu kilku godzin jazdy. Parki narodowe, tereny wysokogórskie i rezerwaty ciemnego nieba oferują najlepsze warunki.',
+  },
+];
+
+const howTo: BortleVisualizerLocaleContent['howTo'] = [
+  { name: '1. Dostosuj poziom Bortle’a', text: 'Przesuń suwak, aby zasymulować wzrost zanieczyszczenia światłem od poziomu 1 (pustynia) do poziomu 9 (centrum miasta).' },
+  { name: '2. Obserwuj efekty wizualne', text: 'Zwróć uwagę, jak na każdym poziomie znikają słabsze gwiazdy, Droga Mleczna blednie, a niebo przybiera pomarańczowy lub szary odcień.' },
+  { name: '3. Określ swój obecny poziom', text: 'Porównaj to, co widzisz ze swojego zwykłego miejsca obserwacji, z symulacjami, aby zidentyfikować lokalny poziom skali Bortle’a.' },
+];
+
+const bibliography: BortleVisualizerLocaleContent['bibliography'] = [
+  { name: 'Oryginalny artykuł Bortle’a (Sky & Telescope, 2001)', url: 'https://skyandtelescope.org/astronomy-resources/light-pollution-and-astronomy-the-bortle-dark-sky-scale/' },
+  { name: 'Light Pollution Map - Mapa świata', url: 'https://www.lightpollutionmap.info/' },
+  { name: 'International Dark-Sky Association', url: 'https://www.darksky.org/' },
+  { name: 'Globe at Night - Nauka obywatelska', url: 'https://www.globeatnight.org/' },
+];
+
+const seo: BortleVisualizerLocaleContent['seo'] = [
+  {
+    type: 'summary',
+    title: 'Kluczowe punkty skali Bortle’a',
+    items: [
+      'Bortle 1-2: Referencyjne ciemne niebo, Droga Mleczna rzuca cienie, NELM > 7.5.',
+      'Bortle 3-4: Optymalne niebo wiejskie, Droga Mleczna widoczna szczegółowo, ale horyzont rozjaśniony.',
+      'Bortle 5-6: Niebo podmiejskie, słaba lub niewidoczna Droga Mleczna, dobre do obserwacji planet i Księżyca.',
+      'Bortle 7-9: Niebo miejskie, gołym okiem widoczne tylko najjaśniejsze obiekty.',
+    ],
+  },
+  { type: 'title', text: 'Skala Bortle’a: Pomiar ciemności nieba', level: 2 },
+  {
+    type: 'paragraph',
+    html: '<strong>Skala Bortle’a</strong> to międzynarodowy system standardowy używany przez astronomów amatorów na całym świecie do określania jakości nocnego nieba. Została stworzona przez Johna E. Bortle’a, doświadczonego obserwatora komet i głębokiego nieba z Nowego Jorku, i opublikowana w 2001 roku w magazynie Sky & Telescope. Celem było zapewnienie obiektywnej i powtarzalnej skali do opisywania warunków obserwacyjnych.',
+  },
+  {
+    type: 'paragraph',
+    html: 'Skala obejmuje zakres od <strong>poziomu 1</strong> (najciemniejsze możliwe niebo, spotykane tylko na odległych pustyniach i w wysokich górach z dala od cywilizacji) do <strong>poziomu 9</strong> (centra dużych miast, gdzie niebo świeci stałym pomarańczowym lub białym blaskiem, a widoczne są jedynie Księżyc i najjaśniejsze planety). Każdy poziom posiada specyficzne cechy, które pozwalają na identyfikację bez użycia instrumentów.',
+  },
+  { type: 'title', text: 'Zanieczyszczenie światłem: Cichy globalny kryzys', level: 2 },
+  {
+    type: 'paragraph',
+    html: 'Wzrost zanieczyszczenia światłem to jeden z najrzadziej omawianych, a jednocześnie najbardziej powszechnych problemów środowiskowych. Według ostatnich badań ponad <strong>80% ludności świata</strong> żyje pod niebem zanieczyszczonym światłem, a w Europie i Ameryce Północnej odsetek ten przekracza 99%. Konsekwencje wykraczają poza astronomię: sztuczne światło w nocy zakłóca rytmy okołodobowe ludzi i zwierząt, dezorientuje ptaki wędrowne, wpływa na rozmnażanie żółwi morskich i hamuje produkcję melatoniny u ssaków.',
+  },
+  {
+    type: 'table',
+    headers: ['Klasa Bortle’a', 'NELM', 'SQM (mag/arcsec²)', 'Droga Mleczna', 'Kluczowa cecha'],
+    rows: [
+      ['1 - Doskonała', '8.0', '21.99 - 22.0', 'Rzuca cienie', 'M33 widoczna gołym okiem'],
+      ['2 - Typowa ciemna', '7.5', '21.89 - 21.99', 'Bardzo wyraźna', 'Chmury = czarne dziury'],
+      ['3 - Wiejska', '7.0', '21.69 - 21.89', 'Złożona', 'Lekka łuna na horyzoncie'],
+      ['4 - Wiejska/Podm.', '6.5', '20.49 - 21.69', 'Widoczna', 'Kopuły światła na horyzoncie'],
+      ['5 - Podmiejska', '6.0', '19.50 - 20.49', 'Słaba', 'Szarawe niebo'],
+      ['6 - Jasna podm.', '5.5', '18.94 - 19.50', 'Niewidoczna', 'M31 ledwo widoczna'],
+      ['7 - Podm./Miejska', '5.0', '18.38 - 18.94', 'Brak', 'Jasnoszare niebo'],
+      ['8 - Miejska', '4.5', '< 18.38', 'Brak', 'Tylko główne gwiazdozbiory'],
+      ['9 - Centrum miasta', '4.0', '< 18.00', 'Brak', 'Tylko Księżyc i planety'],
+    ],
+  },
+  {
+    type: 'tip',
+    title: 'Obiektywny pomiar: Sky Quality Meter',
+    html: 'Dla precyzyjnych i powtarzalnych pomiarów astronomowie używają <strong>Sky Quality Meter (SQM)</strong>, urządzenia mierzącego luminancję nieba w magnitudo na sekundę łuku kwadratową (mag/arcsec²). Wartość SQM 22.0 odpowiada doskonale ciemnemu niebu poziomu Bortle 1, podczas gdy wartość 18.0 wskazuje na niebo poziomu Bortle 8-9. Możesz sprawdzić pomiary w czasie rzeczywistym w sieci Globe at Night.',
+  },
+  { type: 'title', text: 'Znajdowanie rezerwatów ciemnego nieba w Twojej okolicy', level: 2 },
+  {
+    type: 'paragraph',
+    html: 'Mimo powszechnego zanieczyszczenia światłem, wciąż istnieją oazy ciemności. Parki narodowe, wyznaczone rezerwaty ciemnego nieba i odległe tereny górskie oferują warunki Bortle 2-4, dostępne w ciągu kilku godzin jazdy od większości dużych miast. IDA (International Dark-Sky Association) prowadzi globalny rejestr certyfikowanych miejsc ciemnego nieba – od małych parków po całe rezerwaty wyspiarskie. Zaplanowanie nocnej wyprawy do ciemniejszego miejsca odmieni Twoje wrażenia astronomiczne bardziej niż jakakolwiek modernizacja sprzętu.',
+  },
+  {
+    type: 'diagnostic',
+    variant: 'success',
+    title: 'Narzędzie do planowania',
+    icon: 'mdi:map-marker-star',
+    badge: 'Porada Pro',
+    html: 'Przed każdą wyprawą obserwacyjną sprawdź mapę zanieczyszczenia światłem na lightpollutionmap.info, aby zidentyfikować strefy Bortle 3 lub ciemniejsze w promieniu 1-2 godzin. Połącz to z prognozami pogody astronomicznej z Clear Outside lub Meteoblue Astro, aby wybrać idealną noc.',
+  },
+];
+
+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: 'pl',
+};
+
+
+export const content: BortleVisualizerLocaleContent = {
+  slug,
+  title,
+  description,
+  ui,
+  seo,
+  faq,
+  faqTitle: 'Często zadawane pytania',
+  bibliography,
+  bibliographyTitle: 'Bibliografia',
+  howTo,
+  bortleData: ui.bortleData,
+  schemas: [faqSchema as any, howToSchema as any, appSchema],
+};

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

@@ -0,0 +1,167 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { BortleVisualizerUI, BortleVisualizerLocaleContent } from '../index';
+
+const slug = 'dark-sky-simulator';
+const title = 'Simulador de Céu Escuro (Escala de Bortle)';
+const description = 'Visualize interativamente os 9 níveis da Escala de Bortle e descubra como a poluição luminosa apaga o céu noturno estrelado.';
+
+const ui: BortleVisualizerUI = {
+  toolTitle: 'Simulador de Céu Escuro',
+  sliderLabel: 'Arraste para ajustar o nível de poluição luminosa',
+  classLabel: 'Classe de Bortle',
+  nelmLabel: 'NELM',
+  sqmLabel: 'SQM',
+  classPrefix: 'CLASSE',
+  bortleData: {
+    1: { title: 'Céu Escuro Excelente', description: 'O paraíso dos astrónomos. A Via Láctea projeta sombras. Luz zodiacal visível e colorida. M33 visível a olho nu.', nelm: 8.0, sqm: '21.99 - 22.0', starsVisible: true, milkyWayVisible: true, cloudsLit: false, skyBrightness: 0.0 },
+    2: { title: 'Verdadeiramente Escuro', description: 'Locais realmente escuros. A Via Láctea é altamente estruturada. Nuvens visíveis apenas como buracos negros no céu.', nelm: 7.5, sqm: '21.89 - 21.99', starsVisible: true, milkyWayVisible: true, cloudsLit: false, skyBrightness: 0.1 },
+    3: { title: 'Céu Rural', description: 'Via Láctea complexa. Alguma poluição luminosa no horizonte. Nuvens iluminadas perto do horizonte, mas escuras no topo.', nelm: 7.0, sqm: '21.69 - 21.89', starsVisible: true, milkyWayVisible: true, cloudsLit: true, skyBrightness: 0.2 },
+    4: { title: 'Rural/Suburbano', description: 'A Via Láctea perde detalhes, mas permanece visível. Cúpulas de luz no horizonte. Nuvens iluminadas por baixo.', nelm: 6.5, sqm: '20.49 - 21.69', starsVisible: true, milkyWayVisible: true, cloudsLit: true, skyBrightness: 0.35 },
+    5: { title: 'Céu Suburbano', description: 'Via Láctea muito ténue ou invisível perto do horizonte. Luz zodiacal raramente visível. O céu parece acinzentado.', nelm: 6.0, sqm: '19.50 - 20.49', starsVisible: true, milkyWayVisible: true, cloudsLit: true, skyBrightness: 0.5 },
+    6: { title: 'Suburbano Brilhante', description: 'Via Láctea invisível. O céu é cinzento claro. Nuvens muito brilhantes. M31 mal visível.', nelm: 5.5, sqm: '18.94 - 19.50', starsVisible: true, milkyWayVisible: false, cloudsLit: true, skyBrightness: 0.65 },
+    7: { title: 'Suburbano/Urbano', description: 'Céu cinzento-esbranquiçado. Fortes fontes de luz em todas as direções. Apenas as estrelas mais brilhantes são visíveis.', nelm: 5.0, sqm: '18.38 - 18.94', starsVisible: true, milkyWayVisible: false, cloudsLit: true, skyBrightness: 0.8 },
+    8: { title: 'Céu Urbano', description: 'O céu é cinzento-esbranquiçado ou cor de laranja. É possível ler manchetes de jornais. Apenas as principais constelações são visíveis.', nelm: 4.5, sqm: '< 18.38', starsVisible: true, milkyWayVisible: false, cloudsLit: true, skyBrightness: 0.9 },
+    9: { title: 'Centro da Cidade', description: 'Céu tão brilhante como no crepúsculo. Lua visível, mas as constelações não. Apenas planetas e a Lua são visíveis.', nelm: 4.0, sqm: '< 18.00', starsVisible: false, milkyWayVisible: false, cloudsLit: true, skyBrightness: 1.0 },
+  },
+};
+
+const faq: BortleVisualizerLocaleContent['faq'] = [
+  {
+    question: 'O que é a Escala de Bortle?',
+    answer: 'É uma escala numérica de 9 pontos que mede o brilho do céu noturno num determinado local. Foi criada pelo astrónomo amador John E. Bortle em 2001 e publicada na Sky & Telescope. O nível 1 representa o céu mais escuro possível (desertos remotos) e o nível 9 o mais poluído por luz (centros urbanos).',
+  },
+  {
+    question: 'Qual é o nível Bortle mínimo para ver a Via Láctea?',
+    answer: 'A Via Láctea começa a ser claramente visível a partir de Bortle 4 (zona rural/suburbana). Nos níveis 1 e 2 é espetacular, com uma estrutura detalhada capaz até de projetar sombras ténues. A partir de Bortle 6, é praticamente invisível a olho nu.',
+  },
+  {
+    question: 'O que significam NELM e SQM?',
+    answer: 'NELM (Naked Eye Limiting Magnitude) é a magnitude da estrela mais ténue visível a olho nu naquelas condições. SQM (Sky Quality Meter) mede o brilho do céu em magnitudes por segundo de arco quadrado, sendo o padrão científico objetivo.',
+  },
+  {
+    question: 'Como posso encontrar céus mais escuros perto de mim?',
+    answer: 'Utilize mapas de poluição luminosa como lightpollutionmap.info para encontrar zonas Bortle 3 ou mais escuras a poucas horas de distância. Parques nacionais, áreas de alta montanha e reservas de céu escuro oferecem as melhores condições.',
+  },
+];
+
+const howTo: BortleVisualizerLocaleContent['howTo'] = [
+  { name: '1. Ajuste o nível de Bortle', text: 'Arraste o cursor para simular como a poluição luminosa aumenta do nível 1 (deserto) para o nível 9 (centro da cidade).' },
+  { name: '2. Observe os efeitos visuais', text: 'Note como as estrelas ténues desaparecem, a Via Láctea desvanece e o céu assume um tom alaranjado ou cinzento a cada nível.' },
+  { name: '3. Identifique o seu nível atual', text: 'Compare o que vê do seu local de observação habitual com as simulações para identificar o seu nível de Bortle local.' },
+];
+
+const bibliography: BortleVisualizerLocaleContent['bibliography'] = [
+  { name: 'Artigo Original de Bortle (Sky & Telescope, 2001)', url: 'https://skyandtelescope.org/astronomy-resources/light-pollution-and-astronomy-the-bortle-dark-sky-scale/' },
+  { name: 'Mapa de Poluição Luminosa - Mapa Mundial', url: 'https://www.lightpollutionmap.info/' },
+  { name: 'International Dark-Sky Association', url: 'https://www.darksky.org/' },
+  { name: 'Globe at Night - Ciência Cidadã', url: 'https://www.globeatnight.org/' },
+];
+
+const seo: BortleVisualizerLocaleContent['seo'] = [
+  {
+    type: 'summary',
+    title: 'Pontos Chave da Escala de Bortle',
+    items: [
+      'Bortle 1-2: Céu escuro de referência, Via Láctea projeta sombras, NELM > 7.5.',
+      'Bortle 3-4: Céu rural ideal, Via Láctea visível em detalhe, mas horizonte contaminado.',
+      'Bortle 5-6: Suburbano, Via Láctea ténue ou invisível, bom para planetas e Lua.',
+      'Bortle 7-9: Céu urbano, apenas objetos brilhantes visíveis a olho nu.',
+    ],
+  },
+  { type: 'title', text: 'A Escala de Bortle: Medindo a Escuridão do Céu', level: 2 },
+  {
+    type: 'paragraph',
+    html: 'A <strong>Escala de Bortle</strong> é o sistema padrão internacional utilizado por astrónomos amadores em todo o mundo para quantificar a qualidade do céu noturno. Criada por John E. Bortle, um veterano observador de cometas e objetos de céu profundo de Nova Iorque, foi publicada em 2001 na revista Sky & Telescope com o objetivo de fornecer uma escala objetiva e reprodutível para comunicar as condições de observação.',
+  },
+  {
+    type: 'paragraph',
+    html: 'A escala varia do <strong>nível 1</strong> (o céu mais escuro possível, encontrado apenas em desertos remotos e montanhas altas longe de qualquer civilização) ao <strong>nível 9</strong> (o interior de grandes cidades, onde o céu brilha com um brilho permanente alaranjado ou esbranquiçado e apenas a Lua e os planetas mais brilhantes são visíveis). Cada nível possui descritores específicos que permitem a identificação sem instrumentação.',
+  },
+  { type: 'title', text: 'Poluição Luminosa: Uma Crise Global Silenciosa', level: 2 },
+  {
+    type: 'paragraph',
+    html: 'O crescimento da poluição luminosa é um dos problemas ambientais menos discutidos, mas mais generalizados. De acordo com estudos recentes, mais de <strong>80% da população mundial</strong> vive sob céus poluídos por luz e, na Europa e na América do Norte, a percentagem ultrapassa os 99%. As consequências vão para além da astronomia: a luz artificial à noite perturba os ritmos circadianos de humanos e animais, desorienta as aves migratórias, afeta a reprodução das tartarugas marinhas e suprime a produção de melatonina nos mamíferos.',
+  },
+  {
+    type: 'table',
+    headers: ['Classe de Bortle', 'NELM', 'SQM (mag/arcsec²)', 'Via Láctea', 'Característica Principal'],
+    rows: [
+      ['1 - Excelente', '8.0', '21.99 - 22.0', 'Projeta sombras', 'M33 visível a olho nu'],
+      ['2 - Escuro Típico', '7.5', '21.89 - 21.99', 'Muito estruturada', 'Nuvens = buracos negros'],
+      ['3 - Rural', '7.0', '21.69 - 21.89', 'Complexa', 'Algum brilho no horizonte'],
+      ['4 - Rural/Suburb.', '6.5', '20.49 - 21.69', 'Visível', 'Cúpulas de luz no horizonte'],
+      ['5 - Suburbano', '6.0', '19.50 - 20.49', 'Ténue', 'Céu acinzentado'],
+      ['6 - Suburb. Brilh.', '5.5', '18.94 - 19.50', 'Invisível', 'M31 mal visível'],
+      ['7 - Sub/Urbano', '5.0', '18.38 - 18.94', 'Ausente', 'Céu cinzento claro'],
+      ['8 - Urbano', '4.5', '< 18.38', 'Ausente', 'Apenas principais constelações'],
+      ['9 - Centro Urbano', '4.0', '< 18.00', 'Ausente', 'Apenas Lua e planetas'],
+    ],
+  },
+  {
+    type: 'tip',
+    title: 'Medição Objetiva: O Sky Quality Meter',
+    html: 'Para medições precisas e reprodutíveis, os astrónomos utilizam o <strong>Sky Quality Meter (SQM)</strong>, um dispositivo que mede a luminância do céu em magnitudes por segundo de arco quadrado (mag/arcsec²). Um SQM de 22.0 corresponde a um excelente céu Bortle 1, enquanto um valor de 18.0 indica um céu Bortle 8-9. Pode verificar medições em tempo real na rede Globe at Night.',
+  },
+  { type: 'title', text: 'Encontrar Santuários de Céu Escuro Perto de Si', level: 2 },
+  {
+    type: 'paragraph',
+    html: 'Apesar da poluição luminosa generalizada, ainda existem santuários de céu escuro. Parques nacionais, reservas de céu escuro designadas e áreas remotas de montanha oferecem condições Bortle 2-4 acessíveis a poucas horas da maioria das grandes cidades. A IDA (International Dark-Sky Association) mantém um registo global de locais certificados de céu escuro, desde pequenos parques a reservas em ilhas inteiras. Planear uma viagem noturna a um local mais escuro transformará a sua experiência astronómica mais do que qualquer atualização de equipamento.',
+  },
+  {
+    type: 'diagnostic',
+    variant: 'success',
+    title: 'Ferramenta de Planeamento',
+    icon: 'mdi:map-marker-star',
+    badge: 'Dica Pro',
+    html: 'Antes de qualquer saída de observação, verifique o mapa de poluição luminosa em lightpollutionmap.info para identificar zonas Bortle 3 ou mais escuras num raio de 1-2 horas. Combine isto com as previsões meteorológicas astronómicas do Clear Outside ou Meteoblue Astro para escolher a noite perfeita.',
+  },
+];
+
+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: 'pt',
+};
+
+
+export const content: BortleVisualizerLocaleContent = {
+  slug,
+  title,
+  description,
+  ui,
+  seo,
+  faq,
+  faqTitle: 'Perguntas Frequentes',
+  bibliography,
+  bibliographyTitle: 'Referências Bibliográficas',
+  howTo,
+  bortleData: ui.bortleData,
+  schemas: [faqSchema as any, howToSchema as any, appSchema],
+};

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

@@ -0,0 +1,167 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { BortleVisualizerUI, BortleVisualizerLocaleContent } from '../index';
+
+const slug = 'dark-sky-simulator';
+const title = 'Симулятор темного неба (Шкала Бортля)';
+const description = 'Интерактивная визуализация 9 уровней шкалы Бортля: узнайте, как световое загрязнение стирает звездное небо.';
+
+const ui: BortleVisualizerUI = {
+  toolTitle: 'Симулятор темного неба',
+  sliderLabel: 'Перетащите для настройки уровня светового загрязнения',
+  classLabel: 'Класс Бортля',
+  nelmLabel: 'NELM',
+  sqmLabel: 'SQM',
+  classPrefix: 'КЛАСС',
+  bortleData: {
+    1: { title: 'Идеально темное небо', description: 'Рай для астронома. Млечный Путь отбрасывает тени. Зодиакальный свет яркий и цветной. Галактика М33 видна невооруженным глазом.', nelm: 8.0, sqm: '21.99 - 22.0', starsVisible: true, milkyWayVisible: true, cloudsLit: false, skyBrightness: 0.0 },
+    2: { title: 'По настоящему темное', description: 'Очень темные места. Млечный Путь имеет сложную структуру. Облака видны только как черные провалы в небе.', nelm: 7.5, sqm: '21.89 - 21.99', starsVisible: true, milkyWayVisible: true, cloudsLit: false, skyBrightness: 0.1 },
+    3: { title: 'Сельское небо', description: 'Сложная структура Млечного Пути. Небольшое свечение на горизонте. Облака подсвечены у горизонта, но темные в зените.', nelm: 7.0, sqm: '21.69 - 21.89', starsVisible: true, milkyWayVisible: true, cloudsLit: true, skyBrightness: 0.2 },
+    4: { title: 'Сельское/Пригородное', description: 'Млечный Путь теряет детализацию, но виден. Купола света на горизонте. Облака подсвечены снизу.', nelm: 6.5, sqm: '20.49 - 21.69', starsVisible: true, milkyWayVisible: true, cloudsLit: true, skyBrightness: 0.35 },
+    5: { title: 'Пригородное небо', description: 'Млечный Путь очень тусклый или невидим у горизонта. Зодиакальный свет виден редко. Небо кажется сероватым.', nelm: 6.0, sqm: '19.50 - 20.49', starsVisible: true, milkyWayVisible: true, cloudsLit: true, skyBrightness: 0.5 },
+    6: { title: 'Яркое пригородное', description: 'Млечный Путь не виден. Небо светло-серое. Облака очень яркие. Галактика М31 едва различима.', nelm: 5.5, sqm: '18.94 - 19.50', starsVisible: true, milkyWayVisible: false, cloudsLit: true, skyBrightness: 0.65 },
+    7: { title: 'Пригородное/Городское', description: 'Небо серовато-белое. Сильные источники света со всех сторон. Видны только самые яркие звезды.', nelm: 5.0, sqm: '18.38 - 18.94', starsVisible: true, milkyWayVisible: false, cloudsLit: true, skyBrightness: 0.8 },
+    8: { title: 'Городское небо', description: 'Небо серовато-белое или оранжевое. Можно читать заголовки газет. Видны только основные созвездия.', nelm: 4.5, sqm: '< 18.38', starsVisible: true, milkyWayVisible: false, cloudsLit: true, skyBrightness: 0.9 },
+    9: { title: 'Центр города', description: 'Небо яркое, как в сумерках. Луна видна, но созвездия — нет. Видны только планеты и Луна.', nelm: 4.0, sqm: '< 18.00', starsVisible: false, milkyWayVisible: false, cloudsLit: true, skyBrightness: 1.0 },
+  },
+};
+
+const faq: BortleVisualizerLocaleContent['faq'] = [
+  {
+    question: 'Что такое шкала Бортля?',
+    answer: 'Это 9-балльная числовая шкала, измеряющая яркость ночного неба в конкретном месте. Она была создана астрономом-любителем Джоном Бортлем в 2001 году и опубликована в журнале Sky & Telescope. Уровень 1 соответствует самому темному небу (пустыни), а уровень 9 — самому засвеченному (центры городов).',
+  },
+  {
+    question: 'При каком уровне Бортля виден Млечный Путь?',
+    answer: 'Млечный Путь начинает отчетливо проявляться с уровня Бортля 4 (сельская/пригородная зона). На уровнях 1 и 2 он выглядит впечатляюще, с детальной структурой, способной отбрасывать слабые тени. Начиная с 6 уровня, он практически невидим невооруженным глазом.',
+  },
+  {
+    question: 'Что означают аббревиатуры NELM и SQM?',
+    answer: 'NELM (Naked Eye Limiting Magnitude) — это звездная величина самой тусклой звезды, видимой невооруженным глазом. SQM (Sky Quality Meter) — показатель яркости неба в звездных величинах на квадратную угловую секунду, являющийся объективным научным стандартом.',
+  },
+  {
+    question: 'Как найти темное небо рядом со мной?',
+    answer: 'Используйте карты светового загрязнения, такие как lightpollutionmap.info, чтобы найти зоны с уровнем Бортля 3 или ниже. Лучшие условия обычно в национальных парках, высокогорных районах и заповедниках темного неба.',
+  },
+];
+
+const howTo: BortleVisualizerLocaleContent['howTo'] = [
+  { name: '1. Настройте уровень Бортля', text: 'Передвигайте ползунок, чтобы увидеть, как растет световое загрязнение от уровня 1 (пустыня) до уровня 9 (центр города).' },
+  { name: '2. Наблюдайте визуальные эффекты', text: 'Обратите внимание, как исчезают тусклые звезды, меркнет Млечный Путь, а небо приобретает оранжевый или серый оттенок.' },
+  { name: '3. Определите свой уровень', text: 'Сравните вид неба в вашем обычном месте наблюдений с симуляцией, чтобы узнать ваш локальный уровень по шкале Бортля.' },
+];
+
+const bibliography: BortleVisualizerLocaleContent['bibliography'] = [
+  { name: 'Оригинальная статья Джона Бортля (Sky & Telescope, 2001)', url: 'https://skyandtelescope.org/astronomy-resources/light-pollution-and-astronomy-the-bortle-dark-sky-scale/' },
+  { name: 'Карта светового загрязнения мира', url: 'https://www.lightpollutionmap.info/' },
+  { name: 'Международная ассоциация темного неба (IDA)', url: 'https://www.darksky.org/' },
+  { name: 'Проект Globe at Night - гражданская наука', url: 'https://www.globeatnight.org/' },
+];
+
+const seo: BortleVisualizerLocaleContent['seo'] = [
+  {
+    type: 'summary',
+    title: 'Ключевые особенности шкалы Бортля',
+    items: [
+      'Бортль 1-2: Эталонное темное небо, Млечный Путь отбрасывает тени, NELM > 7.5.',
+      'Бortль 3-4: Оптимальное сельское небо, Млечный Путь виден детально, но горизонт засвечен.',
+      'Бортль 5-6: Пригородное небо, Млечный Путь слабый или невидим, подходит для планет и Луны.',
+      'Бортль 7-9: Городское небо, невооруженным глазом видны только ярчайшие объекты.',
+    ],
+  },
+  { type: 'title', text: 'Шкала Бортля: Как измерить темноту неба', level: 2 },
+  {
+    type: 'paragraph',
+    html: '<strong>Шкала Бортля</strong> — это международный стандарт, используемый астрономами-любителями по всему миру для количественной оценки качества ночного неба. Созданная Джоном Бортлем, опытным наблюдателем комет из Нью-Йорка, она была опубликована в 2001 году в журнале Sky & Telescope с целью предоставить объективный и воспроизводимый инструмент для обмена данными об условиях видимости.',
+  },
+  {
+    type: 'paragraph',
+    html: 'Шкала варьируется от <strong>уровня 1</strong> (максимально темное небо, встречающееся только в удаленных пустынях и высокогорьях вдали от цивилизации) до <strong>уровня 9</strong> (центры мегаполисов, где небо сияет постоянным оранжевым светом и видны только Луна и планеты). Каждый уровень имеет четкие дескрипторы, позволяющие проводить оценку без специальных приборов.',
+  },
+  { type: 'title', text: 'Световое загрязнение: Тихий глобальный кризис', level: 2 },
+  {
+    type: 'paragraph',
+    html: 'Рост светового загрязнения — одна из наименее обсуждаемых, но крайне масштабных экологических проблем. Согласно исследованиям, более <strong>80% населения планеты</strong> живет под засвеченным небом. Последствия выходят за рамки астрономии: искусственный свет нарушает циркадные ритмы людей, дезориентирует перелетных птиц и влияет на размножение многих видов животных. Уменьшение естественной темноты подавляет выработку мелатонина у млекопитающих.',
+  },
+  {
+    type: 'table',
+    headers: ['Класс Бортля', 'NELM', 'SQM (вел/кв. сек)', 'Млечный Путь', 'Ключевой признак'],
+    rows: [
+      ['1 - Идеальный', '8.0', '21.99 - 22.0', 'Отбрасывает тени', 'М33 видна глазом'],
+      ['2 - Темный', '7.5', '21.89 - 21.99', 'Очень структурный', 'Облака — черные дыры'],
+      ['3 - Сельский', '7.0', '21.69 - 21.89', 'Сложный', 'Слабое свечение горизонта'],
+      ['4 - Сельск/Приг', '6.5', '20.49 - 21.69', 'Заметен', 'Купола света у горизонта'],
+      ['5 - Пригородный', '6.0', '19.50 - 20.49', 'Тусклый', 'Сероватое небо'],
+      ['6 - Яркий приг', '5.5', '18.94 - 19.50', 'Не виден', 'М31 едва заметна'],
+      ['7 - Городской', '5.0', '18.38 - 18.94', 'Отсутствует', 'Светло-серое небо'],
+      ['8 - Сильный гор', '4.5', '< 18.38', 'Отсутствует', 'Только главные созвездия'],
+      ['9 - Центр города', '4.0', '< 18.00', 'Отсутствует', 'Только Луна и планеты'],
+    ],
+  },
+  {
+    type: 'tip',
+    title: 'Объективное измерение: Sky Quality Meter',
+    html: 'Для точных измерений астрономы используют <strong>Sky Quality Meter (SQM)</strong> — прибор, измеряющий яркость неба в звездных величинах на квадратную угловую секунду (mag/arcsec²). Значение 22.0 соответствует идеальному небу Бортля 1, а 18.0 указывает на условия Бортля 8-9. Вы можете найти данные измерений в реальном времени в сети Globe at Night.',
+  },
+  { type: 'title', text: 'Где найти заповедники темного неба', level: 2 },
+  {
+    type: 'paragraph',
+    html: 'Несмотря на повсеместную засветку, оазисы темноты еще существуют. Национальные парки и удаленные горные районы предлагают условия уровней Бортля 2-4. IDA (Международная ассоциация темного неба) ведет реестр сертифицированных мест с темным небом. Планирование поездки в такое место изменит ваш астрономический опыт сильнее, чем покупка нового дорогого оборудования.',
+  },
+  {
+    type: 'diagnostic',
+    variant: 'success',
+    title: 'Инструмент планирования',
+    icon: 'mdi:map-marker-star',
+    badge: 'Совет профи',
+    html: 'Перед поездкой проверьте карту на lightpollutionmap.info, чтобы найти зоны Бортля 3 или ниже. Совместите это с астропрогнозом погоды (например, Clear Outside), чтобы выбрать идеальную ночь для наблюдений.',
+  },
+];
+
+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: 'ru',
+};
+
+
+export const content: BortleVisualizerLocaleContent = {
+  slug,
+  title,
+  description,
+  ui,
+  seo,
+  faq,
+  faqTitle: 'Часто задаваемые вопросы',
+  bibliography,
+  bibliographyTitle: 'Библиография',
+  howTo,
+  bortleData: ui.bortleData,
+  schemas: [faqSchema as any, howToSchema as any, appSchema],
+};