@jjlmoya/utils-astronomy 1.35.1 → 1.37.0

package/src/tests/mfe_manifest.test.ts

@@ -0,0 +1,28 @@
+import { describe, expect, it } from "vitest";
+import { createUtilityManifestResponse } from "../mfe/manifest";
+
+describe("MFE utility manifest", () => {
+    it("returns a versioned installable manifest for the current utility", async () => {
+        const response = createUtilityManifestResponse({
+            title: "Card draw odds calculator",
+            description: "Calculate card draw probabilities.",
+            startUrl: "/en/utilities/categories/astronomy/card-draw-odds-calculator/",
+            englishSlug: "card-draw-odds-calculator",
+        });
+        const manifest = await response.json() as {
+            name: string;
+            start_url: string;
+            scope: string;
+            icons: { src: string; sizes: string; type: string; purpose: string }[];
+        };
+
+        expect(response.headers.get("Content-Type")).toContain("application/manifest+json");
+        expect(response.headers.get("Cache-Control")).toContain("immutable");
+        expect(manifest.name).toBe("Card draw odds calculator");
+        expect(manifest.start_url).toBe(manifest.scope);
+        expect(manifest.icons[0]?.src).toContain("/_utilities/astronomy/images/card-draw-odds-calculator.webp?version=");
+        expect(manifest.icons[0]?.sizes).toBe("512x512");
+        expect(manifest.icons[0]?.type).toBe("image/webp");
+        expect(manifest.icons[0]?.purpose).toBe("any");
+    });
+});

package/src/tests/registry_contract.test.ts

@@ -0,0 +1,67 @@
+import { describe, expect, it } from 'vitest';
+import { existsSync, readdirSync } from 'fs';
+import { join } from 'path';
+import { pathToFileURL } from 'url';
+import { ALL_ENTRIES } from '../entries';
+import { ALL_TOOLS } from '../tools';
+import type { ToolDefinition } from '../types';
+
+function isToolDefinition(value: unknown): value is ToolDefinition {
+  if (!value || typeof value !== 'object') return false;
+
+  const candidate = value as Record<string, unknown>;
+  return Boolean(
+    candidate.entry &&
+      typeof candidate.entry === 'object' &&
+      typeof candidate.Component === 'function' &&
+      typeof candidate.SEOComponent === 'function' &&
+      typeof candidate.BibliographyComponent === 'function',
+  );
+}
+
+const toolRoot = join(process.cwd(), 'src', 'tool');
+const toolDirectories = readdirSync(toolRoot, { withFileTypes: true })
+  .filter((entry) => entry.isDirectory() && existsSync(join(toolRoot, entry.name, 'index.ts')))
+  .map((entry) => entry.name)
+  .sort();
+
+describe('Library registry contract', () => {
+  it('keeps ALL_ENTRIES and ALL_TOOLS synchronized by id', () => {
+    const entryIds = ALL_ENTRIES.map((entry) => entry.id);
+    const toolIds = ALL_TOOLS.map((tool) => tool.entry.id);
+
+    expect(new Set(entryIds).size).toBe(entryIds.length);
+    expect(new Set(toolIds).size).toBe(toolIds.length);
+    expect([...toolIds].sort()).toEqual([...entryIds].sort());
+  });
+
+  it('registers every tool runtime index in both public registries', async () => {
+    const failures: string[] = [];
+
+    for (const directory of toolDirectories) {
+      const runtimeModule = await import(
+        pathToFileURL(join(toolRoot, directory, 'index.ts')).href,
+      );
+      const definitions = [...new Set(Object.values(runtimeModule).filter(isToolDefinition))];
+
+      if (definitions.length !== 1) {
+        failures.push(`${directory}: expected exactly one ToolDefinition export, found ${definitions.length}`);
+        continue;
+      }
+
+      const [definition] = definitions;
+      if (!definition) {
+        failures.push(`${directory}: runtime definition is undefined`);
+        continue;
+      }
+      if (!ALL_TOOLS.some((tool) => tool.entry.id === definition.entry.id)) {
+        failures.push(`${directory}: runtime definition is missing from ALL_TOOLS`);
+      }
+      if (!ALL_ENTRIES.some((entry) => entry.id === definition.entry.id)) {
+        failures.push(`${directory}: runtime entry is missing from ALL_ENTRIES`);
+      }
+    }
+
+    expect(failures).toEqual([]);
+  });
+});

