@jjlmoya/utils-astronomy 1.18.0 → 1.20.0

package/src/tests/script_density.test.ts

@@ -0,0 +1,94 @@
+import { describe, expect, it } from 'vitest';
+import { ALL_TOOLS } from '../tools';
+
+type ScriptLocale = keyof typeof SCRIPT_RULES;
+
+const SCRIPT_RULES = {
+  ja: {
+    language: 'Japanese',
+    scriptName: 'kana/kanji',
+    scriptCharacters: /[\p{Script=Hiragana}\p{Script=Katakana}\p{Script=Han}]/gu,
+    minScriptRatio: 0.45,
+  },
+  ko: {
+    language: 'Korean',
+    scriptName: 'hangul',
+    scriptCharacters: /\p{Script=Hangul}/gu,
+    minScriptRatio: 0.55,
+  },
+  ru: {
+    language: 'Russian',
+    scriptName: 'cyrillic',
+    scriptCharacters: /\p{Script=Cyrillic}/gu,
+    minScriptRatio: 0.65,
+  },
+  zh: {
+    language: 'Chinese',
+    scriptName: 'han',
+    scriptCharacters: /\p{Script=Han}/gu,
+    minScriptRatio: 0.45,
+  },
+} as const;
+
+const LETTERS = /\p{L}/gu;
+const TRANSLATABLE_KEYS = ['title', 'description', 'ui', 'seo', 'faq', 'howTo'] as const;
+
+function collectStrings(value: unknown): string[] {
+  if (typeof value === 'string') return [value];
+  if (!value || typeof value !== 'object') return [];
+  if (Array.isArray(value)) return value.flatMap(collectStrings);
+  return Object.values(value).flatMap(collectStrings);
+}
+
+function normalizeText(value: unknown): string {
+  return collectStrings(value).join(' ').normalize('NFC');
+}
+
+function translatableContent(content: Record<string, unknown>) {
+  return TRANSLATABLE_KEYS.map((key) => content[key]);
+}
+
+function letterCount(text: string): number {
+  return text.match(LETTERS)?.length ?? 0;
+}
+
+function scriptCount(text: string, locale: ScriptLocale): number {
+  return text.match(SCRIPT_RULES[locale].scriptCharacters)?.length ?? 0;
+}
+
+function scriptRatio(text: string, locale: ScriptLocale): number {
+  const letters = letterCount(text);
+  if (letters === 0) return 0;
+  return scriptCount(text, locale) / letters;
+}
+
+describe('Native script density validation', () => {
+  ALL_TOOLS.forEach((tool) => {
+    describe(`Tool: ${tool.entry.id}`, () => {
+      Object.keys(SCRIPT_RULES).forEach((locale) => {
+        it(`${locale} keeps most translated text in its native script`, async () => {
+          const typedLocale = locale as ScriptLocale;
+          const loader = tool.entry.i18n[typedLocale];
+          if (!loader) return;
+
+          const content = await loader();
+          const rule = SCRIPT_RULES[typedLocale];
+          const text = normalizeText(translatableContent(content as Record<string, unknown>));
+          const letters = letterCount(text);
+          const matches = scriptCount(text, typedLocale);
+          const ratio = scriptRatio(text, typedLocale);
+
+          expect(
+            ratio,
+            [
+              `Possible broken translation detected in ${tool.entry.id}/${typedLocale} (${rule.language}).`,
+              `The text has ${matches} ${rule.scriptName} characters out of ${letters} analyzed letters (${(ratio * 100).toFixed(1)}%).`,
+              `Most translatable content should be written in ${rule.scriptName} script.`,
+              'Non-translatable fields such as slug, bibliography, and schemas are ignored to avoid false positives.',
+            ].join(' '),
+          ).toBeGreaterThanOrEqual(rule.minScriptRatio);
+        });
+      });
+    });
+  });
+});

package/src/tests/seo_parity.test.ts

