pokertools-arena 0.4.4 → 0.4.5

package/README.md

@@ -17,7 +17,7 @@
 | **Package** | `npx pokertools-arena` |
 | **Runtime** | Node.js ≥ 24 for tooling; any modern browser for the app |
 
-> **Current release: 0.4.4.** A maintenance release on top of the 0.4.0 methodology work: modal tooltips float above overflow, the launcher starts exactly once when its default port is busy, real-API diagnostics skip cleanly when repository secrets are absent, the Decision sanity suite attributes results to the correct model, seat editors show the model-derived name, close buttons use centered SVG icons, and decision logs no longer repeat the typed-decision caption.
+> **Current release: 0.4.5.** A maintenance release on top of the 0.4.0 methodology work: modal tooltips float above overflow, the launcher starts exactly once when its default port is busy, real-API diagnostics skip cleanly when repository secrets are absent, the Decision sanity suite attributes results to the correct model, seat editors show the model-derived name, close buttons use centered SVG icons, decision logs no longer repeat the typed-decision caption, and Stop immediately freezes the clock and table effects.
 
 ---
 

package/dist/app.js

@@ -115700,6 +115700,16 @@ function showActionToast(text, type = "") {
 function seatEl(playerId) {
   return $(`.seat[data-player-id="${CSS.escape(String(playerId))}"]`, els.seatsLayer);
 }
+function stopTableEffects() {
+  clearTimeout(showActionToast.timer);
+  els.actionToast?.classList.add("hidden");
+  els.pokerTable?.classList.remove("action-message-visible");
+  els.fxLayer?.replaceChildren();
+  for (const el of $$(".seat.fold-flash, .seat.check-flash")) {
+    el.classList.remove("fold-flash");
+    el.classList.remove("check-flash");
+  }
+}
 function animateNewHand(s) {
   if (!animationsAllowed()) return;
   requestAnimationFrame(() => {
@@ -115727,6 +115737,12 @@ function animateBoardCards(previousCount, currentCount) {
 }
 function processVisualEffects(s) {
   const events = s?.events || [];
+  if (["STOPPED", "ERROR"].includes(s?.status)) {
+    if (events.length) lastProcessedEventId = events.at(-1).id;
+    lastVisualState = s;
+    stopTableEffects();
+    return;
+  }
   if (!animationsAllowed()) {
     if (events.length) lastProcessedEventId = events.at(-1).id;
     lastVisualState = s;
@@ -117353,6 +117369,10 @@ function championBadgeHtml() {
   return '<span class="champion-badge" role="img" aria-label="Tournament champion"><svg viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M6.6 2.6h10.8v4.7a5.4 5.4 0 0 1-10.8 0V2.6Z"/><path d="M10.7 12.4h2.6V15h-2.6z"/><path d="M7.2 15h9.6v2.1H7.2z"/><path d="M5.6 18.2h12.8v2.3H5.6z"/></svg></span>';
 }
 function renderDecision(s) {
+  if (["STOPPED", "ERROR"].includes(s?.status)) {
+    stopClock();
+    return;
+  }
   const d = s?.currentDecision;
   const last = latestDecisionEvent(s);
   const shouldShowCard = Boolean(d || last || seatAssignments.filter(Boolean).length);
@@ -118269,7 +118289,12 @@ els.pauseBtn.addEventListener("click", () => {
   if (!director) return;
   currentState?.status === "PAUSED" ? director.resume() : director.pause();
 });
-els.stopBtn.addEventListener("click", () => director?.stop());
+els.stopBtn.addEventListener("click", () => {
+  if (!director) return;
+  stopClock();
+  stopTableEffects();
+  director.stop();
+});
 els.exportBtn.addEventListener("click", () => {
   if (!director?.events?.length) return;
   downloadText(`${director.config?.id || "pokertools-arena"}.jsonl`, director.exportJsonl());

package/dist/pokertools-arena.html

@@ -118375,6 +118375,16 @@ function showActionToast(text, type = "") {
 function seatEl(playerId) {
   return $(`.seat[data-player-id="${CSS.escape(String(playerId))}"]`, els.seatsLayer);
 }
+function stopTableEffects() {
+  clearTimeout(showActionToast.timer);
+  els.actionToast?.classList.add("hidden");
+  els.pokerTable?.classList.remove("action-message-visible");
+  els.fxLayer?.replaceChildren();
+  for (const el of $$(".seat.fold-flash, .seat.check-flash")) {
+    el.classList.remove("fold-flash");
+    el.classList.remove("check-flash");
+  }
+}
 function animateNewHand(s) {
   if (!animationsAllowed()) return;
   requestAnimationFrame(() => {
@@ -118402,6 +118412,12 @@ function animateBoardCards(previousCount, currentCount) {
 }
 function processVisualEffects(s) {
   const events = s?.events || [];
+  if (["STOPPED", "ERROR"].includes(s?.status)) {
+    if (events.length) lastProcessedEventId = events.at(-1).id;
+    lastVisualState = s;
+    stopTableEffects();
+    return;
+  }
   if (!animationsAllowed()) {
     if (events.length) lastProcessedEventId = events.at(-1).id;
     lastVisualState = s;
@@ -120028,6 +120044,10 @@ function championBadgeHtml() {
   return '<span class="champion-badge" role="img" aria-label="Tournament champion"><svg viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M6.6 2.6h10.8v4.7a5.4 5.4 0 0 1-10.8 0V2.6Z"/><path d="M10.7 12.4h2.6V15h-2.6z"/><path d="M7.2 15h9.6v2.1H7.2z"/><path d="M5.6 18.2h12.8v2.3H5.6z"/></svg></span>';
 }
 function renderDecision(s) {
+  if (["STOPPED", "ERROR"].includes(s?.status)) {
+    stopClock();
+    return;
+  }
   const d = s?.currentDecision;
   const last = latestDecisionEvent(s);
   const shouldShowCard = Boolean(d || last || seatAssignments.filter(Boolean).length);
@@ -120944,7 +120964,12 @@ els.pauseBtn.addEventListener("click", () => {
   if (!director) return;
   currentState?.status === "PAUSED" ? director.resume() : director.pause();
 });
-els.stopBtn.addEventListener("click", () => director?.stop());
+els.stopBtn.addEventListener("click", () => {
+  if (!director) return;
+  stopClock();
+  stopTableEffects();
+  director.stop();
+});
 els.exportBtn.addEventListener("click", () => {
   if (!director?.events?.length) return;
   downloadText(`${director.config?.id || "pokertools-arena"}.jsonl`, director.exportJsonl());

package/docs/diagnostics/SUMMARY.md

@@ -1,4 +1,4 @@
-# pokertools-arena 0.4.4 — benchmark methodology & results
+# pokertools-arena 0.4.5 — benchmark methodology & results
 
 Generated: 2026-09-19T18:19:58.352Z
 Methodology: paired fixed-state corpus; deterministic interleaving with recorded experiment seed.

package/docs/diagnostics/summary.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "version": "0.4.4",
+  "version": "0.4.5",
   "generatedAt": "2026-09-19T18:19:58.352Z",
   "experiments": [
     "paired"

package/docs/releases/RELEASE_NOTES.md

@@ -1,5 +1,15 @@
 # Release notes
 
+## 0.4.5 — Maintenance
+
+- **Stop now freezes the display.** Stopping a tournament clears the decision
+  clock and cancels every table effect still in flight (chip flies, action
+  toast, fold/check flashes and their pending timers). Previously the turn ring
+  and clock kept counting and queued animations finished after the run had
+  stopped, because the last broadcast still carried `currentDecision` and the
+  effects queue was never drained. `renderDecision` and `processVisualEffects`
+  now hard-stop on `STOPPED`/`ERROR`.
+
 ## 0.4.4 — Maintenance
 
 - **Cleaner decision logs.** Removed the repeated spectator caption ("This

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pokertools-arena",
-  "version": "0.4.4",
+  "version": "0.4.5",
   "description": "Browser-first AI poker benchmark powered by @pokertools/engine with generic OpenAI-compatible endpoints, optional OpenRouter/Jev Decisions routing, deterministic hierarchical decisions, paired fixed-state methodology, and reproducible reporting.",
   "type": "module",
   "bin": {

package/src/app.js

@@ -142,6 +142,17 @@ function showActionToast(text, type = '') {
   }, 1550);
 }
 function seatEl(playerId) { return $(`.seat[data-player-id="${CSS.escape(String(playerId))}"]`, els.seatsLayer); }
+// Cancel every effect the table may still have in flight: chip flies, toast,
+// fold/check flashes and their pending timeouts. Called when a run stops so the
+// display freezes instead of finishing queued animations.
+function stopTableEffects() {
+  clearTimeout(showActionToast.timer);
+  els.actionToast?.classList.add('hidden');
+  els.pokerTable?.classList.remove('action-message-visible');
+  els.fxLayer?.replaceChildren();
+  for (const el of $$('.seat.fold-flash, .seat.check-flash'))
+    { el.classList.remove('fold-flash'); el.classList.remove('check-flash'); }
+}
 function animateNewHand(s) {
   if (!animationsAllowed()) return;
   requestAnimationFrame(() => {
@@ -169,6 +180,15 @@ function animateBoardCards(previousCount, currentCount) {
 }
 function processVisualEffects(s) {
   const events = s?.events || [];
+  // Once a run is stopped (or errored) no further effects may be scheduled.
+  // Without this, already-live chip flies, flashes and sounds continued after
+  // Stop, and an in-flight broadcast could replay the last decision's effects.
+  if (['STOPPED', 'ERROR'].includes(s?.status)) {
+    if (events.length) lastProcessedEventId = events.at(-1).id;
+    lastVisualState = s;
+    stopTableEffects();
+    return;
+  }
   if (!animationsAllowed()) {
     if (events.length) lastProcessedEventId = events.at(-1).id;
     lastVisualState = s;
@@ -1569,6 +1589,9 @@ function championBadgeHtml() {
     + '</svg></span>';
 }
 function renderDecision(s) {
+  // A stopped/errored run must not keep a live clock. stop() clears
+  // currentDecision, but the last broadcast can still carry it, so guard here.
+  if (['STOPPED', 'ERROR'].includes(s?.status)) { stopClock(); return; }
   const d = s?.currentDecision;
   const last = latestDecisionEvent(s);
   const shouldShowCard = Boolean(d || last || seatAssignments.filter(Boolean).length);
@@ -2326,7 +2349,11 @@ els.setupBtn.addEventListener('click', openSetup);
 els.closeSetup.addEventListener('click', () => els.setupDialog.close());
 els.addConnectionBtn.addEventListener('click', () => addConnectionRow({ name: `API ${els.connectionsEditor.children.length + 1}`, kind: 'openai', baseUrl: 'https://api.openai.com/v1' }));
 els.pauseBtn.addEventListener('click', () => { if (!director) return; currentState?.status === 'PAUSED' ? director.resume() : director.pause(); });
-els.stopBtn.addEventListener('click', () => director?.stop());
+els.stopBtn.addEventListener('click', () => {
+  if (!director) return;
+  stopClock(); stopTableEffects();
+  director.stop();
+});
 els.exportBtn.addEventListener('click', () => { if (!director?.events?.length) return; downloadText(`${director.config?.id || 'pokertools-arena'}.jsonl`, director.exportJsonl()); });
 els.seatsBtn.addEventListener('click', () => {
   if (director && ['RUNNING', 'PAUSED'].includes(director.status)) return;