@jjlmoya/utils-science 1.24.0 → 1.25.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@jjlmoya/utils-science",
-    "version": "1.24.0",
+    "version": "1.25.0",
     "type": "module",
     "main": "./src/index.ts",
     "types": "./src/index.ts",

package/src/category/index.ts

@@ -7,10 +7,11 @@ import { cellularRenewal } from '../tool/cellular-renewal/index';
 import { cosmicInflation } from '../tool/cosmic-inflation/index';
 import { temperatureTimeline } from '../tool/temperature-timeline/index';
 import { lorenzAttractor } from '../tool/lorenz-attractor/index';
+import { stellarHabitabilityZone } from '../tool/stellar-habitability-zone/index';
 
 export const scienceCategory: ScienceCategoryEntry = {
   icon: 'mdi:flask',
-  tools: [colonyCounter, asteroidImpact, microwaveDetector, simulationProbability, cellularRenewal, cosmicInflation, temperatureTimeline, lorenzAttractor],
+  tools: [colonyCounter, asteroidImpact, microwaveDetector, simulationProbability, cellularRenewal, cosmicInflation, temperatureTimeline, lorenzAttractor, stellarHabitabilityZone],
   i18n: {
     es: () => import('./i18n/es').then((m) => m.content),
     en: () => import('./i18n/en').then((m) => m.content),

package/src/entries.ts

@@ -7,6 +7,7 @@ export { simulationProbability } from './tool/simulation-probability/entry';
 export { cosmicInflation } from './tool/cosmic-inflation/entry';
 export { temperatureTimeline } from './tool/temperature-timeline/entry';
 export { lorenzAttractor } from './tool/lorenz-attractor/entry';
+export { stellarHabitabilityZone } from './tool/stellar-habitability-zone/entry';
 export { scienceCategory } from './category';
 import { asteroidImpact } from './tool/asteroid-impact/entry';
 import { cellularRenewal } from './tool/cellular-renewal/entry';
@@ -16,4 +17,5 @@ import { simulationProbability } from './tool/simulation-probability/entry';
 import { cosmicInflation } from './tool/cosmic-inflation/entry';
 import { temperatureTimeline } from './tool/temperature-timeline/entry';
 import { lorenzAttractor } from './tool/lorenz-attractor/entry';
-export const ALL_ENTRIES = [asteroidImpact, cellularRenewal, colonyCounter, microwaveDetector, simulationProbability, cosmicInflation, temperatureTimeline, lorenzAttractor];
+import { stellarHabitabilityZone } from './tool/stellar-habitability-zone/entry';
+export const ALL_ENTRIES = [asteroidImpact, cellularRenewal, colonyCounter, microwaveDetector, simulationProbability, cosmicInflation, temperatureTimeline, lorenzAttractor, stellarHabitabilityZone];

package/src/index.ts

@@ -8,6 +8,7 @@ export { CELLULAR_RENEWAL_TOOL } from './tool/cellular-renewal/index';
 export { COSMIC_INFLATION_TOOL } from './tool/cosmic-inflation/index';
 export { TEMPERATURE_TIMELINE_TOOL } from './tool/temperature-timeline/index';
 export { LORENZ_ATTRACTOR_TOOL } from './tool/lorenz-attractor/index';
+export { STELLAR_HABITABILITY_ZONE_TOOL } from './tool/stellar-habitability-zone/index';
 
 export type {
   KnownLocale,

package/src/tests/locale_completeness.test.ts

@@ -18,8 +18,8 @@ describe('Locale Completeness Validation', () => {
     });
   });
 
-  it('all 8 tools registered', () => {
-    expect(ALL_TOOLS.length).toBe(8);
+  it('all 9 tools registered', () => {
+    expect(ALL_TOOLS.length).toBe(9);
   });
 });
 

package/src/tests/tool_validation.test.ts

@@ -4,8 +4,8 @@ import { scienceCategory } from '../data';
 
 describe('Tool Validation Suite', () => {
   describe('Library Registration', () => {
-    it('should have 8 tools in ALL_TOOLS', () => {
-      expect(ALL_TOOLS.length).toBe(8);
+    it('should have 9 tools in ALL_TOOLS', () => {
+      expect(ALL_TOOLS.length).toBe(9);
     });
 
     it('scienceCategory should be defined', () => {

package/src/tool/lorenz-attractor/i18n/es.ts

@@ -33,6 +33,14 @@ const faq = [
   {
     "question": "Que representan Sigma, Rho y Beta?",
     "answer": "Sigma es el numero de Prandtl, Rho es el numero de Rayleigh y Beta es la relacion de aspecto geometrico del sistema."
+  },
+  {
+    "question": "Por que la forma del atractor parece una mariposa?",
+    "answer": "La iconica forma de alas dobles de mariposa surge porque el sistema tiene dos puntos de equilibrio inestables. La trayectoria orbita alrededor de un ala y luego transita de forma impredecible para orbitar la otra, creando la estructura distintiva en el espacio de fases tridimensional."
+  },
+  {
+    "question": "Es el Atractor de Lorenz verdaderamente aleatorio?",
+    "answer": "No. El sistema de Lorenz es completamente deterministico, lo que significa que su estado futuro esta totalmente definido por su estado actual y sus ecuaciones. Sin embargo, como es caotico, es completamente impredecible a largo plazo sin una precision infinita de las condiciones iniciales."
   }
 ];
 
@@ -56,10 +64,10 @@ export const content: ToolLocaleContent = {
   "trajectories": "Trayectorias",
   "distance": "Distancia de Divergencia",
   "exponentialGrowth": "Divergencia Exponencial",
-  "resetDefault": "Reset",
-  "clearPath": "Clear",
-  "play": "Resume",
-  "pause": "Pause",
+    "resetDefault": "Reiniciar",
+    "clearPath": "Limpiar",
+    "play": "Reanudar",
+    "pause": "Pausar",
   "coords": "Coordenadas",
   "divergenceExplanation": "El grafico de divergencia muestra la distancia euclidiana entre las dos trayectorias a lo largo del tiempo. Observa como aumenta exponencialmente."
 },

package/src/tool/lorenz-attractor/lorenz-attractor.css

@@ -11,7 +11,6 @@
   --lorenz-text-muted: #64748b;
   --lorenz-slider-track: #cbd5e1;
   --lorenz-shadow-color: rgba(0, 0, 0, 0.04);
-  --lorenz-font-mono: consolas, monaco, 'Courier New', monospace;
 }
 
 .theme-dark {
@@ -33,7 +32,7 @@
   width: 100%;
   max-width: 1200px;
   margin: 0 auto;
-  font: 14px Outfit, Inter, sans-serif;
+  font-size: 14px;
   color: var(--lorenz-text);
   box-sizing: border-box;
 }
@@ -60,13 +59,12 @@
 @media (min-width: 992px) {
   .lorenz-grid {
     grid-template-columns: 1.5fr 1fr;
-    align-items: stretch;
+    align-items: start;
   }
 
   .lorenz-canvas-container {
-    aspect-ratio: auto;
+    aspect-ratio: 4 / 3;
     min-height: 520px;
-    height: 100%;
   }
 
   .lorenz-controls-section {
@@ -160,12 +158,13 @@
 }
 
 .lorenz-slider-label {
-  font: 700 12px Outfit, Inter, sans-serif;
+  font-weight: 700;
+  font-size: 12px;
 }
 
 .lorenz-slider-val {
   color: var(--lorenz-primary);
-  font: 13px consolas, monaco, monospace;
+  font-size: 13px;
   font-variant-numeric: tabular-nums;
 }
 
@@ -261,12 +260,13 @@
 }
 
 .lorenz-coord-item {
-  font: 12px Outfit, Inter, sans-serif;
+  font-size: 12px;
   color: var(--lorenz-text-muted);
 }
 
 .lorenz-coord-val {
-  font: 600 14px consolas, monaco, monospace;
+  font-weight: 600;
+  font-size: 14px;
   font-variant-numeric: tabular-nums;
 }
 
@@ -279,7 +279,8 @@
 }
 
 .lorenz-divergence-title {
-  font: 700 12px Outfit, Inter, sans-serif;
+  font-weight: 700;
+  font-size: 12px;
   text-transform: uppercase;
   letter-spacing: 0.05em;
   color: var(--lorenz-text-muted);
@@ -292,7 +293,8 @@
 }
 
 .lorenz-divergence-num {
-  font: 750 2.8rem consolas, monaco, monospace;
+  font-weight: 750;
+  font-size: 2.8rem;
   line-height: 1;
   color: var(--lorenz-accent);
   font-variant-numeric: tabular-nums;
@@ -300,7 +302,8 @@
 }
 
 .lorenz-divergence-delta {
-  font: 700 14px consolas, monaco, monospace;
+  font-weight: 700;
+  font-size: 14px;
   color: var(--lorenz-text-muted);
   font-variant-numeric: tabular-nums;
 }
@@ -316,7 +319,8 @@
 .lorenz-chart-header {
   display: flex;
   align-items: center;
-  font: 700 12px Outfit, Inter, sans-serif;
+  font-weight: 700;
+  font-size: 12px;
   text-transform: uppercase;
   letter-spacing: 0.05em;
   color: var(--lorenz-text-muted);
@@ -337,7 +341,8 @@
   height: 14px;
   border-radius: 50%;
   border: 1px solid var(--lorenz-text-muted);
-  font: bold 9px consolas, monaco, monospace;
+  font-weight: bold;
+  font-size: 9px;
   color: var(--lorenz-text-muted);
 }
 
@@ -352,7 +357,7 @@
   text-align: center;
   padding: 8px 12px;
   border-radius: 8px;
-  font: 12px Outfit, Inter, sans-serif;
+  font-size: 12px;
   line-height: 1.3;
   width: 200px;
   z-index: 10;
@@ -400,32 +405,39 @@
     display: flex;
     flex-direction: column;
     height: 100%;
-    gap: 16px;
+    gap: 12px;
+    overflow: hidden;
   }
 
   .lorenz-canvas-container {
-    height: 43%;
+    height: 28%;
     flex-shrink: 0;
     aspect-ratio: auto;
+    min-height: 0;
   }
 
   .lorenz-controls-section {
-    height: 57%;
-    overflow-y: auto;
+    flex: 1;
     display: flex;
     flex-direction: column;
-    gap: 20px;
+    gap: 6px;
+    overflow: hidden;
     padding-right: 4px;
+    min-height: 0;
   }
 
   .lorenz-slider-group {
-    padding-left: 24px;
-    padding-right: 24px;
+    padding-left: 12px;
+    padding-right: 12px;
+  }
+
+  .lorenz-slider {
+    height: 28px;
   }
 
   .lorenz-button-row {
     grid-template-columns: 2fr 1fr 1fr;
-    gap: 12px;
+    gap: 6px;
     order: 4;
   }
 
@@ -433,21 +445,40 @@
     order: 1;
     border-top: none;
     padding-top: 0;
+    gap: 4px;
   }
 
   .lorenz-chart-block {
     order: 2;
     border-top: none;
     padding-top: 0;
+    gap: 4px;
   }
 
   .lorenz-chart-canvas-wrapper {
-    height: 56px;
+    height: 40px;
   }
 
   .lorenz-sliders-block {
     order: 3;
+    display: grid;
+    grid-template-columns: 1fr 1fr;
+    gap: 4px;
     border-top: 1px solid var(--lorenz-border);
-    padding-top: 16px;
+    padding-top: 8px;
+  }
+
+  .lorenz-slider-group:nth-child(5) {
+    grid-column: 1 / -1;
+  }
+
+  .lorenz-divergence-display {
+    margin-top: 6px;
+    margin-bottom: 6px;
+    gap: 4px;
+  }
+
+  .lorenz-divergence-num {
+    font-size: 1.5rem;
   }
 }

package/src/tool/stellar-habitability-zone/bibliography.astro

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

package/src/tool/stellar-habitability-zone/bibliography.ts

@@ -0,0 +1,12 @@
+import type { BibliographyEntry } from '../../types';
+
+export const bibliography: BibliographyEntry[] = [
+  {
+    name: 'Habitable Zones Around Main-Sequence Stars: New Estimates',
+    url: 'https://arxiv.org/abs/1301.6674',
+  },
+  {
+    name: 'Habitable Zones Around Main-Sequence Stars: Dependence on Planetary Mass',
+    url: 'https://iopscience.iop.org/article/10.1088/2041-8205/787/2/L29',
+  },
+];

package/src/tool/stellar-habitability-zone/component.astro

@@ -0,0 +1,123 @@
+---
+import './stellar-habitability-zone.css';
+
+interface Props {
+  ui: Record<string, string>;
+}
+
+const { ui } = Astro.props;
+---
+
+<div class="hz-calculator-root" id="hz-simulator-root">
+  <div class="hz-presets-container">
+    <div class="hz-presets">
+      <button class="hz-preset-btn active" data-type="G">G-Type (Sun-like)</button>
+      <button class="hz-preset-btn" data-type="M">M-Type (Red Dwarf)</button>
+      <button class="hz-preset-btn" data-type="K">K-Type (Orange Dwarf)</button>
+      <button class="hz-preset-btn" data-type="F">F-Type (Procyon-like)</button>
+      <button class="hz-preset-btn" data-type="A">A-Type (Sirius-like)</button>
+      <button class="hz-preset-btn" data-type="B">B-Type (Blue Giant)</button>
+      <button class="hz-preset-btn" data-type="O">O-Type (Blue Hypergiant)</button>
+      <div style="flex-grow: 1;"></div>
+      <button class="hz-preset-btn" id="hz-unit-toggle" style="opacity: 0.8; border-bottom: none;"></button>
+    </div>
+  </div>
+
+  <div class="hz-controls-section">
+    <div class="hz-input-group">
+      <label for="hz-temperature">{ui.starTemperature}</label>
+      <input type="range" id="hz-temperature" class="hz-slider" min="2000" max="50000" value="5778" step="100" />
+      <span id="hz-temperature-val" class="hz-input-val">5,778</span>
+    </div>
+
+    <div class="hz-input-group">
+      <label for="hz-luminosity">{ui.starLuminosity}</label>
+      <input type="range" id="hz-luminosity" class="hz-slider" min="-4" max="6" value="0" step="0.1" />
+      <span id="hz-luminosity-val" class="hz-input-val">1.0</span>
+    </div>
+
+    <div class="hz-input-group">
+      <label for="hz-mass">{ui.starMass}</label>
+      <input type="range" id="hz-mass" class="hz-slider" min="0.05" max="100" value="1.0" step="0.05" />
+      <span id="hz-mass-val" class="hz-input-val">1.0</span>
+    </div>
+
+    <div class="hz-input-group">
+      <label for="hz-radius">{ui.starRadius}</label>
+      <input type="range" id="hz-radius" class="hz-slider" min="0.05" max="30" value="1.0" step="0.05" />
+      <span id="hz-radius-val" class="hz-input-val">1.0</span>
+    </div>
+
+    <div class="hz-input-group">
+      <label for="hz-distance">{ui.planetDistance}</label>
+      <input type="range" id="hz-distance" class="hz-slider" min="-2" max="3" value="0" step="0.01" />
+      <span id="hz-distance-val" class="hz-input-val">1.00</span>
+    </div>
+
+    <div class="hz-input-group">
+      <label for="hz-albedo">{ui.planetAlbedo}</label>
+      <input type="range" id="hz-albedo" class="hz-slider" min="0.00" max="0.95" value="0.30" step="0.01" />
+      <span id="hz-albedo-val" class="hz-input-val">0.30</span>
+    </div>
+
+    <div class="hz-input-group">
+      <label for="hz-greenhouse">{ui.greenhouseDelta}</label>
+      <input type="range" id="hz-greenhouse" class="hz-slider" min="0" max="500" value="33" step="1" />
+      <span id="hz-greenhouse-val" class="hz-input-val">33</span>
+    </div>
+  </div>
+
+  <div class="hz-viewport-container">
+    <canvas id="hz-orbit-canvas"></canvas>
+    <div class="hz-canvas-section">
+      <h3>{ui.orbitCanvasTitle}</h3>
+      <div class="hz-canvas-container" id="hz-canvas-placeholder">
+      </div>
+    </div>
+
+    <div class="hz-results-section">
+      <div class="hz-result-grid">
+        <div class="hz-result-block">
+          <span class="hz-result-label">{ui.equilibriumTemperature}</span>
+          <span id="hz-eq-temp" class="hz-result-number">---</span>
+        </div>
+        <div class="hz-result-block">
+          <span class="hz-result-label">{ui.estimatedSurfaceTemp || ui.surfTempResult}</span>
+          <span id="hz-surf-temp" class="hz-result-number">---</span>
+        </div>
+        <div class="hz-result-block">
+          <span class="hz-result-label">{ui.stellarFluxResult}</span>
+          <span id="hz-stellar-flux" class="hz-result-number">---</span>
+        </div>
+        <div class="hz-result-block">
+          <span class="hz-result-label">{ui.orbitPeriodResult}</span>
+          <span id="hz-orbit-period" class="hz-result-number">---</span>
+        </div>
+        <div class="hz-result-block">
+          <span class="hz-result-label">{ui.orbitVelocityResult}</span>
+          <span id="hz-orbit-velocity" class="hz-result-number">---</span>
+        </div>
+        <div class="hz-result-block">
+          <span class="hz-result-label">{ui.innerLimit}</span>
+          <span id="hz-inner-limit" class="hz-result-number">---</span>
+        </div>
+        <div class="hz-result-block">
+          <span class="hz-result-label">{ui.outerLimit}</span>
+          <span id="hz-outer-limit" class="hz-result-number">---</span>
+        </div>
+      </div>
+
+      <div>
+        <div class="hz-status-box habitable" id="hz-status-box">
+          <div class="hz-status-title" id="hz-status-title">---</div>
+          <div class="hz-status-desc">{ui.statusExplanation}</div>
+        </div>
+      </div>
+    </div>
+  </div>
+</div>
+
+<script>
+  import { initStellarSimulator } from './script';
+  initStellarSimulator();
+</script>

package/src/tool/stellar-habitability-zone/dom-updater.ts

@@ -0,0 +1,94 @@
+import type { SimulationResult } from './logic/StellarHabitabilityEngine';
+
+export interface UpdateValTextsParams {
+  temp: number;
+  luminosity: number;
+  mass: number;
+  radius: number;
+  distanceAu: number;
+  albedo: number;
+  greenhouse: number;
+  isImperial: boolean;
+  tempVal: HTMLElement | null;
+  lumVal: HTMLElement | null;
+  massVal: HTMLElement | null;
+  radVal: HTMLElement | null;
+  distVal: HTMLElement | null;
+  albedoVal: HTMLElement | null;
+  greenVal: HTMLElement | null;
+}
+
+export interface UpdateResultsParams {
+  result: SimulationResult;
+  isImperial: boolean;
+  eqTempResult: HTMLElement | null;
+  surfTempResult: HTMLElement | null;
+  fluxResult: HTMLElement | null;
+  periodResult: HTMLElement | null;
+  velocityResult: HTMLElement | null;
+  innerResult: HTMLElement | null;
+  outerResult: HTMLElement | null;
+}
+
+function setText(el: HTMLElement | null, text: string) {
+  if (el) {
+    el.textContent = text;
+  }
+}
+
+export function updateSliderFill(slider: HTMLInputElement | null) {
+  if (!slider) return;
+  const min = parseFloat(slider.min) || 0;
+  const max = parseFloat(slider.max) || 100;
+  const val = parseFloat(slider.value) || 0;
+  const percentage = ((val - min) / (max - min)) * 100;
+  slider.style.setProperty('--percent', `${percentage}%`);
+  slider.style.background = `linear-gradient(to right, var(--hz-slider-active) 0%, var(--hz-slider-active) ${percentage}%, var(--hz-slider-track) ${percentage}%, var(--hz-slider-track) 100%)`;
+}
+
+export function updateValTexts(p: UpdateValTextsParams) {
+  setText(p.tempVal, p.temp.toLocaleString());
+  setText(p.lumVal, p.luminosity >= 100 || p.luminosity <= 0.01 ? p.luminosity.toExponential(2) : p.luminosity.toFixed(2));
+  setText(p.massVal, p.mass.toFixed(2));
+  setText(p.radVal, p.radius.toFixed(2));
+  const dist = p.isImperial ? `${(p.distanceAu * 92.9558).toFixed(1)} Mmi` : `${p.distanceAu.toFixed(2)} AU`;
+  setText(p.distVal, dist);
+  setText(p.albedoVal, p.albedo.toFixed(2));
+  setText(p.greenVal, p.greenhouse.toString());
+}
+
+export function updateResults(p: UpdateResultsParams) {
+  const isImp = p.isImperial;
+  const res = p.result;
+  const eq = isImp 
+    ? `${Math.round((res.equilibriumTemperature - 273.15) * 1.8 + 32)}°F` 
+    : `${Math.round(res.equilibriumTemperature - 273.15)}°C (${Math.round(res.equilibriumTemperature)}K)`;
+  setText(p.eqTempResult, eq);
+
+  const surf = isImp 
+    ? `${Math.round((res.surfaceTemperature - 273.15) * 1.8 + 32)}°F` 
+    : `${Math.round(res.surfaceTemperature - 273.15)}°C (${Math.round(res.surfaceTemperature)}K)`;
+  setText(p.surfTempResult, surf);
+
+  setText(p.fluxResult, `${res.stellarFlux.toFixed(2)} S⊕`);
+
+  const period = res.orbitalPeriod >= 365 
+    ? `${(res.orbitalPeriod / 365.255).toFixed(1)} yr` 
+    : `${Math.round(res.orbitalPeriod)} d`;
+  setText(p.periodResult, period);
+
+  const vel = isImp 
+    ? `${Math.round(res.orbitalVelocity * 2236.936).toLocaleString()} mph` 
+    : `${res.orbitalVelocity.toFixed(1)} km/s`;
+  setText(p.velocityResult, vel);
+
+  const inner = isImp 
+    ? `${(res.hzLimits.runawayGreenhouse * 92.9558).toFixed(1)} Mmi` 
+    : `${res.hzLimits.runawayGreenhouse.toFixed(2)} AU`;
+  setText(p.innerResult, inner);
+
+  const outer = isImp 
+    ? `${(res.hzLimits.maximumGreenhouse * 92.9558).toFixed(1)} Mmi` 
+    : `${res.hzLimits.maximumGreenhouse.toFixed(2)} AU`;
+  setText(p.outerResult, outer);
+}

package/src/tool/stellar-habitability-zone/entry.ts

@@ -0,0 +1,26 @@
+import type { ScienceToolEntry } from '../../types';
+
+export const stellarHabitabilityZone: ScienceToolEntry = {
+  id: 'stellar-habitability-zone',
+  icons: {
+    bg: 'mdi:star-circle-outline',
+    fg: 'mdi:orbit',
+  },
+  i18n: {
+    de: () => import('./i18n/de').then((m) => m.content),
+    en: () => import('./i18n/en').then((m) => m.content),
+    es: () => import('./i18n/es').then((m) => m.content),
+    fr: () => import('./i18n/fr').then((m) => m.content),
+    id: () => import('./i18n/id').then((m) => m.content),
+    it: () => import('./i18n/it').then((m) => m.content),
+    ja: () => import('./i18n/ja').then((m) => m.content),
+    ko: () => import('./i18n/ko').then((m) => m.content),
+    nl: () => import('./i18n/nl').then((m) => m.content),
+    pl: () => import('./i18n/pl').then((m) => m.content),
+    pt: () => import('./i18n/pt').then((m) => m.content),
+    ru: () => import('./i18n/ru').then((m) => m.content),
+    sv: () => import('./i18n/sv').then((m) => m.content),
+    tr: () => import('./i18n/tr').then((m) => m.content),
+    zh: () => import('./i18n/zh').then((m) => m.content),
+  },
+};