@jjlmoya/utils-tabletop 1.10.0 → 1.12.0

package/src/tool/hidden-role-dealer/i18n/tr.ts

@@ -0,0 +1,191 @@
+import { bibliography } from '../bibliography';
+import type { ToolLocaleContent } from '../../../types';
+import type { HiddenRoleDealerUI } from '../entry';
+
+const ui: HiddenRoleDealerUI = {
+  title: 'Gizli Rol Dağıtıcı',
+  setupTitle: 'Rol Dağıtım Kurulumu',
+  playerList: 'Oyuncu Listesi',
+  addPlayer: 'Ekle',
+  addPlayerPlaceholder: 'Oyuncu adı girin...',
+  rolePool: 'Gizli Rol Havuzu',
+  presetsTitle: 'Oyun Şablonları',
+  presetCustom: 'Özel Kurulum',
+  dealRoles: 'Gizli Rolleri Dağıt',
+  clearPlayers: 'Tümünü Temizle',
+  instructions: 'Oyuncu adlarını girin, gizli rolleri yapılandırın ve Gizli Rolleri Dağıt\'a dokunun.',
+  passTo: 'Cihazı şu oyuncuya verin:',
+  holdToReveal: 'Göster seçeneği için basılı tutun',
+  releasingResets: 'Göstermek için basılı tutmaya devam edin...',
+  hideRole: 'Anlaşıldı, rolü gizle',
+  nextPlayer: 'Sıradaki Oyuncu',
+  finishedTitle: 'Tüm Roller Dağıtıldı',
+  finishedDesc: 'Tüm oyuncular gizlice rollerine baktı. Artık oyunu başlatabilirsiniz.',
+  restart: 'Yeniden Başlat ve Dağıt',
+  rolesCount: 'Seçilen Roller',
+  playersCount: 'Eklenen Oyuncular',
+  mismatchWarning: 'Rolleri dağıtmak için en az 3 oyuncu gereklidir.',
+  werewolfName: 'Kurt Adam / Vampir',
+  werewolfDesc: 'Köylüler gizli Kurt Adamları bulmaya ve oylama ile elemeye çalışır.',
+  avalonName: 'The Resistance: Avalon',
+  avalonDesc: 'Merlin ve sadık hizmetkarlar sabote edilmekten kaçınarak görevleri tamamlar.',
+  hitlerName: 'Secret Hitler',
+  hitlerDesc: 'Liberaller yasaları geçirmeye ve gizli lideri bulmaya çalışır.',
+  customName: 'Özel Kurulum',
+  customDesc: 'Oyunculara basit etiketli kartlar dağıtın.',
+  roleWerewolfName: 'Kurt Adam',
+  roleWerewolfDesc: 'Geceleri gizlice Köylüleri eleyin.',
+  roleWerewolfSecret: 'Köyü kandırmak için diğer Kurt Adamlarla birlikte çalışın.',
+  roleSeerName: 'Kahin',
+  roleSeerDesc: 'Her gece bir oyuncunun tarafını kontrol edin.',
+  roleSeerSecret: 'Kurt Adamları belirleyin ancak hayatta kalmak için gizli kalın.',
+  roleDoctorName: 'Doktor',
+  roleDoctorDesc: 'Her gece bir oyuncuyu elenmekten koruyun.',
+  roleDoctorSecret: 'Kritik köylüleri hayatta tutun.',
+  roleVillagerName: 'Köylü',
+  roleVillagerDesc: 'Gizli Kurt Adamları bulun.',
+  roleVillagerSecret: 'Tartışın, analiz edin ve şüpheli oyunculara oy verin.',
+  roleMerlinName: 'Merlin',
+  roleMerlinDesc: 'Kötülüğün ajanlarını bilir.',
+  roleMerlinSecret: 'Kendinizi belli etmeden takımınızı zafere ulaştırın.',
+  roleAssassinName: 'Suikastçı',
+  roleAssassinDesc: 'Oyun sonunda Merlin\'e suikast düzenleyebilir.',
+  roleAssassinSecret: 'Sonunda Merlin\'i bularak zaferi çalın.',
+  roleMinionName: 'Mordred\'in Hizmetkarı',
+  roleMinionDesc: 'Mordred\'in bilgili ajanı.',
+  roleMinionSecret: 'Fark edilmeden görevleri sabote edin.',
+  roleServantName: 'Sadık Hizmetkar',
+  roleServantDesc: 'Arthur için görevleri tamamlayın.',
+  roleServantSecret: 'Tartışın, takım önerin ve mantıklı oy kullanın.',
+  roleHitlerName: 'Hitler',
+  roleHitlerDesc: 'Faşistlerin gizli lideri.',
+  roleHitlerSecret: 'Şansölye seçilin veya Faşistlerin yasaları geçirmesine izin verin.',
+  roleFascistName: 'Faşist',
+  roleFascistDesc: 'Faşist yasaları geçirmek için koordinasyon sağlayın.',
+  roleFascistSecret: 'Hitler\'i koruyun ve seçim sonuçlarını manipüle edin.',
+  roleLiberalName: 'Liberal',
+  roleLiberalDesc: 'Faşist tehdidi bulun ve durdurun.',
+  roleLiberalSecret: 'Liberal yasaları geçirin ve mümkünse Hitler\'i eleyin.',
+  roleCustomName: 'Özel Rol',
+  roleCustomDesc: 'Özel rolün genel açıklaması.',
+  roleCustomSecret: 'Takım hedefinizi gerçekleştirin.',
+  teamWerewolves: 'Kurt Adamlar',
+  teamVillagers: 'Köylüler',
+  teamGood: 'İyi',
+  teamEvil: 'Kötü',
+  teamFascist: 'Faşist',
+  teamLiberal: 'Liberal',
+  teamCustom: 'Özel Takım',
+  secretRoleIs: 'gizli rolünüz:',
+  customRolesTitle: 'Özel Rol Kurulumu',
+  customRolePlaceholder: 'Rol adı girin...',
+  neutralLabel: 'Tarafsız',
+  goodLabel: 'İyi',
+  evilLabel: 'Kötü',
+  customMismatchWarning: 'Oyuncu sayısı kadar özel rol yapılandırın.',
+  impostorPresetName: 'Aramızdaki Hain (Impostor)',
+  impostorPresetDesc: 'Özelleştirilebilir sayılarla Hain ve Mürettebat rolleri atayın.',
+  impostorTitle: 'Hain Ayarları',
+  impostorWarning: 'Hainlerden daha fazla oyuncuya ihtiyacınız var.',
+  roleImpostorName: 'Hain',
+  roleImpostorDesc: 'Mürettebat üyelerini gizlice eleyin.',
+  roleImpostorSecret: 'Yakalanmadan sabote edin ve eleyin.',
+  roleCrewmateName: 'Mürettebat',
+  roleCrewmateDesc: 'Görevleri tamamlayın ve Hain\'i bulun.',
+  roleCrewmateSecret: 'Gizli kelime:',
+  teamImpostor: 'Hain',
+  teamCrewmate: 'Mürettebat',
+  impostorSharedSecretLabel: 'Ortak Gizli Kelime',
+  impostorSharedSecretPlaceholder: 'örn. Yer: Restoran veya Kelime: Elma',
+  impostorModeLabel: 'Hain Hesaplama Modu',
+  impostorModeFixed: 'Sabit Sayı',
+  impostorModePercentage: 'Yüzde (%)',
+  impostorModeRange: 'Rastgele Aralık',
+  impostorFixedLabel: 'Hain Sayısı',
+  impostorPercentageLabel: 'Hain Yüzdesi (%)',
+  impostorRangeMinLabel: 'Minimum Hain',
+  impostorRangeMaxLabel: 'Maximum Hain',
+  impostorWriterLabel: 'Kelime Yazarı / Host',
+  impostorWriterRandom: 'Oyuncu olmayan sunucu',
+  roleWriterName: 'Yazar',
+  roleWriterDesc: 'Gizli kelimeyi siz belirlersiniz.',
+  writerInputPrompt: 'Yazarsınız. Bu oyun için gizli kelimeyi veya yeri girin:',
+  writerInputPlaceholder: 'örn. Restoran, Hastane...',
+  btnSetWord: 'Kelimeyi Kaydet ve Başlat',
+  impostorWriterPreround: 'Gizli Ön Tur (Tüm oyuncular)',
+  impostorWriterDescHost: 'Oyuncu olmayan sunucu rastgele kelime kullanır.',
+  impostorWriterDescPreround: 'Ön tur, tüm oyuncuların gizlice kelimeler yazmasını ve ardından rastgele birini seçmesini sağlar.',
+  impostorWriterDescPlayer: 'Seçilen oyuncu kelimeyi yazar ve hain olamaz.',
+  preroundPassTitle: 'Ön tur: Cihazı şu oyuncuya verin:',
+  preroundInputPrompt: 'Gizlice bir kelime veya yer yazın (ekrandan gizlenir):',
+  preroundPassHint: 'Kelimeyi diğer oyunculardan gizli tutun!',
+  btnSubmitWord: 'Kelimeyi Gönder',
+};
+
+const faq = [
+  {
+    question: 'Gizli Rol Dağıtıcı nasıl çalışır?',
+    answer: 'Bu araç, sosyal çıkarım oyunları için gizli rolleri tek bir cihazda yerel olarak dağıtmanızı sağlar. Oyuncu adlarını girer, şablonu seçer ve cihazı sırayla oyunculara iletirsiniz. Her oyuncu kendi rolünü gizlice görmek için göster butonunu basılı tutar.',
+  },
+];
+
+const howTo = [
+  {
+    name: 'Oyuncuları Ekle',
+    text: 'Katılımcıların adlarını kurulum paneline girin.',
+  },
+  {
+    name: 'Şablon Seç',
+    text: 'Hazır oyun kurallarından birini seçin veya özel bir rol havuzu oluşturun.',
+  },
+  {
+    name: 'Geç ve Göster',
+    text: 'Cihazı sırayla her oyuncuya verin. Her oyuncu gizli rolünü görmek için göster düğmesini basılı tutmalı, ardından sonrakine tıklamalıdır.',
+  },
+];
+
+export const content: ToolLocaleContent<HiddenRoleDealerUI> = {
+  slug: 'gizli-rol-dagitici-roller',
+  title: 'Gizli Rol Dağıtıcı: Oyun Kartı Dağıtıcısı & Kimlik Dağıtıcı',
+  description: 'Kurt Adam, Avalon, Secret Hitler ve Hain gibi sosyal çıkarım oyunları için gizli rolleri fiziksel kartlar olmadan dağıtın.',
+  ui,
+  seo: [
+    { type: 'title', text: 'Sosyal Çıkarım Oyunlarında Takım Dengesi', level: 2 },
+    { type: 'paragraph', html: 'İyi ve kötü rollerin oranını doğru şekilde dengelemek adil ve heyecan verici bir oyun deneyimi için temeldir.' },
+  ],
+  faq,
+  bibliography,
+  howTo,
+  schemas: [
+    {
+      '@context': 'https://schema.org',
+      '@type': 'FAQPage',
+      'mainEntity': faq.map((f) => ({
+        '@type': 'Question',
+        'name': f.question,
+        'acceptedAnswer': {
+          '@type': 'Answer',
+          'text': f.answer,
+        },
+      })),
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'SoftwareApplication',
+      'name': ui.title,
+      'operatingSystem': 'All',
+      'applicationCategory': 'UtilitiesApplication',
+      'browserRequirements': 'Requires HTML5. Requires JavaScript.',
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'HowTo',
+      'name': ui.setupTitle,
+      'step': howTo.map((h) => ({
+        '@type': 'HowToStep',
+        'name': h.name,
+        'text': h.text,
+      })),
+    },
+  ],
+};

