@jjlmoya/utils-astronomy 1.16.0 → 1.18.0

package/src/tool/smartEyepieceCalculator/i18n/sv.ts

@@ -0,0 +1,165 @@
+import { bibliography } from '../bibliography';
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { EyepieceCalculatorLocaleContent } from '../entry';
+
+const title = 'Okularkalkylator & Visuell Simulator';
+const description = 'Beräkna förstoring, verkligt synfält (TFOV) and utgångspupill för valfritt okular med ditt teleskop. Inkluderar en interaktiv visuell simulator.';
+
+const ui = {
+  toolTitle: 'Smart Okularkalkylator',
+  telescopeTitle: 'Ditt Teleskop',
+  apertureLabel: 'Öppning (mm)',
+  focalLabel: 'Brännvidd (mm)',
+  presetsLabel: 'Populära Modeller',
+  presetsPlaceholder: 'Välj ett teleskop...',
+  addEyepieceBtn: '+ Lägg till Okular',
+  eyepiecesTitle: 'Dina Okular',
+  eyepieceFocal: 'Brännvidd (mm)',
+  eyepieceAfov: 'Skenbart Fält (°)',
+  removeEyepiece: 'Ta bort',
+  magLabel: 'Förstoring',
+  tfovLabel: 'Verkligt Fält',
+  pupilLabel: 'Utgångspupill',
+  simulatorTitle: 'Synfälts-simulator',
+  targetLabel: 'Vad vill du se?',
+  targetMoon: 'Månen',
+  targetSaturn: 'Saturnus',
+  targetPleiades: 'Plejader-hopen',
+  targetAndromeda: 'Andromedagalaxen',
+  targetM13: 'M13-hopen',
+  statusDangerHighMag: 'Slöseri med pengar: Du pressar teleskopet bortom dess fysiska gränser.',
+  statusDangerPupil: 'Slöseri med ljus: Utgångspupillen överstiger 7 mm. Ditt öga kan inte bearbeta så mycket ljus.',
+  statusWarningHighMag: 'Varning: För denna förstoring behöver du en exceptionellt stabil himmel (bra seeing).',
+  statusWarningLowMag: 'Låg förstoring: Du ligger under det rekommenderade minimumet. Du kan se skuggan av sekundärspegeln eller tappa kontrast.',
+  statusPerfectDeepSky: 'Perfekt kombination! Idealisk för utsträckta objekt och Deep Sky (stjärnhopar, nebulosor).',
+  statusPerfectPlanetary: 'Perfekt kombination! Idealisk för att se planetdetaljer (Saturnus ringar, Jupiters bälten).',
+  statusPerfectGeneral: 'Utmärkt allround-kombination! Idealisk för allmän observation av alla typer av objekt.',
+  ctaText: 'Baserat på din nuvarande utrustning rekommenderar vi att du använder okular som ger dig mellan {min}x och {max}x förstoring.',
+  compareText: 'Jämför Okular',
+  apertureHelp: 'Diametern på tuben, står oftast på originaletiketten eller kartongen.',
+  focalHelp: 'Teleskopets brännvidd.',
+  afovHelp: 'Okularets skenbara synfält. Plössl är oftast 52°, vidvinkel 68° eller mer.',
+};
+
+const faq: EyepieceCalculatorLocaleContent['faq'] = [
+  {
+    question: 'Hur beräknar man teleskopförstoring?',
+    answer: 'Formeln är enkel: dela teleskopets brännvidd med okularets brännvidd. Till exempel ger ett 1000mm teleskop med ett 10mm okular 100x förstoring.',
+  },
+  {
+    question: 'Vad är utgångspupill och varför är det viktigt?',
+    answer: 'Det är diametern på ljuskäglan som lämnar okularet och når ditt öga. Man räknar ut den genom att dela teleskopets öppning med förstoringen. Om den överstiger 7 mm kan ditt öga inte fånga upp allt ljus, vilket slösar bort teleskopets kraft.',
+  },
+  {
+    question: 'Hur vet jag mitt okulars verkliga synfält?',
+    answer: 'Verkligt synfält (TFOV) beräknas genom att dela okularets skenbara synfält (AFOV) med förstoringen. Detta talar om hur många grader av himlen du faktiskt ser.',
+  },
+];
+
+const howTo: EyepieceCalculatorLocaleContent['howTo'] = [
+  { name: '1. Fyll i teleskopdata', text: 'Skriv in öppning och brännvidd för din tub eller välj en populär modell ur listan.' },
+  { name: '2. Lägg till dina okular', text: 'Skriv in brännvidd och skenbart fält för dina okular för att jämföra deras prestanda.' },
+  { name: '3. Simulera vyn', text: 'Välj ett objekt (Månen, Saturnus etc.) och klicka på dina okular för att se hur bilden ändras och om du är inom de optiska gränserna.' },
+];
+
+const seo: EyepieceCalculatorLocaleContent['seo'] = [
+  {
+    type: 'summary',
+    title: 'Nyckelfaktorer när du väljer okular',
+    items: [
+      'Verklig maxförstoring: 2x öppningen i mm (men begränsad av atmosfären till 200-250x).',
+      'Minsta användbara förstoring: Öppningen delat med 7 (gränsen för den mänskliga pupillen).',
+      'Optimalt område: Mellan 0,5 mm och 7 mm utgångspupill.',
+    ],
+  },
+  { type: 'title', text: 'Att välja okular till ditt teleskop: En Praktisk Guide', level: 2 },
+  {
+    type: 'paragraph',
+    html: 'Köp inte okular på intuition. Nyckeln till bra observationer ligger i balansen mellan teleskopets upplösning och ditt ögas biologiska kapacitet. Ett felvalt okular kan få även världens bästa teleskop att se suddigt eller för mörkt ut.',
+  },
+  { type: 'title', text: '1. Beräkning av förstoring (M)', level: 3 },
+  {
+    type: 'paragraph',
+    html: 'Formeln är enkel: dela teleskopets brännvidd med okularets brännvidd. <br/><strong>Formel:</strong> Teleskopets brännvidd / Okularets brännvidd = Förstoring. <br/>Exempel: Ett 1000mm teleskop med ett 10mm okular ger 100x förstoring.',
+  },
+  { type: 'title', text: '2. Myten om maximal förstoring', level: 3 },
+  {
+    type: 'paragraph',
+    html: 'Den verkliga gränsen sätts inte av okularet, utan av öppningen (diametern) på ditt teleskop. <br/>- <strong>Teoretisk gräns:</strong> 2 × Öppningen i mm. <br/>- <strong>Verklig gräns (Genomsnittlig Seeing):</strong> Du kommer sällan över 200x - 250x på grund av atmosfärisk turbulens, oavsett teleskop. Att pressa mer ger bara en förstorad suddig fläck.',
+  },
+  { type: 'title', text: '3. Utgångspupill: Ljusstyrkefaktorn', level: 3 },
+  {
+    type: 'paragraph',
+    html: 'Utgångspupillen är den ljuscylinder som kommer ur okularet mot ditt öga. <br/>- <strong>Om den är större än 7 mm:</strong> Ditt öga kan inte öppna sig så mycket; du tappar ljus och kastar bokstavligen bort pengar. <br/>- <strong>Om den är mindre än 0,5 mm:</strong> Bilden blir så mörk att du knappt ser detaljer och börjar se "floaters" i ditt eget öga.',
+  },
+  {
+    type: 'table',
+    headers: ['Objekt att observera', 'Rekommenderad förstoring', 'Ideal pupill', 'Visuell upplevelse'],
+    rows: [
+      ['Galaxer och Nebulosor', 'Låg (25x - 50x)', '5 mm - 7 mm', 'Ljus bild, maximalt synfält.'],
+      ['Stjärnhopar', 'Mellan (80x - 120x)', '2 mm', 'Punktformade stjärnor och mörk himmelsbakgrund.'],
+      ['Planeter och Månen', 'Hög (150x eller mer)', '0,7 mm - 1 mm', 'Maximal detaljrikedom, bilden blir mindre och ljussvagare.'],
+    ],
+  },
+  {
+    type: 'diagnostic',
+    variant: 'warning',
+    title: 'Visuell användning eller Astrofotografi?',
+    icon: 'mdi:camera-off',
+    badge: 'Teknisk notering',
+    html: 'Det är avgörande att klargöra att dessa beräkningar exklusivt gäller för <strong>visuell observation</strong>. Många nybörjare försöker applicera dessa förstoringar på astrokameror och blir frustrerade; inom fotografi beror beräkningen på pixelstorlek och upplösning per bågsekund, inte på okularet.',
+  },
+  {
+    type: 'diagnostic',
+    variant: 'info',
+    title: 'Atmosfärisk stabilitet (Seeing)',
+    icon: 'mdi:weather-windy',
+    badge: 'Observationstips',
+    html: 'Även med de bästa okularen är nätter då stjärnorna blinkar intensivt inte lämpliga för hög förstoring. Detta beror på atmosfärisk turbulens (seeing) som sprider ljuset. Vid planetobservation rekommenderas att börja med en låg förstoring och bevaka bildens stabilitet; om bilden ser ut att vara under vatten, minska förstoringen för att se fler detaljer. I de flesta stadsområden är 150x till 200x den praktiska övre gränsen.',
+  },
+];
+
+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: 'sv',
+};
+
+export const content: EyepieceCalculatorLocaleContent = {
+  slug: 'okularkalkylator',
+  title,
+  description,
+  ui,
+  faq,
+  howTo,
+  seo,
+  bibliography,
+  schemas: [faqSchema as any, howToSchema as any, appSchema],
+};

