@jjlmoya/utils-tabletop 1.24.0 → 1.26.0

package/src/tool/encounter-difficulty-calculator/i18n/tr.ts

@@ -0,0 +1,155 @@
+import type { FAQPage, HowTo, SoftwareApplication, WithContext } from 'schema-dts';
+import { bibliography } from '../bibliography';
+import type { EncounterDifficultyLocaleContent, EncounterDifficultyUI } from '../entry';
+
+const ui: EncounterDifficultyUI = {
+  intro: 'Grubu ve tehdidi ayarlayın. Hesaplayıcı karşılaşmayı D&D 5e 2014 eşikleriyle karşılaştırır.',
+  partySection: 'Grup',
+  partyLevel: 'Karakter seviyesi',
+  partyLevelHint: 'Benzer seviyedeki bir grup için ortalama seviye kullanın.',
+  partySize: 'Karakterler',
+  partySizeHint: 'Kurallar çok küçük veya büyük gruplar için canavar çarpanını ayarlar.',
+  threatSection: 'Tehdit',
+  monsterCr: 'Canavar meydan okuma derecesi (CR)',
+  monsterCrHint: 'Aynı tür canavarlar için bir CR seçin. Karışık gruplar ayrı hesaplama gerektirir.',
+  moreCr: 'Daha yüksek CR göster',
+  lessCr: 'Daha az CR göster',
+  monsterCount: 'Canavar sayısı',
+  monsterCountHint: 'Daha fazla yaratık, temel XP mütevazı olsa bile eylem baskısını artırır.',
+  presets: 'Bir sahne ile başlayın',
+  presetClassic: 'Klasik devriye',
+  presetBoss: 'Yalnız patron',
+  presetSwarm: 'Minyon sürüsü',
+  resultSection: 'Karşılaşma baskısı',
+  belowEasyHint: 'Gelecek zorluklar için kaynakları koruyan hafif bir sahne.',
+  easyHint: 'Grup üzerinde az baskı oluşturan yönetilebilir bir sahne.',
+  mediumHint: 'Can puanı veya kaynak maliyeti çıkarabilecek anlamlı bir test.',
+  hardHint: 'Taktik ve kaynak seçimlerinin önem taşıdığı tehlikeli bir sahne.',
+  deadlyHint: 'Ölümcül baskı sinyali. Kaçış yollarını ve araziyi kontrol edin.',
+  adjustedXp: 'Ayarlanmış XP',
+  baseXp: 'Temel XP',
+  multiplier: 'Grup çarpanı',
+  partyThreshold: 'Orta eşik',
+  belowEasy: 'Kolay altı',
+  easy: 'Kolay',
+  medium: 'Orta',
+  hard: 'Zor',
+  deadly: 'Ölümcül',
+  warning: 'Dikkat',
+  partyAdjustment: 'Grup üçten az veya beşten fazla karakterden oluştuğu için çarpan ayarlandı.',
+  highCr: 'Grup seviyesinden yüksek CR değerine sahip bir canavar bir karakteri hızlıca düşürebilir.',
+  manyMonsters: 'On bir veya daha fazla canavar savaşı yönetmeyi zorlaştırır.',
+  rulesNote: 'D&D 5e 2014 kurallarına göre tahmindir. Arazi veya taktikleri hesaba katmaz.',
+  rulesLinkLabel: 'Kaynak kuralları oku',
+  reset: 'Örneğe sıfırla',
+  xpUnit: 'XP',
+  sceneLabel: 'Savaş baskısı görsel göstergesi',
+  partyMarker: 'Grup',
+  threatMarker: 'Tehdit',
+};
+
+const faq = [
+  {
+    question: 'Bu karşılaşma zorluğu hesaplayıcısı hangi kuralları kullanır?',
+    answer: 'Temel Kurallar daki resmi D&D 5e 2014 yöntemini kullanır. Kolay, orta, zor ve ölümcül eşikleri ayarlanmış XP ile karşılaştırır.',
+  },
+  {
+    question: 'Ayarlanmış XP neden canavarın ödül XP sinden farklıdır?',
+    answer: 'Kurallar, aynı turda hareket eden birden fazla yaratığın tehlikesini yansıtmak için toplam XP yi bir çarpanla çarpar.',
+  },
+  {
+    question: 'Bunu karışık canavar grupları için kullanabilir miyim?',
+    answer: 'Aynı tür canavarlar için hızlı bir tahmin olarak kullanın. Karışık gruplarda her yaratığın XP sini toplayıp çarpanı uygulayın.',
+  },
+  {
+    question: 'Ölümcül sonuç grubun öleceği anlamına mı gelir?',
+    answer: 'Hayır. Ölümcül, ayarlanmış XP nin ölümcül eşiğe ulaştığını gösterir. Arazi, taktikler ve büyüler sonucu değiştirebilir.',
+  },
+  {
+    question: 'Grup büyüklüğü çarpanı neden değiştirir?',
+    answer: 'Temel Kurallar, üçten az karaktere sahip gruplar için çarpanı artırmayı, altı veya daha fazla karakter için azaltmayı önerir.',
+  },
+];
+
+const howTo = [
+  {
+    name: 'Grup seviyesini ayarlayın',
+    text: 'Gruptaki karakterlerin ortalama seviyesini seçin.',
+  },
+  {
+    name: 'Grup büyüklüğünü belirleyin',
+    text: 'Savaşa katılacak karakter sayısını girin.',
+  },
+  {
+    name: 'Tehdidi tanımlayın',
+    text: 'Meydan okuma derecesini (CR) ve canavar sayısını seçin.',
+  },
+  {
+    name: 'Baskıyı inceleyin',
+    text: 'Ayarlanmış XP yi resmi zorluk eşikleriyle karşılaştırın.',
+  },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faq.map((item) => ({
+    '@type': 'Question',
+    name: item.question,
+    acceptedAnswer: { '@type': 'Answer', text: item.answer },
+  })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: 'D&D 5e Karşılaşma Zorluğu Hesaplayıcı',
+  operatingSystem: 'All',
+  applicationCategory: 'GameApplication',
+  description: 'Seviye, grup büyüklüğü, canavar CR, sayı ve resmi eşiklere göre D&D 5e 2014 karşılaşma zorluğunu hesaplayın.',
+};
+
+const howToSchema: WithContext<HowTo> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: 'D&D 5e karşılaşma zorluğu nasıl hesaplanır',
+  step: howTo.map((item) => ({
+    '@type': 'HowToStep',
+    name: item.name,
+    text: item.text,
+  })),
+};
+
+export const content: EncounterDifficultyLocaleContent = {
+  slug: 'dnd-5e-karsilasma-zorlugu-hesaplayici',
+  title: 'D&D 5e Karşılaşma Zorluğu Hesaplayıcı',
+  description: 'Grup seviyesi, büyüklük, canavar CR, ayarlanmış XP ve resmi eşikler ile D&D 5e 2014 karşılaşma baskısını tahmin edin.',
+  ui,
+  seo: [
+    { type: 'title', text: 'İnisiyatif zarı atılmadan önce savaş zorluğunu değerlendirin', level: 2 },
+    { type: 'paragraph', html: 'Bir D&D karşılaşması bir canavarın yanında yazan sayıdan ibaret değildir. Bu hesaplayıcı grup büyüklüğü, seviye, CR ve canavar sayısını D&D 5e 2014 kurallarındaki ayarlanmış XP değerine dönüştürür. Görsel sonuç, karşılaşmanın kolay, orta, zor ve ölümcül eşiklerine göre nerede durduğunu net bir şekilde gösterir.' },
+    { type: 'title', text: 'D&D 5e karşılaşma formülü nasıl çalışır', level: 2 },
+    { type: 'paragraph', html: 'Yöntem her zorluk seviyesi için her karakterin XP eşiğini toplar ve ardından toplam canavar XP sine çarpan uygular. Üçten az karaktere sahip gruplar bir üst çarpanı kullanırken, altı veya daha fazla karaktere sahip gruplar bir alt çarpanı kullanır.' },
+    {
+      type: 'table',
+      headers: ['Sinyal', 'Masada ne kontrol edilmeli'],
+      rows: [
+        ['Kolay altı', 'Karşılaşma bir ısınma veya hafif kaynak harcama sahnesidir.'],
+        ['Kolay', 'Grup genellikle fazla kaynak harcamadan kazanır.'],
+        ['Orta', 'Belirli bir baskı ve kaynak kullanımı konusunda anlamlı seçimler bekleyin.'],
+        ['Zor', 'Can puanı ve büyü yuvası kaybı planlayın.'],
+        ['Ölümcül', 'Taktikleri, araziyi ve kaçış yollarını kontrol edin.'],
+      ],
+    },
+    { type: 'title', text: 'Canavar sayısı neden önemlidir', level: 2 },
+    { type: 'paragraph', html: 'Birden fazla canavar aynı turda daha fazla saldırı ve reaksiyon yapabildiği için temel XP lerinin gösterdiğinden daha büyük tehlike yaratır. Bu nedenle bir çift yaratık, aynı birleşik XP ye sahip tek bir yaratıktan daha yüksek bir çarpan kullanır.' },
+    { type: 'tip', title: 'Yüksek CR değerini özel bir uyarı olarak görün', html: 'Grup seviyesinin üzerinde CR ye sahip bir canavar bir karakteri tek bir güçlü eylemle saf dışı bırakabilir. Yalnızca zorluk etiketine güvenmek yerine hasarı ve kontrol etkilerini doğrudan inceleyin.' },
+    { type: 'title', text: 'Sonucu bir hazırlık aracı olarak kullanın', level: 2 },
+    { type: 'paragraph', html: 'Zor veya ölümcül bir karşılaşma hazırlamadan önce ortamı, sürprizi ve grubun genel durumunu değerlendirin. Dar odalar, siperler, tuzaklar ve konsantrasyon büyüleri masadaki gerçek tehlikeyi önemli ölçüde değiştirebilir.' },
+    { type: 'tip', title: 'Karışık canavar grupları', html: 'Her yaratığın temel XP sini toplayın ve toplam canavar sayısına karşılık gelen çarpanı uygulayın.' },
+  ],
+  faq,
+  bibliography,
+  howTo,
+  schemas: [faqSchema, appSchema, howToSchema] as unknown as Record<string, unknown>[],
+};

