@jjlmoya/utils-sports 1.25.0 → 1.26.0

package/package.json

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

package/src/entries.ts

@@ -22,6 +22,8 @@ export { streetballScoreKeeper } from './tool/streetballScoreKeeper/entry';
 export type { StreetballLocaleContent } from './tool/streetballScoreKeeper/entry';
 export { beachVolleyballScoreKeeper } from './tool/beachVolleyballScoreKeeper/entry';
 export type { BeachVolleyballLocaleContent } from './tool/beachVolleyballScoreKeeper/entry';
+export { snookerScoreKeeper } from './tool/snookerScoreKeeper/entry';
+export type { SnookerScoreKeeperLocaleContent } from './tool/snookerScoreKeeper/entry';
 export { sportsCategory } from './category';
 import { basketScoreKeeper } from './tool/basketScoreKeeper/entry';
 import { footballScoreKeeper } from './tool/footballScoreKeeper/entry';
@@ -35,4 +37,6 @@ import { dartsScoreKeeper } from './tool/dartsScoreKeeper/entry';
 import { padelScoreKeeper } from './tool/padelScoreKeeper/entry';
 import { streetballScoreKeeper } from './tool/streetballScoreKeeper/entry';
 import { beachVolleyballScoreKeeper } from './tool/beachVolleyballScoreKeeper/entry';
-export const ALL_ENTRIES = [basketScoreKeeper, footballScoreKeeper, gymTracker, pingPongScoreKeeper, reactionTester, scoreKeeper, tournamentBracket, tennisScoreKeeper, dartsScoreKeeper, padelScoreKeeper, streetballScoreKeeper, beachVolleyballScoreKeeper];
+import { snookerScoreKeeper } from './tool/snookerScoreKeeper/entry';
+export const ALL_ENTRIES = [basketScoreKeeper, footballScoreKeeper, gymTracker, pingPongScoreKeeper, reactionTester, scoreKeeper, tournamentBracket, tennisScoreKeeper, dartsScoreKeeper, padelScoreKeeper, streetballScoreKeeper, beachVolleyballScoreKeeper, snookerScoreKeeper];
+

package/src/tests/locale_completeness.test.ts

@@ -3,6 +3,6 @@ import { ALL_TOOLS } from '../tools';
 
 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

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

package/src/tool/snookerScoreKeeper/audio.ts

@@ -0,0 +1,84 @@
+import { el } from './render';
+
+let isMuted = false;
+
+try {
+  isMuted = localStorage.getItem('sn_muted') === 'true';
+} catch {}
+
+function updateSoundIcon(): void {
+  const onIcon = el('sn-sound-icon-on');
+  const offIcon = el('sn-sound-icon-off');
+  if (onIcon && offIcon) {
+    onIcon.style.display = isMuted ? 'none' : 'block';
+    offIcon.style.display = isMuted ? 'block' : 'none';
+  }
+}
+
+export function setMuted(muted: boolean): void {
+  isMuted = muted;
+  try {
+    localStorage.setItem('sn_muted', String(muted));
+  } catch {}
+  updateSoundIcon();
+}
+
+export function getMuted(): boolean {
+  return isMuted;
+}
+
+export function playPocket(): void {
+  if (isMuted) return;
+  try {
+    const webkitCtx = (window as unknown as { webkitAudioContext: typeof AudioContext }).webkitAudioContext;
+    const ctx = new (window.AudioContext || webkitCtx)();
+    const osc = ctx.createOscillator();
+    const gain = ctx.createGain();
+    osc.type = 'sine';
+    osc.frequency.setValueAtTime(160, ctx.currentTime);
+    osc.frequency.exponentialRampToValueAtTime(50, ctx.currentTime + 0.2);
+    osc.connect(gain);
+    gain.connect(ctx.destination);
+    gain.gain.setValueAtTime(0.4, ctx.currentTime);
+    gain.gain.exponentialRampToValueAtTime(0.01, ctx.currentTime + 0.2);
+    osc.start();
+    osc.stop(ctx.currentTime + 0.2);
+  } catch {}
+}
+
+export function playBuzzer(): void {
+  if (isMuted) return;
+  try {
+    const webkitCtx = (window as unknown as { webkitAudioContext: typeof AudioContext }).webkitAudioContext;
+    const ctx = new (window.AudioContext || webkitCtx)();
+    const osc = ctx.createOscillator();
+    const gain = ctx.createGain();
+    osc.type = 'sawtooth';
+    osc.frequency.setValueAtTime(100, ctx.currentTime);
+    osc.connect(gain);
+    gain.connect(ctx.destination);
+    gain.gain.setValueAtTime(0.3, ctx.currentTime);
+    gain.gain.exponentialRampToValueAtTime(0.01, ctx.currentTime + 0.8);
+    osc.start();
+    osc.stop(ctx.currentTime + 0.8);
+  } catch {}
+}
+
+export function playChime(): void {
+  if (isMuted) return;
+  try {
+    const webkitCtx = (window as unknown as { webkitAudioContext: typeof AudioContext }).webkitAudioContext;
+    const ctx = new (window.AudioContext || webkitCtx)();
+    const osc = ctx.createOscillator();
+    const gain = ctx.createGain();
+    osc.type = 'sine';
+    osc.frequency.setValueAtTime(523.25, ctx.currentTime);
+    osc.frequency.setValueAtTime(659.25, ctx.currentTime + 0.1);
+    osc.connect(gain);
+    gain.connect(ctx.destination);
+    gain.gain.setValueAtTime(0.25, ctx.currentTime);
+    gain.gain.exponentialRampToValueAtTime(0.01, ctx.currentTime + 0.4);
+    osc.start();
+    osc.stop(ctx.currentTime + 0.4);
+  } catch {}
+}