package/src/tool/smartEyepieceCalculator/i18n/tr.ts

@@ -0,0 +1,165 @@
+import { bibliography } from '../bibliography';
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { EyepieceCalculatorLocaleContent } from '../entry';
+
+const title = 'Oküler Hesaplayıcı ve Görsel Simülatör';
+const description = 'Teleskobunuz için herhangi bir okülerle büyütme, gerçek görüş alanı (TFOV) ve çıkış açıklığını hesaplayın. Etkileşimli görsel simülatör içerir.';
+
+const ui = {
+  toolTitle: 'Akıllı Oküler Hesaplayıcı',
+  telescopeTitle: 'Teleskobunuz',
+  apertureLabel: 'Açıklık (mm)',
+  focalLabel: 'Odak Uzaklığı (mm)',
+  presetsLabel: 'Popüler Modeller',
+  presetsPlaceholder: 'Bir teleskop seçin...',
+  addEyepieceBtn: '+ Oküler Ekle',
+  eyepiecesTitle: 'Okülerleriniz',
+  eyepieceFocal: 'Odak G. (mm)',
+  eyepieceAfov: 'Görünür Alan (°)',
+  removeEyepiece: 'Kaldır',
+  magLabel: 'Büyütme',
+  tfovLabel: 'Gerçek Alan',
+  pupilLabel: 'Çıkış Açıklığı',
+  simulatorTitle: 'Görüş Alanı Simülatörü',
+  targetLabel: 'Ne görmek istersiniz?',
+  targetMoon: 'Ay',
+  targetSaturn: 'Satürn',
+  targetPleiades: 'Ülker (Pleiades) Kümesi',
+  targetAndromeda: 'Andromeda Galaksisi',
+  targetM13: 'M13 Kümesi',
+  statusDangerHighMag: 'Boşa harcanan para: Teleskobunuzu fiziksel sınırlarının ötesine zorluyorsunuz.',
+  statusDangerPupil: 'Boşa harcanan ışık: Çıkış açıklığı 7 mm\'yi aşıyor. Gözünüz bu kadar çok ışığı işleyemez.',
+  statusWarningHighMag: 'Dikkat: Bu büyütme için olağanüstü kararlı bir gökyüzüne (iyi seeing) ihtiyacınız olacak.',
+  statusWarningLowMag: 'Düşük büyütme: Önerilen minimumun altındasınız. İkincil ayna gölgesini görebilir veya kontrast kaybedebilirsiniz.',
+  statusPerfectDeepSky: 'Mükemmel kombinasyon! Geniş nesneler ve Derin Uzay (kümeler, nebulalar) için ideal.',
+  statusPerfectPlanetary: 'Mükemmel kombinasyon! Gezegen detaylarını (Satürn halkaları, Jüpiter bantları) görmek için ideal.',
+  statusPerfectGeneral: 'Harika çok yönlü kombinasyon! Her tür nesnenin genel gözlemi için ideal.',
+  ctaText: 'Mevcut ekipmanınıza bağlı olarak, size {min}x ile {max}x arasında büyütme sağlayan okülerler kullanmanızı öneririz.',
+  compareText: 'Okülerleri Karşılaştır',
+  apertureHelp: 'Tüpün çapı, genellikle orijinal çıkartmada veya kutuda yazar.',
+  focalHelp: 'Teleskobun odak uzaklığı.',
+  afovHelp: 'Okülerin görünür görüş alanı. Plössl genellikle 52°, geniş açı 68° veya daha fazladır.',
+};
+
+const faq: EyepieceCalculatorLocaleContent['faq'] = [
+  {
+    question: 'Teleskop büyütmesi nasıl hesaplanır?',
+    answer: 'Formül basittir: Teleskop odak uzaklığını oküler odak uzaklığına bölün. Örneğin, 10mm okülerli 1000mm bir teleskop size 100 kat büyütme (100x) sağlar.',
+  },
+  {
+    question: 'Çıkış açıklığı nedir ve neden önemlidir?',
+    answer: 'Okülerden çıkıp gözünüze giren ışık huzmesinin çapıdır. Teleskop açıklığının büyütmeye bölünmesiyle hesaplanır. 7 mm\'yi aşarsa, gözünüz tüm ışığı yakalayamaz ve teleskobunuzun gücünü boşa harcamış olursunuz.',
+  },
+  {
+    question: 'Okülerimin gerçek görüş alanını nasıl anlarım?',
+    answer: 'Gerçek Görüş Alanı (TFOV), okülerin görünür görüş alanının (AFOV) büyütmeye bölünmesiyle hesaplanır. Bu size gökyüzünün kaç derecesini gerçekten gördüğünüzü söyler.',
+  },
+];
+
+const howTo: EyepieceCalculatorLocaleContent['howTo'] = [
+  { name: '1. Teleskop verilerini girin', text: 'Tüpünüzün açıklığını ve odak uzaklığını yazın veya listeden popüler bir model seçin.' },
+  { name: '2. Okülerlerinizi ekleyin', text: 'Performanslarını karşılaştırmak için okülerlerinizin odak uzaklığını ve görünür alanını girin.' },
+  { name: '3. Görünümü simüle edin', text: 'Bir nesne (Ay, Satürn vb.) seçin ve görüntünün nasıl değiştiğini ve optik sınırlar içinde olup olmadığınızı görmek için okülerlerinize tıklayın.' },
+];
+
+const seo: EyepieceCalculatorLocaleContent['seo'] = [
+  {
+    type: 'summary',
+    title: 'İdeal okülerinizi seçmek için temel faktörler',
+    items: [
+      'Gerçek Maksimum Büyütme: mm cinsinden açıklığın 2 katı (ancak gökyüzü koşulları nedeniyle 200-250 kat ile sınırlıdır).',
+      'Minimum Yararlı Büyütme: Açıklığın 7\'ye bölünmesi (insan göz bebeği sınırı).',
+      'Optimal Aralık: 0,5 mm ile 7 mm çıkış açıklığı arası.',
+    ],
+  },
+  { type: 'title', text: 'Teleskobunuz İçin Oküler Nasıl Seçilir: Pratik Rehber', level: 2 },
+  {
+    type: 'paragraph',
+    html: 'Okülerleri sezgisel olarak satın almayın. İyi bir gözlemin anahtarı, teleskobunuzun çözünürlüğü ile gözünüzün biyolojik kapasitesini dengelemekte yatar. Yanlış seçilmiş bir oküler, dünyanın en iyi teleskobunun bile görüntüsünü bulanık veya çok karanlık yapabilir.',
+  },
+  { type: 'title', text: '1. Büyütme Hesabı (M)', level: 3 },
+  {
+    type: 'paragraph',
+    html: 'Formül basittir: Teleskop odak uzaklığını oküler odak uzaklığına bölün. <br/><strong>Formül:</strong> Teleskop Odak / Oküler Odak = Büyütme. <br/>Örnek: 10mm okülerli 1000mm bir teleskop size 100 kat büyütme (100x) sağlar.',
+  },
+  { type: 'title', text: '2. Maksimum Büyütme Efsanesi', level: 3 },
+  {
+    type: 'paragraph',
+    html: 'Gerçek sınır oküler tarafından değil, tüpünüzün açıklığı (çapı) tarafından belirlenir. <br/>- <strong>Teorik sınır:</strong> mm cinsinden Açıklık × 2. <br/>- <strong>Gerçek sınır (Ortalama Seeing):</strong> Teleskobunuz ne olursa olsun, atmosferik türbülans nedeniyle nadiren 200x - 250x\'i aşarsınız. Daha fazlasını zorlamak sadece büyütülmüş bulanık bir leke verecektir.',
+  },
+  { type: 'title', text: '3. Çıkış Açıklığı: Parlaklık Faktörü', level: 3 },
+  {
+    type: 'paragraph',
+    html: 'Çıkış açıklığı, okülerden gözünüze doğru çıkan ışık silindiridir. <br/>- <strong>7 mm\'den büyükse:</strong> Gözünüz o kadar açılamaz; ışık kaybedersiniz ve kelimenin tam anlamıyla paranızı çöpe atarsınız. <br/>- <strong>0,5 mm\'den küçükse:</strong> Görüntü o kadar karanlık olur ki detayları zar zor görürsünüz ve kendi gözünüzdeki "uçuşan cisimleri" (floaters) görmeye başlarsınız.',
+  },
+  {
+    type: 'table',
+    headers: ['Gözlemlenecek Nesne', 'Önerilen Büyütme', 'İdeal Açıklık', 'Görsel Deneyim'],
+    rows: [
+      ['Galaksiler ve Nebulalar', 'Düşük (25x - 50x)', '5 mm - 7 mm', 'Parlak görüntü, maksimum görüş alanı.'],
+      ['Yıldız Kümeleri', 'Orta (80x - 120x)', '2 mm', 'Noktasal yıldızlar ve koyu gökyüzü arka planı.'],
+      ['Gezegenler ve Ay', 'Yüksek (150x veya daha fazla)', '0,7 mm - 1 mm', 'Maksimum detay, daha küçük ve sönük görüntü.'],
+    ],
+  },
+  {
+    type: 'diagnostic',
+    variant: 'warning',
+    title: 'Görsel Gözlem mi Astrofotografi mi?',
+    icon: 'mdi:camera-off',
+    badge: 'Teknik Not',
+    html: 'Bu hesaplamaların özel olarak <strong>görsel gözlem</strong> için olduğunu netleştirmek hayati önem taşır. Birçok yeni başlayan bu büyütmeleri astro-kameralara uygulamaya çalışır ve hüsrana uğrar; fotoğrafçılıkta hesaplama okülere değil, piksel boyutuna ve yay-saniyesi başına çözünürlüğe bağlıdır.',
+  },
+  {
+    type: 'diagnostic',
+    variant: 'info',
+    title: 'Atmosferik Kararlılığın (Seeing) Etkisi',
+    icon: 'mdi:weather-windy',
+    badge: 'Gözlem İpucu',
+    html: 'En iyi okülerlere sahip olsanız bile, yıldızların şiddetle göz kırptığı geceler yüksek büyütme için uygun değildir. Bunun nedeni, ışığı dağıtan atmosferik türbülanstır (seeing). Gezegenleri gözlemlerken, düşük bir büyütme ile başlamanız ve görüntünün kararlılığını izlemeniz önerilir; eğer görüntü su altındaymış gibi görünüyorsa, daha fazla detay görmek için büyütmeyi azaltın. Çoğu kentsel alanda, 150x veya 200x pratik üst sınırdır.',
+  },
+];
+
+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: 'TRY' },
+  inLanguage: 'tr',
+};
+
+export const content: EyepieceCalculatorLocaleContent = {
+  slug: 'okuler-hesaplayici',
+  title,
+  description,
+  ui,
+  faq,
+  howTo,
+  seo,
+  bibliography,
+  schemas: [faqSchema as any, howToSchema as any, appSchema],
+};

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