package/src/tool/encounter-difficulty-calculator/i18n/zh.ts

@@ -0,0 +1,155 @@
+import type { FAQPage, HowTo, SoftwareApplication, WithContext } from 'schema-dts';
+import { bibliography } from '../bibliography';
+import type { EncounterDifficultyLocaleContent, EncounterDifficultyUI } from '../entry';
+
+const ui: EncounterDifficultyUI = {
+  intro: '设置队伍与威胁。计算器将根据 D&D 5e 2014 的官方阈值评估遭遇战的压力。',
+  partySection: '队伍设置',
+  partyLevel: '角色等级',
+  partyLevelHint: '对于等级相近的队伍，请使用平均等级。',
+  partySize: '角色人数',
+  partySizeHint: '规则会对过小或过大的队伍调整怪物乘数。',
+  threatSection: '威胁设置',
+  monsterCr: '怪物挑战等级 (CR)',
+  monsterCrHint: '选择同种怪物的 CR。混合怪物组合需要单独计算。',
+  moreCr: '显示更高 CR',
+  lessCr: '显示更少 CR',
+  monsterCount: '怪物数量',
+  monsterCountHint: '即便基础 XP 较低，较多的怪物也会显著增加行动经济压力。',
+  presets: '从预设场景开始',
+  presetClassic: '经典巡逻队',
+  presetBoss: '单体 Boss',
+  presetSwarm: '杂兵蜂拥',
+  resultSection: '遭遇战压力评估',
+  belowEasyHint: '轻松场景，可保留资源用于后续挑战。',
+  easyHint: '可控场景，对队伍压力较小。',
+  mediumHint: '有意义的考验，可能会消耗生命值或关键资源。',
+  hardHint: '危险场景，战术与资源选择至关重要。',
+  deadlyHint: '致命压力信号！请检查撤退路线、地形及失误成本。',
+  adjustedXp: '调整后 XP',
+  baseXp: '基础 XP',
+  multiplier: '队伍乘数',
+  partyThreshold: '中等阈值',
+  belowEasy: '低于简单',
+  easy: '简单',
+  medium: '中等',
+  hard: '困难',
+  deadly: '致命',
+  warning: '注意事项',
+  partyAdjustment: '由于队伍人数少于3人或多于5人，怪物乘数已作相应调整。',
+  highCr: 'CR 高于队伍等级的怪物可能在单次强力行动中击倒角色。',
+  manyMonsters: '11 个或更多怪物会让战斗主持变得复杂。',
+  rulesNote: '基于 D&D 5e 2014 规则的估算，未包含地形或战术因素。',
+  rulesLinkLabel: '阅读源规则',
+  reset: '重置为示例',
+  xpUnit: 'XP',
+  sceneLabel: '战斗压力可视化',
+  partyMarker: '队伍',
+  threatMarker: '威胁',
+};
+
+const faq = [
+  {
+    question: '本遭遇难度计算器使用什么规则？',
+    answer: '它使用基础规则中 D&D 5e 2014 的官方计算公式，将队伍阈值与怪物的调整后 XP 进行对比。',
+  },
+  {
+    question: '为什么调整后 XP 与怪物奖励 XP 不同？',
+    answer: '规则对怪物总 XP 进行乘数放大，以反映多个生物在同一轮行动带来的额外危险。',
+  },
+  {
+    question: '能否用于计算混合怪物组合？',
+    answer: '适合作为同种怪物的快速估算。对于混合组合，请累加每个生物的基础 XP 后再乘以对应乘数。',
+  },
+  {
+    question: '致命结果是否意味着队伍必然团灭？',
+    answer: '并非如此。致命代表调整后 XP 达到了致命阈值。地形、战术和法术使用都会改变实际结果。',
+  },
+  {
+    question: '为什么队伍人数会改变乘数？',
+    answer: '官方规则建议对少于 3 人的队伍提高乘数，对 6 人及以上的队伍降低乘数。',
+  },
+];
+
+const howTo = [
+  {
+    name: '设置队伍等级',
+    text: '选择队伍中角色的平均等级。',
+  },
+  {
+    name: '设置队伍人数',
+    text: '输入参战角色的数量。',
+  },
+  {
+    name: '描述威胁',
+    text: '选择怪物的挑战等级 (CR) 和数量。',
+  },
+  {
+    name: '评估压力',
+    text: '对比调整后 XP 与官方难度阈值区间。',
+  },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faq.map((item) => ({
+    '@type': 'Question',
+    name: item.question,
+    acceptedAnswer: { '@type': 'Answer', text: item.answer },
+  })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: 'D&D 5e 遭遇难度计算器',
+  operatingSystem: 'All',
+  applicationCategory: 'GameApplication',
+  description: '根据等级、队伍人数、怪物 CR、数量及官方阈值计算 D&D 5e 2014 的遭遇战难度。',
+};
+
+const howToSchema: WithContext<HowTo> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: '如何计算 D&D 5e 遭遇战难度',
+  step: howTo.map((item) => ({
+    '@type': 'HowToStep',
+    name: item.name,
+    text: item.text,
+  })),
+};
+
+export const content: EncounterDifficultyLocaleContent = {
+  slug: 'dnd-5e-encounter-difficulty-calculator',
+  title: 'D&D 5e 遭遇难度计算器',
+  description: '借助队伍等级、人数、怪物 CR、调整后 XP 与官方阈值估算 D&D 5e 2014 的战斗压力。',
+  ui,
+  seo: [
+    { type: 'title', text: '在投掷先攻前评估战斗难度', level: 2 },
+    { type: 'paragraph', html: 'D&D 遭遇战远不止怪物卡上的数值。本计算器将队伍人数、等级、CR 和怪物数量转化为 D&D 5e 2014 规则的调整后 XP。可视化展示可以清晰展现遭遇战相对于简单、中等、困难和致命阈值所处的位置与危险程度。' },
+    { type: 'title', text: 'D&D 5e 遭遇计算公式原理', level: 2 },
+    { type: 'paragraph', html: '该方法首先汇总各难度等级下的角色 XP 阈值，然后对怪物基础 XP 总和乘以相应的数量乘数。少于 3 人的队伍使用高一阶的乘数，而 6 人及以上的队伍则使用低一阶的乘数进行平衡调整。' },
+    {
+      type: 'table',
+      headers: ['信号', '案头检查要点'],
+      rows: [
+        ['低于简单', '遭遇战可作为热身或轻微资源消耗。'],
+        ['简单', '队伍通常无需消耗过多资源即可获胜。'],
+        ['中等', '预计会有适度压力以及至少一次关键资源决策。'],
+        ['困难', '请预估生命值与法术位的损失。'],
+        ['致命', '检查战术、地形及撤退路线。'],
+      ],
+    },
+    { type: 'title', text: '为什么怪物数量至关重要', level: 2 },
+    { type: 'paragraph', html: '多个怪物在同轮中拥有更多攻击与反应机会，因此带来的危险远超其基础 XP 所示。这就是为什么一对怪物使用的乘数要高于具有相同合并 XP 的单只怪物的原因所在。' },
+    { type: 'tip', title: '将高 CR 视作特定预警', html: 'CR 高于队伍等级的怪物可能凭借单次强力行动直接击倒角色。请仔细检查其伤害能力与控制效果，而不要仅仅依赖最终的难度标签或文字说明。' },
+    { type: 'title', text: '将计算结果作为备战辅助工具', level: 2 },
+    { type: 'paragraph', html: '在安排困难或致命遭遇前，请评估环境、突袭及队伍的整体状态。狭窄的空间、遮蔽物、环境伤害和专注法术都可能极大地改变桌面上的实际危险程度与战斗走向。' },
+    { type: 'tip', title: '混合怪物组合', html: '累加每个生物的基础 XP，并对怪物总数施加对应的乘数进行评估。' },
+  ],
+  faq,
+  bibliography,
+  howTo,
+  schemas: [faqSchema, appSchema, howToSchema] as unknown as Record<string, unknown>[],
+};

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