package/src/tool/snookerScoreKeeper/bibliography.astro

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

package/src/tool/snookerScoreKeeper/bibliography.ts

@@ -0,0 +1,10 @@
+export const bibliography = [
+  {
+    name: 'WPBSA Official Snooker Rules',
+    url: 'https://wpbsa.com/rules/',
+  },
+  {
+    name: 'World Snooker Tour Rules and Regulations',
+    url: 'https://wst.tv/rules/',
+  },
+];

package/src/tool/snookerScoreKeeper/component.astro

@@ -0,0 +1,153 @@
+---
+import type { KnownLocale } from '../../types';
+import type { SnookerScoreKeeperUI } from './ui';
+
+interface Props {
+  locale?: KnownLocale;
+  ui?: Record<string, unknown>;
+}
+
+const { ui } = Astro.props;
+const t = (ui ?? {}) as SnookerScoreKeeperUI;
+---
+
+<div class="sn-console" id="sn-card" data-sn-ui={JSON.stringify(t)}>
+  <div class="sn-header">
+    <div class="sn-header-actions">
+      <button class="sn-action-btn" id="sn-sound-btn" title={t.toggleSound}>
+        <svg id="sn-sound-icon-on" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+          <polygon points="11 5 6 9 2 9 2 15 6 15 11 19 11 5"/>
+          <path d="M19.07 4.93a10 10 0 0 1 0 14.14M15.54 8.46a5 5 0 0 1 0 7.07"/>
+        </svg>
+        <svg id="sn-sound-icon-off" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" style="display: none;">
+          <polygon points="11 5 6 9 2 9 2 15 6 15 11 19 11 5"/>
+          <line x1="23" y1="9" x2="17" y2="15"/>
+          <line x1="17" y1="9" x2="23" y2="15"/>
+        </svg>
+      </button>
+      <button class="sn-action-btn" id="sn-reset-btn" title={t.reset}>
+        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+          <path d="M3 12a9 9 0 0 1 9-9 9.75 9.75 0 0 1 6.74 2.74L21 8"/>
+          <path d="M16 3h5v5M21 12a9 9 0 0 1-9 9 9.75 9.75 0 0 1-6.74-2.74L3 16"/>
+          <path d="M8 21H3v-5"/>
+        </svg>
+      </button>
+      <button class="sn-action-btn" data-sn-fs title={t.fullscreen}>
+        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round">
+          <path d="M15 3h6v6M9 21H3v-6M21 3l-7 7M3 21l7-7"/>
+        </svg>
+      </button>
+    </div>
+  </div>
+
+  <div class="sn-dashboard-grid">
+    <div class="sn-player-panel" id="sn-panel-a">
+      <input type="text" class="sn-player-name" id="sn-name-a" value={t.player1} />
+      <span class="sn-indicator-active"></span>
+      <div class="sn-player-score" id="sn-score-a">0</div>
+      <div class="sn-break-value" id="sn-break-a"></div>
+    </div>
+
+    <div class="sn-player-panel" id="sn-panel-b">
+      <input type="text" class="sn-player-name" id="sn-name-b" value={t.player2} />
+      <span class="sn-indicator-active"></span>
+      <div class="sn-player-score" id="sn-score-b">0</div>
+      <div class="sn-break-value" id="sn-break-b"></div>
+    </div>
+  </div>
+
+  <div class="sn-felt-container">
+    <div class="sn-rack">
+      <button class="sn-ball-btn sn-ball-red" id="sn-btn-red" title="Red">
+        <span class="sn-ball-value">1</span>
+      </button>
+      <button class="sn-ball-btn sn-ball-yellow" id="sn-btn-yellow" title="Yellow">
+        <span class="sn-ball-value">2</span>
+      </button>
+      <button class="sn-ball-btn sn-ball-green" id="sn-btn-green" title="Green">
+        <span class="sn-ball-value">3</span>
+      </button>
+      <button class="sn-ball-btn sn-ball-brown" id="sn-btn-brown" title="Brown">
+        <span class="sn-ball-value">4</span>
+      </button>
+      <button class="sn-ball-btn sn-ball-blue" id="sn-btn-blue" title="Blue">
+        <span class="sn-ball-value">5</span>
+      </button>
+      <button class="sn-ball-btn sn-ball-pink" id="sn-btn-pink" title="Pink">
+        <span class="sn-ball-value">6</span>
+      </button>
+      <button class="sn-ball-btn sn-ball-black" id="sn-btn-black" title="Black">
+        <span class="sn-ball-value">7</span>
+      </button>
+    </div>
+
+    <div class="sn-interactive-hud">
+      <div class="sn-potted-strip" id="sn-potted-strip"></div>
+      <div class="sn-hud-metrics">
+        <div class="sn-metric-box">
+          <div class="sn-metric-lbl">{t.redsRemaining}</div>
+          <div class="sn-metric-val" id="sn-reds-remaining">15</div>
+        </div>
+        <div class="sn-metric-box">
+          <div class="sn-metric-lbl">{t.remainingPoints}</div>
+          <div class="sn-metric-val sn-gold" id="sn-points-remaining">147</div>
+        </div>
+      </div>
+    </div>
+  </div>
+
+  <div class="sn-gauge-container">
+    <div class="sn-status-badge sn-status-normal" id="sn-status-badge">{t.statusNormal}</div>
+    <div class="sn-gauge-track">
+      <div class="sn-gauge-bar" id="sn-gauge-bar"></div>
+    </div>
+  </div>
+
+  <div class="sn-control-toolbar">
+    <button class="sn-btn-action" id="sn-undo-btn">
+      <svg viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="2">
+        <path d="M3 7v6h6M21 17a9 9 0 0 0-9-9 9 9 0 0 0-6 2.3L3 13"/>
+      </svg>
+      Undo
+    </button>
+    <button class="sn-btn-action" id="sn-btn-foul">
+      <svg viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="2">
+        <circle cx="12" cy="12" r="10"/><line x1="12" y1="8" x2="12" y2="12"/><line x1="12" y1="16" x2="12.01" y2="16"/>
+      </svg>
+      {t.foul}
+    </button>
+    <button class="sn-btn-action sn-btn-end-turn" id="sn-btn-end-turn">
+      <svg viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="2">
+        <path d="M5 12h14M12 5l7 7-7 7"/>
+      </svg>
+      {t.endTurn}
+    </button>
+  </div>
+
+  <div class="sn-foul-panel" id="sn-foul-panel">
+    <div class="sn-foul-title">{t.foulTitle}</div>
+    <div class="sn-foul-grid">
+      <button class="sn-btn-foul-select" id="sn-btn-foul-4">{t.foulOnRed} (4)</button>
+      <button class="sn-btn-foul-select" id="sn-btn-foul-5">{t.foulOnBlue} (5)</button>
+      <button class="sn-btn-foul-select" id="sn-btn-foul-6">{t.foulOnPink} (6)</button>
+      <button class="sn-btn-foul-select" id="sn-btn-foul-7">{t.foulOnBlack} (7)</button>
+    </div>
+  </div>
+
+  <div id="sn-particle-container" class="sn-particle-container"></div>
+
+  <div class="sn-reset-modal" id="sn-modal">
+    <div class="sn-modal-content">
+      <div class="sn-modal-text">{t.resetConfirm}</div>
+      <div class="sn-modal-btns">
+        <button class="sn-btn-modal sn-btn-modal-cancel" id="sn-modal-cancel">{t.cancel}</button>
+        <button class="sn-btn-modal sn-btn-modal-confirm" id="sn-modal-confirm">{t.confirm}</button>
+      </div>
+    </div>
+  </div>
+</div>
+
+<script>
+  import { initSnookerScoreKeeper } from './logic';
+  initSnookerScoreKeeper();
+</script>