package/src/tool/hidden-role-dealer/i18n/zh.ts

@@ -0,0 +1,191 @@
+import { bibliography } from '../bibliography';
+import type { ToolLocaleContent } from '../../../types';
+import type { HiddenRoleDealerUI } from '../entry';
+
+const ui: HiddenRoleDealerUI = {
+  title: '秘密身份分发器',
+  setupTitle: '身份分配设置',
+  playerList: '玩家列表',
+  addPlayer: '添加',
+  addPlayerPlaceholder: '输入玩家姓名...',
+  rolePool: '秘密身份池',
+  presetsTitle: '游戏模版',
+  presetCustom: '自定义设置',
+  dealRoles: '分发秘密身份',
+  clearPlayers: '清空玩家',
+  instructions: '输入玩家名称，配置秘密身份，然后点击“分发秘密身份”。',
+  passTo: '将设备递给',
+  holdToReveal: '按住以显示',
+  releasingResets: '继续按住以显示...',
+  hideRole: '已确认，隐藏身份',
+  nextPlayer: '下一位玩家',
+  finishedTitle: '身份全部分发完毕',
+  finishedDesc: '所有玩家已秘密确认自己的身份。现在可以开始游戏了。',
+  restart: '重新开始并分配',
+  rolesCount: '已选身份数',
+  playersCount: '已加玩家数',
+  mismatchWarning: '分发身份至少需要 3 名玩家。',
+  werewolfName: '狼人杀 / 杀手',
+  werewolfDesc: '村民需要找出并投票驱逐隐藏的狼人。',
+  avalonName: '抵抗组织：阿瓦隆',
+  avalonDesc: '梅林和忠臣在躲避邪恶爪牙的同时完成任务。',
+  hitlerName: '秘密希特勒',
+  hitlerDesc: '自由派尝试通过法案并找出秘密领袖。',
+  customName: '自定义设置',
+  customDesc: '为玩家分发带有自定义文本的卡牌。',
+  roleWerewolfName: '狼人',
+  roleWerewolfDesc: '在夜晚秘密消灭村民。',
+  roleWerewolfSecret: '与其他狼人合作，欺骗村民。',
+  roleSeerName: '预言家',
+  roleSeerDesc: '每晚确认一名玩家的阵营。',
+  roleSeerSecret: '找出狼人，但要隐藏自己的身份以求生存。',
+  roleDoctorName: '守卫',
+  roleDoctorDesc: '每晚保护一名玩家免受消灭。',
+  roleDoctorSecret: '确保关键村民的安全。',
+  roleVillagerName: '村民',
+  roleVillagerDesc: '找出隐藏的狼人。',
+  roleVillagerSecret: '进行讨论、分析并投票淘汰嫌疑人。',
+  roleMerlinName: '梅林',
+  roleMerlinDesc: '知道邪恶阵营的成员是谁。',
+  roleMerlinSecret: '引导正义方走向胜利，但不要暴露自己的身份。',
+  roleAssassinName: '刺客',
+  roleAssassinDesc: '可以在游戏结束时刺杀梅林。',
+  roleAssassinSecret: '找出梅林，在最后一刻夺取胜利。',
+  roleMinionName: '莫德雷德的爪牙',
+  roleMinionDesc: '邪恶阵营的知情成员。',
+  roleMinionSecret: '在不被发现的情况下破坏任务。',
+  roleServantName: '亚瑟的忠臣',
+  roleServantDesc: '为亚瑟王完成任务。',
+  roleServantSecret: '讨论、提案并合乎逻辑地投票。',
+  roleHitlerName: '希特勒',
+  roleHitlerDesc: '法西斯阵营的秘密领袖。',
+  roleHitlerSecret: '争取被选为总理，或帮助法西斯通过法案。',
+  roleFascistName: '法西斯',
+  roleFascistDesc: '协同通过法西斯法案。',
+  roleFascistSecret: '保护希特勒并操纵选举结果。',
+  roleLiberalName: '自由派',
+  roleLiberalDesc: '寻找并阻止法西斯的威胁。',
+  roleLiberalSecret: '通过自由法案，或者在可能的情况下消灭希特勒。',
+  roleCustomName: '自定义角色',
+  roleCustomDesc: '自定义角色的描述。',
+  roleCustomSecret: '完成你所在阵营的目标。',
+  teamWerewolves: '狼人阵营',
+  teamVillagers: '村民阵营',
+  teamGood: '正义阵营',
+  teamEvil: '邪恶阵营',
+  teamFascist: '法西斯阵营',
+  teamLiberal: '自由阵营',
+  teamCustom: '自定义阵营',
+  secretRoleIs: '你的秘密身份是：',
+  customRolesTitle: '自定义身份设置',
+  customRolePlaceholder: '输入身份名称...',
+  neutralLabel: '中立',
+  goodLabel: '善良',
+  evilLabel: '邪恶',
+  customMismatchWarning: '配置的自定义身份数量必须与玩家人数相同。',
+  impostorPresetName: '内鬼游戏',
+  impostorPresetDesc: '分配内鬼与船员的身份并自定义其数量。',
+  impostorTitle: '内鬼设置',
+  impostorWarning: '玩家人数必须多于内鬼数量。',
+  roleImpostorName: '内鬼',
+  roleImpostorDesc: '秘密消灭船员。',
+  roleImpostorSecret: '暗中破坏并消灭船员，注意不要被发现。',
+  roleCrewmateName: '船员',
+  roleCrewmateDesc: '完成任务并找出内鬼。',
+  roleCrewmateSecret: '秘密词语是：',
+  teamImpostor: '内鬼',
+  teamCrewmate: '船员',
+  impostorSharedSecretLabel: '共享词语/地点',
+  impostorSharedSecretPlaceholder: '例如 地点：餐厅，或者 词语：苹果',
+  impostorModeLabel: '内鬼数量决定方式',
+  impostorModeFixed: '固定数量',
+  impostorModePercentage: '百分比 (%)',
+  impostorModeRange: '随机范围',
+  impostorFixedLabel: '内鬼数量',
+  impostorPercentageLabel: '内鬼百分比 (%)',
+  impostorRangeMinLabel: '最小内鬼数',
+  impostorRangeMaxLabel: '最大内鬼数',
+  impostorWriterLabel: '出题者 / 房东',
+  impostorWriterRandom: '系统自动出题',
+  roleWriterName: '出题者',
+  roleWriterDesc: '你来决定游戏的秘密词语。',
+  writerInputPrompt: '你是出题者。请输入本局游戏的秘密词语或地点：',
+  writerInputPlaceholder: '例如 餐厅、医院...',
+  btnSetWord: '确定并开始',
+  impostorWriterPreround: '秘密前置轮（所有玩家）',
+  impostorWriterDescHost: '系统出题模式下将使用随机词语。',
+  impostorWriterDescPreround: '前置轮模式将由所有玩家分别暗中输入词语，并随机从中选择一个。',
+  impostorWriterDescPlayer: '所选玩家负责写下秘密词语，其本人必不会成为内鬼。',
+  preroundPassTitle: '前置轮：将设备递给',
+  preroundInputPrompt: '暗中写下一个秘密词语或地点（会被隐藏）：',
+  preroundPassHint: '请不要让其他玩家看到你输入的词语！',
+  btnSubmitWord: '提交词语',
+};
+
+const faq = [
+  {
+    question: '秘密身份分发器是如何工作的？',
+    answer: '秘密身份分发器允许您在一台设备上本地为社交推理解密游戏分配身份。输入玩家名字，选择模板或自定义身份，然后依次传递设备。玩家需要按住确认按钮来查看自己的身份。',
+  },
+];
+
+const howTo = [
+  {
+    name: '添加玩家',
+    text: '在设置面板中输入参与者的名字。',
+  },
+  {
+    name: '选择模版',
+    text: '选择预设的游戏规则或创建完全自定义的角色池。',
+  },
+  {
+    name: '传递并确认',
+    text: '将设备传递给每位玩家。每位玩家必须长按确认按钮以查看其秘密角色，然后点击下一步。',
+  },
+];
+
+export const content: ToolLocaleContent<HiddenRoleDealerUI> = {
+  slug: 'hidden-role-dealer',
+  title: '秘密身份分发器：社交推理与狼人杀卡牌分配器',
+  description: '在单台设备上为狼人杀、阿瓦隆、秘密希特勒和内鬼游戏等社交推理桌游分配秘密身份，无需实体卡牌。',
+  ui,
+  seo: [
+    { type: 'title', text: '桌游身份分发中的阵营平衡策略', level: 2 },
+    { type: 'paragraph', html: '在狼人杀或阿瓦隆中，根据玩家人数合理配置好人与坏人的比例非常关键。本工具提供标准的配比参考以确保游戏平衡。' },
+  ],
+  faq,
+  bibliography,
+  howTo,
+  schemas: [
+    {
+      '@context': 'https://schema.org',
+      '@type': 'FAQPage',
+      'mainEntity': faq.map((f) => ({
+        '@type': 'Question',
+        'name': f.question,
+        'acceptedAnswer': {
+          '@type': 'Answer',
+          'text': f.answer,
+        },
+      })),
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'SoftwareApplication',
+      'name': ui.title,
+      'operatingSystem': 'All',
+      'applicationCategory': 'UtilitiesApplication',
+      'browserRequirements': 'Requires HTML5. Requires JavaScript.',
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'HowTo',
+      'name': ui.setupTitle,
+      'step': howTo.map((h) => ({
+        '@type': 'HowToStep',
+        'name': h.name,
+        'text': h.text,
+      })),
+    },
+  ],
+};