@@ -0,0 +1,11 @@
+import type { ToolDefinition } from '../../types';
+import { encounterDifficultyCalculator } from './entry';
+
+export * from './entry';
+
+export const ENCOUNTER_DIFFICULTY_CALCULATOR_TOOL: ToolDefinition = {
+  entry: encounterDifficultyCalculator,
+  Component: () => import('./component.astro'),
+  SEOComponent: () => import('./seo.astro'),
+  BibliographyComponent: () => import('./bibliography.astro'),
+};

package/src/tool/encounter-difficulty-calculator/logic.test.ts

@@ -0,0 +1,37 @@
+import { describe, expect, it } from 'vitest';
+import { calculateEncounter } from './logic';
+
+describe('calculateEncounter', () => {
+  it('calculates a medium encounter for a level five party', () => {
+    const result = calculateEncounter({ partyLevel: 5, partySize: 4, monsterCr: 3, monsterCount: 2 });
+    expect(result.monsterXp).toBe(700);
+    expect(result.adjustedXp).toBe(2100);
+    expect(result.difficulty).toBe('medium');
+  });
+
+  it('applies the multiple monster multiplier', () => {
+    const result = calculateEncounter({ partyLevel: 3, partySize: 4, monsterCr: 1, monsterCount: 4 });
+    expect(result.baseXp).toBe(800);
+    expect(result.multiplier).toBe(2);
+    expect(result.adjustedXp).toBe(1600);
+    expect(result.difficulty).toBe('deadly');
+  });
+
+  it('raises the multiplier for a small party', () => {
+    const result = calculateEncounter({ partyLevel: 5, partySize: 2, monsterCr: 2, monsterCount: 2 });
+    expect(result.multiplier).toBe(2);
+    expect(result.warnings).toContain('partyAdjustment');
+  });
+
+  it('lowers the multiplier for a large party', () => {
+    const result = calculateEncounter({ partyLevel: 5, partySize: 6, monsterCr: 2, monsterCount: 6 });
+    expect(result.multiplier).toBe(1.5);
+    expect(result.warnings).toContain('partyAdjustment');
+  });
+
+  it('clamps unsafe inputs to the supported range', () => {
+    const result = calculateEncounter({ partyLevel: 99, partySize: 99, monsterCr: 99, monsterCount: 99 });
+    expect(result.settings).toEqual({ partyLevel: 20, partySize: 8, monsterCr: 30, monsterCount: 15 });
+    expect(result.difficulty).toBe('deadly');
+  });
+});

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

