@jjlmoya/utils-forensic-science 1.1.0

package/src/tests/tool_exports.test.ts

@@ -0,0 +1,34 @@
+import { describe, it, expect } from 'vitest';
+import { ALL_TOOLS } from '../tools';
+import { validateToolExports } from './shared-test-helpers';
+
+describe('Tool Exports Pattern Validation', () => {
+  describe('Component Exports Format', () => {
+    ALL_TOOLS.forEach((tool) => {
+      it(`${tool.entry.id}: Component should be a lazy-loaded function`, () => {
+        expect(typeof tool.Component).toBe('function');
+        expect(tool.Component).toBeInstanceOf(Function);
+      });
+
+      it(`${tool.entry.id}: SEOComponent should be a lazy-loaded function`, () => {
+        expect(typeof tool.SEOComponent).toBe('function');
+        expect(tool.SEOComponent).toBeInstanceOf(Function);
+      });
+
+      it(`${tool.entry.id}: BibliographyComponent should be a lazy-loaded function`, () => {
+        expect(typeof tool.BibliographyComponent).toBe('function');
+        expect(tool.BibliographyComponent).toBeInstanceOf(Function);
+      });
+    });
+  });
+
+  describe('Dynamic Import Validation', () => {
+    it('all tools must have functional dynamic imports', async () => {
+      const result = await validateToolExports(ALL_TOOLS);
+      if (!result.passed) {
+        throw new Error(`Tool export validation failed:\n${result.failures.join('\n')}`);
+      }
+      expect(result.passed).toBe(true);
+    });
+  });
+});

package/src/tests/tool_validation.test.ts

@@ -0,0 +1,16 @@
+import { describe, it, expect } from 'vitest';
+import { ALL_TOOLS } from '../tools';
+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('scienceCategory should be defined', () => {
+      expect(scienceCategory).toBeDefined();
+      expect(scienceCategory.i18n).toBeDefined();
+    });
+  });
+});

package/src/tests/widmark.test.ts

@@ -0,0 +1,28 @@
+import { describe, it, expect } from 'vitest';
+import { WidmarkEngine } from '../tool/widmark-alcohol-simulator/logic';
+
+describe('WidmarkEngine simulation tests', () => {
+  it('should calculate correct BAC and linear decay for an 80kg male', () => {
+    const profile = {
+      weight: 80,
+      sex: 'male' as const,
+      hydration: 'normal' as const,
+      stomach: 'empty' as const,
+    };
+    const drinks = [
+      { volume: 1000, abv: 5, time: 0 },
+    ];
+    
+    const result = WidmarkEngine.simulate(profile, drinks);
+    expect(result.peakBac).toBeGreaterThan(0.5);
+    expect(result.peakBac).toBeLessThan(0.75);
+
+    const peakIndex = result.datapoints.findIndex(dp => dp.bac === result.peakBac);
+    expect(peakIndex).toBeGreaterThan(0);
+
+    const step1 = result.datapoints[peakIndex + 5]!;
+    const step2 = result.datapoints[peakIndex + 15]!;
+    const rate = (step1.bac - step2.bac) / ((step2.time - step1.time));
+    expect(rate).toBeCloseTo(0.15, 1);
+  });
+});

package/src/tool/forensic-age-estimator/bibliography.astro

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

package/src/tool/forensic-age-estimator/bibliography.ts

@@ -0,0 +1,16 @@
+import type { BibliographyEntry } from '../../types';
+
+export const bibliography: BibliographyEntry[] = [
+  {
+    name: 'Forensic Science International - Study of third molars for estimating age',
+    url: 'https://pmc.ncbi.nlm.nih.gov/articles/PMC6100221/',
+  },
+  {
+    name: 'Royal College of Paediatrics and Child Health - Age assessment guidance',
+    url: 'https://www.rcpch.ac.uk/news-events/news/2022-02/rcpch-updates-position-statement-age-assessment',
+  },
+  {
+    name: 'UNICEF - Age assessment: a technical note',
+    url: 'https://www.refworld.org/en/download/90892',
+  },
+];

package/src/tool/forensic-age-estimator/component.astro

