@jjlmoya/utils-astronomy 1.28.0 → 1.34.1

package/src/tool/meteorShowerObservingPlanner/logic.ts

@@ -0,0 +1,263 @@
+import type { ShowerPreset, ObservingPlannerInput, HourlyCalculation, EvaluationResult, MeteorShowerObservingPlannerUI } from './ui';
+
+export const METEOR_SHOWERS: ShowerPreset[] = [
+  {
+    id: 'perseids',
+    name: 'Perseids',
+    peakMonth: 8,
+    peakDay: 12,
+    zhr: 100,
+    radiantConstellation: 'Perseus',
+    velocityKms: 59,
+    parentBody: '109P/Swift-Tuttle',
+  },
+  {
+    id: 'geminids',
+    name: 'Geminids',
+    peakMonth: 12,
+    peakDay: 14,
+    zhr: 120,
+    radiantConstellation: 'Gemini',
+    velocityKms: 35,
+    parentBody: '3200 Phaethon',
+  },
+  {
+    id: 'quadrantids',
+    name: 'Quadrantids',
+    peakMonth: 1,
+    peakDay: 4,
+    zhr: 110,
+    radiantConstellation: 'Bootes',
+    velocityKms: 41,
+    parentBody: '2003 EH1',
+  },
+  {
+    id: 'lyrids',
+    name: 'Lyrids',
+    peakMonth: 4,
+    peakDay: 22,
+    zhr: 18,
+    radiantConstellation: 'Lyra',
+    velocityKms: 49,
+    parentBody: 'C/1861 G1 Thatcher',
+  },
+  {
+    id: 'orionids',
+    name: 'Orionids',
+    peakMonth: 10,
+    peakDay: 21,
+    zhr: 20,
+    radiantConstellation: 'Orion',
+    velocityKms: 66,
+    parentBody: '1P/Halley',
+  },
+  {
+    id: 'eta-aquariids',
+    name: 'Eta Aquariids',
+    peakMonth: 5,
+    peakDay: 6,
+    zhr: 50,
+    radiantConstellation: 'Aquarius',
+    velocityKms: 66,
+    parentBody: '1P/Halley',
+  },
+  {
+    id: 'leonids',
+    name: 'Leonids',
+    peakMonth: 11,
+    peakDay: 17,
+    zhr: 15,
+    radiantConstellation: 'Leo',
+    velocityKms: 71,
+    parentBody: '55P/Tempel-Tuttle',
+  },
+  {
+    id: 'custom',
+    name: 'Custom Shower',
+    peakMonth: 1,
+    peakDay: 1,
+    zhr: 50,
+    radiantConstellation: 'Zenith',
+    velocityKms: 50,
+    parentBody: 'Unknown Comet',
+  },
+];
+
+export function getShowerById(id: string): ShowerPreset {
+  const found = METEOR_SHOWERS.find((s) => s.id === id);
+  return found || METEOR_SHOWERS[0];
+}
+
+export function calculateRadiantElevation(hour: number, latitude: number, showerId: string): number {
+  const shower = getShowerById(showerId);
+  const hourNormalized = (hour + 24) % 24;
+  const isNorthern = latitude >= 0;
+
+  let peakHour = 3;
+  if (shower.id === 'eta-aquariids') {
+    peakHour = 4;
+  } else if (shower.id === 'lyrids' || shower.id === 'orionids') {
+    peakHour = 2;
+  }
+
+  const hoursFromPeak = Math.abs(((hourNormalized - peakHour + 12) % 24) - 12);
+  const basePeakAltitude = isNorthern ? 65 : 35;
+  const latitudeFactor = Math.cos(((latitude - 35) * Math.PI) / 180);
+  const rawAltitude = basePeakAltitude * latitudeFactor - hoursFromPeak * 8;
+
+  return Math.max(0, Math.min(90, Math.round(rawAltitude)));
+}
+
+export function calculateMoonInterference(moonPhase: number): number {
+  const normalizedPhase = Math.min(1, Math.max(0, moonPhase));
+  const sineFactor = Math.sin(normalizedPhase * Math.PI);
+  return Math.round(sineFactor * 100);
+}
+
+export function calculateEffectiveZHR(
+  zhr: number,
+  radiantElevation: number,
+  bortleClass: number,
+  moonPhase: number
+): number {
+  if (radiantElevation <= 0) {
+    return 0;
+  }
+
+  const elevationFactor = Math.sin((radiantElevation * Math.PI) / 180);
+  const bortleFactor = Math.max(0.1, 1 - (bortleClass - 1) * 0.1);
+  const moonInterference = calculateMoonInterference(moonPhase);
+  const moonFactor = Math.max(0.2, 1 - (moonInterference / 100) * 0.6);
+
+  const effective = zhr * elevationFactor * bortleFactor * moonFactor;
+  return Math.max(0, Math.round(effective * 10) / 10);
+}
+
+export function formatHourLabel(hour: number): string {
+  const normalized = (hour + 24) % 24;
+  return `${String(normalized).padStart(2, '0')}:00`;
+}
+
+function markPeakHours(list: HourlyCalculation[]): void {
+  const maxZhr = Math.max(...list.map((item) => item.effectiveZhr), -1);
+  if (maxZhr > 0) {
+    list.forEach((item) => {
+      if (item.effectiveZhr === maxZhr) {
+        item.isPeakHour = true;
+      }
+    });
+  }
+}
+
+export function calculateHourlyBreakdown(input: ObservingPlannerInput): HourlyCalculation[] {
+  const shower = getShowerById(input.showerId);
+  const baseZhr = input.showerId === 'custom' ? input.customZhr : shower.zhr;
+  const list: HourlyCalculation[] = [];
+
+  const start = input.sessionStartHour;
+  const end = input.sessionStartHour > input.sessionEndHour ? input.sessionEndHour + 24 : input.sessionEndHour;
+
+  for (let current = start; current <= end; current++) {
+    const actualHour = current % 24;
+    const elevation = calculateRadiantElevation(actualHour, input.latitude, input.showerId);
+    const effZhr = calculateEffectiveZHR(baseZhr, elevation, input.bortleClass, input.moonPhase);
+    const moonPercent = calculateMoonInterference(input.moonPhase);
+
+    list.push({
+      hour: actualHour,
+      formattedTime: formatHourLabel(actualHour),
+      radiantElevationDeg: elevation,
+      effectiveZhr: effZhr,
+      qualityScore: Math.min(100, Math.round((effZhr / Math.max(1, baseZhr)) * 100)),
+      moonInterferencePercent: moonPercent,
+      isPeakHour: false,
+    });
+  }
+
+  markPeakHours(list);
+  return list;
+}
+
+function evaluateDarknessRating(bortle: number, ui: MeteorShowerObservingPlannerUI): string {
+  if (bortle <= 3) {
+    return ui.bortleDescriptions[2] || 'Dark Sky';
+  }
+  if (bortle <= 6) {
+    return ui.bortleDescriptions[5] || 'Suburban Sky';
+  }
+  return ui.bortleDescriptions[8] || 'Urban Light Pollution';
+}
+
+function evaluateMoonRating(moonPhase: number, ui: MeteorShowerObservingPlannerUI): string {
+  const percent = calculateMoonInterference(moonPhase);
+  if (percent < 25) {
+    return ui.moonPhaseNames['new'] || 'Minimal Moon Impact';
+  }
+  if (percent < 70) {
+    return ui.moonPhaseNames['quarter'] || 'Moderate Moon Glow';
+  }
+  return ui.moonPhaseNames['full'] || 'Severe Moon Interference';
+}
+
+function getBortleBadge(bortleClass: number, bLabels: Record<string, string>): EvaluationResult['badges'][number] | null {
+  if (bortleClass <= 3) {
+    return { label: bLabels.darkSky || 'Pristine Dark Sky', type: 'success' };
+  }
+  if (bortleClass >= 7) {
+    return { label: bLabels.lightPollution || 'High Light Pollution', type: 'warning' };
+  }
+  return null;
+}
+
+function getMoonBadge(moonPhase: number, bLabels: Record<string, string>): EvaluationResult['badges'][number] {
+  const isLow = calculateMoonInterference(moonPhase) < 30;
+  return {
+    label: isLow ? bLabels.favorableMoon || 'Favorable Moon' : bLabels.moonWashout || 'Moon Washout Risk',
+    type: isLow ? 'success' : 'info',
+  };
+}
+
+function buildSessionBadges(
+  input: ObservingPlannerInput,
+  ui: MeteorShowerObservingPlannerUI,
+  maxRate: number
+): EvaluationResult['badges'] {
+  const badges: EvaluationResult['badges'] = [];
+  const bLabels = ui.badgeLabels || {};
+
+  const bBadge = getBortleBadge(input.bortleClass, bLabels);
+  if (bBadge) badges.push(bBadge);
+
+  badges.push(getMoonBadge(input.moonPhase, bLabels));
+
+  if (maxRate >= 20) {
+    badges.push({ label: bLabels.primeWindow || 'Prime Activity Window', type: 'success' });
+  }
+
+  return badges;
+}
+
+export function evaluateObservingSession(
+  input: ObservingPlannerInput,
+  ui: MeteorShowerObservingPlannerUI
+): EvaluationResult {
+  const hourly = calculateHourlyBreakdown(input);
+  const maxRate = Math.max(...hourly.map((h) => h.effectiveZhr), 0);
+  const peakItem = hourly.find((h) => h.effectiveZhr === maxRate) || null;
+  const totalScore = hourly.reduce((sum, h) => sum + h.qualityScore, 0);
+
+  const avgScore = hourly.length > 0 ? Math.round(totalScore / hourly.length) : 0;
+  const peakTime = peakItem ? peakItem.formattedTime : '23:00';
+  const bestEnd = formatHourLabel(peakItem ? (peakItem.hour + 2) % 24 : 1);
+
+  return {
+    overallScore: avgScore,
+    bestWindowStart: peakTime,
+    bestWindowEnd: bestEnd,
+    maxEffectiveRate: maxRate,
+    skyDarknessRating: evaluateDarknessRating(input.bortleClass, ui),
+    moonImpactRating: evaluateMoonRating(input.moonPhase, ui),
+    badges: buildSessionBadges(input, ui, maxRate),
+    hourlyBreakdown: hourly,
+  };
+}