@@ -0,0 +1,174 @@
+export type EncounterDifficulty = 'belowEasy' | 'easy' | 'medium' | 'hard' | 'deadly';
+
+export interface EncounterSettings {
+  partyLevel: number;
+  partySize: number;
+  monsterCr: number;
+  monsterCount: number;
+}
+
+export interface EncounterThresholds {
+  easy: number;
+  medium: number;
+  hard: number;
+  deadly: number;
+}
+
+export interface EncounterResult {
+  settings: EncounterSettings;
+  monsterXp: number;
+  baseXp: number;
+  multiplier: number;
+  adjustedXp: number;
+  thresholds: EncounterThresholds;
+  difficulty: EncounterDifficulty;
+  crLabel: string;
+  warnings: string[];
+}
+
+interface CrEntry {
+  value: number;
+  label: string;
+  xp: number;
+}
+
+const CR_ENTRIES: CrEntry[] = [
+  { value: 0, label: '0', xp: 10 },
+  { value: 0.125, label: '1/8', xp: 25 },
+  { value: 0.25, label: '1/4', xp: 50 },
+  { value: 0.5, label: '1/2', xp: 100 },
+  { value: 1, label: '1', xp: 200 },
+  { value: 2, label: '2', xp: 450 },
+  { value: 3, label: '3', xp: 700 },
+  { value: 4, label: '4', xp: 1100 },
+  { value: 5, label: '5', xp: 1800 },
+  { value: 6, label: '6', xp: 2300 },
+  { value: 7, label: '7', xp: 2900 },
+  { value: 8, label: '8', xp: 3900 },
+  { value: 9, label: '9', xp: 5000 },
+  { value: 10, label: '10', xp: 5900 },
+  { value: 11, label: '11', xp: 7200 },
+  { value: 12, label: '12', xp: 8400 },
+  { value: 13, label: '13', xp: 10000 },
+  { value: 14, label: '14', xp: 11500 },
+  { value: 15, label: '15', xp: 13000 },
+  { value: 16, label: '16', xp: 15000 },
+  { value: 17, label: '17', xp: 18000 },
+  { value: 18, label: '18', xp: 20000 },
+  { value: 19, label: '19', xp: 22000 },
+  { value: 20, label: '20', xp: 25000 },
+  { value: 21, label: '21', xp: 33000 },
+  { value: 22, label: '22', xp: 41000 },
+  { value: 23, label: '23', xp: 50000 },
+  { value: 24, label: '24', xp: 62000 },
+  { value: 25, label: '25', xp: 75000 },
+  { value: 26, label: '26', xp: 90000 },
+  { value: 27, label: '27', xp: 105000 },
+  { value: 28, label: '28', xp: 120000 },
+  { value: 29, label: '29', xp: 135000 },
+  { value: 30, label: '30', xp: 155000 },
+];
+
+const THRESHOLDS = [
+  [25, 50, 75, 100], [50, 100, 150, 200], [75, 150, 225, 400],
+  [125, 250, 375, 500], [250, 500, 750, 1100], [300, 600, 900, 1400],
+  [350, 750, 1100, 1700], [450, 900, 1400, 2100], [550, 1100, 1600, 2400],
+  [600, 1200, 1900, 2800], [800, 1600, 2400, 3600], [1000, 2000, 3000, 4500],
+  [1100, 2200, 3400, 5100], [1250, 2500, 3800, 5700], [1400, 2800, 4300, 6400],
+  [1600, 3200, 4800, 7200], [2000, 3900, 5900, 8800], [2100, 4200, 6300, 9500],
+  [2400, 4900, 7300, 10900], [2800, 5700, 8500, 12700],
+] as const;
+
+const MULTIPLIERS = [1, 1.5, 2, 2.5, 3, 4];
+
+export const DEFAULT_SETTINGS: EncounterSettings = {
+  partyLevel: 5,
+  partySize: 4,
+  monsterCr: 2,
+  monsterCount: 2,
+};
+
+export const CR_OPTIONS = CR_ENTRIES;
+export const QUICK_CR_VALUES = [0, 0.125, 0.25, 0.5, 1, 2, 3, 4, 5, 8, 10, 15];
+
+function clamp(value: number, min: number, max: number): number {
+  return Math.min(Math.max(value, min), max);
+}
+
+function findCrEntry(cr: number): CrEntry {
+  return CR_ENTRIES.reduce((closest, entry) => (
+    Math.abs(entry.value - cr) < Math.abs(closest.value - cr) ? entry : closest
+  ));
+}
+
+function getBaseMultiplier(monsterCount: number): number {
+  if (monsterCount === 1) return 1;
+  if (monsterCount === 2) return 1.5;
+  if (monsterCount <= 6) return 2;
+  if (monsterCount <= 10) return 2.5;
+  if (monsterCount <= 14) return 3;
+  return 4;
+}
+
+function getPartyAdjustment(partySize: number): number {
+  if (partySize < 3) return 1;
+  if (partySize > 5) return -1;
+  return 0;
+}
+
+function getMultiplier(monsterCount: number, partySize: number): number {
+  const baseIndex = MULTIPLIERS.indexOf(getBaseMultiplier(monsterCount));
+  const partyAdjustment = getPartyAdjustment(partySize);
+  return MULTIPLIERS[clamp(baseIndex + partyAdjustment, 0, MULTIPLIERS.length - 1)];
+}
+
+function getThresholds(partyLevel: number, partySize: number): EncounterThresholds {
+  const row = THRESHOLDS[clamp(partyLevel, 1, 20) - 1];
+  return {
+    easy: row[0] * partySize,
+    medium: row[1] * partySize,
+    hard: row[2] * partySize,
+    deadly: row[3] * partySize,
+  };
+}
+
+function getDifficulty(adjustedXp: number, thresholds: EncounterThresholds): EncounterDifficulty {
+  if (adjustedXp < thresholds.easy) return 'belowEasy';
+  if (adjustedXp < thresholds.medium) return 'easy';
+  if (adjustedXp < thresholds.hard) return 'medium';
+  if (adjustedXp < thresholds.deadly) return 'hard';
+  return 'deadly';
+}
+
+function getWarnings(settings: EncounterSettings): string[] {
+  const warnings: string[] = [];
+  if (settings.partySize < 3 || settings.partySize > 5) warnings.push('partyAdjustment');
+  if (settings.monsterCr > settings.partyLevel) warnings.push('highCr');
+  if (settings.monsterCount >= 11) warnings.push('manyMonsters');
+  return warnings;
+}
+
+export function calculateEncounter(rawSettings: EncounterSettings): EncounterResult {
+  const settings: EncounterSettings = {
+    partyLevel: clamp(Math.round(rawSettings.partyLevel), 1, 20),
+    partySize: clamp(Math.round(rawSettings.partySize), 1, 8),
+    monsterCr: findCrEntry(rawSettings.monsterCr).value,
+    monsterCount: clamp(Math.round(rawSettings.monsterCount), 1, 15),
+  };
+  const crEntry = findCrEntry(settings.monsterCr);
+  const thresholds = getThresholds(settings.partyLevel, settings.partySize);
+  const baseXp = crEntry.xp * settings.monsterCount;
+  const multiplier = getMultiplier(settings.monsterCount, settings.partySize);
+  const adjustedXp = Math.round(baseXp * multiplier);
+  return {
+    settings,
+    monsterXp: crEntry.xp,
+    baseXp,
+    multiplier,
+    adjustedXp,
+    thresholds,
+    difficulty: getDifficulty(adjustedXp, thresholds),
+    crLabel: crEntry.label,
+    warnings: getWarnings(settings),
+  };
+}

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