package/src/tool/snookerScoreKeeper/entry.ts

@@ -0,0 +1,30 @@
+import type { SportsToolEntry, ToolLocaleContent } from '../../types';
+import type { SnookerScoreKeeperUI } from './ui';
+
+export type { SnookerScoreKeeperUI };
+export type SnookerScoreKeeperLocaleContent = ToolLocaleContent<SnookerScoreKeeperUI>;
+
+export const snookerScoreKeeper: SportsToolEntry<SnookerScoreKeeperUI> = {
+  id: 'snooker-frame-tracker-break-calculator',
+  icons: {
+    bg: 'mdi:billiards',
+    fg: 'mdi:scoreboard-outline',
+  },
+  i18n: {
+    en: () => import('./i18n/en').then((m) => m.content),
+    es: () => import('./i18n/es').then((m) => m.content),
+    fr: () => import('./i18n/fr').then((m) => m.content),
+    de: () => import('./i18n/de').then((m) => m.content),
+    id: () => import('./i18n/id').then((m) => m.content),
+    it: () => import('./i18n/it').then((m) => m.content),
+    ja: () => import('./i18n/ja').then((m) => m.content),
+    ko: () => import('./i18n/ko').then((m) => m.content),
+    nl: () => import('./i18n/nl').then((m) => m.content),
+    pl: () => import('./i18n/pl').then((m) => m.content),
+    pt: () => import('./i18n/pt').then((m) => m.content),
+    ru: () => import('./i18n/ru').then((m) => m.content),
+    sv: () => import('./i18n/sv').then((m) => m.content),
+    tr: () => import('./i18n/tr').then((m) => m.content),
+    zh: () => import('./i18n/zh').then((m) => m.content),
+  },
+};

