@jjlmoya/utils-astronomy 1.34.1 → 1.36.0

package/package.json

@@ -1,66 +1,66 @@
-{
-    "name": "@jjlmoya/utils-astronomy",
-    "version": "1.34.1",
-    "type": "module",
-    "main": "./src/index.ts",
-    "types": "./src/index.ts",
-    "exports": {
-        ".": "./src/index.ts",
-        "./data": "./src/data.ts",
-        "./entries": "./src/entries.ts",
-        "./runtime/*": "./src/tool/*/index.ts",
-        "./category-seo": "./src/category/seo.astro"
-    },
-    "files": [
-        "src",
-        "scripts"
-    ],
-    "publishConfig": {
-        "access": "public"
-    },
-    "scripts": {
-        "dev": "astro dev",
-        "start": "astro dev",
-        "build": "astro build",
-        "preview": "astro preview",
-        "astro": "astro",
-        "lint": "eslint src/ --max-warnings 0 && stylelint \"src/**/*.{css,astro}\"",
-        "check": "astro check",
-        "type-check": "astro check",
-        "test": "vitest run --reporter=verbose --testTimeout=30000",
-        "preversion": "npm run lint && npm run test && npm run build",
-        "postversion": "git push && git push --tags",
-        "patch": "npm version patch",
-        "minor": "npm version minor",
-        "major": "npm version major",
-        "postinstall": "node scripts/postinstall.mjs"
-    },
-    "lint-staged": {
-        "*.{ts,tsx,astro}": [
-            "eslint --fix"
-        ]
-    },
-    "dependencies": {
-        "@iconify-json/mdi": "^1.2.3",
-        "@jjlmoya/prompagate": "^1.1.0",
-        "@jjlmoya/utils-shared": "1.2.0",
-        "astro": "^6.1.2",
-        "astro-icon": "^1.1.0"
-    },
-    "devDependencies": {
-        "@astrojs/check": "^0.9.8",
-        "eslint": "^9.39.4",
-        "eslint-plugin-astro": "^1.6.0",
-        "eslint-plugin-no-comments": "^1.1.10",
-        "husky": "^9.1.7",
-        "lint-staged": "^16.4.0",
-        "postcss-html": "^1.8.1",
-        "schema-dts": "^1.1.2",
-        "stylelint": "^17.6.0",
-        "stylelint-config-standard": "^40.0.0",
-        "stylelint-declaration-strict-value": "^1.11.1",
-        "typescript": "^5.4.0",
-        "typescript-eslint": "^8.58.0",
-        "vitest": "^4.1.2"
-    }
-}
+{
+    "name": "@jjlmoya/utils-astronomy",
+    "version": "1.36.0",
+    "type": "module",
+    "main": "./src/index.ts",
+    "types": "./src/index.ts",
+    "exports": {
+        ".": "./src/index.ts",
+        "./data": "./src/data.ts",
+        "./entries": "./src/entries.ts",
+        "./runtime/*": "./src/tool/*/index.ts",
+        "./category-seo": "./src/category/seo.astro"
+    },
+    "files": [
+        "src",
+        "scripts"
+    ],
+    "publishConfig": {
+        "access": "public"
+    },
+    "scripts": {
+        "dev": "astro dev",
+        "start": "astro dev",
+        "build": "astro build",
+        "preview": "astro preview",
+        "astro": "astro",
+        "lint": "eslint src/ --max-warnings 0 && stylelint \"src/**/*.{css,astro}\"",
+        "check": "astro check",
+        "type-check": "astro check",
+        "test": "vitest run --reporter=verbose --testTimeout=30000",
+        "preversion": "npm run lint && npm run test && npm run build",
+        "postversion": "git push && git push --tags",
+        "patch": "npm version patch",
+        "minor": "npm version minor",
+        "major": "npm version major",
+        "postinstall": "node scripts/postinstall.mjs"
+    },
+    "lint-staged": {
+        "*.{ts,tsx,astro}": [
+            "eslint --fix"
+        ]
+    },
+    "dependencies": {
+        "@iconify-json/mdi": "^1.2.3",
+        "@jjlmoya/prompagate": "^1.1.0",
+        "@jjlmoya/utils-shared": "1.2.0",
+        "astro": "^6.1.2",
+        "astro-icon": "^1.1.0"
+    },
+    "devDependencies": {
+        "@astrojs/check": "^0.9.8",
+        "eslint": "^9.39.4",
+        "eslint-plugin-astro": "^1.6.0",
+        "eslint-plugin-no-comments": "^1.1.10",
+        "husky": "^9.1.7",
+        "lint-staged": "^16.4.0",
+        "postcss-html": "^1.8.1",
+        "schema-dts": "^1.1.2",
+        "stylelint": "^17.6.0",
+        "stylelint-config-standard": "^40.0.0",
+        "stylelint-declaration-strict-value": "^1.11.1",
+        "typescript": "^5.4.0",
+        "typescript-eslint": "^8.58.0",
+        "vitest": "^4.1.2"
+    }
+}