@@ -0,0 +1,16 @@
+---
+import { SEORenderer } from '@jjlmoya/utils-shared';
+import { encounterDifficultyCalculator } from './index';
+import type { KnownLocale } from '../../types';
+
+interface Props {
+  locale?: KnownLocale;
+}
+
+const { locale = 'en' } = Astro.props as Props;
+const loader = encounterDifficultyCalculator.i18n[locale] || encounterDifficultyCalculator.i18n.en;
+const content = await loader?.();
+if (!content) return null;
+---
+
+{content.seo?.length > 0 && <SEORenderer content={{ locale, sections: content.seo }} />}

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

@@ -0,0 +1,26 @@
+import type { EncounterSettings } from './logic';
+
+const STORAGE_KEY = 'jjlmoya-encounter-difficulty-settings-v1';
+
+function isSettings(value: unknown): value is EncounterSettings {
+  if (!value || typeof value !== 'object') return false;
+  const candidate = value as Record<string, unknown>;
+  return ['partyLevel', 'partySize', 'monsterCr', 'monsterCount'].every((key) => typeof candidate[key] === 'number');
+}
+
+export function readEncounterSettings(): EncounterSettings | null {
+  try {
+    const stored = localStorage.getItem(STORAGE_KEY);
+    if (!stored) return null;
+    const value: unknown = JSON.parse(stored);
+    return isSettings(value) ? value : null;
+  } catch {
+    return null;
+  }
+}
+
+export function writeEncounterSettings(settings: EncounterSettings): void {
+  try {
+    localStorage.setItem(STORAGE_KEY, JSON.stringify(settings));
+  } catch {}
+}

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

