@jjlmoya/utils-tabletop 1.3.0 → 1.4.0

package/src/tool/first-player-selector/client.ts

@@ -0,0 +1,197 @@
+import { TouchTracker } from './modules/TouchTracker';
+import { SelectionEngine } from './modules/SelectionEngine';
+import { AnimationEffects } from './modules/AnimationEffects';
+import { SoundEffects } from './modules/SoundEffects';
+import type { ContactPoint, SelectionState, SelectorMode } from './types';
+
+const SOUND_ON_SVG = `<svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M11 5L6 9H2v6h4l5 4V5z"/><path d="M19.07 4.93a10 10 0 010 14.14M15.54 8.46a5 5 0 010 7.07"/></svg>`;
+
+const SOUND_OFF_SVG = `<svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M11 5L6 9H2v6h4l5 4V5z"/><line x1="23" y1="9" x2="17" y2="15"/><line x1="17" y1="9" x2="23" y2="15"/></svg>`;
+
+interface Elements {
+  canvas: HTMLCanvasElement;
+  ctx: CanvasRenderingContext2D;
+  btnModeFinger: HTMLButtonElement;
+  btnModeWheel: HTMLButtonElement;
+  btnSound: HTMLButtonElement;
+  btnReset: HTMLButtonElement;
+  btnSpin: HTMLButtonElement;
+  btnClear: HTMLButtonElement;
+  wheelActions: HTMLElement;
+  instructionsText: HTMLElement;
+  instructionsStatus: HTMLElement;
+}
+
+function getElements(): { els: Elements; ui: Record<string, string> } | null {
+  const container = document.querySelector('.selector-container[data-tool="first-player-selector"]') as HTMLElement;
+  if (!container) return null;
+  const canvas = document.getElementById('selector-canvas') as HTMLCanvasElement;
+  const ctx = canvas.getContext('2d');
+  if (!ctx) return null;
+  return {
+    els: {
+      canvas, ctx,
+      btnModeFinger: document.getElementById('btn-mode-finger') as HTMLButtonElement,
+      btnModeWheel: document.getElementById('btn-mode-wheel') as HTMLButtonElement,
+      btnSound: document.getElementById('btn-sound') as HTMLButtonElement,
+      btnReset: document.getElementById('btn-reset') as HTMLButtonElement,
+      btnSpin: document.getElementById('btn-spin') as HTMLButtonElement,
+      btnClear: document.getElementById('btn-clear') as HTMLButtonElement,
+      wheelActions: document.getElementById('wheel-actions') as HTMLElement,
+      instructionsText: document.getElementById('instructions-text') as HTMLElement,
+      instructionsStatus: document.getElementById('instructions-status') as HTMLElement,
+    },
+    ui: JSON.parse(container.getAttribute('data-ui') || '{}'),
+  };
+}
+
+function handleStateChange(state: SelectionState, els: Elements, ui: Record<string, string>): void {
+  if (state === 'idle') {
+    els.instructionsText.style.display = 'block';
+    els.instructionsText.textContent = ui.instructions;
+    els.instructionsStatus.textContent = '';
+    els.instructionsStatus.className = 'instructions-status';
+  } else if (state === 'countdown') {
+    els.instructionsText.style.display = 'none';
+    els.instructionsStatus.textContent = '';
+    els.instructionsStatus.className = 'instructions-status countdown';
+  } else if (state === 'selecting') {
+    els.instructionsText.style.display = 'none';
+    els.instructionsStatus.textContent = '';
+    els.instructionsStatus.className = 'instructions-status';
+  } else if (state === 'celebration') {
+    els.instructionsText.style.display = 'none';
+    els.instructionsStatus.textContent = ui.winner;
+    els.instructionsStatus.className = 'instructions-status celebration';
+  }
+}
+
+function handleWinner(winner: ContactPoint, sound: SoundEffects, effects: AnimationEffects): void {
+  sound.playWinner();
+  effects.spawnCelebration(winner.x, winner.y, winner.color);
+}
+
+function updateMode(mode: SelectorMode, tracker: TouchTracker, engine: SelectionEngine, els: Elements): void {
+  tracker.setMode(mode);
+  engine.setMode(mode);
+
+  if (mode === 'finger') {
+    els.btnModeFinger.classList.add('active');
+    els.btnModeWheel.classList.remove('active');
+    els.wheelActions.style.display = 'none';
+  } else {
+    els.btnModeFinger.classList.remove('active');
+    els.btnModeWheel.classList.add('active');
+    els.wheelActions.style.display = 'flex';
+  }
+}
+
+function resizeCanvas(canvas: HTMLCanvasElement, ctx: CanvasRenderingContext2D): void {
+  const rect = canvas.getBoundingClientRect();
+  canvas.width = rect.width * window.devicePixelRatio;
+  canvas.height = rect.height * window.devicePixelRatio;
+  ctx.scale(window.devicePixelRatio, window.devicePixelRatio);
+}
+
+function bindSoundToggle(
+  btn: HTMLButtonElement, ui: Record<string, string>,
+  sound: SoundEffects, isSoundEnabled: { value: boolean }
+): void {
+  btn.addEventListener('click', () => {
+    isSoundEnabled.value = !isSoundEnabled.value;
+    sound.setMute(!isSoundEnabled.value);
+    if (isSoundEnabled.value) {
+      btn.classList.add('active');
+      btn.classList.remove('muted');
+      btn.innerHTML = SOUND_ON_SVG;
+      btn.title = ui.soundOn;
+    } else {
+      btn.classList.remove('active');
+      btn.classList.add('muted');
+      btn.innerHTML = SOUND_OFF_SVG;
+      btn.title = ui.soundOff;
+    }
+  });
+}
+
+function bindEvents(
+  els: Elements, ui: Record<string, string>,
+  deps: { engine: SelectionEngine; tracker: TouchTracker; sound: SoundEffects }
+): void {
+  els.btnModeFinger.addEventListener('click', () => updateMode('finger', deps.tracker, deps.engine, els));
+  els.btnModeWheel.addEventListener('click', () => updateMode('wheel', deps.tracker, deps.engine, els));
+
+  const isSoundEnabled = { value: true };
+  bindSoundToggle(els.btnSound, ui, deps.sound, isSoundEnabled);
+
+  els.btnReset.addEventListener('click', () => { deps.tracker.clear(); deps.engine.reset(); });
+  els.btnClear.addEventListener('click', () => { deps.tracker.clear(); deps.engine.reset(); });
+  els.btnSpin.addEventListener('click', () => { deps.engine.startWheelSelection(); });
+}
+
+interface LoopDeps {
+  engine: SelectionEngine;
+  effects: AnimationEffects;
+  tracker: TouchTracker;
+}
+
+function startLoop(
+  canvas: HTMLCanvasElement, ctx: CanvasRenderingContext2D,
+  deps: LoopDeps
+): void {
+  let lastTime = performance.now();
+  function loop(now: number) {
+    const dt = now - lastTime;
+    lastTime = now;
+    deps.engine.update(dt);
+
+    const width = canvas.width / window.devicePixelRatio;
+    const height = canvas.height / window.devicePixelRatio;
+    const isLightMode = document.documentElement.classList.contains('theme-light');
+
+    deps.effects.updateAndDraw({
+      ctx, width, height,
+      contacts: deps.tracker.getContacts(),
+      state: deps.engine.getState(),
+      progress: deps.engine.getCountdownProgress(),
+      wheelAngle: deps.engine.getWheelAngle(),
+      centroid: deps.engine.getCentroid(),
+      isLightMode
+    });
+
+    requestAnimationFrame(loop);
+  }
+  requestAnimationFrame(loop);
+}
+
+function init(): void {
+  const result = getElements();
+  if (!result) return;
+  const { els, ui } = result;
+
+  const sound = new SoundEffects();
+  const effects = new AnimationEffects();
+
+  const engine = new SelectionEngine(
+    (state) => handleStateChange(state, els, ui),
+    () => sound.playTick(),
+    (winner) => handleWinner(winner, sound, effects),
+    () => sound.playCountdown()
+  );
+
+  const tracker = new TouchTracker(els.canvas, (contacts) => {
+    engine.setContacts(contacts);
+  });
+
+  resizeCanvas(els.canvas, els.ctx);
+  window.addEventListener('resize', () => resizeCanvas(els.canvas, els.ctx));
+
+  bindEvents(els, ui, { engine, tracker, sound });
+  startLoop(els.canvas, els.ctx, { engine, effects, tracker });
+}
+
+if (document.readyState === 'loading') {
+  document.addEventListener('DOMContentLoaded', init);
+} else {
+  init();
+}

