@jjlmoya/utils-astronomy 1.35.1 → 1.37.0

package/src/tool/meteorShowerObservingPlanner/ui.ts

@@ -1,87 +1,87 @@
-import type { BibliographyEntry } from '../../types';
-
-export interface ShowerPreset {
-  id: string;
-  name: string;
-  peakMonth: number;
-  peakDay: number;
-  zhr: number;
-  radiantConstellation: string;
-  velocityKms: number;
-  parentBody: string;
-}
-
-export interface ObservingPlannerInput {
-  showerId: string;
-  customZhr: number;
-  latitude: number;
-  bortleClass: number;
-  moonPhase: number;
-  sessionStartHour: number;
-  sessionEndHour: number;
-}
-
-export interface HourlyCalculation {
-  hour: number;
-  formattedTime: string;
-  radiantElevationDeg: number;
-  effectiveZhr: number;
-  qualityScore: number;
-  moonInterferencePercent: number;
-  isPeakHour: boolean;
-}
-
-export interface EvaluationResult {
-  overallScore: number;
-  bestWindowStart: string;
-  bestWindowEnd: string;
-  maxEffectiveRate: number;
-  skyDarknessRating: string;
-  moonImpactRating: string;
-  badges: Array<{
-    label: string;
-    type: 'success' | 'warning' | 'info' | 'error';
-  }>;
-  hourlyBreakdown: HourlyCalculation[];
-}
-
-export interface MeteorShowerObservingPlannerUI {
-  [key: string]: unknown;
-  title: string;
-  subtitle: string;
-  presetLabel: string;
-  customZhrLabel: string;
-  latitudeLabel: string;
-  bortleLabel: string;
-  moonPhaseLabel: string;
-  sessionHoursLabel: string;
-  toLabel: string;
-  classLabel: string;
-  radiantTelemetryLabel: string;
-  belowHorizonLabel: string;
-  altLabel: string;
-  hrUnit: string;
-  presets: Record<string, string>;
-  bortleDescriptions: Record<number, string>;
-  moonPhaseNames: Record<string, string>;
-  badgeLabels: Record<string, string>;
-  resultsTitle: string;
-  bestWindowLabel: string;
-  maxRateLabel: string;
-  skyQualityLabel: string;
-  hourlyChartTitle: string;
-  checklistTitle: string;
-  checklistItems: string[];
-}
-
-export interface MeteorShowerObservingPlannerLocaleContent {
-  slug: string;
-  title: string;
-  description: string;
-  ui: MeteorShowerObservingPlannerUI;
-  seo: unknown[];
-  faq: Array<{ question: string; answer: string }>;
-  howTo: Array<{ name: string; text: string }>;
-  bibliography: BibliographyEntry[];
-  schemas: unknown[];
-}
+import type { BibliographyEntry } from '../../types';
+
+export interface ShowerPreset {
+  id: string;
+  name: string;
+  peakMonth: number;
+  peakDay: number;
+  zhr: number;
+  radiantConstellation: string;
+  velocityKms: number;
+  parentBody: string;
+}
+
+export interface ObservingPlannerInput {
+  showerId: string;
+  customZhr: number;
+  latitude: number;
+  bortleClass: number;
+  moonPhase: number;
+  sessionStartHour: number;
+  sessionEndHour: number;
+}
+
+export interface HourlyCalculation {
+  hour: number;
+  formattedTime: string;
+  radiantElevationDeg: number;
+  effectiveZhr: number;
+  qualityScore: number;
+  moonInterferencePercent: number;
+  isPeakHour: boolean;
+}
+
+export interface EvaluationResult {
+  overallScore: number;
+  bestWindowStart: string;
+  bestWindowEnd: string;
+  maxEffectiveRate: number;
+  skyDarknessRating: string;
+  moonImpactRating: string;
+  badges: Array<{
+    label: string;
+    type: 'success' | 'warning' | 'info' | 'error';
+  }>;
+  hourlyBreakdown: HourlyCalculation[];
+}
+
+export interface MeteorShowerObservingPlannerUI {
+  [key: string]: unknown;
+  title: string;
+  subtitle: string;
+  presetLabel: string;
+  customZhrLabel: string;
+  latitudeLabel: string;
+  bortleLabel: string;
+  moonPhaseLabel: string;
+  sessionHoursLabel: string;
+  toLabel: string;
+  classLabel: string;
+  radiantTelemetryLabel: string;
+  belowHorizonLabel: string;
+  altLabel: string;
+  hrUnit: string;
+  presets: Record<string, string>;
+  bortleDescriptions: Record<number, string>;
+  moonPhaseNames: Record<string, string>;
+  badgeLabels: Record<string, string>;
+  resultsTitle: string;
+  bestWindowLabel: string;
+  maxRateLabel: string;
+  skyQualityLabel: string;
+  hourlyChartTitle: string;
+  checklistTitle: string;
+  checklistItems: string[];
+}
+
+export interface MeteorShowerObservingPlannerLocaleContent {
+  slug: string;
+  title: string;
+  description: string;
+  ui: MeteorShowerObservingPlannerUI;
+  seo: unknown[];
+  faq: Array<{ question: string; answer: string }>;
+  howTo: Array<{ name: string; text: string }>;
+  bibliography: BibliographyEntry[];
+  schemas: unknown[];
+}

