@jjlmoya/utils-tabletop 1.3.0 → 1.5.0

package/package.json

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

package/src/category/TabletopCategorySEO.astro

@@ -1,14 +1,9 @@
 ---
 import { SEORenderer } from '@jjlmoya/utils-shared';
 import { tabletopCategory } from './index';
-import type { KnownLocale } from '../types';
 
-interface Props {
-  locale?: string;
-}
-
-const { locale = 'es' } = Astro.props;
-const categoryContent = await tabletopCategory.i18n[locale as KnownLocale]?.();
+const locale: string = Astro.props.locale ?? 'es';
+const categoryContent = await tabletopCategory.i18n[locale as keyof typeof tabletopCategory.i18n]?.();
 ---
 
 {categoryContent && <SEORenderer content={{ locale, sections: categoryContent.seo }} />}

package/src/category/i18n/en.ts

@@ -1,4 +1,4 @@
-import type { CategoryLocaleContent } from '../../types';
+import type { CategoryLocaleContent } from '../../types';
 
 const slug = 'tabletop';
 const title = 'Tabletop Game Utilities & Tools';
@@ -10,13 +10,13 @@ export const content: CategoryLocaleContent = {
   description,
   seo: [
     { type: 'title', text: 'Tabletop Game Tools | Roll Dice Online & Track Turn Times', level: 2 },
-    { type: 'paragraph', html: 'Game nights should be about fun, not hunting for lost dice or waiting for someone to add up their roll. This utility library gives you and your group fast, well-designed tools that work instantly—no strings attached. Whether you are a dungeon master juggling a hundred things or a player who just wants to roll without the fuss, these tools are built for you.' },
+    { type: 'paragraph', html: 'Game nights should be about fun, not hunting for lost dice or waiting for someone to add up their roll. This utility library gives you and your group fast, well-designed tools that work instantly-no strings attached. Whether you are a dungeon master juggling a hundred things or a player who just wants to roll without the fuss, these tools are built for you.' },
     { type: 'title', text: 'Roll Virtual Dice with Real-Time Statistics', level: 2 },
     { type: 'paragraph', html: 'Tired of scrambling under the table for missing dice or waiting for someone to tally results? The virtual dice roller lets you throw any combination of polyhedral dice instantly, with modifiers, advantage, disadvantage, and a full roll history. The built-in probability analyzer shows your real odds before you roll, helping you make smarter decisions at the table. Perfect for Dungeons & Dragons, Pathfinder, Call of Cthulhu, Shadowrun, or any game that relies on chance.' },
     { type: 'title', text: 'Keep Your Game on Pace with a Smart Turn Timer', level: 2 },
-    { type: 'paragraph', html: 'We all know that one player who takes forever on every turn. The game timer lets you set fair and fun time limits, with modes that adapt to every play style—from a simple shared countdown to chess-style Fischer increment or Bronstein delay. Works for two-player duels with split-screen rotation or groups of up to eight with central turn control. When the game ends, review detailed stats on timing, rounds, and play pace.' },
+    { type: 'paragraph', html: 'We all know that one player who takes forever on every turn. The game timer lets you set fair and fun time limits, with modes that adapt to every play style-from a simple shared countdown to chess-style Fischer increment or Bronstein delay. Works for two-player duels with split-screen rotation or groups of up to eight with central turn control. When the game ends, review detailed stats on timing, rounds, and play pace.' },
     { type: 'title', text: 'Privacy First: Everything Runs on Your Device', level: 2 },
-    { type: 'paragraph', html: 'One of the best things about this library is that everything processes in your browser. No data is sent to any server, no tracking cookies, no email or registration required. Use the tools offline, share your screen with the table, or project to a big screen TV—nothing to worry about except the game itself. And more tools are coming, always designed to make life easier for tabletop players.' },
+    { type: 'paragraph', html: 'One of the best things about this library is that everything processes in your browser. No data is sent to any server, no tracking cookies, no email or registration required. Use the tools offline, share your screen with the table, or project to a big screen TV-nothing to worry about except the game itself. And more tools are coming, always designed to make life easier for tabletop players.' },
     { type: 'stats', items: [
       { label: 'Tools', value: '2+', icon: 'mdi:tools' },
       { label: 'Players', value: '2-8', icon: 'mdi:account-group' },

package/src/category/i18n/ru.ts

@@ -1,4 +1,4 @@
-import type { CategoryLocaleContent } from '../../types';
+import type { CategoryLocaleContent } from '../../types';
 
 const slug = 'nastolnye-igry';
 const title = 'Инструменты и утилиты для настольных игр';
@@ -16,7 +16,7 @@ export const content: CategoryLocaleContent = {
     { type: 'title', text: 'Контролируйте темп игры с умным таймером ходов', level: 2 },
     { type: 'paragraph', html: 'Все мы знаем того игрока, который тратит вечность на каждый ход. Игровой таймер позволяет устанавливать справедливые и увлекательные лимиты времени с режимами на любой стиль: от простого общего отсчёта до шахматных систем с инкрементом Фишера или задержкой Бронштейна. Работает для дуэлей с разделённым экраном или групп до восьми игроков с централизованным управлением. После игры доступна подробная статистика времени и темпа.' },
     { type: 'title', text: 'Конфиденциальность превыше всего: все данные остаются на вашем устройстве', level: 2 },
-    { type: 'paragraph', html: 'Одно из главных преимуществ этой библиотеки — вся обработка происходит в вашем браузере. Никакие данные не отправляются на сервер, нет отслеживающих cookie, не требуется email или регистрация. Используйте инструменты офлайн, делитесь экраном с игроками или выводите на телевизор — ни о чём, кроме игры, беспокоиться не придётся. А новые инструменты уже в разработке, всегда нацеленные на то, чтобы облегчить жизнь любителям настольных игр.' },
+    { type: 'paragraph', html: 'Одно из главных преимуществ этой библиотеки - вся обработка происходит в вашем браузере. Никакие данные не отправляются на сервер, нет отслеживающих cookie, не требуется email или регистрация. Используйте инструменты офлайн, делитесь экраном с игроками или выводите на телевизор - ни о чём, кроме игры, беспокоиться не придётся. А новые инструменты уже в разработке, всегда нацеленные на то, чтобы облегчить жизнь любителям настольных игр.' },
     { type: 'stats', items: [
       { label: 'Инструментов', value: '2+', icon: 'mdi:tools' },
       { label: 'Игроков', value: '2-8', icon: 'mdi:account-group' },

package/src/category/i18n/zh.ts

@@ -1,22 +1,22 @@
-import type { CategoryLocaleContent } from '../../types';
+import type { CategoryLocaleContent } from '../../types';
 
 const slug = 'tabletop';
 const title = '桌游工具与实用程序';
-const description = '免费的桌游和TRPG工具：虚拟骰子带实时统计，多人回合计时器等。在浏览器中运行，无需注册，100%隐私保护。';
+const description = '免费的桌游和TRPG工具：虚拟骰子带实�-�统计，多人回合计�-�器等。在浏览器中运行，�-�需注册，100%隐私保护。';
 
 export const content: CategoryLocaleContent = {
   slug,
   title,
   description,
   seo: [
-    { type: 'title', text: '桌游工具 | 在线掷骰子和回合计时器', level: 2 },
-    { type: 'paragraph', html: '游戏之夜本该充满乐趣，而不是到处找丢失的骰子或等待别人计算结果。这款实用工具库为您和您的团队提供快速、精心设计的工具，即刻可用，无需任何回报。无论您是手忙脚乱的 dungeon master，还是只想轻松掷骰的玩家，这些工具都是为您打造的。' },
-    { type: 'title', text: '使用虚拟骰子进行实时统计分析', level: 2 },
+    { type: 'title', text: '桌游工具 | 在线掷骰子和回合计�-�器', level: 2 },
+    { type: 'paragraph', html: '游戏之夜本该充满乐趣，而不是到处找丢失的骰子或等待别人计�-结果。这款实用工具库为您和您的团队提供快速、精心设计的工具，即刻可用，�-�需任何回报。�-�论您是手忙脚乱的 dungeon master，还是只想轻松掷骰的玩家，这些工具都是为您打造的。' },
+    { type: 'title', text: '使用虚拟骰子进行实�-�统计分析', level: 2 },
     { type: 'paragraph', html: '厌倦了在桌子下找骰子或等待别人加总结果？虚拟骰子掷投器让您立即投掷任何组合的多面骰子，支持调整值、优势、劣势和完整历史记录。内置概率分析器在投掷前显示您的真实成功率。非常适合 Dungeons & Dragons、Pathfinder、Call of Cthulhu、Shadowrun 或任何依赖运气的游戏。' },
-    { type: 'title', text: '使用智能回合计时器掌控游戏节奏', level: 2 },
-    { type: 'paragraph', html: '我们都知道那个每回合都要花上大量时间的玩家。游戏计时器让您设定公平又有趣的时间限制，提供适应各种风格的模式：从简单的共享倒计时到 Fischer 增量或 Bronstein 延迟等国际象棋系统。支持双人分屏对决和最多八人的中央控制模式。游戏结束后，可查看时间和游戏节奏的详细统计数据。' },
+    { type: 'title', text: '使用智能回合计�-�器掌控游戏节奏', level: 2 },
+    { type: 'paragraph', html: '我们都知道那个每回合都要花上大量�-��-�的玩家。游戏计�-�器让您设定公平又有趣的�-��-�限制，提供适应各种风格的模式：从简单的共享倒计�-�到 Fischer 增量或 Bronstein 延迟等国际象棋系统。支持双人分屏对决和最多八人的中央控制模式。游戏结束后，可查看�-��-�和游戏节奏的详细统计数据。' },
     { type: 'title', text: '隐私至上：所有数据保留在您的设备上', level: 2 },
-    { type: 'paragraph', html: '该库的最大优势之一是所有处理都在您的浏览器内完成。不会有数据发送到服务器，没有跟踪 Cookie，无需电子邮件或注册。可离线使用工具，与桌上玩家共享屏幕，或投影到电视上——除了游戏本身，无需担心任何事。更多的工具正在开发中，始终以方便桌游玩家为设计目标。' },
+    { type: 'paragraph', html: '该库的最大优势之一是所有处理都在您的浏览器内完成。不会有数据发送到服务器，没有跟踪 Cookie，�-�需电子邮件或注册。可离线使用工具，与桌上玩家共享屏幕，或投影到电视上--除了游戏本身，�-�需担心任何事。更多的工具正在开发中，始终以方便桌游玩家为设计目标。' },
     { type: 'stats', items: [
       { label: '工具', value: '2+', icon: 'mdi:tools' },
       { label: '玩家', value: '2-8', icon: 'mdi:account-group' },

package/src/category/index.ts

@@ -1,5 +1,6 @@
 import { diceRollerSimulator } from '../tool/dice-roller-simulator/entry';
 import { boardGameTimer } from '../tool/board-game-timer/entry';
+import type { CategoryLocaleContent, KnownLocale } from '../types';
 
 export const tabletopCategory = {
   icon: 'mdi:dice-multiple-outline',
@@ -23,5 +24,5 @@ export const tabletopCategory = {
     sv: () => import('./i18n/sv').then((m) => m.content),
     tr: () => import('./i18n/tr').then((m) => m.content),
     zh: () => import('./i18n/zh').then((m) => m.content),
-  },
+  } as Partial<Record<KnownLocale, () => Promise<CategoryLocaleContent>>>,
 };

package/src/entries.ts

@@ -2,9 +2,22 @@ export { diceRollerSimulator } from './tool/dice-roller-simulator/entry';
 export type { DiceRollerUI, DiceRollerLocaleContent } from './tool/dice-roller-simulator/entry';
 export { boardGameTimer } from './tool/board-game-timer/entry';
 export type { BoardGameTimerUI, BoardGameTimerLocaleContent } from './tool/board-game-timer/entry';
+export { firstPlayerSelector } from './tool/first-player-selector/entry';
+export type { FirstPlayerSelectorUI, FirstPlayerSelectorLocaleContent } from './tool/first-player-selector/entry';
+export { scoreTracker } from './tool/score-tracker/entry';
+export type { ScoreTrackerUI, ScoreTrackerLocaleContent } from './tool/score-tracker/entry';
+export { initiativeTracker } from './tool/rpg-initiative-tracker/entry';
+export type { InitiativeTrackerUI, InitiativeTrackerLocaleContent } from './tool/rpg-initiative-tracker/entry';
+export { fantasyRunesTranslator } from './tool/fantasy-runes-translator/entry';
+export type { FantasyRunesTranslatorUI, FantasyRunesTranslatorLocaleContent } from './tool/fantasy-runes-translator/entry';
 export { tabletopCategory } from './category';
 
 import { diceRollerSimulator } from './tool/dice-roller-simulator/entry';
 import { boardGameTimer } from './tool/board-game-timer/entry';
+import { firstPlayerSelector } from './tool/first-player-selector/entry';
+import { scoreTracker } from './tool/score-tracker/entry';
+import { initiativeTracker } from './tool/rpg-initiative-tracker/entry';
+import { fantasyRunesTranslator } from './tool/fantasy-runes-translator/entry';
+import { decisionWheel } from './tool/decision-wheel/entry';
 
-export const ALL_ENTRIES = [diceRollerSimulator, boardGameTimer];
+export const ALL_ENTRIES = [diceRollerSimulator, boardGameTimer, firstPlayerSelector, scoreTracker, initiativeTracker, fantasyRunesTranslator, decisionWheel];

package/src/index.ts

@@ -3,6 +3,7 @@ export const tabletopCategorySEO = () => import('./category/TabletopCategorySEO.
 
 export { diceRollerSimulator, DICE_ROLLER_SIMULATOR_TOOL } from './tool/dice-roller-simulator';
 export { boardGameTimer, BOARD_GAME_TIMER_TOOL } from './tool/board-game-timer';
+export { fantasyRunesTranslator, FANTASY_RUNES_TRANSLATOR_TOOL } from './tool/fantasy-runes-translator';
 
 export type {
   KnownLocale,

package/src/pages/[locale]/[slug].astro

@@ -15,7 +15,7 @@ export async function getStaticPaths() {
   const paths = [];
 
   for (const { entry, Component: lazyComp } of ALL_TOOLS) {
-    const { default: Component } = await lazyComp();
+    const { default: Component } = await (lazyComp as () => Promise<{ default: unknown }>)();
     const localeEntries = Object.entries(entry.i18n) as [
       KnownLocale,
       () => Promise<ToolLocaleContent>,
@@ -70,20 +70,21 @@ interface NavItem {
   isActive?: boolean;
 }
 
-interface Props {
+type PageProps = {
   Component: unknown;
   locale: KnownLocale;
   content: ToolLocaleContent;
   localeUrls: Partial<Record<KnownLocale, string>>;
   allToolsNav: NavItem[];
   englishSlug: string;
-}
+};
 
-const { Component, locale, content, localeUrls, allToolsNav, englishSlug } = Astro.props;
+const { Component, locale, content, localeUrls, allToolsNav, englishSlug } = Astro.props as PageProps;
 
-const cssFiles = import.meta.glob("../../tool/*/*.css", { query: "?raw", import: "default" });
+const cssFiles = import.meta.glob<{ default: string }>("../../tool/*/*.css", { query: "?raw", import: "default" });
 const cssKey = Object.keys(cssFiles).find((k) => k.endsWith(`/${englishSlug}.css`));
-const toolCss = cssKey ? await cssFiles[cssKey]() as string : "";
+const cssLoader = cssKey ? cssFiles[cssKey] : undefined;
+const toolCss = cssLoader ? await cssLoader() as string : "";
 
 const seoContent: UtilitySEOContent = { locale, sections: content.seo ?? [] };
 

package/src/tests/locale_completeness.test.ts

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

package/src/tests/no_em_dash.test.ts

@@ -0,0 +1,47 @@
+import { describe, it } from 'vitest';
+import fs from 'node:fs';
+import path from 'node:path';
+
+function getFiles(dir: string, ext: string[]): string[] {
+  const results: string[] = [];
+  if (!fs.existsSync(dir)) return results;
+  const list = fs.readdirSync(dir);
+  for (const file of list) {
+    const fullPath = path.join(dir, file);
+    const stat = fs.statSync(fullPath);
+    if (stat && stat.isDirectory()) {
+      results.push(...getFiles(fullPath, ext));
+    } else if (ext.some((e) => file.endsWith(e))) {
+      results.push(fullPath);
+    }
+  }
+  return results;
+}
+
+const EM_DASH = '\u2014';
+
+describe('Em Dash Prohibition', () => {
+  const files = [
+    ...getFiles(path.join(process.cwd(), 'src', 'tool'), ['.ts']),
+    ...getFiles(path.join(process.cwd(), 'src', 'category'), ['.ts']),
+  ].filter(f => f.includes('i18n'));
+
+  it.each(files)('should not contain em dash (—) in %s', (filePath) => {
+    const content = fs.readFileSync(filePath, 'utf-8');
+    const relativePath = path.relative(process.cwd(), filePath);
+
+    const lines = content.split('\n');
+    const findings: { line: number; text: string }[] = [];
+
+    lines.forEach((line, index) => {
+      if (line.includes(EM_DASH)) {
+        findings.push({ line: index + 1, text: line.trim() });
+      }
+    });
+
+    if (findings.length > 0) {
+      const list = findings.map((f) => `  Line ${f.line}: ${f.text}`).join('\n');
+      throw new Error(`Em dash (—) found in ${relativePath}:\n${list}`);
+    }
+  });
+});

package/src/tests/seo_length.test.ts

@@ -11,6 +11,7 @@ describe('SEO Content Length Validation', () => {
       Object.keys(entry.i18n).forEach((locale) => {
         it(`${locale}: SEO section should exist`, async () => {
           const loader = (entry.i18n as Record<string, () => Promise<{ seo?: unknown[] }>>)[locale];
+          if (!loader) return;
           const content = await loader();
           if (!content.seo) return;
           expect(Array.isArray(content.seo)).toBe(true);

package/src/tests/title_quality.test.ts

@@ -40,7 +40,7 @@ describe('Project Titles - Separator Validation', () => {
     for (const pattern of titlePatterns) {
       let match;
       while ((match = pattern.exec(content)) !== null) {
-        const title = match[1];
+        const title = match[1]!;
         if (title.includes('|') || title.includes('-')) {
           findings.push(title);
         }

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(2);
+      expect(ALL_TOOLS.length).toBe(7);
     });
 
     it('tabletopCategory should be defined', () => {

package/src/tool/board-game-timer/modules/ColorHelper.ts

@@ -5,8 +5,8 @@ export function getLuminance(hex: string): number {
   const r = parseInt(cleanHex.substring(0, 2), 16) / 255;
   const g = parseInt(cleanHex.substring(2, 4), 16) / 255;
   const b = parseInt(cleanHex.substring(4, 6), 16) / 255;
-  const a = [r, g, b].map(v => v <= 0.03928 ? v / 12.92 : Math.pow((v + 0.055) / 1.055, 2.4));
-  return a[0] * 0.2126 + a[1] * 0.7152 + a[2] * 0.0722;
+  const [lr, lg, lb] = [r, g, b].map(v => v <= 0.03928 ? v / 12.92 : Math.pow((v + 0.055) / 1.055, 2.4));
+  return lr * 0.2126 + lg * 0.7152 + lb * 0.0722;
 }
 
 export function getContrastColorForBackground(colorName: PlayerColor): string {

package/src/tool/board-game-timer/modules/DuelViewManager.ts

@@ -48,8 +48,8 @@ export class DuelViewManager {
 
   public initView() {
     this.duelPanel.style.display = 'grid';
-    const p1 = this.state.players[0];
-    const p2 = this.state.players[1];
+    const p1 = this.state.players[0]!;
+    const p2 = this.state.players[1]!;
     const d1 = document.getElementById('duel-p1') as HTMLElement;
     const d2 = document.getElementById('duel-p2') as HTMLElement;
     d1.setAttribute('data-player-id', p1.id);
@@ -86,8 +86,8 @@ export class DuelViewManager {
   }
 
   public update() {
-    const p1 = this.state.players[0];
-    const p2 = this.state.players[1];
+    const p1 = this.state.players[0]!;
+    const p2 = this.state.players[1]!;
     const t1 = this.state.engine.getTimer(p1.id);
     const t2 = this.state.engine.getTimer(p2.id);
     if (!t1 || !t2) return;

package/src/tool/board-game-timer/modules/GameRunner.ts

@@ -45,7 +45,7 @@ export class GameRunner {
       this.state.activeMode = 'multi';
       this.multiView.initView();
     }
-    const firstPlayer = this.state.players[0];
+    const firstPlayer = this.state.players[0]!;
     this.state.engine.start(firstPlayer.id);
     this.state.stats.startTurn();
   }

package/src/tool/board-game-timer/modules/MultiplayerViewManager.ts

@@ -21,7 +21,7 @@ export class MultiplayerViewManager {
   private handleGiantButtonClick() {
     if (this.state.isPaused) return;
     this.state.sound.playTurn();
-    const currPlayer = this.state.players[this.state.activePlayerIndex];
+    const currPlayer = this.state.players[this.state.activePlayerIndex]!;
     this.state.stats.endTurn(currPlayer.id, this.state.roundNumber);
     this.state.activePlayerIndex = (this.state.activePlayerIndex + 1) % this.state.players.length;
     if (this.state.activePlayerIndex === 0) {
@@ -29,7 +29,7 @@ export class MultiplayerViewManager {
       const roundEl = document.getElementById('multi-round-number');
       if (roundEl) roundEl.textContent = this.state.roundNumber.toString();
     }
-    const nextPlayer = this.state.players[this.state.activePlayerIndex];
+    const nextPlayer = this.state.players[this.state.activePlayerIndex]!;
     this.state.engine.switchTurn(nextPlayer.id);
     this.state.stats.startTurn();
     this.update();

package/src/tool/board-game-timer/modules/SetupPanelManager.ts

@@ -138,7 +138,7 @@ export class SetupPanelManager {
     const name = this.nameInput.value.trim();
     if (!name) return;
     this.state.players.push({
-      id: `p-${Date.now()}-${Math.random().toString(36).substr(2, 4)}`,
+      id: `p-${Date.now()}-${Math.random().toString(36).substring(2, 6)}`,
       name,
       color: this.state.selectedColor,
       time: this.getBaseDuration()

package/src/tool/board-game-timer/modules/TimerEngine.ts

@@ -136,7 +136,7 @@ export class TimerEngineImpl extends TimerEngineClock implements TimerEngine {
 
   public switchToNextPlayer(playerIds: string[], currentIndex: number) {
     const nextIndex = (currentIndex + 1) % playerIds.length;
-    const nextId = playerIds[nextIndex];
+    const nextId = playerIds[nextIndex]!;
     return { nextId, nextIndex };
   }
 

package/src/tool/board-game-timer/types.ts

@@ -26,7 +26,7 @@ export interface TimerConfig {
 export interface PlayerConfig {
   id: string;
   name: string;
-  color: string;
+  color: PlayerColor;
   avatar?: string;
   time: number;
 }

package/src/tool/decision-wheel/audio.ts

@@ -0,0 +1,78 @@
+export class SoundEngine {
+  private ctx: AudioContext | null = null;
+  private muted = false;
+
+  private initCtx(): void {
+    if (this.ctx) return;
+    const AudioContextClass = window.AudioContext || (window as unknown as { webkitAudioContext: typeof AudioContext }).webkitAudioContext;
+    if (AudioContextClass) {
+      this.ctx = new AudioContextClass();
+    }
+  }
+
+  public setMuted(muted: boolean): void {
+    this.muted = muted;
+  }
+
+  public isMuted(): boolean {
+    return this.muted;
+  }
+
+  public playTick(): void {
+    if (this.muted) return;
+    this.initCtx();
+    if (!this.ctx) return;
+
+    if (this.ctx.state === 'suspended') {
+      this.ctx.resume();
+    }
+
+    const osc = this.ctx.createOscillator();
+    const gain = this.ctx.createGain();
+
+    osc.connect(gain);
+    gain.connect(this.ctx.destination);
+
+    osc.type = 'sine';
+    osc.frequency.setValueAtTime(800, this.ctx.currentTime);
+    osc.frequency.exponentialRampToValueAtTime(100, this.ctx.currentTime + 0.05);
+
+    gain.gain.setValueAtTime(0.1, this.ctx.currentTime);
+    gain.gain.exponentialRampToValueAtTime(0.01, this.ctx.currentTime + 0.05);
+
+    osc.start();
+    osc.stop(this.ctx.currentTime + 0.05);
+  }
+
+  public playChime(): void {
+    if (this.muted) return;
+    this.initCtx();
+    if (!this.ctx) return;
+
+    if (this.ctx.state === 'suspended') {
+      this.ctx.resume();
+    }
+
+    const notes = [523.25, 659.25, 783.99, 1046.50];
+    const now = this.ctx.currentTime;
+
+    notes.forEach((freq, idx) => {
+      if (!this.ctx) return;
+      const osc = this.ctx.createOscillator();
+      const gain = this.ctx.createGain();
+
+      osc.connect(gain);
+      gain.connect(this.ctx.destination);
+
+      osc.type = 'triangle';
+      osc.frequency.setValueAtTime(freq, now + idx * 0.08);
+
+      gain.gain.setValueAtTime(0, now + idx * 0.08);
+      gain.gain.linearRampToValueAtTime(0.15, now + idx * 0.08 + 0.02);
+      gain.gain.exponentialRampToValueAtTime(0.001, now + idx * 0.08 + 0.3);
+
+      osc.start(now + idx * 0.08);
+      osc.stop(now + idx * 0.08 + 0.35);
+    });
+  }
+}

package/src/tool/decision-wheel/bibliography.astro

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

package/src/tool/decision-wheel/bibliography.ts

@@ -0,0 +1,8 @@
+import type { BibliographyEntry } from '../../types';
+
+export const bibliography: BibliographyEntry[] = [
+  {
+    name: 'Decision Wheel Spinner Guide',
+    url: 'https://en.wikipedia.org/wiki/Wheel_of_fortune_(game_show)',
+  },
+];