@@ -0,0 +1,60 @@
+import { describe, it, expect } from 'vitest';
+import { ALL_ENTRIES } from '../entries';
+import type { KnownLocale } from '../types';
+
+interface ExpectedCounts {
+  seo: number;
+  faq: number;
+  howTo: number;
+}
+
+function countItems(arr: unknown[] | undefined): number {
+  return arr?.length ?? 0;
+}
+
+async function verifyLocaleParity(
+  entry: typeof ALL_ENTRIES[number],
+  loc: KnownLocale,
+  expected: ExpectedCounts,
+): Promise<void> {
+  const locContent = await entry.i18n[loc]?.();
+  expect(locContent, `Locale ${loc} missing content`).toBeDefined();
+
+  const locSeoCount = countItems(locContent?.seo);
+  const locFaqCount = countItems(locContent?.faq);
+  const locHowToCount = countItems(locContent?.howTo);
+
+  expect(
+    locSeoCount,
+    `Locale ${loc} SEO sections count (${locSeoCount}) must match EN (${expected.seo})`,
+  ).toBe(expected.seo);
+  expect(
+    locFaqCount,
+    `Locale ${loc} FAQ items count (${locFaqCount}) must match EN (${expected.faq})`,
+  ).toBe(expected.faq);
+  expect(
+    locHowToCount,
+    `Locale ${loc} HowTo steps count (${locHowToCount}) must match EN (${expected.howTo})`,
+  ).toBe(expected.howTo);
+}
+
+describe('SEO & i18n Structural Parity Suite', () => {
+  ALL_ENTRIES.forEach((entry) => {
+    describe(`Tool: ${entry.id}`, () => {
+      it('all 15 locales should have identical SEO section counts and types as English', async () => {
+        const enContent = await entry.i18n.en?.();
+        expect(enContent).toBeDefined();
+        const expected: ExpectedCounts = {
+          seo: countItems(enContent?.seo),
+          faq: countItems(enContent?.faq),
+          howTo: countItems(enContent?.howTo),
+        };
+
+        const locales = Object.keys(entry.i18n) as KnownLocale[];
+        for (const loc of locales) {
+          await verifyLocaleParity(entry, loc, expected);
+        }
+      });
+    });
+  });
+});

package/src/tests/shared-test-helpers.ts

@@ -0,0 +1,56 @@
+import type { ToolDefinition } from '../types';
+
+export interface ToolExportValidationResult {
+  passed: boolean;
+  failures: string[];
+}
+
+function validateComponentType(
+  toolId: string,
+  componentName: string,
+  component: unknown,
+  failures: string[],
+): void {
+  if (typeof component !== 'function') {
+    failures.push(`${toolId}: ${componentName} is not a function (${typeof component})`);
+  }
+}
+
+async function validateComponentExecution(
+  toolId: string,
+  componentName: string,
+  fn: () => Promise<unknown>,
+  failures: string[],
+): Promise<void> {
+  try {
+    const result = await fn();
+    if (!result || typeof result !== 'object') {
+      failures.push(`${toolId}: ${componentName} import returned invalid result`);
+    }
+  } catch (error) {
+    failures.push(`${toolId}: ${componentName} execution error - ${error instanceof Error ? error.message : 'unknown'}`);
+  }
+}
+
+export async function validateToolExports(tools: ToolDefinition[]): Promise<ToolExportValidationResult> {
+  const failures: string[] = [];
+
+  for (const tool of tools) {
+    validateComponentType(tool.entry.id, 'Component', tool.Component, failures);
+    validateComponentType(tool.entry.id, 'SEOComponent', tool.SEOComponent, failures);
+    validateComponentType(tool.entry.id, 'BibliographyComponent', tool.BibliographyComponent, failures);
+
+    const componentFn = tool.Component as () => Promise<unknown>;
+    const seoFn = tool.SEOComponent as () => Promise<unknown>;
+    const bibFn = tool.BibliographyComponent as () => Promise<unknown>;
+
+    await validateComponentExecution(tool.entry.id, 'Component', componentFn, failures);
+    await validateComponentExecution(tool.entry.id, 'SEOComponent', seoFn, failures);
+    await validateComponentExecution(tool.entry.id, 'BibliographyComponent', bibFn, failures);
+  }
+
+  return {
+    passed: failures.length === 0,
+    failures,
+  };
+}

package/src/tests/tool_exports.test.ts