package/src/tool/hidden-role-dealer/index.ts

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

package/src/tool/hidden-role-dealer/logic.test.ts

@@ -0,0 +1,99 @@
+import { describe, it, expect } from 'vitest';
+import { assignRoles, addPlayer, removePlayer, updatePlayerName, addCustomRole, removeCustomRole, calculateImpostorCount, generateImpostorRoles } from './logic';
+import type { Player, Role } from './types';
+
+describe('Hidden Role Dealer Logic', () => {
+  const mockRoles: Role[] = [
+    { id: '1', name: 'Role A', description: 'Desc A', team: 'Team A', secretInfo: 'Info A', alignment: 'good' },
+    { id: '2', name: 'Role B', description: 'Desc B', team: 'Team B', secretInfo: 'Info B', alignment: 'evil' },
+  ];
+
+  it('should add a player', () => {
+    const players: Player[] = [];
+    const result = addPlayer(players, 'Player 1');
+    expect(result.length).toBe(1);
+    expect(result[0].name).toBe('Player 1');
+    expect(result[0].role).toBeNull();
+  });
+
+  it('should not add an empty player name', () => {
+    const players: Player[] = [];
+    const result = addPlayer(players, '   ');
+    expect(result.length).toBe(0);
+  });
+
+  it('should remove a player', () => {
+    const players: Player[] = [
+      { id: 'p1', name: 'Player 1', role: null, revealed: false },
+      { id: 'p2', name: 'Player 2', role: null, revealed: false },
+    ];
+    const result = removePlayer(players, 'p1');
+    expect(result.length).toBe(1);
+    expect(result[0].id).toBe('p2');
+  });
+
+  it('should update player name', () => {
+    const players: Player[] = [
+      { id: 'p1', name: 'Player 1', role: null, revealed: false },
+    ];
+    const result = updatePlayerName(players, 'p1', 'New Name');
+    expect(result[0].name).toBe('New Name');
+  });
+
+  it('should assign roles to players', () => {
+    const players: Player[] = [
+      { id: 'p1', name: 'Player 1', role: null, revealed: false },
+      { id: 'p2', name: 'Player 2', role: null, revealed: false },
+    ];
+    const result = assignRoles(players, mockRoles);
+    expect(result[0].role).not.toBeNull();
+    expect(result[1].role).not.toBeNull();
+    expect(result[0].role!.id).not.toBe(result[1].role!.id);
+  });
+
+  it('should add custom roles', () => {
+    const roles: Role[] = [];
+    const result = addCustomRole(roles, 'Detective', 'good');
+    expect(result.length).toBe(1);
+    expect(result[0].name).toBe('Detective');
+    expect(result[0].alignment).toBe('good');
+  });
+
+  it('should remove custom roles', () => {
+    const roles: Role[] = [
+      { id: 'r1', name: 'Detective', description: '', team: '', secretInfo: '', alignment: 'good' }
+    ];
+    const result = removeCustomRole(roles, 'r1');
+    expect(result.length).toBe(0);
+  });
+
+  it('should calculate impostor count correctly', () => {
+    const vals = { fixedVal: 2, percentVal: 25, minVal: 1, maxVal: 3 };
+    expect(calculateImpostorCount('fixed', 8, vals)).toBe(2);
+    expect(calculateImpostorCount('percentage', 8, { ...vals, fixedVal: 1 })).toBe(2);
+    const rangeVal = calculateImpostorCount('range', 8, { ...vals, fixedVal: 1 });
+    expect(rangeVal).toBeGreaterThanOrEqual(1);
+    expect(rangeVal).toBeLessThanOrEqual(3);
+  });
+
+  it('should generate impostor roles correctly with shared secret', () => {
+    const ui = {
+      roleImpostorName: 'Impostor',
+      roleImpostorDesc: 'Secretly eliminate Crewmates.',
+      teamImpostor: 'Impostor',
+      roleImpostorSecret: 'Sabotage.',
+      roleCrewmateName: 'Crewmate',
+      roleCrewmateDesc: 'Find the Impostor.',
+      teamCrewmate: 'Crewmate',
+      roleCrewmateSecret: 'Secret word is:',
+    };
+    const roles = generateImpostorRoles(6, 2, 'Restaurant', ui);
+    expect(roles.length).toBe(6);
+    const impostors = roles.filter(r => r.alignment === 'evil');
+    const crewmates = roles.filter(r => r.alignment === 'good');
+    expect(impostors.length).toBe(2);
+    expect(crewmates.length).toBe(4);
+    expect(crewmates[0].secretInfo).toBe('Secret word is: Restaurant');
+    expect(impostors[0].secretInfo).toBe('Sabotage.');
+  });
+});