@@ -0,0 +1,165 @@
+import { bibliography } from '../bibliography';
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { EyepieceCalculatorLocaleContent } from '../entry';
+
+const title = '目镜计算器与视觉模拟器';
+const description = '为您的望远镜计算任何目镜的放大倍数、实际视野 (TFOV) 和出瞳直径。包含交互式视觉模拟器。';
+
+const ui = {
+  toolTitle: '智能目镜计算器',
+  telescopeTitle: '您的望远镜',
+  apertureLabel: '口径 (mm)',
+  focalLabel: '焦距 (mm)',
+  presetsLabel: '常见型号',
+  presetsPlaceholder: '选择望远镜...',
+  addEyepieceBtn: '+ 添加目镜',
+  eyepiecesTitle: '您的目镜',
+  eyepieceFocal: '焦距 (mm)',
+  eyepieceAfov: '表观视野 (°)',
+  removeEyepiece: '删除',
+  magLabel: '放大倍数',
+  tfovLabel: '实际视野',
+  pupilLabel: '出瞳直径',
+  simulatorTitle: '视野模拟器',
+  targetLabel: '您想看什么？',
+  targetMoon: '月球',
+  targetSaturn: '土星',
+  targetPleiades: '昴星团',
+  targetAndromeda: '仙女座星系',
+  targetM13: 'M13 球状星团',
+  statusDangerHighMag: '浪费钱：您正在强行让望远镜超出其物理极限。',
+  statusDangerPupil: '光线浪费：出瞳直径超过 7mm。您的眼睛无法处理这么多光线。',
+  statusWarningHighMag: '注意：此放大倍数需要极其稳定的天气（良好的视宁度）。',
+  statusWarningLowMag: '放大倍数过低：低于推荐的最小值。您可能会看到副镜的影子或失去对比度。',
+  statusPerfectDeepSky: '完美结合！非常适合观测弥散天体和深空（星团、星云）。',
+  statusPerfectPlanetary: '完美结合！非常适合观测行星细节（土星环、木星条纹）。',
+  statusPerfectGeneral: '出色的全能组合！适合各种天体的常规观测。',
+  ctaText: '根据您目前的设备，我们建议使用放大倍数在 {min}x 到 {max}x 之间的目镜。',
+  compareText: '比较目镜',
+  apertureHelp: '镜筒的直径，通常可以在原厂标签或包装盒上找到。',
+  focalHelp: '望远镜的焦距。',
+  afovHelp: '目镜的表观视野。普罗索 (Plössl) 目镜通常为 52°，广角目镜为 68° 或更高。',
+};
+
+const faq: EyepieceCalculatorLocaleContent['faq'] = [
+  {
+    question: '望远镜的放大倍数是如何计算的？',
+    answer: '公式很简单：将望远镜的焦距除以目镜的焦距。例如，焦距为 1000mm 的望远镜搭配 10mm 的目镜，其放大倍数为 100x。',
+  },
+  {
+    question: '什么是出瞳直径，为什么它很重要？',
+    answer: '它是从目镜射出并进入你眼睛的光束直径。计算方法是将望远镜口径除以放大倍数。如果它超过 7mm，你的眼睛将无法捕获所有光线，从而浪费望远镜的性能。',
+  },
+  {
+    question: '我如何知道目镜的实际视野？',
+    answer: '实际视野 (TFOV) 的计算方法是将目镜的表观视野 (AFOV) 除以放大倍数。这会告诉你在望远镜中实际能看到多少度的天空。',
+  },
+];
+
+const howTo: EyepieceCalculatorLocaleContent['howTo'] = [
+  { name: '1. 输入望远镜数据', text: '输入镜筒的口径和焦距，或从列表中选择一个常见型号。' },
+  { name: '2. 添加您的目镜', text: '输入目镜的焦距和表观视野以比较它们的性能。' },
+  { name: '3. 模拟视野', text: '选择一个天体（月球、土星等）并点击目镜，查看图像如何变化以及是否在光学极限之内。' },
+];
+
+const seo: EyepieceCalculatorLocaleContent['seo'] = [
+  {
+    type: 'summary',
+    title: '选择理想目镜的关键因素',
+    items: [
+      '实际最大放大倍数：口径（毫米）的 2 倍（但受视宁度限制，通常为 200-250x）。',
+      '最小有效放大倍数：口径除以 7（人类瞳孔的极限）。',
+      '最佳范围：出瞳直径在 0.5mm 到 7mm 之间。',
+    ],
+  },
+  { type: 'title', text: '如何为您的望远镜选择目镜：实用指南', level: 2 },
+  {
+    type: 'paragraph',
+    html: '不要凭直觉购买目镜。良好观测的关键在于平衡望远镜的分辨率与人眼的生理极限。选择不当的目镜即使让世界上最好的望远镜也可能看起来模糊或太暗。',
+  },
+  { type: 'title', text: '1. 放大倍数的计算 (M)', level: 3 },
+  {
+    type: 'paragraph',
+    html: '公式很简单：将望远镜焦距除以目镜焦距。 <br/><strong>公式：</strong> 望远镜焦距 / 目镜焦距 = 放大倍数。 <br/>例子：一个 1000mm 焦距的望远镜搭配 10mm 目镜，放大倍数为 100x。',
+  },
+  { type: 'title', text: '2. 最大放大倍数的迷思', level: 3 },
+  {
+    type: 'paragraph',
+    html: '实际极限不是由目镜决定的，而是由望远镜的口径（直径）决定的。 <br/>- <strong>理论极限：</strong> 口径（毫米）的 2 倍。 <br/>- <strong>实际极限（平均视宁度）：</strong> 无论使用何种望远镜，由于大气湍流的影响，放大倍数很少能超过 200x - 250x。强行提高放大倍数只会得到一个放大的模糊光斑。',
+  },
+  { type: 'title', text: '3. 出瞳直径：亮度因素', level: 3 },
+  {
+    type: 'paragraph',
+    html: '出瞳直径是从目镜射向你眼睛的光束。 <br/>- <strong>如果大于 7mm：</strong> 你的眼睛无法张开那么大；你会损失光线，字面上就是在浪费钱。 <br/>- <strong>如果小于 0.5mm：</strong> 图像会变得非常暗，以至于你几乎看不到细节，并会开始看到自己眼中的“浮游物”。',
+  },
+  {
+    type: 'table',
+    headers: ['观测对象', '推荐放大倍数', '理想出瞳', '视觉体验'],
+    rows: [
+      ['星系与星云', '低倍 (25x - 50x)', '5mm - 7mm', '图像明亮，视野最大化。'],
+      ['星团', '中倍 (80x - 120x)', '2mm', '恒星呈点状，背景天空黑暗。'],
+      ['行星与月球', '高倍 (150x 或更高)', '0.7mm - 1mm', '细节最清晰，图像更小且更暗。'],
+    ],
+  },
+  {
+    type: 'diagnostic',
+    variant: 'warning',
+    title: '目视观测还是天体摄影？',
+    icon: 'mdi:camera-off',
+    badge: '技术提示',
+    html: '至关重要的是要明确这些计算仅适用于 <strong>目视观测</strong>。许多初学者试图将这些放大倍数应用于天文相机，结果感到沮丧；在摄影中，计算取决于像素大小和角秒分辨率，而不是目镜。',
+  },
+  {
+    type: 'diagnostic',
+    variant: 'info',
+    title: '大气视宁度的影响',
+    icon: 'mdi:weather-windy',
+    badge: '观测技巧',
+    html: '即使拥有顶级的目镜，如果大气层不稳定（星光闪烁剧烈），高倍观测的效果也会大打折扣。这种现象被称为“视宁度”。在观测行星时，建议先从低倍率开始，观察图像的垂直稳定性。如果图像像是在水底一样晃动，那么降低倍率反而能看到更多细节。在大多数城市环境下，150x 到 200x 是最实用的上限。',
+  },
+];
+
+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: 'CNY' },
+  inLanguage: 'zh',
+};
+
+export const content: EyepieceCalculatorLocaleContent = {
+  slug: 'smart-eyepiece-calculator',
+  title,
+  description,
+  ui,
+  faq,
+  howTo,
+  seo,
+  bibliography,
+  schemas: [faqSchema as any, howToSchema as any, appSchema],
+};

