@jjlmoya/utils-tabletop 1.25.0 → 1.26.0

package/package.json

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

package/src/category/index.ts

@@ -1,6 +1,7 @@
 import { diceRollerSimulator } from '../tool/dice-roller-simulator/entry';
 import { boardGameTimer } from '../tool/board-game-timer/entry';
 import { dungeonMapGenerator } from '../tool/dungeon-map-generator/entry';
+import { encounterDifficultyCalculator } from '../tool/encounter-difficulty-calculator/entry';
 import type { CategoryLocaleContent, KnownLocale } from '../types';
 
 export const tabletopCategory = {
@@ -9,6 +10,7 @@ export const tabletopCategory = {
     diceRollerSimulator,
     boardGameTimer,
     dungeonMapGenerator,
+    encounterDifficultyCalculator,
   ],
   i18n: {
     de: () => import('./i18n/de').then((m) => m.content),

package/src/entries.ts

@@ -34,6 +34,7 @@ import { lunarTideTracker } from './tool/lunar-tide-tracker/entry';
 import { hiddenRoleDealer } from './tool/hidden-role-dealer/entry';
 import { scatterDirectionSelector } from './tool/scatter-direction-selector/entry';
 import { dungeonMapGenerator } from './tool/dungeon-map-generator/entry';
+import { encounterDifficultyCalculator } from './tool/encounter-difficulty-calculator/entry';
 
 export const ALL_ENTRIES = [
   diceRollerSimulator,
@@ -48,5 +49,6 @@ export const ALL_ENTRIES = [
   hiddenRoleDealer,
   scatterDirectionSelector,
   dungeonMapGenerator,
+  encounterDifficultyCalculator,
 ];
 

package/src/tests/locale_completeness.test.ts

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

package/src/tests/tool_validation.test.ts

@@ -5,7 +5,7 @@ import { tabletopCategory } from '../data';
 describe('Tool Validation Suite', () => {
   describe('Library Registration', () => {
     it('should have tools in ALL_TOOLS', () => {
-      expect(ALL_TOOLS.length).toBe(12);
+      expect(ALL_TOOLS.length).toBe(13);
     });
 
 

package/src/tool/encounter-difficulty-calculator/bibliography.astro

@@ -0,0 +1,6 @@
+---
+import { Bibliography } from '@jjlmoya/utils-shared';
+import { bibliography } from './bibliography';
+---
+
+<Bibliography links={bibliography} />

package/src/tool/encounter-difficulty-calculator/bibliography.ts

@@ -0,0 +1,12 @@
+import type { BibliographyEntry } from '../../types';
+
+export const bibliography: BibliographyEntry[] = [
+  {
+    name: 'D&D Beyond, Basic Rules 2014, Building Combat Encounters',
+    url: 'https://www.dndbeyond.com/sources/dnd/basic-rules-2014/building-combat-encounters',
+  },
+  {
+    name: 'D&D Beyond, Basic Rules 2014, Monsters and Experience Points',
+    url: 'https://www.dndbeyond.com/sources/dnd/basic-rules-2014/monsters',
+  },
+];

package/src/tool/encounter-difficulty-calculator/component.astro

@@ -0,0 +1,53 @@
+---
+import type { EncounterDifficultyUI } from './ui';
+
+interface Props {
+  ui: EncounterDifficultyUI;
+}
+
+const { ui } = Astro.props as Props;
+---
+
+<div class="encounter-calculator" data-encounter-calculator data-ui={JSON.stringify(ui)}>
+  <div class="encounter-intro">{ui.intro}</div>
+  <div class="encounter-presets">
+    <span>{ui.presets}</span>
+    <button type="button" data-preset="classic">{ui.presetClassic}</button>
+    <button type="button" data-preset="boss">{ui.presetBoss}</button>
+    <button type="button" data-preset="swarm">{ui.presetSwarm}</button>
+  </div>
+  <div class="encounter-layout">
+    <section class="encounter-controls" aria-label={ui.partySection}>
+      <div class="control-group">
+        <div class="group-heading"><span>{ui.partySection}</span><span class="eyebrow">D&D 5E 2014</span></div>
+        <label for="party-level">{ui.partyLevel}<output data-output="partyLevel">5</output></label>
+        <input id="party-level" data-input="partyLevel" type="range" min="1" max="20" value="5" />
+        <small>{ui.partyLevelHint}</small>
+        <label for="party-size">{ui.partySize}<output data-output="partySize">4</output></label>
+        <input id="party-size" data-input="partySize" type="range" min="1" max="8" value="4" />
+        <small>{ui.partySizeHint}</small>
+      </div>
+      <div class="control-group">
+        <div class="group-heading"><span>{ui.threatSection}</span><span class="eyebrow">CR + XP</span></div>
+        <label>{ui.monsterCr}<output data-cr-output>2</output></label>
+        <div class="cr-list" data-cr-list aria-label={ui.monsterCr}></div>
+        <button type="button" class="cr-more-button" data-cr-more>{ui.moreCr}</button>
+        <small>{ui.monsterCrHint}</small>
+        <label for="monster-count">{ui.monsterCount}<output data-output="monsterCount">2</output></label>
+        <input id="monster-count" data-input="monsterCount" type="range" min="1" max="15" value="2" />
+        <small>{ui.monsterCountHint}</small>
+      </div>
+      <button type="button" class="reset-button" data-reset>{ui.reset}</button>
+    </section>
+    <section class="encounter-result" aria-live="polite" aria-label={ui.sceneLabel}>
+      <div data-result></div>
+    </section>
+  </div>
+  <p class="rules-note">{ui.rulesNote} <a href="https://www.dndbeyond.com/sources/dnd/basic-rules-2014/building-combat-encounters" target="_blank" rel="noreferrer">{ui.rulesLinkLabel}</a></p>
+</div>
+
+<script>
+  import { mountEncounterCalculator } from './controller';
+  const root = document.querySelector('[data-encounter-calculator]');
+  if (root) mountEncounterCalculator(root);
+</script>

package/src/tool/encounter-difficulty-calculator/controller.ts

@@ -0,0 +1,133 @@
+import { calculateEncounter, CR_OPTIONS, DEFAULT_SETTINGS, QUICK_CR_VALUES, type EncounterSettings } from './logic';
+import { readEncounterSettings, writeEncounterSettings } from './storage';
+import { renderResult } from './dom-views';
+
+type Root = HTMLElement & { dataset: DOMStringMap };
+type Labels = Record<string, string>;
+
+function getUi(root: Root): Labels {
+  try {
+    return JSON.parse(root.dataset.ui ?? '{}') as Labels;
+  } catch {
+    return {};
+  }
+}
+
+function query<T extends HTMLElement>(root: Root, selector: string): T {
+  return root.querySelector(selector) as T;
+}
+
+function getSettings(root: Root): EncounterSettings {
+  return {
+    partyLevel: Number(query<HTMLInputElement>(root, '[data-input="partyLevel"]').value),
+    partySize: Number(query<HTMLInputElement>(root, '[data-input="partySize"]').value),
+    monsterCr: Number(root.querySelector<HTMLElement>('[data-cr].is-active')?.dataset.cr ?? 2),
+    monsterCount: Number(query<HTMLInputElement>(root, '[data-input="monsterCount"]').value),
+  };
+}
+
+function setRangeValue(root: Root, key: string, value: number): void {
+  const input = query<HTMLInputElement>(root, '[data-input="' + key + '"]');
+  const output = query<HTMLElement>(root, '[data-output="' + key + '"]');
+  input.value = String(value);
+  output.textContent = String(value);
+}
+
+function setCr(root: Root, cr: number): void {
+  const list = query<HTMLElement>(root, '[data-cr-list]');
+  if (!QUICK_CR_VALUES.includes(cr as typeof QUICK_CR_VALUES[number])) list.classList.add('is-expanded');
+  root.querySelectorAll<HTMLElement>('[data-cr]').forEach((chip) => {
+    const active = Number(chip.dataset.cr) === cr;
+    chip.classList.toggle('is-active', active);
+    chip.setAttribute('aria-pressed', String(active));
+  });
+  const output = root.querySelector<HTMLElement>('[data-cr-output]');
+  if (output) output.textContent = formatCr(cr);
+}
+
+function formatCr(cr: number): string {
+  if (cr === 0.125) return '1/8';
+  if (cr === 0.25) return '1/4';
+  if (cr === 0.5) return '1/2';
+  return String(cr);
+}
+
+function applySettings(root: Root, settings: EncounterSettings): void {
+  setRangeValue(root, 'partyLevel', settings.partyLevel);
+  setRangeValue(root, 'partySize', settings.partySize);
+  setRangeValue(root, 'monsterCount', settings.monsterCount);
+  setCr(root, settings.monsterCr);
+}
+
+function render(root: Root): void {
+  const result = calculateEncounter(getSettings(root));
+  const labels = getUi(root);
+  query<HTMLElement>(root, '[data-result]').innerHTML = renderResult(result, labels);
+  writeEncounterSettings(result.settings);
+  root.dataset.difficulty = result.difficulty;
+}
+
+function bindRanges(root: Root): void {
+  root.querySelectorAll<HTMLInputElement>('[data-input]').forEach((input) => {
+    input.addEventListener('input', () => {
+      query<HTMLElement>(root, '[data-output="' + input.dataset.input + '"]').textContent = input.value;
+      render(root);
+    });
+  });
+}
+
+function bindCr(root: Root): void {
+  root.querySelectorAll<HTMLElement>('[data-cr]').forEach((chip) => chip.addEventListener('click', () => {
+    setCr(root, Number(chip.dataset.cr));
+    render(root);
+  }));
+}
+
+function bindCrMore(root: Root): void {
+  const button = query<HTMLButtonElement>(root, '[data-cr-more]');
+  button.addEventListener('click', () => {
+    const list = query<HTMLElement>(root, '[data-cr-list]');
+    const expanded = list.classList.toggle('is-expanded');
+    const labels = getUi(root);
+    button.textContent = expanded ? labels.lessCr : labels.moreCr;
+  });
+}
+
+function bindPresets(root: Root): void {
+  const presets: Record<string, EncounterSettings> = {
+    classic: { partyLevel: 5, partySize: 4, monsterCr: 2, monsterCount: 2 },
+    boss: { partyLevel: 8, partySize: 4, monsterCr: 10, monsterCount: 1 },
+    swarm: { partyLevel: 3, partySize: 4, monsterCr: 0.25, monsterCount: 8 },
+  };
+  root.querySelectorAll<HTMLElement>('[data-preset]').forEach((button) => button.addEventListener('click', () => {
+    applySettings(root, presets[button.dataset.preset ?? ''] ?? DEFAULT_SETTINGS);
+    render(root);
+  }));
+}
+
+function bindReset(root: Root): void {
+  query<HTMLButtonElement>(root, '[data-reset]').addEventListener('click', () => {
+    applySettings(root, DEFAULT_SETTINGS);
+    render(root);
+  });
+}
+
+function setupCrOptions(root: Root): void {
+  const list = query<HTMLElement>(root, '[data-cr-list]');
+  list.innerHTML = CR_OPTIONS.map((entry) => {
+    const advanced = QUICK_CR_VALUES.includes(entry.value as typeof QUICK_CR_VALUES[number]);
+    const attribute = advanced ? 'false' : 'true';
+    return '<button type="button" class="cr-chip" data-cr="' + entry.value + '" data-advanced="' + attribute + '" aria-pressed="false">' + entry.label + '</button>';
+  }).join('');
+}
+
+export function mountEncounterCalculator(root: Root): void {
+  setupCrOptions(root);
+  applySettings(root, readEncounterSettings() ?? DEFAULT_SETTINGS);
+  bindRanges(root);
+  bindCr(root);
+  bindCrMore(root);
+  bindPresets(root);
+  bindReset(root);
+  render(root);
+}

package/src/tool/encounter-difficulty-calculator/dnd-5e-encounter-difficulty-calculator.css

@@ -0,0 +1,389 @@
+.encounter-calculator {
+  --n-ink: #18212b;
+  --n-muted: #5b6875;
+  --n-paper: #f7f4ed;
+  --n-card: #fff;
+  --n-line: #d9d5cb;
+  --n-accent: #bf542f;
+  --n-accent-soft: #f2d1c5;
+  --n-safe: #5e8b68;
+  --n-medium: #c18b3c;
+  --n-hard: #b8643d;
+  --n-deadly: #853e42;
+  --n-shadow: #d5cec2;
+
+  color: var(--n-ink);
+  background: var(--n-paper);
+  border: 1px solid var(--n-line);
+  border-radius: 1.75rem;
+  padding: clamp(1rem, 3vw, 2rem);
+  box-shadow: 0 1rem 0 var(--n-shadow);
+}
+
+.theme-dark .encounter-calculator {
+  --n-ink: #f7f4ed;
+  --n-muted: #b5bdc4;
+  --n-paper: #1d252d;
+  --n-card: #26313b;
+  --n-line: #44515b;
+  --n-accent: #ee8661;
+  --n-accent-soft: #633d36;
+  --n-safe: #8cb596;
+  --n-medium: #dfb265;
+  --n-hard: #e18b63;
+  --n-deadly: #dc7a7d;
+  --n-shadow: #11171c;
+}
+
+.encounter-intro,
+.rules-note {
+  color: var(--n-muted);
+  line-height: 1.6;
+}
+
+.encounter-presets {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: .5rem;
+  margin: 1.25rem 0;
+  font-size: .8rem;
+  font-weight: 700;
+}
+
+.encounter-presets span {
+  color: var(--n-muted);
+  margin-right: .25rem;
+}
+
+.encounter-presets button,
+.cr-chip,
+.reset-button {
+  color: var(--n-ink);
+  background: var(--n-card);
+  border: 1px solid var(--n-line);
+  border-radius: 999px;
+  padding: .55rem .75rem;
+  cursor: pointer;
+  font: inherit;
+}
+
+.encounter-presets button:hover,
+.cr-chip:hover,
+.reset-button:hover,
+.cr-chip.is-active {
+  color: var(--n-card);
+  background: var(--n-accent);
+  border-color: var(--n-accent);
+}
+
+.encounter-layout {
+  display: grid;
+  grid-template-columns: minmax(16rem, .75fr) minmax(20rem, 1.25fr);
+  gap: 1rem;
+}
+
+.encounter-controls,
+.encounter-result {
+  background: var(--n-card);
+  border: 1px solid var(--n-line);
+  border-radius: 1.25rem;
+  padding: 1.25rem;
+}
+
+.encounter-result {
+  align-self: start;
+}
+
+.control-group + .control-group {
+  border-top: 1px solid var(--n-line);
+  margin-top: 1.25rem;
+  padding-top: 1.25rem;
+}
+
+.group-heading,
+.orbit-labels,
+.result-head,
+.result-stats,
+.encounter-controls label {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: .75rem;
+}
+
+.group-heading {
+  font-size: .75rem;
+  letter-spacing: .12em;
+  text-transform: uppercase;
+  font-weight: 800;
+  margin-bottom: 1rem;
+}
+
+.eyebrow,
+.result-kicker {
+  color: var(--n-accent);
+  font-size: .65rem;
+  letter-spacing: .1em;
+  text-transform: uppercase;
+}
+
+.encounter-controls label {
+  margin-top: .95rem;
+  font-size: .9rem;
+  font-weight: 750;
+}
+
+.encounter-controls output {
+  min-width: 2.5rem;
+  color: var(--n-accent);
+  font-size: 1.15rem;
+  text-align: right;
+}
+
+.encounter-controls input[type='range'] {
+  accent-color: var(--n-accent);
+  width: 100%;
+  margin: .7rem 0 .25rem;
+}
+
+.encounter-controls small {
+  display: block;
+  color: var(--n-muted);
+  font-size: .75rem;
+  line-height: 1.45;
+}
+
+.cr-list {
+  display: flex;
+  flex-wrap: wrap;
+  gap: .4rem;
+  margin: .75rem 0 .35rem;
+}
+
+.cr-chip {
+  padding: .4rem .55rem;
+  font-size: .78rem;
+}
+
+.cr-chip[data-advanced='true'] {
+  display: none;
+}
+
+.cr-list.is-expanded .cr-chip[data-advanced='true'] {
+  display: inline-block;
+}
+
+.cr-more-button {
+  border: 0;
+  padding: .25rem 0;
+  color: var(--n-accent);
+  background: transparent;
+  cursor: pointer;
+  font: inherit;
+  font-size: .72rem;
+  font-weight: 800;
+}
+
+.reset-button {
+  margin-top: 1.25rem;
+  color: var(--n-muted);
+  font-size: .8rem;
+}
+
+.result-orbit {
+  display: flex;
+  flex-direction: column;
+  gap: 1rem;
+}
+
+.orbit-labels {
+  color: var(--n-muted);
+  font-size: .72rem;
+  font-weight: 800;
+  letter-spacing: .1em;
+  text-transform: uppercase;
+}
+
+.orbit-scene {
+  position: relative;
+  height: 11rem;
+  overflow: hidden;
+  border: 1px solid var(--n-line);
+  border-radius: 1rem;
+  background: var(--n-paper);
+}
+
+.orbit-line {
+  position: absolute;
+  top: 50%;
+  left: 12%;
+  right: 12%;
+  border-top: 2px solid var(--n-line);
+  transform: scaleX(var(--threat-scale));
+  transform-origin: center;
+}
+
+.party-orbit,
+.threat-orbit {
+  position: absolute;
+  top: 50%;
+  display: flex;
+  gap: .4rem;
+}
+
+.party-orbit {
+  left: 10%;
+  transform: translateY(-50%);
+}
+
+.threat-orbit {
+  right: 10%;
+  opacity: var(--threat-opacity);
+  transform: translateY(-50%) scale(var(--threat-scale));
+  transform-origin: right center;
+}
+
+.party-orbit i,
+.threat-orbit b {
+  display: block;
+  width: 1rem;
+  height: 1rem;
+  border-radius: 50%;
+  background: var(--n-safe);
+  box-shadow: 0 0 0 .35rem var(--n-card), 0 0 0 .45rem var(--n-safe);
+}
+
+.party-marker,
+.threat-marker {
+  position: relative;
+}
+
+.threat-orbit b {
+  background: var(--n-deadly);
+  box-shadow: 0 0 0 .35rem var(--n-card), 0 0 0 .45rem var(--n-deadly);
+}
+
+.result-head {
+  align-items: flex-end;
+}
+
+.result-head strong {
+  color: var(--n-accent);
+  font-size: clamp(1.5rem, 4vw, 2.4rem);
+}
+
+.result-head small {
+  color: var(--n-muted);
+  font-size: .8rem;
+  font-weight: 700;
+  white-space: nowrap;
+}
+
+.result-hint {
+  margin: -.5rem 0 0;
+  color: var(--n-muted);
+  font-size: .78rem;
+  line-height: 1.45;
+}
+
+.threshold-track {
+  display: grid;
+  grid-template-columns: repeat(5, 1fr);
+  gap: .35rem;
+}
+
+.threshold-band {
+  min-height: 4.1rem;
+  display: flex;
+  flex-direction: column;
+  justify-content: space-between;
+  padding: .55rem;
+  border-top: .25rem solid var(--n-line);
+  color: var(--n-muted);
+  font-size: .68rem;
+}
+
+.threshold-band strong {
+  color: var(--n-ink);
+  font-size: .72rem;
+}
+
+.threshold-band.easy {
+  border-color: var(--n-safe);
+}
+
+.threshold-band.medium {
+  border-color: var(--n-medium);
+}
+
+.threshold-band.hard {
+  border-color: var(--n-hard);
+}
+
+.threshold-band.deadly {
+  border-color: var(--n-deadly);
+}
+
+.threshold-band.is-active {
+  background: var(--n-accent-soft);
+  color: var(--n-ink);
+}
+
+.result-stats {
+  border-top: 1px solid var(--n-line);
+  padding-top: 1rem;
+}
+
+.result-stats span {
+  display: flex;
+  flex-direction: column;
+  gap: .25rem;
+}
+
+.result-stats small {
+  color: var(--n-muted);
+  font-size: .7rem;
+}
+
+.result-stats strong {
+  font-size: .9rem;
+}
+
+.encounter-warning {
+  display: grid;
+  grid-template-columns: auto 1fr;
+  gap: .7rem;
+  border-left: .25rem solid var(--n-medium);
+  padding: .7rem .8rem;
+  color: var(--n-ink);
+  background: var(--n-paper);
+}
+
+.encounter-warning span {
+  color: var(--n-medium);
+  font-weight: 800;
+  font-size: .75rem;
+}
+
+.encounter-warning p {
+  margin: 0;
+  color: var(--n-muted);
+  font-size: .78rem;
+  line-height: 1.45;
+}
+
+.rules-note {
+  margin: 1.25rem 0 0;
+  font-size: .75rem;
+}
+
+.rules-note a {
+  color: var(--n-accent);
+}
+
+@media (max-width: 760px) {
+  .encounter-layout { grid-template-columns: 1fr; }
+  .threshold-track { grid-template-columns: repeat(2, 1fr); }
+  .threshold-band:last-child { grid-column: span 2; }
+}