package/src/tool/hidden-role-dealer/logic.ts

@@ -0,0 +1,134 @@
+import type { Player, Role, ImpostorValues } from './types';
+
+export function shuffleArray<T>(array: T[]): T[] {
+  const result = [...array];
+  for (let i = result.length - 1; i > 0; i--) {
+    const j = Math.floor(Math.random() * (i + 1));
+    const temp = result[i];
+    result[i] = result[j];
+    result[j] = temp;
+  }
+  return result;
+}
+
+export function assignRoles(players: Player[], roles: Role[]): Player[] {
+  const shuffledRoles = shuffleArray(roles);
+  return players.map((player, index) => ({
+    ...player,
+    role: shuffledRoles[index] || null,
+    revealed: false,
+  }));
+}
+
+export function addPlayer(players: Player[], name: string): Player[] {
+  const cleanedName = name.trim();
+  if (!cleanedName) {
+    return players;
+  }
+  return [
+    ...players,
+    {
+      id: `player-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`,
+      name: cleanedName,
+      role: null,
+      revealed: false,
+    },
+  ];
+}
+
+export function removePlayer(players: Player[], id: string): Player[] {
+  return players.filter((p) => p.id !== id);
+}
+
+export function updatePlayerName(players: Player[], id: string, name: string): Player[] {
+  return players.map((p) => (p.id === id ? { ...p, name: name.trim() } : p));
+}
+
+export function addCustomRole(roles: Role[], name: string, alignment: 'good' | 'evil' | 'neutral'): Role[] {
+  const cleaned = name.trim();
+  if (!cleaned) return roles;
+  return [
+    ...roles,
+    {
+      id: `r-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`,
+      name: cleaned,
+      description: 'Custom game role.',
+      team: alignment.toUpperCase(),
+      secretInfo: 'Achieve your victory conditions.',
+      alignment,
+    },
+  ];
+}
+
+export function removeCustomRole(roles: Role[], id: string): Role[] {
+  return roles.filter((r) => r.id !== id);
+}
+
+export function calculateImpostorCount(
+  mode: string,
+  totalPlayers: number,
+  vals: ImpostorValues
+): number {
+  if (mode === 'percentage') {
+    return Math.max(1, Math.round((vals.percentVal / 100) * totalPlayers));
+  }
+  if (mode === 'range') {
+    const min = Math.max(1, vals.minVal);
+    const max = Math.max(min, vals.maxVal);
+    const actualMax = Math.min(max, totalPlayers - 1);
+    const actualMin = Math.min(min, actualMax);
+    return Math.floor(Math.random() * (actualMax - actualMin + 1)) + actualMin;
+  }
+  return Math.max(1, vals.fixedVal);
+}
+
+function createImpostorRole(index: number, ui: Record<string, string>): Role {
+  return {
+    id: `imp-${index}`,
+    name: ui.roleImpostorName || 'Impostor',
+    description: ui.roleImpostorDesc || 'Secretly eliminate Crewmates.',
+    team: ui.teamImpostor || 'Impostor',
+    secretInfo: ui.roleImpostorSecret || 'Sabotage and eliminate without getting caught.',
+    alignment: 'evil',
+  };
+}
+
+function createCrewmateRole(index: number, secretMsg: string, ui: Record<string, string>): Role {
+  return {
+    id: `crew-${index}`,
+    name: ui.roleCrewmateName || 'Crewmate',
+    description: ui.roleCrewmateDesc || 'Complete tasks and find the Impostor.',
+    team: ui.teamCrewmate || 'Crewmate',
+    secretInfo: secretMsg,
+    alignment: 'good',
+  };
+}
+
+export function generateImpostorRoles(
+  totalPlayers: number,
+  impostorCount: number,
+  sharedSecret: string,
+  ui: Record<string, string>
+): Role[] {
+  const roles: Role[] = [];
+  const actualImpostors = Math.min(impostorCount, totalPlayers - 1);
+  for (let i = 0; i < actualImpostors; i++) {
+    roles.push(createImpostorRole(i, ui));
+  }
+  const prefix = ui.roleCrewmateSecret || 'The Secret Word is:';
+  const secretMsg = `${prefix} ${sharedSecret}`;
+  while (roles.length < totalPlayers) {
+    roles.push(createCrewmateRole(roles.length, secretMsg, ui));
+  }
+  return roles;
+}
+
+const RANDOM_WORDS = [
+  'Restaurant', 'Space Station', 'Submarine', 'Supermarket', 'Movie Theater',
+  'School', 'Hospital', 'Pirate Ship', 'Amusement Park', 'Hotel',
+  'Airport', 'Police Station', 'Museum', 'Bank', 'Casino'
+];
+
+export function getRandomSecretWord(): string {
+  return RANDOM_WORDS[Math.floor(Math.random() * RANDOM_WORDS.length)];
+}