package/src/tool/first-player-selector/component.astro

@@ -0,0 +1,77 @@
+---
+import './first-player-selector.css';
+
+interface Props {
+  ui: Record<string, string>;
+}
+
+const { ui } = Astro.props;
+---
+
+<div class="selector-container" data-tool="first-player-selector" data-ui={JSON.stringify(ui)}>
+  <div class="mode-selector" role="group" aria-label="Selection mode">
+    <button class="mode-btn active" id="btn-mode-finger" type="button" title={ui.fingerMode}>
+      <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round">
+        <path d="M14.5 11.5a3 3 0 1 0-4-4"/>
+        <path d="M12 17V7"/>
+        <path d="M8.5 8.5a3 3 0 0 0 1 5.5"/>
+        <path d="M10.5 14.5A5 5 0 0 0 17 11"/>
+        <path d="M7 19a7 7 0 0 1 10 0"/>
+      </svg>
+      <span>{ui.fingerMode}</span>
+    </button>
+    <button class="mode-btn" id="btn-mode-wheel" type="button" title={ui.wheelMode}>
+      <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round">
+        <circle cx="12" cy="12" r="8"/>
+        <circle cx="12" cy="12" r="2" fill="currentColor"/>
+        <path d="M12 2v4M12 18v4M2 12h4M18 12h4"/>
+      </svg>
+      <span>{ui.wheelMode}</span>
+    </button>
+  </div>
+
+
+  <button class="icon-btn sound-btn active" id="btn-sound" type="button" title={ui.soundOn}>
+    <svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+      <path d="M11 5L6 9H2v6h4l5 4V5z"/>
+      <path d="M19.07 4.93a10 10 0 010 14.14M15.54 8.46a5 5 0 010 7.07"/>
+    </svg>
+  </button>
+
+  <button class="icon-btn reset-btn" id="btn-reset" type="button" title={ui.reset}>
+    <svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+      <polyline points="23 4 23 10 17 10"/>
+      <path d="M20.49 15a9 9 0 11-2.12-9.36L23 10"/>
+    </svg>
+  </button>
+
+
+  <div class="wheel-actions" id="wheel-actions" style="display: none;">
+    <button class="action-btn spin" id="btn-spin" type="button">
+      <svg width="22" height="22" viewBox="0 0 24 24" fill="currentColor" stroke="none">
+        <polygon points="6 3 20 12 6 21 6 3"/>
+      </svg>
+      {ui.start}
+    </button>
+    <button class="action-btn clear" id="btn-clear" type="button">
+      <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round">
+        <line x1="18" y1="6" x2="6" y2="18"/>
+        <line x1="6" y1="6" x2="18" y2="18"/>
+      </svg>
+      {ui.clearPlayers}
+    </button>
+  </div>
+
+  <div class="canvas-wrapper">
+    <canvas id="selector-canvas" class="selector-canvas"></canvas>
+  </div>
+
+  <div class="instructions-overlay">
+    <div class="instructions-text" id="instructions-text">
+      {ui.instructions}
+    </div>
+    <div class="instructions-status" id="instructions-status"></div>
+  </div>
+</div>
+
+<script src="./client.ts"></script>