package/src/tool/smartEyepieceCalculator/index.ts

@@ -0,0 +1,13 @@
+import type { ToolDefinition } from '../../types';
+import { eyepieceCalculator } from './entry';
+
+export * from './entry';
+
+export const EYEPIECE_CALCULATOR_TOOL: ToolDefinition = {
+  entry: eyepieceCalculator,
+  Component: () => import('./component.astro'),
+  SEOComponent: () => import('./seo.astro'),
+  BibliographyComponent: () => import('./bibliography.astro'),
+};
+
+export { EYEPIECE_CALCULATOR_TOOL as smartEyepieceCalculator };

package/src/tool/smartEyepieceCalculator/logic.ts

@@ -0,0 +1,67 @@
+export interface EyepieceStats {
+  magnification: number;
+  trueFieldOfView: number;
+  exitPupil: number;
+}
+
+export interface TelescopeLimits {
+  maxMagnification: number;
+  minMagnification: number;
+}
+
+export interface EyepieceStatus {
+  state: 'perfect' | 'warning' | 'danger';
+  reason?: 'lowMag' | 'highMag' | 'highPupil' | 'lowPupil';
+}
+
+export function calculateEyepieceStats(
+  telescopeFocal: number,
+  eyepieceFocal: number,
+  eyepieceAfov: number
+): EyepieceStats {
+  if (!telescopeFocal || !eyepieceFocal || eyepieceFocal <= 0) {
+    return { magnification: 0, trueFieldOfView: 0, exitPupil: 0 };
+  }
+
+  const magnification = telescopeFocal / eyepieceFocal;
+  const trueFieldOfView = eyepieceAfov / magnification;
+
+  return {
+    magnification,
+    trueFieldOfView,
+    exitPupil: 0,
+  };
+}
+
+export function calculateExitPupil(eyepieceFocal: number, focalRatio: number): number {
+  if (!focalRatio || focalRatio <= 0 || !eyepieceFocal) return 0;
+  return eyepieceFocal / focalRatio;
+}
+
+export function getTelescopeLimits(apertureMm: number): TelescopeLimits {
+  if (!apertureMm || apertureMm <= 0) {
+    return { maxMagnification: 0, minMagnification: 0 };
+  }
+  return {
+    maxMagnification: apertureMm * 2,
+    minMagnification: apertureMm / 7,
+  };
+}
+
+export function analyzeEyepiece(stats: EyepieceStats, limits: TelescopeLimits, exitPupil: number): EyepieceStatus {
+  if (exitPupil > 7.0) {
+    return { state: 'danger', reason: 'highPupil' };
+  }
+  if (stats.magnification > limits.maxMagnification * 1.2) {
+    return { state: 'danger', reason: 'highMag' };
+  }
+
+  if (stats.magnification > limits.maxMagnification * 0.8 || exitPupil < 0.5) {
+    return { state: 'warning', reason: 'highMag' };
+  }
+  if (stats.magnification < limits.minMagnification || exitPupil > 6.0) {
+    return { state: 'warning', reason: 'lowMag' };
+  }
+
+  return { state: 'perfect' };
+}

package/src/tool/smartEyepieceCalculator/seo.astro

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