package/src/tool/hidden-role-dealer/modules/custom-role-manager.ts

@@ -0,0 +1,35 @@
+import { addCustomRole, removeCustomRole } from '../logic';
+import { loadSavedCustomRoles } from './storage';
+import type { Role } from '../types';
+
+export class CustomRoleManager {
+  private roles: Role[] = [];
+
+  constructor() {
+    this.roles = loadSavedCustomRoles();
+  }
+
+  public getRoles(): Role[] {
+    return this.roles;
+  }
+
+  public add(name: string, alignment: 'good' | 'evil' | 'neutral'): void {
+    this.roles = addCustomRole(this.roles, name, alignment);
+    localStorage.setItem('hidden-role-dealer-custom-roles', JSON.stringify(this.roles));
+  }
+
+  public addFromInput(container: HTMLElement): void {
+    const input = container.querySelector('#input-role-name') as HTMLInputElement;
+    const select = container.querySelector('#select-role-alignment') as HTMLSelectElement;
+    if (input && select && input.value.trim()) {
+      this.add(input.value.trim(), select.value as 'good' | 'evil' | 'neutral');
+      input.value = '';
+      input.focus();
+    }
+  }
+
+  public delete(id: string): void {
+    this.roles = removeCustomRole(this.roles, id);
+    localStorage.setItem('hidden-role-dealer-custom-roles', JSON.stringify(this.roles));
+  }
+}