package/src/category/index.ts

@@ -6,10 +6,11 @@ import { telescopeResolution } from '../tool/telescopeResolution/entry';
 import { eyepieceCalculator } from '../tool/smartEyepieceCalculator/entry';
 import { telescopeExitPupilPlanner } from '../tool/telescopeExitPupilPlanner/entry';
 import { meteorShowerObservingPlanner } from '../tool/meteorShowerObservingPlanner/entry';
+import { astrophotographyExposureStackPlanner } from '../tool/astrophotographyExposureStackPlanner/entry';
 
 export const toolsCategory: AstronomyCategoryEntry = {
   icon: 'mdi:telescope',
-  tools: [bortleVisualizer, deepSpaceScope, starExposureCalculator, telescopeResolution, eyepieceCalculator, telescopeExitPupilPlanner, meteorShowerObservingPlanner],
+  tools: [bortleVisualizer, deepSpaceScope, starExposureCalculator, telescopeResolution, eyepieceCalculator, telescopeExitPupilPlanner, meteorShowerObservingPlanner, astrophotographyExposureStackPlanner],
   i18n: {
     de: () => import('./i18n/de').then((m) => m.content),
     en: () => import('./i18n/en').then((m) => m.content),

package/src/entries.ts

@@ -12,6 +12,8 @@ export { telescopeExitPupilPlanner } from './tool/telescopeExitPupilPlanner/entr
 export type { TelescopeExitPupilPlannerUI, TelescopeExitPupilPlannerLocaleContent } from './tool/telescopeExitPupilPlanner/entry';
 export { meteorShowerObservingPlanner } from './tool/meteorShowerObservingPlanner/entry';
 export type { MeteorShowerObservingPlannerUI, MeteorShowerObservingPlannerLocaleContent } from './tool/meteorShowerObservingPlanner/entry';
+export { astrophotographyExposureStackPlanner } from './tool/astrophotographyExposureStackPlanner/entry';
+export type { ExposurePlannerUI, ExposurePlannerLocaleContent } from './tool/astrophotographyExposureStackPlanner/entry';
 export { toolsCategory, astronomyCategory } from './category';
 import { bortleVisualizer } from './tool/bortleVisualizer/entry';
 import { deepSpaceScope } from './tool/deepSpaceScope/entry';
@@ -20,5 +22,5 @@ import { telescopeResolution } from './tool/telescopeResolution/entry';
 import { eyepieceCalculator } from './tool/smartEyepieceCalculator/entry';
 import { telescopeExitPupilPlanner } from './tool/telescopeExitPupilPlanner/entry';
 import { meteorShowerObservingPlanner } from './tool/meteorShowerObservingPlanner/entry';
-export const ALL_ENTRIES = [bortleVisualizer, deepSpaceScope, starExposureCalculator, telescopeResolution, eyepieceCalculator, telescopeExitPupilPlanner, meteorShowerObservingPlanner];
-
+import { astrophotographyExposureStackPlanner } from './tool/astrophotographyExposureStackPlanner/entry';
+export const ALL_ENTRIES = [bortleVisualizer, deepSpaceScope, starExposureCalculator, telescopeResolution, eyepieceCalculator, telescopeExitPupilPlanner, meteorShowerObservingPlanner, astrophotographyExposureStackPlanner];

package/src/index.ts

@@ -2,7 +2,8 @@ export * from './tool/bortleVisualizer';
 export * from './tool/deepSpaceScope';
 export * from './tool/starExposureCalculator';
 export * from './tool/telescopeResolution';
-export * from './tool/meteorShowerObservingPlanner';
+export * from './tool/meteorShowerObservingPlanner';
+export * from './tool/astrophotographyExposureStackPlanner';
 
 export { toolsCategory as astronomyCategory } from './category';
 export const AstronomyCategorySEO = () => import('./category/seo.astro').then((m) => m.default);

package/src/tests/locale_completeness.test.ts

@@ -2,7 +2,7 @@ import { describe, it, expect } from 'vitest';
 import { ALL_TOOLS } from '../tools';
 
 describe('Locale Completeness Validation', () => {
-  it('all 7 tools registered', () => {
-    expect(ALL_TOOLS.length).toBe(7);
+  it('all 8 tools registered', () => {
+    expect(ALL_TOOLS.length).toBe(8);
   });
 });

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;
+  }
+}