@jjlmoya/utils-science 1.27.0 → 1.29.0

package/package.json

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

package/src/category/index.ts

@@ -10,10 +10,12 @@ import { lorenzAttractor } from '../tool/lorenz-attractor/index';
 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 { phaseDiagramCriticalPoints } from '../tool/phase-diagram-critical-points/index';
 
 export const scienceCategory: ScienceCategoryEntry = {
   icon: 'mdi:flask',
-  tools: [colonyCounter, asteroidImpact, microwaveDetector, simulationProbability, cellularRenewal, cosmicInflation, temperatureTimeline, lorenzAttractor, stellarHabitabilityZone, radioactiveDecay, naturalSelectionDrift],
+  tools: [colonyCounter, asteroidImpact, microwaveDetector, simulationProbability, cellularRenewal, cosmicInflation, temperatureTimeline, lorenzAttractor, stellarHabitabilityZone, radioactiveDecay, naturalSelectionDrift, entropySecondLaw, phaseDiagramCriticalPoints],
   i18n: {
     es: () => import('./i18n/es').then((m) => m.content),
     en: () => import('./i18n/en').then((m) => m.content),

package/src/entries.ts

@@ -10,6 +10,8 @@ export { lorenzAttractor } from './tool/lorenz-attractor/entry';
 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 { phaseDiagramCriticalPoints } from './tool/phase-diagram-critical-points/entry';
 export { scienceCategory } from './category';
 import { asteroidImpact } from './tool/asteroid-impact/entry';
 import { cellularRenewal } from './tool/cellular-renewal/entry';
@@ -22,4 +24,6 @@ import { lorenzAttractor } from './tool/lorenz-attractor/entry';
 import { stellarHabitabilityZone } from './tool/stellar-habitability-zone/entry';
 import { radioactiveDecay } from './tool/radioactive-decay/entry';
 import { naturalSelectionDrift } from './tool/natural-selection-drift/entry';
-export const ALL_ENTRIES = [asteroidImpact, cellularRenewal, colonyCounter, microwaveDetector, simulationProbability, cosmicInflation, temperatureTimeline, lorenzAttractor, stellarHabitabilityZone, radioactiveDecay, naturalSelectionDrift];
+import { entropySecondLaw } from './tool/entropy-second-law/entry';
+import { phaseDiagramCriticalPoints } from './tool/phase-diagram-critical-points/entry';
+export const ALL_ENTRIES = [asteroidImpact, cellularRenewal, colonyCounter, microwaveDetector, simulationProbability, cosmicInflation, temperatureTimeline, lorenzAttractor, stellarHabitabilityZone, radioactiveDecay, naturalSelectionDrift, entropySecondLaw, phaseDiagramCriticalPoints];

package/src/index.ts

@@ -11,6 +11,8 @@ export { LORENZ_ATTRACTOR_TOOL } from './tool/lorenz-attractor/index';
 export { STELLAR_HABITABILITY_ZONE_TOOL } from './tool/stellar-habitability-zone/index';
 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 { PHASE_DIAGRAM_CRITICAL_POINTS_TOOL } from './tool/phase-diagram-critical-points/index';
 
 export type {
   KnownLocale,

package/src/tests/locale_completeness.test.ts

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

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

package/src/tool/entropy-second-law/bibliography.astro

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

package/src/tool/entropy-second-law/bibliography.ts

@@ -0,0 +1,12 @@
+import type { BibliographyEntry } from '../../types';
+
+export const bibliography: BibliographyEntry[] = [
+  {
+    name: 'Entropy and the Second Law of Thermodynamics',
+    url: 'https://www.mdpi.com/1099-4300/22/7/793',
+  },
+  {
+    name: 'OpenStax University Physics Volume 2, The Second Law of Thermodynamics',
+    url: 'https://openstax.org/books/university-physics-volume-2/pages/4-introduction',
+  }
+];

package/src/tool/entropy-second-law/component.astro

@@ -0,0 +1,366 @@
+---
+import './entropy-second-law-simulator.css';
+
+interface Props {
+  ui: Record<string, string>;
+}
+
+const { ui } = Astro.props;
+---
+
+<div class="entropy-lab" id="entropy-lab">
+  <section class="entropy-controls" aria-label={ui.controls}>
+    <p class="entropy-status">{ui.status}</p>
+    <div class="entropy-control-grid">
+      <label class="entropy-field" for="entropy-left-temp">
+        <span>{ui.leftTemperature}</span>
+        <output id="entropy-left-temp-output">280 K</output>
+        <input id="entropy-left-temp" type="range" min="180" max="800" step="10" value="280" />
+      </label>
+
+      <label class="entropy-field" for="entropy-right-temp">
+        <span>{ui.rightTemperature}</span>
+        <output id="entropy-right-temp-output">480 K</output>
+        <input id="entropy-right-temp" type="range" min="180" max="800" step="10" value="480" />
+      </label>
+
+      <label class="entropy-field entropy-field-barrier" for="entropy-gate-open">
+        <span>{ui.gateAperture}</span>
+        <output id="entropy-gate-output">55%</output>
+        <input id="entropy-gate-open" type="range" min="20" max="92" step="1" value="55" />
+      </label>
+    </div>
+
+    <div class="entropy-actions">
+      <button type="button" id="entropy-toggle" data-pause={ui.pause} data-resume={ui.resume}>{ui.pause}</button>
+      <button type="button" id="entropy-reset">{ui.reset}</button>
+    </div>
+  </section>
+
+  <section class="entropy-stage" aria-label={ui.particleBox}>
+    <div class="entropy-canvas-head">
+      <div class="entropy-divider" aria-hidden="true">
+        <i class="entropy-divider-line"></i>
+        <span>{ui.barrier}</span>
+        <i class="entropy-divider-line"></i>
+      </div>
+    </div>
+
+    <div class="entropy-canvas-shell">
+      <canvas id="entropy-canvas" width="720" height="440"></canvas>
+    </div>
+
+    <div class="entropy-graph-shell">
+      <div class="entropy-graph-meta">
+        <span>{ui.entropyGraph}</span>
+        <span>{ui.liveTrace}</span>
+      </div>
+      <svg class="entropy-graph" viewBox="0 0 760 180" role="img" aria-label={ui.entropyGraph}>
+        <defs>
+          <linearGradient id="entropy-fill" x1="0%" y1="0%" x2="100%" y2="0%">
+            <stop offset="0%" stop-color="#56d7ff"></stop>
+            <stop offset="100%" stop-color="#ffd36a"></stop>
+          </linearGradient>
+          <filter id="entropy-line-glow" x="-20%" y="-80%" width="140%" height="240%">
+            <feGaussianBlur stdDeviation="4" result="glow"></feGaussianBlur>
+            <feMerge>
+              <feMergeNode in="glow"></feMergeNode>
+              <feMergeNode in="SourceGraphic"></feMergeNode>
+            </feMerge>
+          </filter>
+        </defs>
+        <path class="entropy-graph-area" id="entropy-graph-area" d=""></path>
+        <path class="entropy-graph-line" id="entropy-graph-line" d=""></path>
+        <path class="entropy-graph-guide" d="M56 24 L56 150 L740 150"></path>
+        <path class="entropy-graph-guide entropy-graph-guide-mid" d="M56 87 L740 87"></path>
+        <text x="8" y="30">{ui.highEntropy}</text>
+        <text x="12" y="91">{ui.midEntropy}</text>
+        <text x="12" y="146">{ui.lowEntropy}</text>
+      </svg>
+    </div>
+  </section>
+
+  <section class="entropy-console" aria-label={ui.results}>
+    <div class="entropy-readout">
+      <span>{ui.totalEntropy}</span>
+      <strong id="entropy-total-value">0.00</strong>
+    </div>
+
+    <div class="entropy-metrics">
+      <article>
+        <span>{ui.particleBalance}</span>
+        <strong id="entropy-balance-value">48 / 48</strong>
+      </article>
+      <article>
+        <span>{ui.spatialEntropy}</span>
+        <strong id="entropy-spatial-value">0.00</strong>
+      </article>
+      <article>
+        <span>{ui.thermalEntropy}</span>
+        <strong id="entropy-thermal-value">0.00</strong>
+      </article>
+      <article>
+        <span>{ui.energyGap}</span>
+        <strong id="entropy-gap-value">0.00</strong>
+      </article>
+    </div>
+
+    <div class="entropy-note">
+      <span>{ui.noteLabel}</span>
+      <div class="entropy-stateboard">
+        <div class="entropy-state-dial" id="entropy-state-dial" aria-hidden="true">
+          <i class="entropy-state-track"></i>
+          <i class="entropy-state-node"></i>
+        </div>
+        <div class="entropy-state-labels">
+          <strong id="entropy-state-gradient" class="is-active">{ui.stateGradient}</strong>
+          <strong id="entropy-state-mixing">{ui.stateMixing}</strong>
+          <strong id="entropy-state-equilibrium">{ui.stateEquilibrium}</strong>
+        </div>
+      </div>
+      <p>{ui.note}</p>
+    </div>
+  </section>
+</div>
+
+<script>
+  import { createParticles, measureSystem, stepParticles } from './logic';
+
+  const canvas = document.getElementById('entropy-canvas') as HTMLCanvasElement | null;
+  const context = canvas?.getContext('2d');
+  const leftTemperatureInput = document.getElementById('entropy-left-temp') as HTMLInputElement | null;
+  const rightTemperatureInput = document.getElementById('entropy-right-temp') as HTMLInputElement | null;
+  const gateInput = document.getElementById('entropy-gate-open') as HTMLInputElement | null;
+  const leftTemperatureOutput = document.getElementById('entropy-left-temp-output');
+  const rightTemperatureOutput = document.getElementById('entropy-right-temp-output');
+  const gateOutput = document.getElementById('entropy-gate-output');
+  const balanceValue = document.getElementById('entropy-balance-value');
+  const spatialValue = document.getElementById('entropy-spatial-value');
+  const thermalValue = document.getElementById('entropy-thermal-value');
+  const totalValue = document.getElementById('entropy-total-value');
+  const gapValue = document.getElementById('entropy-gap-value');
+  const graphLine = document.getElementById('entropy-graph-line');
+  const graphArea = document.getElementById('entropy-graph-area');
+  const stateDial = document.getElementById('entropy-state-dial');
+  const stateGradient = document.getElementById('entropy-state-gradient');
+  const stateMixing = document.getElementById('entropy-state-mixing');
+  const stateEquilibrium = document.getElementById('entropy-state-equilibrium');
+  const toggleButton = document.getElementById('entropy-toggle');
+  const resetButton = document.getElementById('entropy-reset');
+
+  const scene = {
+    width: 720,
+    height: 440,
+    leftCount: 48,
+    rightCount: 48,
+    gateOpen: 0.55,
+    leftTemperature: 280,
+    rightTemperature: 480,
+    particles: [],
+    entropyHistory: [],
+    isPaused: false,
+    seed: 20260617,
+    lastTime: 0,
+    raf: 0,
+  };
+
+  function colorForEnergy(energy: number) {
+    const hue = 198 - energy * 148;
+    const saturation = 88;
+    const lightness = 64 - energy * 18;
+
+    return `hsl(${hue} ${saturation}% ${lightness}%)`;
+  }
+
+  function resetSimulation() {
+    scene.seed += 137;
+    scene.particles = createParticles({
+      width: scene.width,
+      height: scene.height,
+      gateOpen: scene.gateOpen,
+      seed: scene.seed,
+      left: { count: scene.leftCount, temperature: scene.leftTemperature },
+      right: { count: scene.rightCount, temperature: scene.rightTemperature },
+    });
+    scene.entropyHistory = [];
+    scene.lastTime = 0;
+    updateReadout();
+    renderFrame();
+  }
+
+  function updateControlOutputs() {
+    leftTemperatureOutput!.textContent = `${scene.leftTemperature} K`;
+    rightTemperatureOutput!.textContent = `${scene.rightTemperature} K`;
+    gateOutput!.textContent = `${Math.round(scene.gateOpen * 100)}%`;
+  }
+
+  function updateSliderFills() {
+    leftTemperatureInput?.style.setProperty('--fill', `${((scene.leftTemperature - 180) / (800 - 180)) * 100}%`);
+    rightTemperatureInput?.style.setProperty('--fill', `${((scene.rightTemperature - 180) / (800 - 180)) * 100}%`);
+    gateInput?.style.setProperty('--fill', `${((scene.gateOpen * 100 - 20) / (92 - 20)) * 100}%`);
+  }
+
+  function updateMetricOutputs(metrics: ReturnType<typeof measureSystem>) {
+    balanceValue!.textContent = `${metrics.leftCount} / ${metrics.rightCount}`;
+    spatialValue!.textContent = metrics.spatialEntropy.toFixed(2);
+    thermalValue!.textContent = metrics.thermalEntropy.toFixed(2);
+    totalValue!.textContent = metrics.totalEntropy.toFixed(2);
+    gapValue!.textContent = Math.abs(metrics.leftAverageEnergy - metrics.rightAverageEnergy).toFixed(2);
+  }
+
+  function updateMacroState(metrics: ReturnType<typeof measureSystem>) {
+    stateDial?.style.setProperty('--entropy-progress', `${metrics.totalEntropy}`);
+
+    const gradientActive = metrics.totalEntropy < 0.42;
+    const mixingActive = metrics.totalEntropy >= 0.42 && metrics.totalEntropy < 0.9;
+    const equilibriumActive = metrics.totalEntropy >= 0.9;
+
+    stateGradient?.classList.toggle('is-active', gradientActive);
+    stateMixing?.classList.toggle('is-active', mixingActive);
+    stateEquilibrium?.classList.toggle('is-active', equilibriumActive);
+    stateDial?.classList.toggle('is-equilibrium', equilibriumActive);
+  }
+
+  function updateReadout() {
+    updateControlOutputs();
+    updateSliderFills();
+    const metrics = measureSystem(scene.particles, scene.width, {
+      left: scene.leftTemperature,
+      right: scene.rightTemperature,
+    });
+    updateMetricOutputs(metrics);
+    updateMacroState(metrics);
+
+    scene.entropyHistory.push(metrics.totalEntropy);
+    if (scene.entropyHistory.length > 90) {
+      scene.entropyHistory.shift();
+    }
+
+    drawGraph();
+  }
+
+  function drawGraph() {
+    const left = 56;
+    const right = 740;
+    const bottom = 150;
+    const top = 24;
+    const width = right - left;
+    const height = bottom - top;
+
+    if (scene.entropyHistory.length === 0) {
+      graphLine?.setAttribute('d', '');
+      graphArea?.setAttribute('d', '');
+      return;
+    }
+
+    const points = scene.entropyHistory.map((value, index) => {
+      const x = left + (index / Math.max(1, scene.entropyHistory.length - 1)) * width;
+      const y = bottom - value * height;
+      return `${index === 0 ? 'M' : 'L'}${x.toFixed(2)} ${y.toFixed(2)}`;
+    }).join(' ');
+
+    graphLine?.setAttribute('d', points);
+    graphArea?.setAttribute('d', `${points} L ${right} ${bottom} L ${left} ${bottom} Z`);
+  }
+
+  function drawDivider() {
+    if (!context) return;
+
+    const dividerX = scene.width / 2;
+    const aperture = scene.height * scene.gateOpen;
+    const gateTop = (scene.height - aperture) / 2;
+    const gateBottom = gateTop + aperture;
+
+    context.strokeStyle = 'rgba(255, 244, 220, 0.3)';
+    context.lineWidth = 2;
+    context.beginPath();
+    context.moveTo(dividerX, 0);
+    context.lineTo(dividerX, gateTop);
+    context.moveTo(dividerX, gateBottom);
+    context.lineTo(dividerX, scene.height);
+    context.stroke();
+
+    context.fillStyle = 'rgba(255, 211, 106, 0.12)';
+    context.fillRect(dividerX - 3, gateTop, 6, aperture);
+  }
+
+  function renderFrame() {
+    if (!context || !canvas) return;
+
+    context.clearRect(0, 0, canvas.width, canvas.height);
+
+    const coldGlow = context.createRadialGradient(scene.width * 0.23, scene.height * 0.5, 0, scene.width * 0.23, scene.height * 0.5, scene.width * 0.28);
+    coldGlow.addColorStop(0, 'rgba(86, 215, 255, 0.12)');
+    coldGlow.addColorStop(1, 'rgba(86, 215, 255, 0)');
+    context.fillStyle = coldGlow;
+    context.fillRect(0, 0, scene.width, scene.height);
+
+    const hotGlow = context.createRadialGradient(scene.width * 0.77, scene.height * 0.5, 0, scene.width * 0.77, scene.height * 0.5, scene.width * 0.28);
+    hotGlow.addColorStop(0, 'rgba(255, 163, 71, 0.12)');
+    hotGlow.addColorStop(1, 'rgba(255, 163, 71, 0)');
+    context.fillStyle = hotGlow;
+    context.fillRect(0, 0, scene.width, scene.height);
+
+    drawDivider();
+
+    context.globalCompositeOperation = 'lighter';
+    scene.particles.forEach((particle) => {
+      context.beginPath();
+      context.fillStyle = colorForEnergy(particle.energy);
+      context.shadowBlur = 16;
+      context.shadowColor = colorForEnergy(particle.energy);
+      context.arc(particle.x, particle.y, 4.8 + particle.energy * 2.2, 0, Math.PI * 2);
+      context.fill();
+    });
+    context.globalCompositeOperation = 'source-over';
+    context.shadowBlur = 0;
+  }
+
+  function frame(time: number) {
+    if (!scene.isPaused) {
+      if (!scene.lastTime) scene.lastTime = time;
+      const delta = Math.min(32, time - scene.lastTime);
+      scene.lastTime = time;
+
+      stepParticles(scene.particles, {
+        width: scene.width,
+        height: scene.height,
+        gateOpen: scene.gateOpen,
+        left: { count: scene.leftCount, temperature: scene.leftTemperature },
+        right: { count: scene.rightCount, temperature: scene.rightTemperature },
+      }, delta);
+
+      updateReadout();
+      renderFrame();
+    }
+
+    scene.raf = window.requestAnimationFrame(frame);
+  }
+
+  leftTemperatureInput?.addEventListener('input', () => {
+    scene.leftTemperature = Number(leftTemperatureInput.value);
+    resetSimulation();
+  });
+
+  rightTemperatureInput?.addEventListener('input', () => {
+    scene.rightTemperature = Number(rightTemperatureInput.value);
+    resetSimulation();
+  });
+
+  gateInput?.addEventListener('input', () => {
+    scene.gateOpen = Number(gateInput.value) / 100;
+    resetSimulation();
+  });
+
+  toggleButton?.addEventListener('click', () => {
+    scene.isPaused = !scene.isPaused;
+    toggleButton.textContent = scene.isPaused
+      ? toggleButton.getAttribute('data-resume')
+      : toggleButton.getAttribute('data-pause');
+  });
+
+  resetButton?.addEventListener('click', resetSimulation);
+
+  resetSimulation();
+  scene.raf = window.requestAnimationFrame(frame);
+</script>