package/src/tool/snookerScoreKeeper/game-logic.ts

@@ -0,0 +1,181 @@
+export interface SnookerMatchState {
+  scoreA: number;
+  scoreB: number;
+  activePlayer: 'a' | 'b';
+  currentBreak: number;
+  breakBalls: string[];
+  redsOnTable: number;
+  expecting: 'red' | 'color' | 'yellow' | 'green' | 'brown' | 'blue' | 'pink' | 'black' | 'ended';
+  remainingPoints: number;
+  status: 'normal' | 'safe' | 'need-snookers' | 'deciding-black';
+  leader: 'a' | 'b' | null;
+}
+
+export function createInitialMatch(): SnookerMatchState {
+  return {
+    scoreA: 0,
+    scoreB: 0,
+    activePlayer: 'a',
+    currentBreak: 0,
+    breakBalls: [],
+    redsOnTable: 15,
+    expecting: 'red',
+    remainingPoints: 147,
+    status: 'normal',
+    leader: null,
+  };
+}
+
+const COLOR_VALUES: Record<string, number> = {
+  red: 1,
+  yellow: 2,
+  green: 3,
+  brown: 4,
+  blue: 5,
+  pink: 6,
+  black: 7,
+};
+
+const SEQUENCE_ORDER = ['yellow', 'green', 'brown', 'blue', 'pink', 'black'];
+
+function calculateRemainingPoints(
+  reds: number,
+  expecting: SnookerMatchState['expecting']
+): number {
+  if (reds > 0) {
+    if (expecting === 'color') {
+      return (reds * 8) + 34;
+    }
+    return (reds * 8) + 27;
+  }
+  const idx = SEQUENCE_ORDER.indexOf(expecting as string);
+  if (idx === -1) {
+    if (expecting === 'black') return 7;
+    return 0;
+  }
+  let sum = 0;
+  for (let i = idx; i < SEQUENCE_ORDER.length; i++) {
+    sum += COLOR_VALUES[SEQUENCE_ORDER[i]];
+  }
+  return sum;
+}
+
+function getLeader(scoreA: number, scoreB: number): 'a' | 'b' | null {
+  if (scoreA > scoreB) return 'a';
+  if (scoreB > scoreA) return 'b';
+  return null;
+}
+
+function determineStatus(
+  scoreA: number,
+  scoreB: number,
+  rem: number,
+  activePlayer: 'a' | 'b'
+): SnookerMatchState['status'] {
+  if (rem === 0) {
+    return scoreA === scoreB ? 'deciding-black' : 'safe';
+  }
+  const diff = Math.abs(scoreA - scoreB);
+  if (diff > rem) return 'safe';
+  if (diff === rem) return 'normal';
+  
+  const activeScore = activePlayer === 'a' ? scoreA : scoreB;
+  const opponentScore = activePlayer === 'a' ? scoreB : scoreA;
+  if (opponentScore > activeScore + rem) return 'need-snookers';
+  return 'normal';
+}
+
+function updateStatus(state: SnookerMatchState): SnookerMatchState {
+  const rem = state.remainingPoints;
+  return {
+    ...state,
+    leader: getLeader(state.scoreA, state.scoreB),
+    status: determineStatus(state.scoreA, state.scoreB, rem, state.activePlayer),
+  };
+}
+
+function getNextExpecting(
+  color: string,
+  redsOnTable: number,
+  currentExpecting: SnookerMatchState['expecting']
+): SnookerMatchState['expecting'] {
+  if (color === 'red') return 'color';
+  if (redsOnTable > 0) return 'red';
+  
+  const currentIdx = SEQUENCE_ORDER.indexOf(currentExpecting as string);
+  if (currentIdx !== -1 && currentIdx < SEQUENCE_ORDER.length - 1) {
+    return SEQUENCE_ORDER[currentIdx + 1] as SnookerMatchState['expecting'];
+  }
+  return 'ended';
+}
+
+export function potBall(state: SnookerMatchState, color: string): SnookerMatchState {
+  const val = COLOR_VALUES[color] || 0;
+  const isPlayerA = state.activePlayer === 'a';
+  const nextScoreA = isPlayerA ? state.scoreA + val : state.scoreA;
+  const nextScoreB = isPlayerA ? state.scoreB : state.scoreB + val;
+
+  const nextBreak = state.currentBreak + val;
+  const nextBreakBalls = [...state.breakBalls, color];
+
+  const nextReds = color === 'red' ? Math.max(0, state.redsOnTable - 1) : state.redsOnTable;
+  const nextExpecting = getNextExpecting(color, nextReds, state.expecting);
+  const nextRem = calculateRemainingPoints(nextReds, nextExpecting);
+
+  return updateStatus({
+    ...state,
+    scoreA: nextScoreA,
+    scoreB: nextScoreB,
+    currentBreak: nextBreak,
+    breakBalls: nextBreakBalls,
+    redsOnTable: nextReds,
+    expecting: nextExpecting,
+    remainingPoints: nextRem,
+  });
+}
+
+export function endTurn(state: SnookerMatchState): SnookerMatchState {
+  const nextPlayer = state.activePlayer === 'a' ? 'b' : 'a';
+  let nextExpecting = state.expecting;
+  if (state.redsOnTable > 0) {
+    nextExpecting = 'red';
+  }
+  const nextRem = calculateRemainingPoints(state.redsOnTable, nextExpecting);
+
+  return updateStatus({
+    ...state,
+    activePlayer: nextPlayer,
+    currentBreak: 0,
+    breakBalls: [],
+    expecting: nextExpecting,
+    remainingPoints: nextRem,
+  });
+}
+
+export function commitFoul(state: SnookerMatchState, penaltyPoints: number): SnookerMatchState {
+  let nextScoreA = state.scoreA;
+  let nextScoreB = state.scoreB;
+  if (state.activePlayer === 'a') {
+    nextScoreB += penaltyPoints;
+  } else {
+    nextScoreA += penaltyPoints;
+  }
+
+  const nextPlayer = state.activePlayer === 'a' ? 'b' : 'a';
+  let nextExpecting = state.expecting;
+  if (state.redsOnTable > 0) {
+    nextExpecting = 'red';
+  }
+  const nextRem = calculateRemainingPoints(state.redsOnTable, nextExpecting);
+
+  return updateStatus({
+    ...state,
+    scoreA: nextScoreA,
+    scoreB: nextScoreB,
+    activePlayer: nextPlayer,
+    currentBreak: 0,
+    breakBalls: [],
+    expecting: nextExpecting,
+    remainingPoints: nextRem,
+  });
+}