@@ -0,0 +1,34 @@
+import { describe, it, expect } from 'vitest';
+import { ALL_TOOLS } from '../tools';
+import { validateToolExports } from './shared-test-helpers';
+
+describe('Tool Exports Pattern Validation', () => {
+  describe('Component Exports Format', () => {
+    ALL_TOOLS.forEach((tool) => {
+      it(`${tool.entry.id}: Component should be a lazy-loaded function`, () => {
+        expect(typeof tool.Component).toBe('function');
+        expect(tool.Component).toBeInstanceOf(Function);
+      });
+
+      it(`${tool.entry.id}: SEOComponent should be a lazy-loaded function`, () => {
+        expect(typeof tool.SEOComponent).toBe('function');
+        expect(tool.SEOComponent).toBeInstanceOf(Function);
+      });
+
+      it(`${tool.entry.id}: BibliographyComponent should be a lazy-loaded function`, () => {
+        expect(typeof tool.BibliographyComponent).toBe('function');
+        expect(tool.BibliographyComponent).toBeInstanceOf(Function);
+      });
+    });
+  });
+
+  describe('Dynamic Import Validation', () => {
+    it('all tools must have functional dynamic imports', async () => {
+      const result = await validateToolExports(ALL_TOOLS);
+      if (!result.passed) {
+        throw new Error(`Tool export validation failed:\n${result.failures.join('\n')}`);
+      }
+      expect(result.passed).toBe(true);
+    });
+  });
+});

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