@@ -0,0 +1,45 @@
+export interface EncounterDifficultyUI {
+  intro: string;
+  partySection: string;
+  partyLevel: string;
+  partyLevelHint: string;
+  partySize: string;
+  partySizeHint: string;
+  threatSection: string;
+  monsterCr: string;
+  monsterCrHint: string;
+  moreCr: string;
+  lessCr: string;
+  monsterCount: string;
+  monsterCountHint: string;
+  presets: string;
+  presetClassic: string;
+  presetBoss: string;
+  presetSwarm: string;
+  resultSection: string;
+  belowEasyHint: string;
+  easyHint: string;
+  mediumHint: string;
+  hardHint: string;
+  deadlyHint: string;
+  adjustedXp: string;
+  baseXp: string;
+  multiplier: string;
+  partyThreshold: string;
+  belowEasy: string;
+  easy: string;
+  medium: string;
+  hard: string;
+  deadly: string;
+  warning: string;
+  partyAdjustment: string;
+  highCr: string;
+  manyMonsters: string;
+  rulesNote: string;
+  rulesLinkLabel: string;
+  reset: string;
+  xpUnit: string;
+  sceneLabel: string;
+  partyMarker: string;
+  threatMarker: string;
+}

package/src/tools.ts

@@ -12,6 +12,7 @@ import { LUNAR_TIDE_TRACKER_TOOL } from './tool/lunar-tide-tracker';
 import { HIDDEN_ROLE_DEALER_TOOL } from './tool/hidden-role-dealer';
 import { SCATTER_DIRECTION_SELECTOR_TOOL } from './tool/scatter-direction-selector';
 import { DUNGEON_MAP_GENERATOR_TOOL } from './tool/dungeon-map-generator';
+import { ENCOUNTER_DIFFICULTY_CALCULATOR_TOOL } from './tool/encounter-difficulty-calculator';
 
 export const ALL_TOOLS: ToolDefinition[] = [
   DICE_ROLLER_SIMULATOR_TOOL,
@@ -26,5 +27,6 @@ export const ALL_TOOLS: ToolDefinition[] = [
   HIDDEN_ROLE_DEALER_TOOL,
   SCATTER_DIRECTION_SELECTOR_TOOL,
   DUNGEON_MAP_GENERATOR_TOOL,
+  ENCOUNTER_DIFFICULTY_CALCULATOR_TOOL,
 ];