@@ -0,0 +1,321 @@
+---
+import './dental-skeletal-third-molar-age-estimator.css';
+
+interface Props {
+  ui: Record<string, string>;
+}
+
+const { ui } = Astro.props;
+
+const stageValues = Array.from({ length: 9 }, (_, stage) => stage);
+---
+
+<div class="forensic-age" id="forensic-age">
+  <section class="forensic-age-panel" aria-label={ui.controls}>
+    <label class="forensic-age-field" for="forensic-evidence">
+      <span>{ui.evidenceType}</span>
+      <select id="forensic-evidence">
+        <option value="mixed">{ui.mixedEvidence}</option>
+        <option value="dental">{ui.dentalPriority}</option>
+        <option value="skeletal">{ui.skeletalPriority}</option>
+      </select>
+    </label>
+
+    <div class="forensic-age-stage-field" data-stage-field="dental">
+      <button class="forensic-age-stage-select" type="button" aria-expanded="false" aria-controls="forensic-dental-list">
+        <span>
+          <b>{ui.dentalStage}</b>
+          <small>{ui.dentalStageHelp}</small>
+        </span>
+        <output id="forensic-dental-output">{ui.stageLabel} 4</output>
+      </button>
+      <div class="forensic-age-stage-list" id="forensic-dental-list" hidden>
+        {stageValues.map((stage) => (
+          <label class="forensic-age-stage-card">
+            <input name="forensic-dental-stage" data-stage-input="forensic-dental" type="radio" value={stage} checked={stage === 4} />
+            <svg viewBox="0 0 44 44" aria-hidden="true">
+              <path d="M16 10c4-3 8-3 12 0 4 4 4 11 1 19l-3 7h-8l-3-7c-3-8-3-15 1-19Z" />
+              <path style={`opacity:${0.18 + stage * 0.1}`} d="M17 26h10" />
+            </svg>
+            <strong>{ui.stageLabel} {stage}</strong>
+            <span>{ui[`dentalStage${stage}`]}</span>
+          </label>
+        ))}
+      </div>
+    </div>
+
+    <div class="forensic-age-stage-field" data-stage-field="epiphyseal">
+      <button class="forensic-age-stage-select" type="button" aria-expanded="false" aria-controls="forensic-epiphyseal-list">
+        <span>
+          <b>{ui.epiphysealStage}</b>
+          <small>{ui.epiphysealStageHelp}</small>
+        </span>
+        <output id="forensic-epiphyseal-output">{ui.stageLabel} 4</output>
+      </button>
+      <div class="forensic-age-stage-list" id="forensic-epiphyseal-list" hidden>
+        {stageValues.map((stage) => (
+          <label class="forensic-age-stage-card">
+            <input name="forensic-epiphyseal-stage" data-stage-input="forensic-epiphyseal" type="radio" value={stage} checked={stage === 4} />
+            <svg viewBox="0 0 44 44" aria-hidden="true">
+              <path d="M13 12h18M13 32h18" />
+              <path style={`opacity:${0.12 + stage * 0.1}`} d="M14 22h16" />
+              <path style={`opacity:${stage / 8}`} d="M22 12v20" />
+            </svg>
+            <strong>{ui.stageLabel} {stage}</strong>
+            <span>{ui[`epiphysealStage${stage}`]}</span>
+          </label>
+        ))}
+      </div>
+    </div>
+
+    <div class="forensic-age-stage-field" data-stage-field="molar">
+      <button class="forensic-age-stage-select" type="button" aria-expanded="false" aria-controls="forensic-molar-list">
+        <span>
+          <b>{ui.thirdMolarStage}</b>
+          <small>{ui.molarStageHelp}</small>
+        </span>
+        <output id="forensic-molar-output">{ui.stageLabel} 4</output>
+      </button>
+      <div class="forensic-age-stage-list" id="forensic-molar-list" hidden>
+        {stageValues.map((stage) => (
+          <label class="forensic-age-stage-card">
+            <input name="forensic-molar-stage" data-stage-input="forensic-molar" type="radio" value={stage} checked={stage === 4} />
+            <svg viewBox="0 0 44 44" aria-hidden="true">
+              <circle cx="22" cy="18" r="8" />
+              <path style={`opacity:${0.12 + stage * 0.1}`} d="M17 27c3 5 7 5 10 0" />
+              <path style={`opacity:${stage / 8}`} d="M22 26v9" />
+            </svg>
+            <strong>{ui.stageLabel} {stage}</strong>
+            <span>{ui[`molarStage${stage}`]}</span>
+          </label>
+        ))}
+      </div>
+    </div>
+  </section>
+
+  <section class="forensic-age-visual" aria-label={ui.caseBoard}>
+    <svg class="forensic-age-instrument" viewBox="0 0 430 430" role="img" aria-label={ui.maturityProfile}>
+      <circle class="forensic-age-progress-track" cx="215" cy="176" r="126" pathLength="100" />
+      <circle class="forensic-age-progress-fill" cx="215" cy="176" r="126" pathLength="100" />
+      <text class="forensic-age-score-label" x="215" y="160">{ui.maturityScore}</text>
+      <text class="forensic-age-score-value" id="forensic-score" x="215" y="203">-</text>
+      <g class="forensic-age-signals">
+        <line class="forensic-age-signal" x1="108" y1="320" x2="322" y2="320" />
+        <circle class="forensic-age-signal-dot forensic-age-signal-dot-dental" cx="108" cy="320" r="5" />
+        <circle class="forensic-age-signal-dot forensic-age-signal-dot-epiphyseal" cx="215" cy="320" r="5" />
+        <circle class="forensic-age-signal-dot forensic-age-signal-dot-molar" cx="322" cy="320" r="5" />
+        <text x="108" y="350">{ui.dentalShort}</text>
+        <text x="215" y="350">{ui.boneShort}</text>
+        <text x="322" y="350">{ui.molarShort}</text>
+      </g>
+    </svg>
+  </section>
+
+  <section class="forensic-age-results" aria-label={ui.results}>
+    <div class="forensic-age-band forensic-age-band-main">
+      <strong id="forensic-likely">-</strong>
+    </div>
+    <div class="forensic-age-interval">
+      <strong id="forensic-minimum">-</strong>
+      <strong id="forensic-likely-marker">-</strong>
+      <i></i>
+      <strong id="forensic-maximum">-</strong>
+    </div>
+
+    <div class="forensic-age-notes">
+      <strong id="forensic-confidence">-</strong>
+      <p id="forensic-notes">-</p>
+    </div>
+  </section>
+</div>
+
+<script id="forensic-age-ui" type="application/json" set:html={JSON.stringify(ui)}></script>
+
+<script>
+  import { estimateForensicAge } from './logic';
+  import type { EvidenceType } from './logic';
+
+  const uiElement = document.getElementById('forensic-age-ui');
+  const ui = JSON.parse(uiElement?.textContent ?? '{}') as Record<string, string>;
+  const evidence = document.getElementById('forensic-evidence') as HTMLSelectElement | null;
+  const root = document.getElementById('forensic-age') as HTMLElement | null;
+  const dentalOutput = document.getElementById('forensic-dental-output');
+  const epiphysealOutput = document.getElementById('forensic-epiphyseal-output');
+  const molarOutput = document.getElementById('forensic-molar-output');
+  const minimum = document.getElementById('forensic-minimum');
+  const likely = document.getElementById('forensic-likely');
+  const likelyMarker = document.getElementById('forensic-likely-marker');
+  const maximum = document.getElementById('forensic-maximum');
+  const confidence = document.getElementById('forensic-confidence');
+  const notes = document.getElementById('forensic-notes');
+  const score = document.getElementById('forensic-score');
+  const progressFill = document.querySelector<SVGCircleElement>('.forensic-age-progress-fill');
+  const instrument = document.querySelector<SVGSVGElement>('.forensic-age-instrument');
+  const interval = document.querySelector<HTMLElement>('.forensic-age-interval');
+  const storageKey = 'forensic-age-estimator:last-input';
+  const renderedValues = new WeakMap<HTMLElement, number>();
+  let renderedScore = 0;
+
+  function selectedStage(name: string): number {
+    const input = document.querySelector<HTMLInputElement>(`[data-stage-input="${name}"]:checked`);
+    return Number(input?.value ?? 4);
+  }
+
+  function selectStage(name: string, value: number) {
+    const stage = Math.min(8, Math.max(0, Math.round(value)));
+    const input = document.querySelector<HTMLInputElement>(`[data-stage-input="${name}"][value="${stage}"]`);
+    if (input) input.checked = true;
+  }
+
+  function renderAge(target: HTMLElement | null, value: number, animate = true) {
+    if (!target) return;
+    const from = renderedValues.get(target) ?? value;
+    renderedValues.set(target, value);
+    animateNumber(from, value, (current) => {
+      target.innerHTML = `<span class="forensic-age-number">${current.toFixed(1)}</span><span class="forensic-age-unit">${ui.ageUnit}</span>`;
+    }, animate);
+  }
+
+  function isEvidenceType(value: string | undefined): value is EvidenceType {
+    return value === 'dental' || value === 'skeletal' || value === 'mixed';
+  }
+
+  function restoreInput() {
+    if (!evidence) return;
+
+    try {
+      const saved = JSON.parse(localStorage.getItem(storageKey) ?? '{}') as {
+        dentalStage?: number;
+        epiphysealStage?: number;
+        evidenceType?: EvidenceType;
+        molarStage?: number;
+      };
+
+      if (isEvidenceType(saved.evidenceType)) {
+        evidence.value = saved.evidenceType;
+      }
+
+      selectStage('forensic-dental', saved.dentalStage ?? 4);
+      selectStage('forensic-epiphyseal', saved.epiphysealStage ?? 4);
+      selectStage('forensic-molar', saved.molarStage ?? 4);
+    } catch {
+      localStorage.removeItem(storageKey);
+    }
+  }
+
+  function saveInput(dentalStage: number, epiphysealStage: number, molarStage: number) {
+    if (!evidence) return;
+
+    localStorage.setItem(storageKey, JSON.stringify({
+      dentalStage,
+      epiphysealStage,
+      evidenceType: evidence.value,
+      molarStage,
+    }));
+  }
+
+  function pulseInstrument() {
+    if (!instrument) return;
+    instrument.classList.remove('forensic-age-instrument-pulse');
+    requestAnimationFrame(() => instrument.classList.add('forensic-age-instrument-pulse'));
+  }
+
+  function pulseInterval() {
+    if (!interval) return;
+    interval.classList.remove('forensic-age-interval-pulse');
+    requestAnimationFrame(() => interval.classList.add('forensic-age-interval-pulse'));
+  }
+
+  function animateNumber(from: number, to: number, render: (value: number) => void, animate = true) {
+    if (!animate || window.matchMedia('(prefers-reduced-motion: reduce)').matches) {
+      render(to);
+      return;
+    }
+
+    const started = performance.now();
+    const duration = 420;
+    const tick = (time: number) => {
+      const progress = Math.min(1, (time - started) / duration);
+      const eased = 1 - Math.pow(1 - progress, 3);
+      render(from + (to - from) * eased);
+      if (progress < 1) requestAnimationFrame(tick);
+    };
+    requestAnimationFrame(tick);
+  }
+
+  function renderResult(result: ReturnType<typeof estimateForensicAge>) {
+    renderAge(minimum, result.minimumAge);
+    renderAge(likely, result.likelyAge);
+    renderAge(likelyMarker, result.likelyAge);
+    renderAge(maximum, result.maximumAge);
+    confidence!.textContent = ui[`confidence${result.confidence}`] ?? null;
+    notes!.textContent = result.notes.map((note) => ui[note]).join(' ') || null;
+    animateNumber(renderedScore, result.maturityScore, (current) => {
+      score!.textContent = `${Math.round(current)}%`;
+    });
+    renderedScore = result.maturityScore;
+    progressFill?.classList.toggle('forensic-age-progress-fill-complete', result.maturityScore >= 100);
+  }
+
+  function update() {
+    if (!evidence || !root) return;
+
+    const dentalStage = selectedStage('forensic-dental');
+    const epiphysealStage = selectedStage('forensic-epiphyseal');
+    const molarStage = selectedStage('forensic-molar');
+
+    const result = estimateForensicAge({
+      dentalStage,
+      epiphysealStage,
+      thirdMolarStage: molarStage,
+      evidenceType: evidence.value as EvidenceType,
+    });
+
+    dentalOutput!.textContent = `${ui.stageLabel} ${dentalStage}`;
+    epiphysealOutput!.textContent = `${ui.stageLabel} ${epiphysealStage}`;
+    molarOutput!.textContent = `${ui.stageLabel} ${molarStage}`;
+    renderResult(result);
+    root.style.setProperty('--dental-maturity', String(dentalStage / 8));
+    root.style.setProperty('--epiphyseal-maturity', String(epiphysealStage / 8));
+    root.style.setProperty('--molar-maturity', String(molarStage / 8));
+    root.style.setProperty('--overall-maturity', String(result.maturityScore / 100));
+    saveInput(dentalStage, epiphysealStage, molarStage);
+    pulseInstrument();
+    pulseInterval();
+  }
+
+  function closeStageLists() {
+    document.querySelectorAll<HTMLElement>('.forensic-age-stage-list').forEach((item) => { item.hidden = true; });
+    document.querySelectorAll<HTMLButtonElement>('.forensic-age-stage-select').forEach((item) => {
+      item.setAttribute('aria-expanded', 'false');
+    });
+  }
+
+  restoreInput();
+  evidence?.addEventListener('change', update);
+  document.querySelectorAll<HTMLButtonElement>('.forensic-age-stage-select').forEach((button) => {
+    button.addEventListener('click', () => {
+      const list = document.getElementById(button.getAttribute('aria-controls') ?? '');
+      const shouldOpen = button.getAttribute('aria-expanded') !== 'true';
+      closeStageLists();
+      if (list) list.hidden = !shouldOpen;
+      button.setAttribute('aria-expanded', String(shouldOpen));
+    });
+  });
+  document.querySelectorAll<HTMLInputElement>('[data-stage-input]').forEach((input) => {
+    input.addEventListener('change', () => {
+      const field = input.closest<HTMLElement>('.forensic-age-stage-field');
+      field!.querySelector<HTMLElement>('.forensic-age-stage-list')!.hidden = true;
+      field!.querySelector<HTMLButtonElement>('.forensic-age-stage-select')!.setAttribute('aria-expanded', 'false');
+      update();
+    });
+  });
+  document.addEventListener('click', (event) => {
+    if ((event.target as HTMLElement).closest('.forensic-age-stage-field')) return;
+    closeStageLists();
+  });
+  document.addEventListener('keydown', (event) => {
+    if (event.key === 'Escape') closeStageLists();
+  });
+  update();
+</script>