package/src/tool/meteorShowerObservingPlanner/meteor-shower-observing-planner.css

@@ -0,0 +1,404 @@
+:root {
+  --n-card-bg: #ffffff;
+  --n-card-border: #e2e8f0;
+  --n-text-main: #0f172a;
+  --n-text-muted: #475569;
+  --n-accent: #4f46e5;
+  --n-accent-hover: #4338ca;
+  --n-accent-dim: rgba(79, 70, 229, 0.12);
+  --n-surface-sub: #f8fafc;
+  --n-surface-dark: #0f172a;
+  --n-badge-success-bg: #dcfce7;
+  --n-badge-success-fg: #14532d;
+  --n-badge-warning-bg: #fef3c7;
+  --n-badge-warning-fg: #78350f;
+  --n-badge-info-bg: #e0e7ff;
+  --n-badge-info-fg: #312e81;
+  --n-bar-bg: #cbd5e1;
+  --n-bar-fill: #4f46e5;
+  --n-bar-peak: #e11d48;
+}
+
+.theme-dark .meteor-shower-planner-card,
+.meteor-shower-planner-card.theme-dark {
+  --n-card-bg: #0f172a;
+  --n-card-border: #1e293b;
+  --n-text-main: #f8fafc;
+  --n-text-muted: #94a3b8;
+  --n-accent: #6366f1;
+  --n-accent-hover: #818cf8;
+  --n-accent-dim: rgba(99, 102, 241, 0.2);
+  --n-surface-sub: #1e293b;
+  --n-surface-dark: #020617;
+  --n-badge-success-bg: rgba(22, 101, 52, 0.35);
+  --n-badge-success-fg: #4ade80;
+  --n-badge-warning-bg: rgba(146, 64, 14, 0.35);
+  --n-badge-warning-fg: #fbbf24;
+  --n-badge-info-bg: rgba(55, 48, 163, 0.35);
+  --n-badge-info-fg: #a5b4fc;
+  --n-bar-bg: #334155;
+  --n-bar-fill: #6366f1;
+  --n-bar-peak: #fb7185;
+}
+
+.meteor-shower-planner-card {
+  background: var(--n-card-bg);
+  border: 1px solid var(--n-card-border);
+  border-radius: 20px;
+  padding: 24px;
+  color: var(--n-text-main);
+  font-family: system-ui, -apple-system, sans-serif;
+  max-width: 900px;
+  margin: 0 auto;
+  box-shadow: 0 10px 25px -5px rgba(0, 0, 0, 0.05);
+}
+
+.planner-layout-grid {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: 24px;
+}
+
+@media (max-width: 768px) {
+  .planner-layout-grid {
+    grid-template-columns: 1fr;
+  }
+}
+
+.planner-control-section {
+  display: flex;
+  flex-direction: column;
+  gap: 20px;
+}
+
+.presets-chip-grid {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 8px;
+}
+
+.preset-chip-btn {
+  background: var(--n-surface-sub);
+  border: 1px solid var(--n-card-border);
+  color: var(--n-text-main);
+  border-radius: 9999px;
+  padding: 6px 14px;
+  font-size: 13px;
+  font-weight: 500;
+  cursor: pointer;
+  transition: all 0.2s ease;
+}
+
+.preset-chip-btn:hover {
+  border-color: var(--n-accent);
+}
+
+.preset-chip-btn.active {
+  background: var(--n-accent);
+  color: #fff;
+  border-color: var(--n-accent);
+}
+
+.input-control-group {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+}
+
+.input-label-row {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  font-size: 14px;
+  font-weight: 600;
+  color: var(--n-text-main);
+}
+
+.input-val-badge {
+  color: var(--n-accent);
+  font-weight: 700;
+}
+
+.planner-slider-range {
+  width: 100%;
+  accent-color: var(--n-accent);
+  height: 6px;
+  border-radius: 4px;
+  background: var(--n-bar-bg);
+}
+
+.hours-select-row {
+  display: flex;
+  gap: 12px;
+  align-items: center;
+}
+
+.hours-sep-txt {
+  font-size: 13px;
+  font-weight: 500;
+  color: var(--n-text-muted);
+}
+
+/* Custom Select Dropdown UI */
+.custom-select-wrap {
+  position: relative;
+  flex: 1;
+}
+
+.custom-select-trigger {
+  width: 100%;
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  background: var(--n-surface-sub);
+  border: 1px solid var(--n-card-border);
+  color: var(--n-text-main);
+  border-radius: 10px;
+  padding: 8px 14px;
+  font-size: 14px;
+  font-weight: 600;
+  cursor: pointer;
+  transition: border-color 0.2s ease, box-shadow 0.2s ease;
+}
+
+.custom-select-trigger:hover,
+.custom-select-trigger[aria-expanded="true"] {
+  border-color: var(--n-accent);
+  outline: none;
+}
+
+.select-arrow-icon {
+  color: var(--n-text-muted);
+  transition: transform 0.2s ease;
+}
+
+.custom-select-trigger[aria-expanded="true"] .select-arrow-icon {
+  transform: rotate(180deg);
+}
+
+.custom-select-menu {
+  position: absolute;
+  top: calc(100% + 4px);
+  left: 0;
+  right: 0;
+  z-index: 50;
+  background: var(--n-card-bg);
+  border: 1px solid var(--n-card-border);
+  border-radius: 10px;
+  box-shadow: 0 10px 25px -5px rgba(0, 0, 0, 0.15);
+  max-height: 200px;
+  overflow-y: auto;
+  display: flex;
+  flex-direction: column;
+  padding: 4px;
+}
+
+.custom-select-menu[hidden] {
+  display: none !important;
+}
+
+.custom-select-opt {
+  width: 100%;
+  text-align: left;
+  background: transparent;
+  border: none;
+  color: var(--n-text-main);
+  padding: 8px 12px;
+  font-size: 13px;
+  font-weight: 500;
+  border-radius: 6px;
+  cursor: pointer;
+  transition: background 0.15s ease;
+}
+
+.custom-select-opt:hover {
+  background: var(--n-accent-dim);
+  color: var(--n-accent);
+}
+
+.custom-select-opt.active {
+  background: var(--n-accent);
+  color: #ffffff;
+}
+
+.planner-results-section {
+  display: flex;
+  flex-direction: column;
+  gap: 20px;
+}
+
+.results-metrics-grid {
+  display: grid;
+  grid-template-columns: repeat(3, 1fr);
+  gap: 12px;
+}
+
+.metric-card-box {
+  background: var(--n-surface-sub);
+  border: 1px solid var(--n-card-border);
+  border-radius: 12px;
+  padding: 12px;
+  text-align: center;
+}
+
+.metric-lbl-txt {
+  font-size: 12px;
+  color: var(--n-text-muted);
+  font-weight: 500;
+  margin-bottom: 4px;
+}
+
+.metric-val-txt {
+  font-size: 16px;
+  font-weight: 700;
+  color: var(--n-text-main);
+}
+
+.res-score-val.badge-excellent {
+  color: #059669;
+}
+
+.res-score-val.badge-moderate {
+  color: #d97706;
+}
+
+.res-score-val.badge-poor {
+  color: #dc2626;
+}
+
+.res-badges-list {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 8px;
+}
+
+.badge {
+  padding: 5px 12px;
+  border-radius: 9999px;
+  font-size: 12px;
+  font-weight: 600;
+}
+
+.badge-success {
+  background: var(--n-badge-success-bg);
+  color: var(--n-badge-success-fg);
+}
+
+.badge-warning {
+  background: var(--n-badge-warning-bg);
+  color: var(--n-badge-warning-fg);
+}
+
+.badge-info {
+  background: var(--n-badge-info-bg);
+  color: var(--n-badge-info-fg);
+}
+
+.sky-dome-container {
+  border-radius: 16px;
+  overflow: hidden;
+  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.1);
+}
+
+.sky-dome-svg {
+  width: 100%;
+  height: auto;
+  display: block;
+}
+
+.hourly-timeline-panel {
+  background: var(--n-surface-sub);
+  border: 1px solid var(--n-card-border);
+  border-radius: 14px;
+  padding: 16px;
+}
+
+.panel-title-lbl {
+  font-size: 14px;
+  font-weight: 600;
+  color: var(--n-text-main);
+  margin-bottom: 12px;
+}
+
+.hourly-bars-track {
+  display: flex;
+  gap: 8px;
+  align-items: flex-end;
+  height: 120px;
+  padding-top: 16px;
+}
+
+.hourly-bar-col {
+  flex: 1;
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 4px;
+  height: 100%;
+}
+
+.bar-val {
+  font-size: 11px;
+  font-weight: 600;
+  color: var(--n-text-main);
+}
+
+.bar-track {
+  flex: 1;
+  width: 100%;
+  max-width: 18px;
+  background: var(--n-bar-bg);
+  border-radius: 4px;
+  display: flex;
+  align-items: flex-end;
+  overflow: hidden;
+}
+
+.bar-fill {
+  width: 100%;
+  background: var(--n-bar-fill);
+  border-radius: 4px;
+  transition: height 0.3s ease;
+}
+
+.hourly-bar-col.is-peak .bar-fill {
+  background: var(--n-bar-peak);
+}
+
+.bar-label {
+  font-size: 10px;
+  font-weight: 600;
+  color: var(--n-text-muted);
+}
+
+.checklist-card-panel {
+  background: var(--n-surface-sub);
+  border: 1px solid var(--n-card-border);
+  border-radius: 14px;
+  padding: 16px;
+  margin-top: 20px;
+}
+
+.checklist-ul {
+  list-style: none;
+  padding: 0;
+  margin: 8px 0 0 0;
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+}
+
+.checklist-li {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  font-size: 13px;
+  color: var(--n-text-main);
+}
+
+.checklist-icon-bullet {
+  width: 8px;
+  height: 8px;
+  border-radius: 50%;
+  background: var(--n-accent);
+}