@@ -74,11 +74,7 @@ const seo: BortleVisualizerLocaleContent['seo'] = [
   { 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.',
+    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. Las consecuencias van más allá de la astronomía: la luz artificial nocturna altera los ritmos circadianos y la biodiversidad.',
   },
   {
     type: 'table',

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

@@ -3,13 +3,13 @@ import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dt
 import type { BortleVisualizerUI, BortleVisualizerLocaleContent } from '../index';
 
 const slug = 'symulator-ciemnego-nieba';
-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 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',
+  classLabel: 'Klasa Bortle\'a',
   nelmLabel: 'NELM',
   sqmLabel: 'SQM',
   classPrefix: 'KLASA',
@@ -28,11 +28,11 @@ const ui: BortleVisualizerUI = {
 
 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: '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ą?',
+    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.',
   },
   {
@@ -46,15 +46,15 @@ const faq: BortleVisualizerLocaleContent['faq'] = [
 ];
 
 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: '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.' },
+  { 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 seo: BortleVisualizerLocaleContent['seo'] = [
   {
     type: 'summary',
-    title: 'Kluczowe punkty skali Bortle’a',
+    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.',
@@ -62,10 +62,10 @@ const seo: BortleVisualizerLocaleContent['seo'] = [
       '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: '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.',
+    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',
@@ -78,7 +78,7 @@ const seo: BortleVisualizerLocaleContent['seo'] = [
   },
   {
     type: 'table',
-    headers: ['Klasa Bortle’a', 'NELM', 'SQM (mag/arcsec²)', 'Droga Mleczna', 'Kluczowa cecha'],
+    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'],
@@ -99,7 +99,7 @@ const seo: BortleVisualizerLocaleContent['seo'] = [
   { 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.',
+    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',

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

@@ -22,14 +22,14 @@ const ui: BortleVisualizerUI = {
     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 },
+    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 — самому засвеченному (центры городов).',
+    answer: 'Это 9-балльная числовая шкала, измеряющая яркость ночного неба в конкретном месте. Она была создана астрономом-любителем Джоном Бортлем в 2001 году и опубликована в журнале Sky & Telescope. Уровень 1 соответствует самому темному небу (пустыни), а уровень 9 - самому засвеченному (центры городов).',
   },
   {
     question: 'При каком уровне Бортля виден Млечный Путь?',
@@ -37,7 +37,7 @@ const faq: BortleVisualizerLocaleContent['faq'] = [
   },
   {
     question: 'Что означают аббревиатуры NELM и SQM?',
-    answer: 'NELM (Naked Eye Limiting Magnitude) — это звездная величина самой тусклой звезды, видимой невооруженным глазом. SQM (Sky Quality Meter) — показатель яркости неба в звездных величинах на квадратную угловую секунду, являющийся объективным научным стандартом.',
+    answer: 'NELM (Naked Eye Limiting Magnitude) - это звездная величина самой тусклой звезды, видимой невооруженным глазом. SQM (Sky Quality Meter) - показатель яркости неба в звездных величинах на квадратную угловую секунду, являющийся объективным научным стандартом.',
   },
   {
     question: 'Как найти темное небо рядом со мной?',
@@ -65,7 +65,7 @@ const seo: BortleVisualizerLocaleContent['seo'] = [
   { type: 'title', text: 'Шкала Бортля: Как измерить темноту неба', level: 2 },
   {
     type: 'paragraph',
-    html: '<strong>Шкала Бортля</strong> — это международный стандарт, используемый астрономами-любителями по всему миру для количественной оценки качества ночного неба. Созданная Джоном Бортлем, опытным наблюдателем комет из Нью-Йорка, она была опубликована в 2001 году в журнале Sky & Telescope с целью предоставить объективный и воспроизводимый инструмент для обмена данными об условиях видимости.',
+    html: '<strong>Шкала Бортля</strong> - это международный стандарт, используемый астрономами-любителями по всему миру для количественной оценки качества ночного неба. Созданная Джоном Бортлем, опытным наблюдателем комет из Нью-Йорка, она была опубликована в 2001 году в журнале Sky & Telescope с целью предоставить объективный и воспроизводимый инструмент для обмена данными об условиях видимости.',
   },
   {
     type: 'paragraph',
@@ -74,14 +74,14 @@ const seo: BortleVisualizerLocaleContent['seo'] = [
   { type: 'title', text: 'Световое загрязнение: Тихий глобальный кризис', level: 2 },
   {
     type: 'paragraph',
-    html: 'Рост светового загрязнения — одна из наименее обсуждаемых, но крайне масштабных экологических проблем. Согласно исследованиям, более <strong>80% населения планеты</strong> живет под засвеченным небом. Последствия выходят за рамки астрономии: искусственный свет нарушает циркадные ритмы людей, дезориентирует перелетных птиц и влияет на размножение многих видов животных. Уменьшение естественной темноты подавляет выработку мелатонина у млекопитающих.',
+    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', 'Очень структурный', 'Облака — черные дыры'],
+      ['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', 'Тусклый', 'Сероватое небо'],
@@ -94,7 +94,7 @@ const seo: BortleVisualizerLocaleContent['seo'] = [
   {
     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.',
+    html: 'Для точных измерений астрономы используют <strong>Sky Quality Meter (SQM)</strong> - прибор, измеряющий яркость неба в звездных величинах на квадратную угловую секунду (mag/arcsec²). Значение 22.0 соответствует идеальному небу Бортля 1, а 18.0 указывает на условия Бортля 8-9. Вы можете найти данные измерений в реальном времени в сети Globe at Night.',
   },
   { type: 'title', text: 'Где найти заповедники темного неба', level: 2 },
   {

package/src/tool/deepSpaceScope/component.astro

@@ -143,6 +143,9 @@ const { ui } = Astro.props;
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   const uiData = (window as any).__deepSpaceUI || {};
   const canvas = document.getElementById("sky-canvas") as HTMLCanvasElement;
+  const getCanvasWidth = () => canvas ? canvas.offsetWidth : 0;
+  const getCanvasHeight = () => canvas ? canvas.offsetHeight : 0;
+  const getContainerWidth = () => container ? container.offsetWidth : 0;
   const ctx = canvas?.getContext("2d");
   const objectsLayer = document.getElementById("objects-layer");
   const apertureInput = document.getElementById("aperture") as HTMLInputElement;
@@ -303,8 +306,8 @@ const { ui } = Astro.props;
 
   function render() {
     if (!ctx || !canvas) return;
-    const w = (canvas.width = canvas.offsetWidth);
-    const h = (canvas.height = canvas.offsetHeight);
+    const w = (canvas.width = getCanvasWidth());
+    const h = (canvas.height = getCanvasHeight());
     ctx.clearRect(0, 0, w, h);
     const sliderVal = parseInt(apertureInput.value);
     const bortle = parseInt(bortleInput.value);
@@ -329,7 +332,7 @@ const { ui } = Astro.props;
     if (!isDragging || !container) return;
     const dx = e.clientX - startX;
     dragDistance += Math.abs(e.movementX);
-    const degreesPerPixel = FOV / container.offsetWidth;
+    const degreesPerPixel = FOV / getContainerWidth();
     let newPan = startPan - dx * degreesPerPixel;
     if (newPan < 0) newPan += 360;
     if (newPan >= 360) newPan -= 360;
@@ -355,7 +358,7 @@ const { ui } = Astro.props;
     if (!isDragging || !container) return;
     const dx = e.touches[0].clientX - startX;
     dragDistance += Math.abs(dx);
-    const degreesPerPixel = FOV / container.offsetWidth;
+    const degreesPerPixel = FOV / getContainerWidth();
     let newPan = startPan - dx * degreesPerPixel;
     if (newPan < 0) newPan += 360;
     if (newPan >= 360) newPan -= 360;

package/src/tool/deepSpaceScope/i18n/de.ts

@@ -76,7 +76,7 @@ const seo: DeepSpaceScopeLocaleContent['seo'] = [
       'Die Öffnung ist der entscheidende Faktor: Ein größerer Durchmesser bedeutet mehr Licht und eine höhere Grenzgröße.',
       'Ein dunkler Himmel (niedriger Bortle-Wert) kann gegenüber einem städtischen Himmel 2-3 Magnituden Gewinn bringen.',
       'Ein 200-mm-Teleskop erreicht bei Bortle 3 Magn. 13-14, bei Bortle 7 jedoch nur Magn. 11.',
-      'Helle Planeten und der Mond erfordern keinen dunklen Himmel – sie sind auch aus der Stadt sichtbar.',
+      'Helle Planeten und der Mond erfordern keinen dunklen Himmel - sie sind auch aus der Stadt sichtbar.',
     ],
   },
   { type: 'title', text: 'Die Physik der astronomischen Beobachtung: Öffnung und Magnitude', level: 2 },

package/src/tool/deepSpaceScope/i18n/ko.ts

@@ -91,7 +91,7 @@ const seo: DeepSpaceScopeLocaleContent['seo'] = [
   { type: 'title', text: '빛 공해가 관측 성능에 미치는 영향', level: 2 },
   {
     type: 'paragraph',
-    html: '세계에서 가장 큰 망원경을 가져와도 도심 한복판에서는 희미한 은하를 볼 수 없습니다. 밤하늘 배경의 밝기가 필요한 대비(콘트라스트)를 „지워버리기“ 때문입니다. <strong>보틀 척도</strong>는 이 효과를 수치화한 것으로, 보틀 지수가 1단계씩 올라갈 때마다 망원경의 관측 한계가 약 0.5등급씩 줄어듭니다.',
+    html: '세계에서 가장 큰 망원경을 가져와도 도심 한복판에서는 희미한 은하를 볼 수 없습니다. 밤하늘 배경의 밝기가 필요한 대비(콘트라스트)를 \"지워버리기\" 때문입니다. <strong>보틀 척도</strong>는 이 효과를 수치화한 것으로, 보틀 지수가 1단계씩 올라갈 때마다 망원경의 관측 한계가 약 0.5등급씩 줄어듭니다.',
   },
   {
     type: 'table',

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

@@ -45,11 +45,11 @@ const ui: DeepSpaceScopeUI = {
 const faq: DeepSpaceScopeLocaleContent['faq'] = [
   {
     question: 'Co to jest magnitudo graniczne teleskopu?',
-    answer: 'To jasność najsłabszego obiektu, jaki teleskop może wykryć w danych warunkach nieba. Zależy od średnicy apertury (większa apertura = więcej zebranego światła) oraz jakości nieba (skala Bortle’a). Ludzkie oko w optymalnych warunkach sięga 6,5 magnitudo; teleskop 200 mm może osiągnąć 13-14 magnitudo.',
+    answer: 'To jasność najsłabszego obiektu, jaki teleskop może wykryć w danych warunkach nieba. Zależy od średnicy apertury (większa apertura = więcej zebranego światła) oraz jakości nieba (skala Bortle\'a). Ludzkie oko w optymalnych warunkach sięga 6,5 magnitudo; teleskop 200 mm może osiągnąć 13-14 magnitudo.',
   },
   {
-    question: 'Jak skala Bortle’a wpływa na to, co widzę?',
-    answer: 'Każdy poziom skali Bortle’a zmniejsza zasięg o około 0,5 magnitudo. Teleskop 200 mm pod niebem klasy 2 może sięgnąć 14,5 magnitudo, ale pod niebem klasy 7 ta sama apertura pozwoli na dostrzeżenie obiektów tylko do 11-12 magnitudo. Ciemne niebo wielokrotnie zwiększa możliwości każdego instrumentu.',
+    question: 'Jak skala Bortle\'a wpływa na to, co widzę?',
+    answer: 'Każdy poziom skali Bortle\'a zmniejsza zasięg o około 0,5 magnitudo. Teleskop 200 mm pod niebem klasy 2 może sięgnąć 14,5 magnitudo, ale pod niebem klasy 7 ta sama apertura pozwoli na dostrzeżenie obiektów tylko do 11-12 magnitudo. Ciemne niebo wielokrotnie zwiększa możliwości każdego instrumentu.',
   },
   {
     question: 'Jakie obiekty są widoczne z miasta?',
@@ -63,7 +63,7 @@ const faq: DeepSpaceScopeLocaleContent['faq'] = [
 
 const howTo: DeepSpaceScopeLocaleContent['howTo'] = [
   { name: '1. Ustaw aperturę', text: 'Przesuń suwak apertury, aby dopasować go do Twojego teleskopu. Zakres obejmuje od 50 mm (lornetka) do 400 mm (zaawansowany teleskop).' },
-  { name: '2. Dostosuj jakość nieba', text: 'Ustaw poziom skali Bortle’a dla Twojego stałego miejsca obserwacji, aby zobaczyć rzeczywiste magnitudo graniczne.' },
+  { name: '2. Dostosuj jakość nieba', text: 'Ustaw poziom skali Bortle\'a dla Twojego stałego miejsca obserwacji, aby zobaczyć rzeczywiste magnitudo graniczne.' },
   { name: '3. Eksploruj mapę gwiazd', text: 'Przeciągaj widok, aby przeszukać pełne 360° nieba i odkryć, jakie obiekty są widoczne przez Twój sprzęt.' },
   { name: '4. Klikaj w obiekty', text: 'Dotknij dowolnego obiektu na niebie, aby zobaczyć szczegółowe informacje: typ, jasność i opis.' },
 ];
@@ -74,9 +74,9 @@ const seo: DeepSpaceScopeLocaleContent['seo'] = [
     title: 'Kluczowe punkty dotyczące zasięgu teleskopu',
     items: [
       'Apertura jest decydującym czynnikiem: większa średnica to więcej światła i wyższe magnitudo graniczne.',
-      'Ciemne niebo (niski poziom Bortle’a) pozwala zyskać 2-3 magnitudo w porównaniu z niebem miejskim.',
+      'Ciemne niebo (niski poziom Bortle\'a) pozwala zyskać 2-3 magnitudo w porównaniu z niebem miejskim.',
       'Teleskop 200 mm sięga 13-14 mag przy klasie Bortle 3, a tylko 11 mag przy klasie 7.',
-      'Jasne planety i Księżyc nie wymagają ciemnego nieba – są widoczne także z miasta.',
+      'Jasne planety i Księżyc nie wymagają ciemnego nieba - są widoczne także z miasta.',
     ],
   },
   { type: 'title', text: 'Fizyka obserwacji astronomicznych: apertura i magnitudo', level: 2 },
@@ -91,7 +91,7 @@ const seo: DeepSpaceScopeLocaleContent['seo'] = [
   { type: 'title', text: 'Wpływ zanieczyszczenia światłem na zasięg', level: 2 },
   {
     type: 'paragraph',
-    html: 'Nawet przy użyciu największego teleskopu świata nie dostrzeżesz słabych galaktyk z centrum miasta. Jasność tła nieba „wymazuje” niezbędny kontrast. <strong>Skala Bortle’a</strong> określa ten efekt ilościowo: każdy dodatkowy poziom klasy Bortle odejmuje około 0,5 magnitudo od zasięgu teleskopu.',
+    html: 'Nawet przy użyciu największego teleskopu świata nie dostrzeżesz słabych galaktyk z centrum miasta. Jasność tła nieba \"wymazuje\" niezbędny kontrast. <strong>Skala Bortle\'a</strong> określa ten efekt ilościowo: każdy dodatkowy poziom klasy Bortle odejmuje około 0,5 magnitudo od zasięgu teleskopu.',
   },
   {
     type: 'table',

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

@@ -45,7 +45,7 @@ const ui: DeepSpaceScopeUI = {
 const faq: DeepSpaceScopeLocaleContent['faq'] = [
   {
     question: 'Что такое предельная звездная величина телескопа?',
-    answer: 'Это яркость самого тусклого объекта, который телескоп может обнаружить при данных условиях неба. Она зависит от диаметра апертуры (чем больше апертура — тем больше света собрано) и качества неба (шкала Бортля). Человеческий глаз в идеальных условиях видит до 6.5 вел.; 200-мм телескоп может достичь 13-14 вел.',
+    answer: 'Это яркость самого тусклого объекта, который телескоп может обнаружить при данных условиях неба. Она зависит от диаметра апертуры (чем больше апертура - тем больше света собрано) и качества неба (шкала Бортля). Человеческий глаз в идеальных условиях видит до 6.5 вел.; 200-мм телескоп может достичь 13-14 вел.',
   },
   {
     question: 'Как шкала Бортля влияет на то, что я вижу?',
@@ -73,16 +73,16 @@ const seo: DeepSpaceScopeLocaleContent['seo'] = [
     type: 'summary',
     title: 'Ключевые факты оReach телескопа',
     items: [
-      'Апертура — решающий фактор: больше диаметр — больше света и выше предельная величина.',
+      'Апертура - решающий фактор: больше диаметр - больше света и выше предельная величина.',
       'Темное небо (низкий Бортль) дает выигрыш в 2-3 величины по сравнению с городским небом.',
       '200-мм телескоп видит до 13-14 вел. при Бортле 3, и только до 11 вел. при Бортле 7.',
-      'Яркие планеты и Луна не требуют темного неба — они отлично видны из города.',
+      'Яркие планеты и Луна не требуют темного неба - они отлично видны из города.',
     ],
   },
   { type: 'title', text: 'Физика астронаблюдений: Апертура и звездная величина', level: 2 },
   {
     type: 'paragraph',
-    html: 'Главная задача телескопа — не увеличивать изображение, а <strong>собирать свет</strong>. Человеческий зрачок расширяется максимум до 6-7 мм в полной темноте. Телескоп 200 мм имеет собирающую поверхность 31 416 мм², что более чем в <strong>800 раз больше</strong> зрачка, позволяя видеть объекты в сотни раз слабее.',
+    html: 'Главная задача телескопа - не увеличивать изображение, а <strong>собирать свет</strong>. Человеческий зрачок расширяется максимум до 6-7 мм в полной темноте. Телескоп 200 мм имеет собирающую поверхность 31 416 мм², что более чем в <strong>800 раз больше</strong> зрачка, позволяя видеть объекты в сотни раз слабее.',
   },
   {
     type: 'paragraph',
@@ -112,7 +112,7 @@ const seo: DeepSpaceScopeLocaleContent['seo'] = [
   { type: 'title', text: 'Интересные объекты по типам и сложности', level: 2 },
   {
     type: 'paragraph',
-    html: 'Для новичков <strong>планеты</strong> — лучшие цели: они не требуют темного неба и показывают детали даже в малые трубы (кольца Сатурна — 40х, полосы Юпитера — 80х, полярные шапки Марса). <strong>Туманности</strong> требуют апертуры и темного неба, но дарят виды невероятной красоты.',
+    html: 'Для новичков <strong>планеты</strong> - лучшие цели: они не требуют темного неба и показывают детали даже в малые трубы (кольца Сатурна - 40х, полосы Юпитера - 80х, полярные шапки Марса). <strong>Туманности</strong> требуют апертуры и темного неба, но дарят виды невероятной красоты.',
   },
   {
     type: 'stats',

package/src/tool/deepSpaceScope/i18n/zh.ts

@@ -76,7 +76,7 @@ const seo: DeepSpaceScopeLocaleContent['seo'] = [
       '口径是决定性因素：直径越大意味着收集的光线越多，极限星等越高。',
       '暗空（低波特尔值）相比城市天空可以获得 2-3 等的深度增益。',
       '200mm 望远镜在波特尔 3 级可达 13-14 等，而在波特尔 7 级仅为 11 等。',
-      '明亮的行星和月亮不需要暗空 —— 在城市中即可观测。',
+      '明亮的行星和月亮不需要暗空 - 在城市中即可观测。',
     ],
   },
   { type: 'title', text: '天文观测物理学：口径与星等', level: 2 },
@@ -91,7 +91,7 @@ const seo: DeepSpaceScopeLocaleContent['seo'] = [
   { type: 'title', text: '光污染对观测深度的影响', level: 2 },
   {
     type: 'paragraph',
-    html: '即使使用世界上最好的望远镜，您也无法在市中心看到暗淡的星系。天空背景的亮度会“抹除”必要的对比度。<strong>波特尔量表</strong>量化了这种影响：每增加一阶波特尔等级，望远镜的观测深度大约会减少 0.5 等。',
+    html: '即使使用世界上最好的望远镜，您也无法在市中心看到暗淡的星系。天空背景的亮度会\"抹除\"必要的对比度。<strong>波特尔量表</strong>量化了这种影响：每增加一阶波特尔等级，望远镜的观测深度大约会减少 0.5 等。',
   },
   {
     type: 'table',