package/src/tests/tool_validation.test.ts

@@ -79,6 +79,7 @@ describe('Tool Validation Suite', () => {
                   'calculadora-oculares',
                   'planificador-pupila-salida-aumentos-telescopio',
                   'planificador-observacion-lluvia-meteoros',
+                  'planificador-apilado-exposiciones-astrofotografia',
                   'meteor-shower-observing-planner',
                 ];
                 expect(validSlugs).toContain(content.slug);
@@ -105,12 +106,12 @@ describe('Tool Validation Suite', () => {
   });
 
   describe('Library Registration', () => {
-    it('should have 7 tools in ALL_TOOLS', () => {
-      expect(ALL_TOOLS.length).toBe(7);
+    it('should have 8 tools in ALL_TOOLS', () => {
+      expect(ALL_TOOLS.length).toBe(8);
     });
 
     it('should have all tools in astronomyCategory', () => {
-      expect(astronomyCategory.tools.length).toBe(7);
+      expect(astronomyCategory.tools.length).toBe(8);
       ALL_TOOLS.forEach(({ entry }) => {
         const exists = astronomyCategory.tools.some((t: any) => t.id === entry.id);
         expect(exists).toBe(true);

package/src/tool/astrophotographyExposureStackPlanner/astrophotography-exposure-stacking-planner.css

@@ -0,0 +1,496 @@
+:root {
+  --n-base-night: #f4f1ea;
+  --n-base-paper: #fffdf8;
+  --n-base-ink: #202a2e;
+  --n-base-muted: #657276;
+  --n-base-line: #d8d5cc;
+  --n-base-blue: #2f6677;
+  --n-base-gold: #b67b2c;
+  --n-base-alert: #b65742;
+  --n-base-shadow: #c9c3b8;
+}
+
+.theme-dark {
+  --n-dark-night: #15191c;
+  --n-dark-paper: #20262a;
+  --n-dark-ink: #f1eee5;
+  --n-dark-muted: #aab4b4;
+  --n-dark-line: #3a4447;
+  --n-dark-blue: #8fc2ca;
+  --n-dark-gold: #e1ad5a;
+  --n-dark-alert: #ed987f;
+  --n-dark-shadow: #0a0d0e;
+}
+
+.astrophotography-exposure-stack-planner {
+  --n-night: var(--n-base-night);
+  --n-paper: var(--n-base-paper);
+  --n-ink: var(--n-base-ink);
+  --n-muted: var(--n-base-muted);
+  --n-line: var(--n-base-line);
+  --n-blue: var(--n-base-blue);
+  --n-gold: var(--n-base-gold);
+  --n-alert: var(--n-base-alert);
+  --n-shadow: var(--n-base-shadow);
+
+  display: grid;
+  grid-template-columns: minmax(260px, 0.8fr) minmax(0, 1.5fr);
+  min-height: 690px;
+  overflow: hidden;
+  border: 1px solid var(--n-line);
+  background-color: var(--n-night);
+  color: var(--n-ink);
+  box-shadow: 12px 12px 0 var(--n-shadow);
+  min-width: 0;
+}
+
+.theme-dark .astrophotography-exposure-stack-planner {
+  --n-night: var(--n-dark-night);
+  --n-paper: var(--n-dark-paper);
+  --n-ink: var(--n-dark-ink);
+  --n-muted: var(--n-dark-muted);
+  --n-line: var(--n-dark-line);
+  --n-blue: var(--n-dark-blue);
+  --n-gold: var(--n-dark-gold);
+  --n-alert: var(--n-dark-alert);
+  --n-shadow: var(--n-dark-shadow);
+}
+
+body:has(.astrophotography-exposure-stack-planner) .utility-header-title {
+  font-size: clamp(2.15rem, 6.5vw, 4.5rem);
+}
+
+body:has(.astrophotography-exposure-stack-planner) .utility-header-title > span {
+  min-width: 0;
+  max-width: 100%;
+  overflow-wrap: anywhere;
+  text-align: center;
+}
+
+body:has(.astrophotography-exposure-stack-planner) .utility-header-description {
+  width: 100%;
+  padding: 0 10px;
+}
+
+.exposure-planner-form {
+  min-width: 0;
+  padding: 30px 26px;
+  border-right: 1px solid var(--n-line);
+}
+
+.control-rail,
+.camera-fields,
+.choice-fieldset,
+.timing-fields {
+  display: grid;
+  gap: 16px;
+  border: 0;
+  margin: 0;
+  padding: 0;
+}
+
+.control-rail {
+  gap: 24px;
+}
+
+legend {
+  width: 100%;
+  margin-bottom: 2px;
+  color: var(--n-gold);
+  font-size: 0.7rem;
+  font-weight: 800;
+  letter-spacing: 0.14em;
+  text-transform: uppercase;
+}
+
+.camera-fields {
+  grid-template-columns: 1fr 1fr;
+  padding-bottom: 22px;
+  border-bottom: 1px solid var(--n-line);
+}
+
+.camera-fields legend {
+  grid-column: 1 / -1;
+}
+
+.timing-fields {
+  padding-top: 2px;
+}
+
+.field-control {
+  display: grid;
+  gap: 7px;
+  color: var(--n-ink);
+  font-size: 0.82rem;
+  font-weight: 700;
+}
+
+.field-control small {
+  color: var(--n-muted);
+  font-size: 0.68rem;
+  font-weight: 500;
+  line-height: 1.35;
+}
+
+input {
+  width: 100%;
+  min-height: 44px;
+  padding: 9px 10px;
+  border: 1px solid var(--n-line);
+  border-radius: 0;
+  background-color: var(--n-paper);
+  color: var(--n-ink);
+  font: inherit;
+  font-variant-numeric: tabular-nums;
+}
+
+input:focus-visible,
+button:focus-visible,
+summary:focus-visible {
+  outline: 3px solid var(--n-gold);
+  outline-offset: 2px;
+}
+
+.choice-grid {
+  min-width: 0;
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: 7px;
+}
+
+.sensor-grid {
+  grid-template-columns: 1fr 1fr;
+}
+
+button {
+  min-width: 0;
+  min-height: 40px;
+  padding: 8px 9px;
+  border: 1px solid var(--n-line);
+  border-radius: 0;
+  background-color: var(--n-paper);
+  color: var(--n-muted);
+  cursor: pointer;
+  font: inherit;
+  font-size: 0.7rem;
+  font-weight: 700;
+  line-height: 1.2;
+  overflow-wrap: anywhere;
+  transition: border-color 160ms ease, background-color 160ms ease, color 160ms ease;
+}
+
+button:hover,
+button.is-active {
+  border-color: var(--n-blue);
+  background-color: var(--n-blue);
+  color: var(--n-night);
+}
+
+.integration-field {
+  padding-top: 4px;
+}
+
+.exposure-result {
+  min-width: 0;
+  display: grid;
+  align-content: start;
+  gap: 24px;
+  padding: 30px 34px 28px;
+  background-color: var(--n-paper);
+}
+
+.result-topline,
+.timeline-header,
+.timeline-labels,
+.result-heading,
+.comparison-row,
+.metric-strip {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 16px;
+}
+
+.result-kicker {
+  color: var(--n-muted);
+  font-size: 0.68rem;
+  font-weight: 800;
+  letter-spacing: 0.16em;
+  text-transform: uppercase;
+}
+
+.status-pill {
+  max-width: 45%;
+  overflow-wrap: anywhere;
+  padding: 6px 9px;
+  border: 1px solid var(--n-gold);
+  color: var(--n-gold);
+  font-size: 0.66rem;
+  font-weight: 800;
+  text-transform: uppercase;
+}
+
+.status-pill[data-tone="critical"] {
+  border-color: var(--n-alert);
+  color: var(--n-alert);
+}
+
+.result-heading {
+  align-items: end;
+  padding-bottom: 24px;
+  border-bottom: 1px solid var(--n-line);
+}
+
+h2,
+h3,
+p {
+  margin: 0;
+}
+
+h2 {
+  max-width: 420px;
+  font-size: clamp(1.35rem, 3vw, 2.4rem);
+  line-height: 1;
+  letter-spacing: -0.04em;
+}
+
+.result-heading p {
+  max-width: 500px;
+  margin-top: 10px;
+  color: var(--n-muted);
+  font-size: 0.82rem;
+  line-height: 1.5;
+}
+
+.hero-output {
+  display: grid;
+  flex: 0 0 auto;
+  justify-items: end;
+  color: var(--n-blue);
+}
+
+.hero-output strong {
+  font-size: clamp(2.5rem, 7vw, 5.3rem);
+  font-weight: 800;
+  letter-spacing: -0.08em;
+  line-height: 0.85;
+  font-variant-numeric: tabular-nums;
+}
+
+.hero-output span {
+  margin-top: 8px;
+  color: var(--n-muted);
+  font-size: 0.72rem;
+  font-weight: 800;
+  letter-spacing: 0.12em;
+  text-transform: uppercase;
+}
+
+.timeline-panel {
+  display: grid;
+  gap: 13px;
+}
+
+h3 {
+  font-size: 0.82rem;
+  letter-spacing: 0.02em;
+}
+
+.timeline-header > span {
+  color: var(--n-muted);
+  font-size: 0.74rem;
+  font-variant-numeric: tabular-nums;
+}
+
+.timeline {
+  min-height: 88px;
+  padding: 20px 0;
+  border-top: 1px solid var(--n-line);
+  border-bottom: 1px solid var(--n-line);
+}
+
+.exposure-track {
+  display: flex;
+  align-items: stretch;
+  height: 47px;
+  gap: 3px;
+}
+
+.exposure-slice {
+  position: relative;
+  min-width: 7px;
+  background-color: var(--n-blue);
+  opacity: 0.55;
+}
+
+.exposure-slice::after {
+  position: absolute;
+  right: 2px;
+  bottom: 6px;
+  left: 2px;
+  height: 3px;
+  background-color: var(--n-gold);
+  content: '';
+}
+
+.exposure-slice.is-final {
+  background-color: var(--n-gold);
+  opacity: 1;
+}
+
+.exposure-slice.is-final::after {
+  background-color: var(--n-paper);
+}
+
+.timeline-labels {
+  color: var(--n-muted);
+  font-size: 0.68rem;
+}
+
+.metric-strip {
+  align-items: stretch;
+  border-bottom: 1px solid var(--n-line);
+}
+
+.metric-strip > div {
+  display: grid;
+  flex: 1;
+  gap: 7px;
+  padding: 0 16px 20px 0;
+  border-right: 1px solid var(--n-line);
+}
+
+.metric-strip > div + div {
+  padding-left: 16px;
+}
+
+.metric-strip > div:last-child {
+  border-right: 0;
+}
+
+.metric-strip span,
+.comparison-row span {
+  color: var(--n-muted);
+  font-size: 0.7rem;
+}
+
+.metric-strip strong,
+.comparison-row strong {
+  font-size: 1rem;
+  font-variant-numeric: tabular-nums;
+}
+
+.session-detail,
+.workload-note,
+.sensor-warning {
+  color: var(--n-muted);
+  font-size: 0.74rem;
+  line-height: 1.5;
+}
+
+.session-detail {
+  margin-top: -15px;
+}
+
+.workload-note,
+.sensor-warning {
+  padding: 13px 15px;
+  border-left: 3px solid var(--n-gold);
+  background-color: var(--n-night);
+}
+
+.sensor-warning {
+  border-left-color: var(--n-alert);
+}
+
+.comparison-panel {
+  display: grid;
+  gap: 11px;
+  padding: 17px;
+  border: 1px solid var(--n-line);
+}
+
+.comparison-panel h3 {
+  margin-bottom: 3px;
+  color: var(--n-gold);
+  font-size: 0.7rem;
+  letter-spacing: 0.14em;
+  text-transform: uppercase;
+}
+
+.comparison-row + .comparison-row {
+  padding-top: 10px;
+  border-top: 1px solid var(--n-line);
+}
+
+.method-details {
+  color: var(--n-muted);
+  font-size: 0.76rem;
+  line-height: 1.55;
+}
+
+.method-details summary {
+  color: var(--n-ink);
+  cursor: pointer;
+  font-weight: 800;
+}
+
+.method-details p {
+  margin-top: 10px;
+}
+
+.limits-note {
+  padding: 13px 15px;
+  border-left: 3px solid var(--n-alert);
+  background-color: var(--n-night);
+  color: var(--n-muted);
+  font-size: 0.74rem;
+  line-height: 1.5;
+}
+
+.limits-note strong {
+  color: var(--n-alert);
+}
+
+.limits-note p {
+  margin-top: 5px;
+}
+
+@media (max-width: 820px) {
+  .astrophotography-exposure-stack-planner {
+    grid-template-columns: 1fr;
+  }
+
+  .exposure-planner-form {
+    border-right: 0;
+    border-bottom: 1px solid var(--n-line);
+  }
+}
+
+@media (max-width: 520px) {
+  .exposure-planner-form,
+  .exposure-result {
+    padding: 23px 18px;
+  }
+
+  .camera-fields {
+    grid-template-columns: 1fr;
+  }
+
+  .camera-fields legend {
+    grid-column: auto;
+  }
+
+  .result-heading {
+    align-items: start;
+    flex-direction: column;
+  }
+
+  .result-topline {
+    align-items: flex-start;
+  }
+
+  .hero-output {
+    justify-items: start;
+  }
+}

package/src/tool/astrophotographyExposureStackPlanner/bibliography.astro

@@ -0,0 +1,14 @@
+---
+import { Bibliography as SharedBibliography } from '@jjlmoya/utils-shared';
+import { astrophotographyExposureStackPlanner } from './index';
+import type { KnownLocale } from '../../types';
+
+interface Props {
+  locale?: KnownLocale;
+}
+
+const { locale = 'en' } = Astro.props;
+const content = await astrophotographyExposureStackPlanner.i18n[locale]?.();
+---
+
+{content && <SharedBibliography links={content.bibliography} />}

package/src/tool/astrophotographyExposureStackPlanner/bibliography.ts

@@ -0,0 +1,12 @@
+import type { BibliographyEntry } from '../../types';
+
+export const ASTROPHOTOGRAPHY_EXPOSURE_BIBLIOGRAPHY: BibliographyEntry[] = [
+  {
+    name: 'Societe Astronomique du Havre, La Regle NPF',
+    url: 'https://sahavre.fr/wp/regle-npf-rule/',
+  },
+  {
+    name: 'NASA Science, Astrophotography With Your Smartphone',
+    url: 'https://science.nasa.gov/solar-system/skywatching/night-sky-network/astrophotography-with-your-smartphone/',
+  },
+];