package/src/tool/meteorShowerObservingPlanner/seo.astro

@@ -0,0 +1,14 @@
+---
+import { SEORenderer } from '@jjlmoya/utils-shared';
+import { meteorShowerObservingPlanner } from './index';
+
+interface Props {
+  locale: string;
+}
+
+const { locale } = Astro.props;
+const entry = await meteorShowerObservingPlanner.i18n[locale as keyof typeof meteorShowerObservingPlanner.i18n]();
+const content = entry();
+---
+
+<SEORenderer locale={locale} sections={content.seo} />

package/src/tool/meteorShowerObservingPlanner/storage.ts

@@ -0,0 +1,41 @@
+import type { ObservingPlannerInput } from './ui';
+
+const STORAGE_KEY = 'jjlmoya_astronomy_meteor_planner_v1';
+
+export const DEFAULT_INPUT: ObservingPlannerInput = {
+  showerId: 'perseids',
+  customZhr: 100,
+  latitude: 40,
+  bortleClass: 4,
+  moonPhase: 0.15,
+  sessionStartHour: 22,
+  sessionEndHour: 5,
+};
+
+export function loadSavedInput(): ObservingPlannerInput {
+  if (typeof window === 'undefined') {
+    return DEFAULT_INPUT;
+  }
+  try {
+    const raw = localStorage.getItem(STORAGE_KEY);
+    if (!raw) {
+      return DEFAULT_INPUT;
+    }
+    const parsed = JSON.parse(raw);
+    return {
+      ...DEFAULT_INPUT,
+      ...parsed,
+    };
+  } catch {
+    return DEFAULT_INPUT;
+  }
+}
+
+export function saveInput(input: ObservingPlannerInput): void {
+  if (typeof window === 'undefined') {
+    return;
+  }
+  try {
+    localStorage.setItem(STORAGE_KEY, JSON.stringify(input));
+  } catch {}
+}