package/src/tool/first-player-selector/entry.ts

@@ -0,0 +1,42 @@
+import type { TabletopToolEntry, ToolLocaleContent } from '../../types';
+
+export type FirstPlayerSelectorUI = {
+  title: string;
+  instructions: string;
+  tapToSelect: string;
+  winner: string;
+  reset: string;
+  start: string;
+  setupTitle: string;
+  clearPlayers: string;
+  fingerMode: string;
+  wheelMode: string;
+  presetsTitle: string;
+  soundOn: string;
+  soundOff: string;
+  playerCountLabel: string;
+};
+
+export type FirstPlayerSelectorLocaleContent = ToolLocaleContent<FirstPlayerSelectorUI>;
+
+export const firstPlayerSelector: TabletopToolEntry<FirstPlayerSelectorUI> = {
+  id: 'first-player-selector',
+  icons: { bg: 'mdi:gesture-tap', fg: 'mdi:gesture-double-tap' },
+  i18n: {
+    de: () => import('./i18n/de').then((m) => m.content),
+    en: () => import('./i18n/en').then((m) => m.content),
+    es: () => import('./i18n/es').then((m) => m.content),
+    fr: () => import('./i18n/fr').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/first-player-selector/first-player-selector.css

@@ -0,0 +1,303 @@
+.selector-container {
+  position: relative;
+  width: 100%;
+  height: 100vh;
+  min-height: 500px;
+  overflow: hidden;
+  user-select: none;
+  -webkit-user-select: none;
+  background: var(--bg-surface);
+  color: var(--text-base);
+  box-shadow: inset 0 0 0 1px var(--border-base);
+}
+
+.canvas-wrapper {
+  position: absolute;
+  top: 0;
+  left: 0;
+  width: 100%;
+  height: 100%;
+  z-index: 10;
+  touch-action: none;
+}
+
+.selector-canvas {
+  display: block;
+  width: 100%;
+  height: 100%;
+}
+
+.mode-selector {
+  position: absolute;
+  top: 20px;
+  left: 50%;
+  transform: translateX(-50%);
+  display: inline-flex;
+  background: var(--bg-surface);
+  border: 1px solid var(--border-base);
+  border-radius: 9999px;
+  padding: 3px;
+  z-index: 20;
+  box-shadow: 0 10px 25px -5px var(--shadow-base), 0 8px 10px -6px var(--shadow-base);
+}
+
+.mode-btn {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  padding: 7px 16px;
+  font-size: 13px;
+  font-weight: 600;
+  color: var(--text-dimmed);
+  background: transparent;
+  border: none;
+  border-radius: 9999px;
+  cursor: pointer;
+  transition: all 0.25s cubic-bezier(0.4, 0, 0.2, 1);
+  outline: none;
+  white-space: nowrap;
+}
+
+.mode-btn:hover {
+  color: var(--text-base);
+}
+
+.mode-btn.active {
+  color: var(--text-base);
+  background: var(--bg-muted);
+}
+
+.mode-btn svg {
+  flex-shrink: 0;
+}
+
+.icon-btn {
+  position: absolute;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 40px;
+  height: 40px;
+  background: var(--bg-surface);
+  border: 1px solid var(--border-base);
+  border-radius: 50%;
+  cursor: pointer;
+  transition: all 0.2s cubic-bezier(0.4, 0, 0.2, 1);
+  outline: none;
+  z-index: 20;
+  color: var(--text-dimmed);
+}
+
+.icon-btn:hover {
+  color: var(--text-base);
+  background: var(--bg-muted);
+}
+
+.icon-btn.active {
+  color: var(--text-base);
+  background: var(--bg-muted);
+}
+
+.icon-btn.muted {
+  opacity: 0.5;
+}
+
+.sound-btn {
+  top: 20px;
+  right: 20px;
+}
+
+.reset-btn {
+  bottom: 20px;
+  right: 20px;
+}
+
+.wheel-actions {
+  position: absolute;
+  bottom: 80px;
+  left: 50%;
+  transform: translateX(-50%);
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 10px;
+  z-index: 20;
+  pointer-events: none;
+}
+
+.wheel-actions .action-btn {
+  pointer-events: auto;
+}
+
+.action-btn {
+  display: inline-flex;
+  align-items: center;
+  gap: 8px;
+  border: none;
+  border-radius: 9999px;
+  cursor: pointer;
+  font-weight: 600;
+  outline: none;
+  transition: all 0.25s cubic-bezier(0.4, 0, 0.2, 1);
+}
+
+.action-btn.spin {
+  padding: 14px 32px;
+  font-size: 16px;
+  color: var(--text-on-primary);
+  background: var(--primary);
+  box-shadow: 0 8px 24px var(--shadow-hover);
+}
+
+.action-btn.spin:hover {
+  transform: translateY(-2px);
+  box-shadow: 0 12px 28px var(--shadow-hover);
+}
+
+.action-btn.spin:active {
+  transform: translateY(0);
+}
+
+.action-btn.spin:disabled {
+  opacity: 0.4;
+  cursor: not-allowed;
+  transform: none;
+  box-shadow: none;
+}
+
+.action-btn.clear {
+  padding: 8px 20px;
+  font-size: 13px;
+  color: var(--text-dimmed);
+  background: var(--bg-surface);
+  border: 1px solid var(--border-base);
+}
+
+.action-btn.clear:hover {
+  color: var(--text-base);
+  background: var(--bg-muted);
+}
+
+.instructions-overlay {
+  position: absolute;
+  bottom: 40px;
+  left: 50%;
+  transform: translateX(-50%);
+  text-align: center;
+  pointer-events: none;
+  z-index: 20;
+}
+
+.instructions-text {
+  font-size: 16px;
+  font-weight: 500;
+  color: var(--text-dimmed);
+  background: var(--bg-surface);
+  padding: 8px 20px;
+  border-radius: 9999px;
+  border: 1px solid var(--border-base);
+  letter-spacing: 0.025em;
+  animation: pulse-glow 2s infinite ease-in-out;
+}
+
+.instructions-status {
+  margin-top: 10px;
+  font-size: 24px;
+  font-weight: 700;
+  letter-spacing: 0.05em;
+  text-transform: uppercase;
+}
+
+.instructions-status.countdown {
+  color: var(--text-base);
+  animation: scale-up-pulse 0.5s infinite alternate ease-in-out;
+}
+
+.instructions-status.celebration {
+  color: var(--color-warning);
+  text-shadow: 0 0 10px var(--shadow-hover);
+  animation: winner-bounce 0.6s infinite alternate ease-in-out;
+}
+
+@keyframes pulse-glow {
+  0%, 100% {
+    opacity: 0.6;
+  }
+  50% {
+    opacity: 1.0;
+  }
+}
+
+@keyframes scale-up-pulse {
+  from {
+    transform: scale(0.95);
+  }
+  to {
+    transform: scale(1.05);
+  }
+}
+
+@keyframes winner-bounce {
+  from {
+    transform: translateY(0);
+  }
+  to {
+    transform: translateY(-8px);
+  }
+}
+
+@media (max-width: 768px) {
+  .mode-selector {
+    top: 12px;
+    padding: 2px;
+  }
+
+  .mode-btn {
+    padding: 6px 12px;
+    font-size: 12px;
+    gap: 4px;
+  }
+
+  .mode-btn svg {
+    width: 16px;
+    height: 16px;
+  }
+
+  .icon-btn {
+    width: 36px;
+    height: 36px;
+  }
+
+  .icon-btn svg {
+    width: 18px;
+    height: 18px;
+  }
+
+  .sound-btn {
+    top: 12px;
+    right: 12px;
+  }
+
+  .reset-btn {
+    bottom: 12px;
+    right: 12px;
+  }
+
+  .wheel-actions {
+    bottom: 90px;
+  }
+
+  .action-btn.spin {
+    padding: 12px 24px;
+    font-size: 14px;
+  }
+
+  .action-btn.clear {
+    padding: 6px 16px;
+    font-size: 12px;
+  }
+
+  .instructions-overlay {
+    bottom: 30px;
+  }
+}