package/src/tools.ts

@@ -6,6 +6,7 @@ import { TELESCOPE_RESOLUTION_TOOL } from './tool/telescopeResolution';
 import { EYEPIECE_CALCULATOR_TOOL } from './tool/smartEyepieceCalculator';
 import { TELESCOPE_EXIT_PUPIL_PLANNER_TOOL } from './tool/telescopeExitPupilPlanner';
 import { METEOR_SHOWER_OBSERVING_PLANNER_TOOL } from './tool/meteorShowerObservingPlanner';
+import { ASTROPHOTOGRAPHY_EXPOSURE_STACK_PLANNER_TOOL } from './tool/astrophotographyExposureStackPlanner';
 import type { ToolDefinition } from './types';
 
 export const ALL_TOOLS: ToolDefinition[] = [
@@ -16,6 +17,7 @@ export const ALL_TOOLS: ToolDefinition[] = [
   EYEPIECE_CALCULATOR_TOOL,
   TELESCOPE_EXIT_PUPIL_PLANNER_TOOL,
   METEOR_SHOWER_OBSERVING_PLANNER_TOOL,
+  ASTROPHOTOGRAPHY_EXPOSURE_STACK_PLANNER_TOOL,
 ];
 
 export {
@@ -26,5 +28,5 @@ export {
   EYEPIECE_CALCULATOR_TOOL,
   TELESCOPE_EXIT_PUPIL_PLANNER_TOOL,
   METEOR_SHOWER_OBSERVING_PLANNER_TOOL,
+  ASTROPHOTOGRAPHY_EXPOSURE_STACK_PLANNER_TOOL,
 };
-

package/src/types.ts

@@ -1,9 +1,9 @@
 import type { SEOSection } from '@jjlmoya/utils-shared';
+import type { UtilityLocale } from '@jjlmoya/utils-shared/routing';
 
 export type { SEOSection };
 
-export type KnownLocale =
-  | 'de' | 'en' | 'es' | 'fr' | 'id' | 'it' | 'ja' | 'ko' | 'nl' | 'pl' | 'pt' | 'ru' | 'sv' | 'tr' | 'zh';
+export type KnownLocale = UtilityLocale;
 
 export interface FAQItem {
   question: string;

package/src/worker.ts

@@ -0,0 +1,27 @@
+interface UtilityMfeEnvironment {
+    ASSETS: { fetch(request: Request): Promise<Response> };
+}
+
+export const LONG_LIVED_ASSET_CACHE = "public, max-age=31536000, immutable";
+export const SITEMAP_CACHE = "public, max-age=3600, s-maxage=3600, must-revalidate";
+
+export const getCacheControl = (pathname: string): string | undefined => {
+    if (pathname.endsWith("/sitemap.xml")) return SITEMAP_CACHE;
+    if (pathname.endsWith("/manifest.json")) return LONG_LIVED_ASSET_CACHE;
+    if (pathname.startsWith("/_utilities/")) {
+        return LONG_LIVED_ASSET_CACHE;
+    }
+    return undefined;
+};
+
+export default {
+    async fetch(request: Request, environment: UtilityMfeEnvironment): Promise<Response> {
+        const response = await environment.ASSETS.fetch(request);
+        const cacheControl = getCacheControl(new URL(request.url).pathname);
+        if (!cacheControl) return response;
+
+        const headers = new Headers(response.headers);
+        headers.set("Cache-Control", cacheControl);
+        return new Response(response.body, { status: response.status, headers });
+    },
+};

package/src/pages/[locale]/[slug].astro

@@ -1,161 +0,0 @@
----
-import PreviewLayout from "../../layouts/PreviewLayout.astro";
-import PreviewNavSidebar from "../../components/PreviewNavSidebar.astro";
-import { ALL_TOOLS } from "../../index";
-import {
-  UtilityHeader,
-  FAQSection,
-  Bibliography,
-  SEORenderer,
-} from "@jjlmoya/utils-shared";
-import type { KnownLocale, ToolLocaleContent } from "../../types";
-import type { UtilitySEOContent } from "@jjlmoya/utils-shared";
-
-export async function getStaticPaths() {
-  const paths = [];
-
-  for (const { entry, Component: lazyComp } of ALL_TOOLS) {
-    const { default: Component } = await lazyComp();
-    const localeEntries = Object.entries(entry.i18n) as [
-      KnownLocale,
-      () => Promise<ToolLocaleContent>,
-    ][];
-    const localeContents = await Promise.all(
-      localeEntries.map(async ([locale, loader]) => ({
-        locale,
-        content: await loader(),
-      })),
-    );
-
-    const localeUrls = Object.fromEntries(
-      localeContents.map(({ locale, content }) => [
-        locale,
-        `/${locale}/${content.slug}`,
-      ]),
-    ) as Partial<Record<KnownLocale, string>>;
-
-    const firstLoader = entry.i18n.en ?? Object.values(entry.i18n)[0];
-    const englishSlug = firstLoader ? (await firstLoader()).slug : entry.id;
-
-    for (const { locale, content } of localeContents) {
-      const allToolsNav = (
-        await Promise.all(
-          ALL_TOOLS.map(async ({ entry: navEntry }) => {
-            const loader = navEntry.i18n[locale] ?? navEntry.i18n.en;
-            if (!loader) return null;
-            const navContent = await loader();
-            return {
-              id: navEntry.id,
-              title: navContent.title,
-              href: `/${locale}/${navContent.slug}`,
-              isActive: navEntry.id === entry.id,
-            };
-          }),
-        )
-      ).filter(Boolean) as NavItem[];
-      paths.push({
-        params: { locale, slug: content.slug },
-        props: { Component, locale, content, localeUrls, allToolsNav, englishSlug },
-      });
-    }
-  }
-
-  return paths;
-}
-
-interface NavItem {
-  id: string;
-  title: string;
-  href: string;
-  isActive?: boolean;
-}
-
-interface Props {
-  Component: unknown;
-  locale: KnownLocale;
-  content: ToolLocaleContent;
-  localeUrls: Partial<Record<KnownLocale, string>>;
-  allToolsNav: NavItem[];
-  englishSlug: string;
-}
-
-const { Component, locale, content, localeUrls, allToolsNav, englishSlug } = Astro.props;
-
-const cssFiles = import.meta.glob('../../tool/*/*.css', { query: '?raw', import: 'default' });
-const cssKey = Object.keys(cssFiles).find((k) => k.endsWith(`/${englishSlug}.css`));
-const toolCss = cssKey ? await cssFiles[cssKey]() as string : '';
-
-const seoContent: UtilitySEOContent = { locale, sections: content.seo ?? [] };
-
-const words = content.title.split(" ");
-const titleHighlight = words[0] || "";
-const titleBase = words.slice(1).join(" ") || "";
----
-
-<PreviewLayout
-  title={content.title}
-  currentLocale={locale}
-  localeUrls={localeUrls}
-  hasSidebar={true}
->
-  <PreviewNavSidebar
-    slot="sidebar"
-    categoryTitle="Tools"
-    tools={allToolsNav}
-  />
-  <Fragment slot="head">
-    <Fragment set:html={toolCss ? `<style>${toolCss}</style>` : ''} />
-    {
-      (content.schemas ?? []).map((schema) => (
-        <script
-          is:inline
-          type="application/ld+json"
-          set:html={JSON.stringify(schema)}
-        />
-      ))
-    }
-  </Fragment>
-
-  <div class="tool-page">
-    <UtilityHeader
-      titleHighlight={titleHighlight}
-      titleBase={titleBase}
-      description={content.description}
-    />
-
-    <section class="section-tool">
-      <Component ui={content.ui} />
-    </section>
-
-    <section class="section-seo">
-      <SEORenderer content={seoContent} />
-    </section>
-
-    <section class="section-faq">
-      <FAQSection items={content.faq} />
-    </section>
-
-    <section class="section-bibliography">
-      <Bibliography links={content.bibliography}  />
-    </section>
-  </div>
-</PreviewLayout>
-
-<style>
-  .tool-page {
-    display: flex;
-    flex-direction: column;
-    gap: 2rem;
-  }
-  .section-tool {
-    max-width: 1200px;
-    margin: 0 auto;
-    width: 100%;
-  }
-  .section-seo,
-  .section-faq,
-  .section-bibliography {
-    padding-top: 2rem;
-    border-top: 1px solid var(--border-color);
-  }
-</style>

package/src/pages/[locale].astro

@@ -1,251 +0,0 @@
----
-import PreviewLayout from '../layouts/PreviewLayout.astro';
-import PreviewNavSidebar from '../components/PreviewNavSidebar.astro';
-import { astronomyCategory, ALL_TOOLS } from '../index';
-import { Icon } from 'astro-icon/components';
-import type { KnownLocale, ToolLocaleContent } from '../types';
-
-export async function getStaticPaths() {
-  const locales = ['en', 'es', 'fr'] as KnownLocale[];
-  return locales.map(locale => ({ params: { locale } }));
-}
-
-const { locale: currentLocale } = Astro.params as { locale: KnownLocale };
-
-const categoryContent = await astronomyCategory.i18n[currentLocale]!();
-
-const tools = ALL_TOOLS || [];
-
-const toolsWithContent = tools.length > 0
-  ? await Promise.all(
-      tools.map(async ({ entry, Component }) => {
-        const languages = Object.keys(entry.i18n);
-        const localeEntries = await Promise.all(
-          languages.map(async (l) => {
-            const content = await entry.i18n[l as KnownLocale]!();
-            return [l, content];
-          })
-        );
-
-        const localeContents = Object.fromEntries(localeEntries) as Record<string, ToolLocaleContent<Record<string, string>>>;
-
-        const currentLocaleContent = localeContents[currentLocale] || localeContents['en'] || localeContents['es'];
-        const availableLocales: Record<string, string> = {};
-
-        for (const l of languages) {
-          const lCont = localeContents[l];
-          if (lCont) {
-            availableLocales[l] = `/${l}/${lCont.slug}`;
-          }
-        }
-
-        return { entry, Component, locale: currentLocaleContent, availableLocales };
-      })
-    )
-  : [];
----
-
-<PreviewLayout
-  title={categoryContent.title}
-  currentLocale={currentLocale}
-  hasSidebar={true}
->
-  <PreviewNavSidebar
-    slot="sidebar"
-    categoryTitle={categoryContent.title}
-    tools={toolsWithContent.map(({ entry, locale, availableLocales }) => {
-      const href = availableLocales[currentLocale] || (locale ? `/${currentLocale}/${locale.slug}` : '#');
-      return {
-        id: entry.id,
-        title: locale?.title || entry.id,
-        href: href,
-      };
-    })}
-  />
-  <div class="dashboard">
-    <header class="preview-header">
-      <span class="badge">preview · @jjlmoya/utils-astronomy</span>
-      <h1>{categoryContent.title}</h1>
-      <p>{categoryContent.description}</p>
-    </header>
-
-    <div class="tool-list">
-      {toolsWithContent?.map(({ entry, locale, availableLocales }) => (
-        <article class="tool-card">
-          <a href={availableLocales?.[currentLocale] || (locale ? `/${currentLocale}/${locale.slug}` : '#')} class="tool-card-link">
-            <div class="tool-icons">
-               <div class="icon-wrapper bg">
-                  <Icon name={entry.icons.bg} />
-               </div>
-               <div class="icon-wrapper fg">
-                  <Icon name={entry.icons.fg} />
-               </div>
-            </div>
-            <div class="tool-card-content">
-              <h2 class="tool-title">{locale?.title}</h2>
-              <p class="tool-description">{locale?.description}</p>
-            </div>
-            <div class="tool-card-meta">
-              <span class="tool-id">{entry.id}</span>
-            </div>
-          </a>
-
-          {availableLocales && Object.keys(availableLocales).length > 1 && (
-            <div class="tool-locales">
-              {Object.entries(availableLocales).map(([l, url]) => (
-                <a href={url} class="locale-badge" title={`Ver en ${l.toUpperCase()}`} class:list={{ active: l === currentLocale }}>
-                  {l.toUpperCase()}
-                </a>
-              ))}
-            </div>
-          )}
-        </article>
-      ))}
-    </div>
-  </div>
-</PreviewLayout>
-
-<style>
-  .dashboard {
-    display: flex;
-    flex-direction: column;
-    gap: 5rem;
-  }
-  .preview-header {
-    text-align: center;
-    padding-bottom: 3rem;
-    border-bottom: 1px solid var(--border-color);
-  }
-  .badge {
-    display: inline-block;
-    padding: 0.25rem 0.75rem;
-    background: var(--accent);
-    border-radius: 99px;
-    font-size: 0.7rem;
-    font-weight: 800;
-    margin-bottom: 1.5rem;
-    color: var(--text-base);
-    letter-spacing: 0.05em;
-  }
-  h1 {
-    font-size: clamp(2rem, 6vw, 3.5rem);
-    font-weight: 900;
-    margin: 0 0 1rem;
-    background: linear-gradient(to bottom, var(--text-base), var(--text-muted));
-    -webkit-background-clip: text;
-    -webkit-text-fill-color: transparent;
-    background-clip: text;
-  }
-  .preview-header p {
-    color: var(--text-muted);
-    font-size: 1.1rem;
-    margin: 0;
-  }
-  .tool-list {
-    display: grid;
-    grid-template-columns: repeat(auto-fill, minmax(320px, 1fr));
-    gap: 2rem;
-  }
-  .tool-card {
-    display: flex;
-    flex-direction: column;
-    gap: 1rem;
-  }
-  .tool-card-link {
-    flex: 1;
-    display: flex;
-    flex-direction: column;
-    padding: 1.5rem;
-    background: var(--bg-surface);
-    border: 1px solid var(--border-color);
-    border-radius: 0.75rem;
-    text-decoration: none;
-    transition: all 0.2s ease;
-  }
-  .tool-card-link:hover {
-    border-color: var(--accent);
-    background: rgba(244, 63, 94, 0.05);
-    transform: translateY(-2px);
-  }
-  .tool-icons {
-    display: flex;
-    align-items: center;
-    gap: 1rem;
-    margin-bottom: 1.25rem;
-  }
-  .icon-wrapper {
-    display: flex;
-    align-items: center;
-    justify-content: center;
-    width: 3rem;
-    height: 3rem;
-    border-radius: 0.5rem;
-    font-size: 1.5rem;
-  }
-  .icon-wrapper.bg {
-    background: var(--accent);
-    color: var(--text-base);
-  }
-  .icon-wrapper.fg {
-    background: var(--bg-page);
-    border: 1px solid var(--border-color);
-    color: var(--accent);
-  }
-  .tool-card-content {
-    flex: 1;
-    display: flex;
-    flex-direction: column;
-  }
-  .tool-title {
-    font-size: 1.25rem;
-    font-weight: 700;
-    margin: 0 0 0.5rem;
-    color: var(--text-base);
-  }
-  .tool-description {
-    font-size: 0.9375rem;
-    color: var(--text-muted);
-    line-height: 1.5;
-    margin: 0;
-  }
-  .tool-card-meta {
-    padding-top: 1rem;
-    border-top: 1px solid var(--border-color);
-    margin-top: 1.5rem;
-  }
-  .tool-id {
-    display: inline-block;
-    font-size: 0.7rem;
-    background: var(--bg-page);
-    border: 1px solid var(--border-color);
-    padding: 0.35rem 0.75rem;
-    border-radius: 0.4rem;
-    color: var(--accent);
-    font-weight: 600;
-  }
-  .tool-locales {
-    display: flex;
-    gap: 0.5rem;
-    flex-wrap: wrap;
-  }
-  .locale-badge {
-    display: inline-block;
-    padding: 0.4rem 0.85rem;
-    background: var(--bg-page);
-    border: 1px solid var(--border-color);
-    border-radius: 0.4rem;
-    color: var(--text-muted);
-    text-decoration: none;
-    font-size: 0.75rem;
-    font-weight: 600;
-    text-transform: uppercase;
-    letter-spacing: 0.05em;
-    transition: all 0.15s ease;
-  }
-  .locale-badge:hover,
-  .locale-badge.active {
-    color: var(--accent);
-    border-color: var(--accent);
-    background: rgba(244, 63, 94, 0.1);
-  }
-</style>