@jjlmoya/utils-science 1.36.0 → 1.38.0

package/package.json

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

package/src/category/index.ts

@@ -11,16 +11,19 @@ import { stellarHabitabilityZone } from '../tool/stellar-habitability-zone/index
 import { radioactiveDecay } from '../tool/radioactive-decay/index';
 import { naturalSelectionDrift } from '../tool/natural-selection-drift/index';
 import { entropySecondLaw } from '../tool/entropy-second-law/index';
+import { doubleSlitDecoherence } from '../tool/double-slit-decoherence/index';
 import { phaseDiagramCriticalPoints } from '../tool/phase-diagram-critical-points/index';
 import { twinParadoxVisualizer } from '../tool/twin-paradox-visualizer/index';
 import { mandelbrotFractal } from '../tool/mandelbrot-fractal/index';
 import { planetAtmosphereSurvival } from '../tool/planet-atmosphere-survival/index';
 import { threeBodyProblem } from '../tool/three-body-problem/index';
 import { rocheLimitSatelliteDisruption } from '../tool/roche-limit-satellite-disruption/index';
+import { dysonSphereEnergyCapture } from '../tool/dyson-sphere-energy-capture/index';
+import { globalAlbedoSnowballSimulator } from '../tool/global-albedo-snowball-simulator/index';
 
 export const scienceCategory: ScienceCategoryEntry = {
   icon: 'mdi:flask',
-  tools: [colonyCounter, asteroidImpact, microwaveDetector, simulationProbability, cellularRenewal, cosmicInflation, temperatureTimeline, lorenzAttractor, stellarHabitabilityZone, radioactiveDecay, naturalSelectionDrift, entropySecondLaw, phaseDiagramCriticalPoints, twinParadoxVisualizer, mandelbrotFractal, planetAtmosphereSurvival, threeBodyProblem, rocheLimitSatelliteDisruption],
+  tools: [colonyCounter, asteroidImpact, microwaveDetector, simulationProbability, cellularRenewal, cosmicInflation, temperatureTimeline, lorenzAttractor, stellarHabitabilityZone, radioactiveDecay, naturalSelectionDrift, entropySecondLaw, doubleSlitDecoherence, phaseDiagramCriticalPoints, twinParadoxVisualizer, mandelbrotFractal, planetAtmosphereSurvival, threeBodyProblem, rocheLimitSatelliteDisruption, dysonSphereEnergyCapture, globalAlbedoSnowballSimulator],
   i18n: {
     es: () => import('./i18n/es').then((m) => m.content),
     en: () => import('./i18n/en').then((m) => m.content),

package/src/entries.ts

@@ -11,12 +11,15 @@ export { stellarHabitabilityZone } from './tool/stellar-habitability-zone/entry'
 export { radioactiveDecay } from './tool/radioactive-decay/entry';
 export { naturalSelectionDrift } from './tool/natural-selection-drift/entry';
 export { entropySecondLaw } from './tool/entropy-second-law/entry';
+export { doubleSlitDecoherence } from './tool/double-slit-decoherence/entry';
 export { phaseDiagramCriticalPoints } from './tool/phase-diagram-critical-points/entry';
 export { twinParadoxVisualizer } from './tool/twin-paradox-visualizer/entry';
 export { mandelbrotFractal } from './tool/mandelbrot-fractal/entry';
 export { planetAtmosphereSurvival } from './tool/planet-atmosphere-survival/entry';
 export { threeBodyProblem } from './tool/three-body-problem/entry';
 export { rocheLimitSatelliteDisruption } from './tool/roche-limit-satellite-disruption/entry';
+export { dysonSphereEnergyCapture } from './tool/dyson-sphere-energy-capture/entry';
+export { globalAlbedoSnowballSimulator } from './tool/global-albedo-snowball-simulator/entry';
 export { scienceCategory } from './category';
 import { asteroidImpact } from './tool/asteroid-impact/entry';
 import { cellularRenewal } from './tool/cellular-renewal/entry';
@@ -30,10 +33,13 @@ import { stellarHabitabilityZone } from './tool/stellar-habitability-zone/entry'
 import { radioactiveDecay } from './tool/radioactive-decay/entry';
 import { naturalSelectionDrift } from './tool/natural-selection-drift/entry';
 import { entropySecondLaw } from './tool/entropy-second-law/entry';
+import { doubleSlitDecoherence } from './tool/double-slit-decoherence/entry';
 import { phaseDiagramCriticalPoints } from './tool/phase-diagram-critical-points/entry';
 import { twinParadoxVisualizer } from './tool/twin-paradox-visualizer/entry';
 import { mandelbrotFractal } from './tool/mandelbrot-fractal/entry';
 import { planetAtmosphereSurvival } from './tool/planet-atmosphere-survival/entry';
 import { threeBodyProblem } from './tool/three-body-problem/entry';
 import { rocheLimitSatelliteDisruption } from './tool/roche-limit-satellite-disruption/entry';
-export const ALL_ENTRIES = [asteroidImpact, cellularRenewal, colonyCounter, microwaveDetector, simulationProbability, cosmicInflation, temperatureTimeline, lorenzAttractor, stellarHabitabilityZone, radioactiveDecay, naturalSelectionDrift, entropySecondLaw, phaseDiagramCriticalPoints, twinParadoxVisualizer, mandelbrotFractal, planetAtmosphereSurvival, threeBodyProblem, rocheLimitSatelliteDisruption];
+import { dysonSphereEnergyCapture } from './tool/dyson-sphere-energy-capture/entry';
+import { globalAlbedoSnowballSimulator } from './tool/global-albedo-snowball-simulator/entry';
+export const ALL_ENTRIES = [asteroidImpact, cellularRenewal, colonyCounter, microwaveDetector, simulationProbability, cosmicInflation, temperatureTimeline, lorenzAttractor, stellarHabitabilityZone, radioactiveDecay, naturalSelectionDrift, entropySecondLaw, doubleSlitDecoherence, phaseDiagramCriticalPoints, twinParadoxVisualizer, mandelbrotFractal, planetAtmosphereSurvival, threeBodyProblem, rocheLimitSatelliteDisruption, dysonSphereEnergyCapture, globalAlbedoSnowballSimulator];

package/src/index.ts

@@ -12,12 +12,15 @@ export { STELLAR_HABITABILITY_ZONE_TOOL } from './tool/stellar-habitability-zone
 export { RADIOACTIVE_DECAY_TOOL } from './tool/radioactive-decay/index';
 export { NATURAL_SELECTION_DRIFT_TOOL } from './tool/natural-selection-drift/index';
 export { ENTROPY_SECOND_LAW_TOOL } from './tool/entropy-second-law/index';
+export { DOUBLE_SLIT_DECOHERENCE_TOOL } from './tool/double-slit-decoherence/index';
 export { PHASE_DIAGRAM_CRITICAL_POINTS_TOOL } from './tool/phase-diagram-critical-points/index';
 export { TWIN_PARADOX_VISUALIZER_TOOL } from './tool/twin-paradox-visualizer/index';
 export { MANDELBROT_FRACTAL_TOOL } from './tool/mandelbrot-fractal/index';
 export { PLANET_ATMOSPHERE_SURVIVAL_TOOL } from './tool/planet-atmosphere-survival/index';
 export { THREE_BODY_PROBLEM_TOOL } from './tool/three-body-problem/index';
 export { ROCHE_LIMIT_SATELLITE_DISRUPTION_TOOL } from './tool/roche-limit-satellite-disruption/index';
+export { DYSON_SPHERE_ENERGY_CAPTURE_TOOL } from './tool/dyson-sphere-energy-capture/index';
+export { GLOBAL_ALBEDO_SNOWBALL_SIMULATOR_TOOL } from './tool/global-albedo-snowball-simulator/index';
 
 export type {
   KnownLocale,

package/src/tests/locale_completeness.test.ts

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

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 18 tools in ALL_TOOLS', () => {
-      expect(ALL_TOOLS.length).toBe(18);
+    it('should have 20 tools in ALL_TOOLS', () => {
+      expect(ALL_TOOLS.length).toBe(21);
     });
 
     it('scienceCategory should be defined', () => {

package/src/tool/double-slit-decoherence/bibliography.astro

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

package/src/tool/double-slit-decoherence/bibliography.ts

@@ -0,0 +1,12 @@
+import type { BibliographyEntry } from '../../types';
+
+export const bibliography: BibliographyEntry[] = [
+  {
+    name: 'Feynman Lectures on Physics, Volume III, Chapter 1: Quantum Behavior',
+    url: 'https://www.feynmanlectures.caltech.edu/III_01.html',
+  },
+  {
+    name: 'Decoherence, the measurement problem, and interpretations of quantum mechanics',
+    url: 'https://arxiv.org/abs/quant-ph/0312059',
+  },
+];

package/src/tool/double-slit-decoherence/component.astro

@@ -0,0 +1,235 @@
+---
+import './double-slit-decoherence-simulator.css';
+
+interface Props {
+  ui: Record<string, string>;
+}
+
+const { ui } = Astro.props;
+---
+
+<div class="dslit-lab" id="dslit-lab">
+  <section class="dslit-stage" aria-label={ui.stage}>
+    <div class="dslit-apparatus">
+      <canvas id="dslit-canvas" width="860" height="520"></canvas>
+      <div class="dslit-source" aria-hidden="true"></div>
+      <div class="dslit-barrier" aria-hidden="true">
+        <span></span>
+        <i></i>
+        <span></span>
+        <i></i>
+        <span></span>
+      </div>
+      <div class="dslit-screen" aria-hidden="true"></div>
+    </div>
+
+    <div class="dslit-mode-strip">
+      <span>{ui.unobserved}</span>
+      <strong id="dslit-state-label" data-wave={ui.waveMode} data-particle={ui.particleMode}>{ui.waveMode}</strong>
+      <span>{ui.observed}</span>
+    </div>
+  </section>
+
+  <section class="dslit-panel" aria-label={ui.controls}>
+    <div class="dslit-kicker">{ui.kicker}</div>
+    <label class="dslit-toggle">
+      <input id="dslit-detector-enabled" type="checkbox" />
+      <span>{ui.detectorToggle}</span>
+    </label>
+
+    <label class="dslit-field" for="dslit-detector">
+      <span>{ui.detectorStrength}</span>
+      <output id="dslit-detector-output">0%</output>
+      <input id="dslit-detector" type="range" min="0" max="100" step="1" value="0" />
+    </label>
+
+    <label class="dslit-field" for="dslit-separation">
+      <span>{ui.slitSeparation}</span>
+      <output id="dslit-separation-output">1.80</output>
+      <input id="dslit-separation" type="range" min="80" max="280" step="5" value="180" />
+    </label>
+
+    <label class="dslit-field" for="dslit-width">
+      <span>{ui.slitWidth}</span>
+      <output id="dslit-width-output">0.42</output>
+      <input id="dslit-width" type="range" min="16" max="90" step="2" value="42" />
+    </label>
+  </section>
+
+  <section class="dslit-readout" aria-label={ui.results}>
+    <article>
+      <span>{ui.fringeVisibility}</span>
+      <strong id="dslit-visibility">1.00</strong>
+    </article>
+    <article>
+      <span>{ui.whichPath}</span>
+      <strong id="dslit-path">0%</strong>
+    </article>
+    <article>
+      <span>{ui.coherence}</span>
+      <strong id="dslit-coherence">100%</strong>
+    </article>
+    <p>{ui.readoutNote}</p>
+  </section>
+</div>
+
+<script>
+  import { calculateDoubleSlitPattern, measurePattern } from './logic';
+
+  const canvas = document.getElementById('dslit-canvas') as HTMLCanvasElement | null;
+  const ctx = canvas?.getContext('2d');
+  const detectorToggle = document.getElementById('dslit-detector-enabled') as HTMLInputElement | null;
+  const detectorInput = document.getElementById('dslit-detector') as HTMLInputElement | null;
+  const separationInput = document.getElementById('dslit-separation') as HTMLInputElement | null;
+  const widthInput = document.getElementById('dslit-width') as HTMLInputElement | null;
+  const detectorOutput = document.getElementById('dslit-detector-output');
+  const separationOutput = document.getElementById('dslit-separation-output');
+  const widthOutput = document.getElementById('dslit-width-output');
+  const visibilityOutput = document.getElementById('dslit-visibility');
+  const pathOutput = document.getElementById('dslit-path');
+  const coherenceOutput = document.getElementById('dslit-coherence');
+  const stateLabel = document.getElementById('dslit-state-label');
+
+  const state = {
+    detectorStrength: 0,
+    slitSeparation: 1.8,
+    slitWidth: 0.42,
+    wavelength: 0.36,
+    screenDistance: 4.2,
+    phase: 0,
+    raf: 0,
+  };
+
+  function isDarkTheme() {
+    return document.documentElement.classList.contains('theme-dark') || document.body.classList.contains('theme-dark');
+  }
+
+  function createBeamGradient(sourceX: number, screenX: number, isDark: boolean) {
+    const gradient = ctx!.createLinearGradient(sourceX, 0, screenX, 0);
+    gradient.addColorStop(0, isDark ? 'rgba(64, 224, 208, 0.1)' : 'rgba(0, 139, 130, 0.16)');
+    gradient.addColorStop(0.48, isDark ? 'rgba(64, 224, 208, 0.3)' : 'rgba(0, 139, 130, 0.42)');
+    gradient.addColorStop(1, isDark ? 'rgba(255, 207, 102, 0.2)' : 'rgba(181, 111, 0, 0.32)');
+
+    return gradient;
+  }
+
+  function drawInterferencePaths(
+    samples: ReturnType<typeof calculateDoubleSlitPattern>,
+    scene: { sourceX: number; slitX: number; screenX: number; centerY: number; slitGap: number },
+    isDark: boolean,
+  ) {
+    ctx!.strokeStyle = createBeamGradient(scene.sourceX, scene.screenX, isDark);
+    ctx!.lineWidth = isDark ? 1.2 : 1.45;
+    ctx!.globalCompositeOperation = isDark ? 'lighter' : 'multiply';
+
+    samples.forEach((sample, index) => {
+      if (index % 2 !== 0) return;
+      const screenY = scene.centerY + sample.y * 68;
+      const glow = Math.max(0.04, sample.observedIntensity);
+      ctx!.globalAlpha = Math.min(isDark ? 0.62 : 0.74, glow * (isDark ? 0.85 : 1.05));
+      ctx!.beginPath();
+      ctx!.moveTo(scene.sourceX, scene.centerY + Math.sin(state.phase + index * 0.05) * 8);
+      ctx!.quadraticCurveTo(scene.slitX, scene.centerY - scene.slitGap / 2, scene.screenX, screenY);
+      ctx!.stroke();
+      ctx!.beginPath();
+      ctx!.moveTo(scene.sourceX, scene.centerY + Math.cos(state.phase + index * 0.04) * 8);
+      ctx!.quadraticCurveTo(scene.slitX, scene.centerY + scene.slitGap / 2, scene.screenX, screenY);
+      ctx!.stroke();
+    });
+
+    ctx!.globalAlpha = 1;
+    ctx!.globalCompositeOperation = 'source-over';
+  }
+
+  function drawBarrier(scene: { slitX: number; centerY: number; slitGap: number; slitWidth: number }, isDark: boolean) {
+    ctx!.fillStyle = isDark ? 'rgba(249, 245, 234, 0.82)' : 'rgba(9, 18, 32, 0.86)';
+    ctx!.fillRect(scene.slitX - 12, 58, 24, scene.centerY - scene.slitGap / 2 - scene.slitWidth / 2 - 58);
+    ctx!.fillRect(scene.slitX - 12, scene.centerY - scene.slitGap / 2 + scene.slitWidth / 2, 24, scene.slitGap - scene.slitWidth);
+    ctx!.fillRect(scene.slitX - 12, scene.centerY + scene.slitGap / 2 + scene.slitWidth / 2, 24, canvas!.height - (scene.centerY + scene.slitGap / 2 + scene.slitWidth / 2) - 58);
+  }
+
+  function drawScreenPattern(
+    samples: ReturnType<typeof calculateDoubleSlitPattern>,
+    scene: { screenX: number; centerY: number },
+    isDark: boolean,
+  ) {
+    samples.forEach((sample) => {
+      const y = scene.centerY + sample.y * 68;
+      const intensity = Math.min(1, sample.observedIntensity);
+      ctx!.fillStyle = isDark
+        ? `rgba(255, ${Math.round(178 + intensity * 60)}, 92, ${0.12 + intensity * 0.8})`
+        : `rgba(${Math.round(170 + intensity * 30)}, ${Math.round(95 + intensity * 60)}, 0, ${0.22 + intensity * 0.72})`;
+      ctx!.fillRect(scene.screenX, y - 1.2 - intensity * 3, 34 + intensity * 30, 2.4 + intensity * 6);
+    });
+  }
+
+  function drawBeam(samples: ReturnType<typeof calculateDoubleSlitPattern>) {
+    if (!ctx || !canvas) return;
+
+    const isDark = isDarkTheme();
+    const scene = {
+      sourceX: 86,
+      slitX: 330,
+      screenX: 742,
+      centerY: canvas.height / 2,
+      slitGap: state.slitSeparation * 58,
+      slitWidth: state.slitWidth * 42,
+    };
+
+    ctx.clearRect(0, 0, canvas.width, canvas.height);
+    drawInterferencePaths(samples, scene, isDark);
+    drawBarrier(scene, isDark);
+    drawScreenPattern(samples, scene, isDark);
+  }
+
+  function update() {
+    const samples = calculateDoubleSlitPattern(state, 201);
+    const metrics = measurePattern(samples, state.detectorStrength);
+
+    detectorOutput!.textContent = `${Math.round(state.detectorStrength * 100)}%`;
+    separationOutput!.textContent = state.slitSeparation.toFixed(2);
+    widthOutput!.textContent = state.slitWidth.toFixed(2);
+    visibilityOutput!.textContent = metrics.fringeVisibility.toFixed(2);
+    pathOutput!.textContent = `${Math.round(metrics.whichPath * 100)}%`;
+    coherenceOutput!.textContent = `${Math.round(metrics.coherence * 100)}%`;
+    stateLabel!.textContent = state.detectorStrength > 0.55
+      ? stateLabel!.getAttribute('data-particle') ?? 'Particle bands'
+      : stateLabel!.getAttribute('data-wave') ?? 'Interference';
+
+    detectorInput?.style.setProperty('--fill', `${state.detectorStrength * 100}%`);
+    separationInput?.style.setProperty('--fill', `${((state.slitSeparation * 100 - 80) / 200) * 100}%`);
+    widthInput?.style.setProperty('--fill', `${((state.slitWidth * 100 - 16) / 74) * 100}%`);
+
+    drawBeam(samples);
+  }
+
+  function animate() {
+    state.phase += 0.025 * (1 - state.detectorStrength * 0.55);
+    update();
+    state.raf = window.requestAnimationFrame(animate);
+  }
+
+  detectorToggle?.addEventListener('change', () => {
+    state.detectorStrength = detectorToggle.checked ? Math.max(0.72, Number(detectorInput?.value ?? 0) / 100) : 0;
+    if (detectorInput) detectorInput.value = String(Math.round(state.detectorStrength * 100));
+    update();
+  });
+
+  detectorInput?.addEventListener('input', () => {
+    state.detectorStrength = Number(detectorInput.value) / 100;
+    if (detectorToggle) detectorToggle.checked = state.detectorStrength > 0.02;
+    update();
+  });
+
+  separationInput?.addEventListener('input', () => {
+    state.slitSeparation = Number(separationInput.value) / 100;
+    update();
+  });
+
+  widthInput?.addEventListener('input', () => {
+    state.slitWidth = Number(widthInput.value) / 100;
+    update();
+  });
+
+  animate();
+</script>