mirror of
https://github.com/TheRealOwenRees/chess-endgame-trainer.git
synced 2026-11-18 11:42:07 +00:00
add puzzle training sessions with difficulty and ratings
- /train starts an ephemeral session by choosing easy/medium/hard, banded relative to the user's current rating (band width configurable) - session timer, average per-puzzle time, net rating gain and per-puzzle delta - next puzzle, plus review and retry reused from the play surface - explicit stop/start: stopping returns to the difficulty picker - puzzle rating shown once a puzzle completes, and a side-to-move indicator - extract the play logic/markup into shared PlayCore and PlayComponents so the standalone play view and sessions share one implementation - sticky footer; glossary entries for Difficulty and Session; ADR 0009
This commit is contained in:
@@ -1,10 +1,9 @@
|
||||
defmodule ChesstrainerWeb.EndgameLive.Play do
|
||||
use ChesstrainerWeb, :live_view
|
||||
|
||||
alias Chesstrainer.Attempts
|
||||
alias Chesstrainer.Endgames
|
||||
alias Chesstrainer.Endgames.Tablebase
|
||||
alias Chesstrainer.Ratings
|
||||
alias ChesstrainerWeb.EndgameLive.PlayCore
|
||||
alias ChesstrainerWeb.PlayComponents
|
||||
|
||||
@impl true
|
||||
def render(assigns) do
|
||||
@@ -39,140 +38,21 @@ defmodule ChesstrainerWeb.EndgameLive.Play do
|
||||
</:actions>
|
||||
</.header>
|
||||
|
||||
<div class="flex gap-2 bg-base-200 p-4 rounded-xl shadow-inner">
|
||||
<div
|
||||
id="endgame-board"
|
||||
phx-hook="ChessBoard"
|
||||
phx-update="ignore"
|
||||
data-endgame-id={@endgame.id}
|
||||
class="w-100 h-100"
|
||||
>
|
||||
</div>
|
||||
|
||||
<div class="w-48 h-100 flex flex-col gap-3">
|
||||
<div class="rounded-lg bg-canvas-raised p-3 text-sm">
|
||||
<%= cond do %>
|
||||
<% @status == :loading -> %>
|
||||
<p class="text-muted">Loading tablebase…</p>
|
||||
<% @status == :blocked -> %>
|
||||
<p class="font-semibold text-error">Tablebase unavailable</p>
|
||||
<p class="text-error">{@blocked_reason}</p>
|
||||
<% @status == :solved -> %>
|
||||
<p class="font-semibold text-success-text">
|
||||
{if @endgame.result == :draw, do: "Draw held!", else: "Solved!"}
|
||||
</p>
|
||||
<% @status == :failed -> %>
|
||||
<p class="font-semibold text-error">Failed</p>
|
||||
<p class="text-error">
|
||||
{if @endgame.result == :draw,
|
||||
do: "That move loses the draw.",
|
||||
else: "That move throws away the win."}
|
||||
</p>
|
||||
<%= if @best_move && @plies != [] do %>
|
||||
<p class="text-muted">
|
||||
You played {List.last(@plies).san}; best was: {@best_move}
|
||||
</p>
|
||||
<% end %>
|
||||
<% @awaiting_reply -> %>
|
||||
<p class="text-muted">Opponent is replying…</p>
|
||||
<% @last_grade == :optimal -> %>
|
||||
<p class="font-semibold text-success-text">Optimal move</p>
|
||||
<% @last_grade == :winning -> %>
|
||||
<p class="font-semibold text-warning">
|
||||
{if @endgame.result == :draw,
|
||||
do: "Keeps the draw — but not the sharpest",
|
||||
else: "Winning — but not the sharpest"}
|
||||
</p>
|
||||
<% @last_grade == :losing -> %>
|
||||
<p class="font-semibold text-error">
|
||||
{if @endgame.result == :draw,
|
||||
do: "Losing move — this loses the draw",
|
||||
else: "Losing move — this throws away the win"}
|
||||
</p>
|
||||
<% @last_grade == :unknown -> %>
|
||||
<p class="font-semibold text-muted">Could not grade that move</p>
|
||||
<% true -> %>
|
||||
<p class="text-muted">Make a move to have it graded.</p>
|
||||
<% end %>
|
||||
</div>
|
||||
|
||||
<div :if={@reviewing} id="best-move-panel" class="rounded-lg bg-canvas-raised p-3 text-sm">
|
||||
<%= cond do %>
|
||||
<% @review_blocked -> %>
|
||||
<p class="text-muted">Best move unavailable here</p>
|
||||
<p class="text-muted">{@review_blocked}</p>
|
||||
<% @review_tablebase -> %>
|
||||
<p class="text-muted font-semibold mb-1">Best move:</p>
|
||||
<p class="text-success-text">{best_move_text(@review_tablebase) || "—"}</p>
|
||||
<%= if played_ply = played_ply_at(@line, @review_index) do %>
|
||||
<p class={["mt-1", grade_class(played_ply.grade)]}>Played: {played_ply.san}</p>
|
||||
<% end %>
|
||||
<% true -> %>
|
||||
<p class="text-muted">No best move.</p>
|
||||
<% end %>
|
||||
</div>
|
||||
|
||||
<div id="move-list" class="flex-1 min-h-0 flex flex-col bg-canvas-raised rounded-lg p-3">
|
||||
<% plies = display_plies(@reviewing, @line, @plies) %>
|
||||
<p class="text-sm text-muted font-semibold mb-2">Moves:</p>
|
||||
<div class="flex-1 overflow-y-auto">
|
||||
<%= if plies == [] do %>
|
||||
<p class="text-sm text-muted">No Moves</p>
|
||||
<% else %>
|
||||
<%= for {[white_ply, black_ply], move_no} <- move_rows(plies, @endgame.color) do %>
|
||||
<div class="font-mono text-sm leading-6">
|
||||
<span class="text-muted mr-2">{move_no}.</span>
|
||||
<%= if white_ply do %>
|
||||
<.ply
|
||||
ply={white_ply}
|
||||
reviewing={@reviewing}
|
||||
review_index={@review_index}
|
||||
result={@endgame.result}
|
||||
/>
|
||||
<% else %>
|
||||
<span class="text-body">...</span>
|
||||
<% end %>
|
||||
<%= if black_ply do %>
|
||||
<.ply
|
||||
ply={black_ply}
|
||||
reviewing={@reviewing}
|
||||
review_index={@review_index}
|
||||
result={@endgame.result}
|
||||
/>
|
||||
<% end %>
|
||||
</div>
|
||||
<% end %>
|
||||
<% end %>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="flex gap-2">
|
||||
<.button
|
||||
:if={@status in [:solved, :failed] and not @reviewing}
|
||||
phx-click="review"
|
||||
>
|
||||
<.icon name="hero-eye" /> Review
|
||||
</.button>
|
||||
<.button phx-click="reset" variant="primary">
|
||||
<.icon name="hero-arrow-path" />
|
||||
{if @status in [:solved, :failed], do: "Try again", else: "Reset"}
|
||||
</.button>
|
||||
</div>
|
||||
|
||||
<div :if={@reviewing} id="review-controls" class="flex flex-wrap gap-2">
|
||||
<.button phx-click="review_prev" disabled={@review_index <= 0}>←</.button>
|
||||
<.button phx-click="review_next" disabled={@review_index >= length(@line)}>→</.button>
|
||||
<.button
|
||||
:if={@review_tablebase && best_move_text(@review_tablebase)}
|
||||
phx-click="play_best_line"
|
||||
disabled={@awaiting_best_line}
|
||||
>
|
||||
Play best line
|
||||
</.button>
|
||||
<.button :if={@line != @plies} phx-click="back_to_game">Back to game</.button>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<PlayComponents.play_surface
|
||||
endgame={@endgame}
|
||||
status={@status}
|
||||
blocked_reason={@blocked_reason}
|
||||
best_move={@best_move}
|
||||
plies={@plies}
|
||||
line={@line}
|
||||
reviewing={@reviewing}
|
||||
review_index={@review_index}
|
||||
review_tablebase={@review_tablebase}
|
||||
review_blocked={@review_blocked}
|
||||
awaiting_reply={@awaiting_reply}
|
||||
last_grade={@last_grade}
|
||||
awaiting_best_line={@awaiting_best_line}
|
||||
/>
|
||||
</Layouts.app>
|
||||
"""
|
||||
end
|
||||
@@ -181,637 +61,34 @@ defmodule ChesstrainerWeb.EndgameLive.Play do
|
||||
def mount(%{"public_code" => public_code}, _session, socket) do
|
||||
endgame = Endgames.get_endgame_by_public_code!(public_code)
|
||||
|
||||
socket =
|
||||
socket
|
||||
|> assign(:page_title, "Play endgame")
|
||||
|> assign(:endgame, endgame)
|
||||
|> assign(:user_rating, user_rating(socket.assigns.current_scope))
|
||||
|> assign(:fen, endgame.fen)
|
||||
|> assign(:tablebase, nil)
|
||||
|> assign(:status, :loading)
|
||||
|> assign(:blocked_reason, nil)
|
||||
|> assign(:best_move, nil)
|
||||
|> assign(:plies, [])
|
||||
|> assign(:reviewing, false)
|
||||
|> assign(:review_index, 0)
|
||||
|> assign(:pending_reply, nil)
|
||||
|> assign(:snapshots, %{})
|
||||
|> assign(:line, [])
|
||||
|> assign(:review_tablebase, nil)
|
||||
|> assign(:review_blocked, nil)
|
||||
|> assign(:awaiting_best_line, false)
|
||||
|> assign(:pending_best_move, nil)
|
||||
|> assign(:last_san, "None yet")
|
||||
|> assign(:last_from_to, "None yet")
|
||||
|> assign(:last_grade, nil)
|
||||
|> assign(:awaiting_reply, false)
|
||||
|
||||
{:ok, load_attempt(socket)}
|
||||
{:ok, PlayCore.init(socket, endgame)}
|
||||
end
|
||||
|
||||
@impl true
|
||||
def handle_event("endgame_move_played", params, socket) do
|
||||
%{"from" => from, "to" => to, "san" => san} = params
|
||||
promotion = params["promotion"]
|
||||
draw = params["draw"] || false
|
||||
prev_fen = params["prev_fen"] || socket.assigns.fen
|
||||
fen_after = params["fen"] || socket.assigns.fen
|
||||
def handle_event("endgame_move_played", params, socket),
|
||||
do: PlayCore.move_played(socket, params)
|
||||
|
||||
cond do
|
||||
socket.assigns.status == :blocked ->
|
||||
{:noreply,
|
||||
put_flash(socket, :error, "The tablebase is unavailable, so this move cannot be graded.")}
|
||||
def handle_event("opponent_reply_applied", params, socket),
|
||||
do: PlayCore.opponent_reply_applied(socket, params)
|
||||
|
||||
socket.assigns.status != :playing ->
|
||||
{:noreply, socket}
|
||||
def handle_event("chess_fen_invalid", params, socket),
|
||||
do: PlayCore.fen_invalid(socket, params)
|
||||
|
||||
not same_position?(prev_fen, socket.assigns.fen) ->
|
||||
{:noreply,
|
||||
put_flash(socket, :error, "That move is out of sequence. Press Reset to try again.")}
|
||||
def handle_event("reset", _params, socket), do: PlayCore.reset(socket)
|
||||
|
||||
true ->
|
||||
grade_and_record(socket, from, to, promotion, san, fen_after, draw)
|
||||
end
|
||||
end
|
||||
def handle_event("review", _params, socket), do: PlayCore.review(socket)
|
||||
|
||||
def handle_event("opponent_reply_applied", params, socket) do
|
||||
%{"fen" => fen} = params
|
||||
draw = params["draw"] || false
|
||||
def handle_event("review_prev", _params, socket), do: PlayCore.review_prev(socket)
|
||||
|
||||
cond do
|
||||
not socket.assigns.awaiting_reply ->
|
||||
{:noreply, socket}
|
||||
def handle_event("review_next", _params, socket), do: PlayCore.review_next(socket)
|
||||
|
||||
true ->
|
||||
socket = record_opponent_ply(socket, fen, params["san"])
|
||||
def handle_event("review_step", %{"index" => index}, socket),
|
||||
do: PlayCore.review_step(socket, index)
|
||||
|
||||
if draw and socket.assigns.endgame.result == :draw do
|
||||
solve_attempt(socket)
|
||||
else
|
||||
case Tablebase.new(fen) do
|
||||
{:ok, tablebase} ->
|
||||
{:noreply,
|
||||
socket
|
||||
|> assign(:fen, fen)
|
||||
|> assign(:tablebase, tablebase)
|
||||
|> snapshot(fen, tablebase)
|
||||
|> assign(:awaiting_reply, false)
|
||||
|> assign(:status, :playing)
|
||||
|> assign(:blocked_reason, nil)
|
||||
|> push_event("resume_board", %{})}
|
||||
def handle_event("play_best_line", _params, socket), do: PlayCore.play_best_line(socket)
|
||||
|
||||
other ->
|
||||
{:noreply,
|
||||
socket
|
||||
|> assign(:awaiting_reply, false)
|
||||
|> assign(:status, :blocked)
|
||||
|> assign(:blocked_reason, blocked_reason(other))}
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
||||
def handle_event("best_line_move_applied", params, socket),
|
||||
do: PlayCore.best_line_move_applied(socket, params)
|
||||
|
||||
def handle_event("chess_fen_invalid", %{"fen" => fen, "message" => message}, socket) do
|
||||
{:noreply,
|
||||
put_flash(
|
||||
socket,
|
||||
:error,
|
||||
"Endgame FEN is invalid and the board cannot be loaded: #{message} (#{fen})"
|
||||
)}
|
||||
end
|
||||
|
||||
def handle_event("reset", _params, socket) do
|
||||
socket =
|
||||
socket
|
||||
|> assign(:plies, [])
|
||||
|> assign(:reviewing, false)
|
||||
|> assign(:review_index, 0)
|
||||
|> assign(:pending_reply, nil)
|
||||
|> assign(:snapshots, %{})
|
||||
|> assign(:line, [])
|
||||
|> assign(:review_tablebase, nil)
|
||||
|> assign(:review_blocked, nil)
|
||||
|> assign(:awaiting_best_line, false)
|
||||
|> assign(:pending_best_move, nil)
|
||||
|> assign(:last_san, "None yet")
|
||||
|> assign(:last_from_to, "None yet")
|
||||
|> assign(:last_grade, nil)
|
||||
|
||||
{:noreply, load_attempt(socket)}
|
||||
end
|
||||
|
||||
def handle_event("review", _params, socket) do
|
||||
if socket.assigns.status in [:solved, :failed] do
|
||||
socket =
|
||||
socket
|
||||
|> assign(:reviewing, true)
|
||||
|> assign(:line, socket.assigns.plies)
|
||||
|> set_review_index(length(socket.assigns.plies))
|
||||
|
||||
{:noreply, push_review_position(socket)}
|
||||
else
|
||||
{:noreply, socket}
|
||||
end
|
||||
end
|
||||
|
||||
def handle_event("review_prev", _params, socket), do: step_review(socket, -1)
|
||||
|
||||
def handle_event("review_next", _params, socket), do: step_review(socket, 1)
|
||||
|
||||
def handle_event("review_step", %{"index" => index}, socket) do
|
||||
if socket.assigns.reviewing do
|
||||
last = length(socket.assigns.line)
|
||||
index = parse_index(index) |> max(0) |> min(last)
|
||||
|
||||
{:noreply, push_review_position(set_review_index(socket, index))}
|
||||
else
|
||||
{:noreply, socket}
|
||||
end
|
||||
end
|
||||
|
||||
def handle_event("play_best_line", _params, socket) do
|
||||
with true <- socket.assigns.reviewing,
|
||||
%Tablebase{} = tablebase <- socket.assigns.review_tablebase,
|
||||
%Tablebase.Move{} = move <- pick_best_move(tablebase) do
|
||||
# Branch the review line at the current position, then play one best move.
|
||||
{:noreply,
|
||||
socket
|
||||
|> assign(:line, Enum.take(socket.assigns.line, socket.assigns.review_index))
|
||||
|> assign(:awaiting_best_line, true)
|
||||
|> assign(:pending_best_move, move)
|
||||
|> push_event("best_line_move", reply_payload(move))}
|
||||
else
|
||||
_ -> {:noreply, socket}
|
||||
end
|
||||
end
|
||||
|
||||
def handle_event("best_line_move_applied", %{"fen" => fen}, socket) do
|
||||
if socket.assigns.awaiting_best_line do
|
||||
move = socket.assigns.pending_best_move
|
||||
|
||||
line =
|
||||
socket.assigns.line ++
|
||||
[
|
||||
%{
|
||||
index: length(socket.assigns.line),
|
||||
san: move.san,
|
||||
fen_after: fen,
|
||||
grade: nil,
|
||||
best_line: true
|
||||
}
|
||||
]
|
||||
|
||||
socket =
|
||||
socket
|
||||
|> assign(:line, line)
|
||||
|> assign(:awaiting_best_line, false)
|
||||
|> assign(:pending_best_move, nil)
|
||||
|> set_review_index(length(line))
|
||||
|
||||
{:noreply, push_review_position(socket)}
|
||||
else
|
||||
{:noreply, socket}
|
||||
end
|
||||
end
|
||||
|
||||
def handle_event("back_to_game", _params, socket) do
|
||||
if socket.assigns.reviewing do
|
||||
socket =
|
||||
socket
|
||||
|> assign(:line, socket.assigns.plies)
|
||||
|> set_review_index(length(socket.assigns.plies))
|
||||
|
||||
{:noreply, push_review_position(socket)}
|
||||
else
|
||||
{:noreply, socket}
|
||||
end
|
||||
end
|
||||
|
||||
attr :ply, :map, required: true
|
||||
attr :reviewing, :boolean, required: true
|
||||
attr :review_index, :integer, required: true
|
||||
attr :result, :atom, required: true
|
||||
|
||||
defp ply(assigns) do
|
||||
~H"""
|
||||
<%= if @reviewing do %>
|
||||
<button
|
||||
type="button"
|
||||
phx-click="review_step"
|
||||
phx-value-index={@ply.index + 1}
|
||||
class={[
|
||||
"ml-2",
|
||||
ply_class(@ply),
|
||||
current_ply?(@ply, @review_index) && "underline"
|
||||
]}
|
||||
title={ply_title(@ply, @result)}
|
||||
data-grade={@ply.grade}
|
||||
>
|
||||
{@ply.san}
|
||||
</button>
|
||||
<% else %>
|
||||
<span
|
||||
class={["ml-2", ply_class(@ply)]}
|
||||
title={ply_title(@ply, @result)}
|
||||
data-grade={@ply.grade}
|
||||
>
|
||||
{@ply.san}
|
||||
</span>
|
||||
<% end %>
|
||||
"""
|
||||
end
|
||||
|
||||
defp move_rows(plies, color) do
|
||||
padded = if color in [:black, "black"], do: [nil | plies], else: plies
|
||||
|
||||
padded
|
||||
|> Enum.chunk_every(2, 2, [nil])
|
||||
|> Enum.with_index(1)
|
||||
end
|
||||
|
||||
defp positions(start_fen, plies), do: [start_fen | Enum.map(plies, & &1.fen_after)]
|
||||
|
||||
defp display_plies(true, line, _plies), do: line
|
||||
defp display_plies(false, _line, plies), do: plies
|
||||
|
||||
defp push_review_position(socket) do
|
||||
fen =
|
||||
socket.assigns.endgame.fen
|
||||
|> positions(socket.assigns.line)
|
||||
|> Enum.at(socket.assigns.review_index)
|
||||
|
||||
push_event(socket, "review_position", %{fen: fen})
|
||||
end
|
||||
|
||||
defp set_review_index(socket, index) do
|
||||
socket
|
||||
|> assign(:review_index, index)
|
||||
|> update_review_tablebase()
|
||||
end
|
||||
|
||||
defp update_review_tablebase(socket) do
|
||||
fen =
|
||||
socket.assigns.endgame.fen
|
||||
|> positions(socket.assigns.line)
|
||||
|> Enum.at(socket.assigns.review_index)
|
||||
|
||||
case snapshot_or_fetch(socket, fen) do
|
||||
{:ok, tablebase, socket} ->
|
||||
assign(socket, review_tablebase: tablebase, review_blocked: nil)
|
||||
|
||||
{:unavailable, reason, socket} ->
|
||||
assign(socket, review_tablebase: nil, review_blocked: reason)
|
||||
end
|
||||
end
|
||||
|
||||
defp snapshot_or_fetch(socket, fen) do
|
||||
case Map.fetch(socket.assigns.snapshots, fen) do
|
||||
{:ok, tablebase} ->
|
||||
{:ok, tablebase, socket}
|
||||
|
||||
:error ->
|
||||
case Tablebase.new(fen) do
|
||||
{:ok, tablebase} -> {:ok, tablebase, snapshot(socket, fen, tablebase)}
|
||||
other -> {:unavailable, blocked_reason(other), socket}
|
||||
end
|
||||
end
|
||||
end
|
||||
|
||||
defp snapshot(socket, fen, tablebase) do
|
||||
assign(socket, :snapshots, Map.put(socket.assigns.snapshots, fen, tablebase))
|
||||
end
|
||||
|
||||
defp step_review(socket, delta) do
|
||||
if socket.assigns.reviewing do
|
||||
last = length(socket.assigns.line)
|
||||
index = (socket.assigns.review_index + delta) |> max(0) |> min(last)
|
||||
|
||||
{:noreply, socket |> set_review_index(index) |> push_review_position()}
|
||||
else
|
||||
{:noreply, socket}
|
||||
end
|
||||
end
|
||||
|
||||
defp parse_index(index) when is_integer(index), do: index
|
||||
defp parse_index(index) when is_binary(index), do: String.to_integer(index)
|
||||
|
||||
defp current_ply?(%{index: index}, review_index), do: index + 1 == review_index
|
||||
|
||||
defp played_ply_at(line, review_index) do
|
||||
case Enum.at(line, review_index) do
|
||||
%{best_line: true} -> nil
|
||||
ply -> ply
|
||||
end
|
||||
end
|
||||
|
||||
defp ply_class(%{best_line: true}), do: "text-info italic"
|
||||
defp ply_class(ply), do: grade_class(ply.grade)
|
||||
|
||||
defp ply_title(%{best_line: true}, _result), do: "Best line"
|
||||
defp ply_title(ply, result), do: grade_label(ply.grade, result)
|
||||
|
||||
defp grade_class(:optimal), do: "text-success-text"
|
||||
defp grade_class(:winning), do: "text-warning"
|
||||
defp grade_class(:losing), do: "text-error"
|
||||
defp grade_class(_), do: "text-body"
|
||||
|
||||
defp grade_label(nil, _result), do: nil
|
||||
defp grade_label(:optimal, _result), do: "Optimal move"
|
||||
defp grade_label(:winning, :draw), do: "Keeps the draw — but not the sharpest"
|
||||
defp grade_label(:winning, _result), do: "Winning — but not the sharpest"
|
||||
defp grade_label(:losing, :draw), do: "Loses the draw"
|
||||
defp grade_label(:losing, _result), do: "Throws away the win"
|
||||
defp grade_label(:unknown, _result), do: "Not graded"
|
||||
|
||||
defp load_attempt(socket) do
|
||||
fen = socket.assigns.endgame.fen
|
||||
|
||||
socket =
|
||||
socket
|
||||
|> assign(:fen, fen)
|
||||
|> assign(:awaiting_reply, false)
|
||||
|> assign(:best_move, nil)
|
||||
|
||||
if connected?(socket) do
|
||||
case Tablebase.new(fen) do
|
||||
{:ok, tablebase} ->
|
||||
{:ok, endgame} = Endgames.record_attempt(socket.assigns.endgame)
|
||||
|
||||
socket
|
||||
|> assign(:endgame, endgame)
|
||||
|> assign(:tablebase, tablebase)
|
||||
|> snapshot(fen, tablebase)
|
||||
|> assign(:status, :playing)
|
||||
|> assign(:blocked_reason, nil)
|
||||
|> push_init_board(fen)
|
||||
|
||||
other ->
|
||||
socket
|
||||
|> assign(:tablebase, nil)
|
||||
|> assign(:status, :blocked)
|
||||
|> assign(:blocked_reason, blocked_reason(other))
|
||||
|> push_init_board(fen)
|
||||
end
|
||||
else
|
||||
assign(socket, :status, :loading)
|
||||
end
|
||||
end
|
||||
|
||||
defp push_init_board(socket, fen) do
|
||||
push_event(socket, "init_board", %{
|
||||
fen: fen,
|
||||
orientation: Atom.to_string(socket.assigns.endgame.color),
|
||||
player_color: Atom.to_string(socket.assigns.endgame.color),
|
||||
blocked: socket.assigns.status == :blocked
|
||||
})
|
||||
end
|
||||
|
||||
defp blocked_reason({:cooldown, remaining_ms}) do
|
||||
seconds = max(div(remaining_ms + 999, 1000), 1)
|
||||
"The tablebase is rate-limited. Try again in about #{seconds}s."
|
||||
end
|
||||
|
||||
defp blocked_reason({:error, {:too_many_requests, _, _}}) do
|
||||
"The tablebase is rate-limited. Try again in a minute."
|
||||
end
|
||||
|
||||
defp blocked_reason({:error, {:client_error, 404, _}}) do
|
||||
"This position is not covered by the tablebase."
|
||||
end
|
||||
|
||||
defp blocked_reason({:error, :not_covered}) do
|
||||
"This position is not covered by the tablebase."
|
||||
end
|
||||
|
||||
defp blocked_reason({:error, reason}) do
|
||||
"The tablebase is unavailable (#{inspect(reason)})."
|
||||
end
|
||||
|
||||
defp grade_and_record(socket, from, to, promotion, san, fen_after, draw) do
|
||||
case find_move(socket.assigns.tablebase, from, to, promotion) do
|
||||
nil ->
|
||||
{:noreply, put_flash(socket, :error, "Could not identify that move in the tablebase.")}
|
||||
|
||||
move ->
|
||||
grade = grade_move(socket.assigns.tablebase, move)
|
||||
|
||||
ply = %{
|
||||
index: length(socket.assigns.plies),
|
||||
san: san,
|
||||
fen_after: fen_after,
|
||||
grade: grade
|
||||
}
|
||||
|
||||
socket =
|
||||
socket
|
||||
|> assign(:last_from_to, "#{from} ➔ #{to}")
|
||||
|> assign(:last_san, san)
|
||||
|> assign(:last_grade, grade)
|
||||
|> assign(:plies, socket.assigns.plies ++ [ply])
|
||||
|
||||
cond do
|
||||
grade == :losing ->
|
||||
fail_attempt(socket)
|
||||
|
||||
grade not in [:optimal, :winning] ->
|
||||
{:noreply, socket}
|
||||
|
||||
draw and socket.assigns.endgame.result == :draw ->
|
||||
# A drawn-by-rule position is the goal of a draw puzzle.
|
||||
solve_attempt(socket)
|
||||
|
||||
socket.assigns.endgame.result == :win and not is_nil(promotion) ->
|
||||
# Conversion cutoff: a promotion that keeps the win ends a win puzzle.
|
||||
solve_attempt(socket)
|
||||
|
||||
not same_position?(fen_after, socket.assigns.fen) ->
|
||||
start_opponent_reply(socket, fen_after)
|
||||
|
||||
true ->
|
||||
{:noreply, socket}
|
||||
end
|
||||
end
|
||||
end
|
||||
|
||||
defp start_opponent_reply(socket, fen_after) do
|
||||
case Tablebase.new(fen_after) do
|
||||
{:ok, tablebase} ->
|
||||
socket = snapshot(socket, fen_after, tablebase)
|
||||
reply_to(socket, tablebase)
|
||||
|
||||
other ->
|
||||
{:noreply,
|
||||
socket
|
||||
|> assign(:status, :blocked)
|
||||
|> assign(:blocked_reason, blocked_reason(other))}
|
||||
end
|
||||
end
|
||||
|
||||
defp reply_to(socket, %Tablebase{checkmate: true}), do: solve_attempt(socket)
|
||||
|
||||
defp reply_to(socket, %Tablebase{moves: [reply | _]}) do
|
||||
{:noreply,
|
||||
socket
|
||||
|> assign(:awaiting_reply, true)
|
||||
|> assign(:pending_reply, %{san: reply.san, uci: reply.uci})
|
||||
|> push_event("opponent_move", reply_payload(reply))}
|
||||
end
|
||||
|
||||
defp reply_to(socket, %Tablebase{}) do
|
||||
# Terminal non-mate position (stalemate/insufficient): no reply to play.
|
||||
{:noreply, socket}
|
||||
end
|
||||
|
||||
defp solve_attempt(socket) do
|
||||
{:ok, endgame} = Endgames.record_solve(socket.assigns.endgame)
|
||||
|
||||
socket =
|
||||
socket
|
||||
|> assign(:endgame, endgame)
|
||||
|> record_attempt(:solved)
|
||||
|
||||
{:noreply,
|
||||
socket
|
||||
|> assign(:status, :solved)
|
||||
|> assign(:awaiting_reply, false)
|
||||
|> assign(:best_move, nil)}
|
||||
end
|
||||
|
||||
defp fail_attempt(socket) do
|
||||
socket = record_attempt(socket, :failed)
|
||||
|
||||
{:noreply,
|
||||
socket
|
||||
|> assign(:status, :failed)
|
||||
|> assign(:awaiting_reply, false)
|
||||
|> assign(:best_move, best_move_text(socket.assigns.tablebase))}
|
||||
end
|
||||
|
||||
defp record_attempt(socket, outcome) do
|
||||
case Attempts.record_attempt(socket.assigns.current_scope, socket.assigns.endgame, outcome) do
|
||||
{:ok, attempt} ->
|
||||
case Ratings.rate_attempt(attempt) do
|
||||
{:ok, %{user: user, endgame: endgame}} ->
|
||||
socket
|
||||
|> assign(:endgame, endgame)
|
||||
|> assign(:user_rating, user.rating)
|
||||
|
||||
{:skipped, _attempt} ->
|
||||
put_flash(
|
||||
socket,
|
||||
:info,
|
||||
"Replay recorded. Your rating is unchanged because you played this recently."
|
||||
)
|
||||
end
|
||||
|
||||
_ ->
|
||||
socket
|
||||
end
|
||||
end
|
||||
|
||||
defp user_rating(%{user: %{rating: rating}}), do: rating
|
||||
defp user_rating(_), do: nil
|
||||
|
||||
defp best_move_text(tablebase) do
|
||||
san =
|
||||
tablebase
|
||||
|> best_moves()
|
||||
|> Enum.map(& &1.san)
|
||||
|> Enum.reject(&is_nil/1)
|
||||
|> Enum.take(3)
|
||||
|> Enum.join(", ")
|
||||
|
||||
if san == "", do: nil, else: san
|
||||
end
|
||||
|
||||
defp pick_best_move(tablebase), do: tablebase |> best_moves() |> List.first()
|
||||
|
||||
defp best_moves(%Tablebase{moves: moves} = tablebase) when is_list(moves) do
|
||||
case {outcome_rank(tablebase.category), moves} do
|
||||
{nil, _} ->
|
||||
[]
|
||||
|
||||
{_best_rank, []} ->
|
||||
[]
|
||||
|
||||
{best_rank, [best | _]} ->
|
||||
Enum.filter(moves, fn move ->
|
||||
outcome_rank(mover_outcome(move.category)) == best_rank and move.dtz == best.dtz
|
||||
end)
|
||||
end
|
||||
end
|
||||
|
||||
defp best_moves(_tablebase), do: []
|
||||
|
||||
defp record_opponent_ply(socket, fen, client_san) do
|
||||
san =
|
||||
case socket.assigns.pending_reply do
|
||||
%{san: san} when is_binary(san) -> san
|
||||
_ -> client_san || "…"
|
||||
end
|
||||
|
||||
ply = %{
|
||||
index: length(socket.assigns.plies),
|
||||
san: san,
|
||||
fen_after: fen,
|
||||
grade: nil
|
||||
}
|
||||
|
||||
socket
|
||||
|> assign(:plies, socket.assigns.plies ++ [ply])
|
||||
|> assign(:pending_reply, nil)
|
||||
end
|
||||
|
||||
defp reply_payload(%Tablebase.Move{uci: uci, san: san}) do
|
||||
%{
|
||||
from: String.slice(uci, 0, 2),
|
||||
to: String.slice(uci, 2, 2),
|
||||
promotion: String.at(uci, 4),
|
||||
san: san
|
||||
}
|
||||
end
|
||||
|
||||
defp find_move(%Tablebase{moves: moves}, from, to, promotion) when is_list(moves) do
|
||||
uci = "#{from}#{to}#{promotion || ""}"
|
||||
Enum.find(moves, &(&1.uci == uci))
|
||||
end
|
||||
|
||||
defp find_move(_tablebase, _from, _to, _promotion), do: nil
|
||||
|
||||
# Compare only the board and side to move: chess.js may normalise the rest
|
||||
# (castling/en-passant/halfmove/fullmove) differently from the stored FEN.
|
||||
defp same_position?(fen_a, fen_b), do: position_key(fen_a) == position_key(fen_b)
|
||||
|
||||
defp position_key(fen) do
|
||||
case String.split(fen, " ") do
|
||||
[board, active | _] -> {board, active}
|
||||
_ -> fen
|
||||
end
|
||||
end
|
||||
|
||||
defp grade_move(%Tablebase{moves: []}, _move), do: :unknown
|
||||
|
||||
defp grade_move(%Tablebase{category: position_category, moves: [best | _]}, move) do
|
||||
best_rank = outcome_rank(position_category)
|
||||
move_rank = outcome_rank(mover_outcome(move.category))
|
||||
|
||||
cond do
|
||||
is_nil(best_rank) or is_nil(move_rank) -> :unknown
|
||||
move_rank < best_rank -> :losing
|
||||
move.dtz == best.dtz -> :optimal
|
||||
true -> :winning
|
||||
end
|
||||
end
|
||||
|
||||
# The mover's outcome is the flip of `category`, which is reported from the
|
||||
# perspective of the side to move *after* the move.
|
||||
defp mover_outcome(:loss), do: :win
|
||||
defp mover_outcome(:win), do: :loss
|
||||
defp mover_outcome(:draw), do: :draw
|
||||
defp mover_outcome(_), do: :unknown
|
||||
|
||||
defp outcome_rank(:win), do: 2
|
||||
defp outcome_rank(:draw), do: 1
|
||||
defp outcome_rank(:loss), do: 0
|
||||
defp outcome_rank(_), do: nil
|
||||
def handle_event("back_to_game", _params, socket), do: PlayCore.back_to_game(socket)
|
||||
end
|
||||
|
||||
@@ -0,0 +1,591 @@
|
||||
defmodule ChesstrainerWeb.EndgameLive.PlayCore do
|
||||
@moduledoc """
|
||||
Shared per-puzzle play logic.
|
||||
|
||||
Used by `ChesstrainerWeb.EndgameLive.Play` (standalone play, optional auth)
|
||||
and `ChesstrainerWeb.EndgameLive.Train` (a session of puzzles). Every public
|
||||
function takes and returns the LiveView socket, or a `{:noreply, socket}`
|
||||
tuple, so each LiveView keeps its own `handle_event/3` entry points and
|
||||
delegates here.
|
||||
|
||||
The board hook pushes events to whichever LiveView renders it, so this module
|
||||
never assumes a particular parent.
|
||||
"""
|
||||
|
||||
import Phoenix.Component, only: [assign: 2, assign: 3, assign_new: 3]
|
||||
import Phoenix.LiveView, only: [connected?: 1, push_event: 3, put_flash: 3]
|
||||
|
||||
alias Chesstrainer.Attempts
|
||||
alias Chesstrainer.Endgames
|
||||
alias Chesstrainer.Endgames.Tablebase
|
||||
alias Chesstrainer.Ratings
|
||||
|
||||
@doc """
|
||||
Loads `endgame` and starts an attempt on it.
|
||||
|
||||
`:page_title` overrides the default "Play endgame". The user's rating is only
|
||||
assigned when it is not already present, so a session keeps the rating it has
|
||||
already advanced.
|
||||
"""
|
||||
def init(socket, endgame, opts \\ []) do
|
||||
socket
|
||||
|> assign(:page_title, Keyword.get(opts, :page_title, "Play endgame"))
|
||||
|> assign(:endgame, endgame)
|
||||
|> assign_new(:user_rating, fn -> user_rating(socket.assigns.current_scope) end)
|
||||
|> assign(:fen, endgame.fen)
|
||||
|> assign(:tablebase, nil)
|
||||
|> assign(:status, :loading)
|
||||
|> assign(:blocked_reason, nil)
|
||||
|> assign(:best_move, nil)
|
||||
|> assign(:plies, [])
|
||||
|> assign(:reviewing, false)
|
||||
|> assign(:review_index, 0)
|
||||
|> assign(:pending_reply, nil)
|
||||
|> assign(:snapshots, %{})
|
||||
|> assign(:line, [])
|
||||
|> assign(:review_tablebase, nil)
|
||||
|> assign(:review_blocked, nil)
|
||||
|> assign(:awaiting_best_line, false)
|
||||
|> assign(:pending_best_move, nil)
|
||||
|> assign(:last_san, "None yet")
|
||||
|> assign(:last_from_to, "None yet")
|
||||
|> assign(:last_grade, nil)
|
||||
|> assign(:awaiting_reply, false)
|
||||
|> assign(:last_rating_delta, nil)
|
||||
|> load_attempt()
|
||||
end
|
||||
|
||||
def move_played(socket, params) do
|
||||
%{"from" => from, "to" => to, "san" => san} = params
|
||||
promotion = params["promotion"]
|
||||
draw = params["draw"] || false
|
||||
prev_fen = params["prev_fen"] || socket.assigns.fen
|
||||
fen_after = params["fen"] || socket.assigns.fen
|
||||
|
||||
cond do
|
||||
socket.assigns.status == :blocked ->
|
||||
{:noreply,
|
||||
put_flash(socket, :error, "The tablebase is unavailable, so this move cannot be graded.")}
|
||||
|
||||
socket.assigns.status != :playing ->
|
||||
{:noreply, socket}
|
||||
|
||||
not same_position?(prev_fen, socket.assigns.fen) ->
|
||||
{:noreply,
|
||||
put_flash(socket, :error, "That move is out of sequence. Press Reset to try again.")}
|
||||
|
||||
true ->
|
||||
grade_and_record(socket, from, to, promotion, san, fen_after, draw)
|
||||
end
|
||||
end
|
||||
|
||||
def opponent_reply_applied(socket, params) do
|
||||
%{"fen" => fen} = params
|
||||
draw = params["draw"] || false
|
||||
|
||||
if socket.assigns.awaiting_reply do
|
||||
socket = record_opponent_ply(socket, fen, params["san"])
|
||||
|
||||
if draw and socket.assigns.endgame.result == :draw do
|
||||
solve_attempt(socket)
|
||||
else
|
||||
case Tablebase.new(fen) do
|
||||
{:ok, tablebase} ->
|
||||
{:noreply,
|
||||
socket
|
||||
|> assign(:fen, fen)
|
||||
|> assign(:tablebase, tablebase)
|
||||
|> snapshot(fen, tablebase)
|
||||
|> assign(:awaiting_reply, false)
|
||||
|> assign(:status, :playing)
|
||||
|> assign(:blocked_reason, nil)
|
||||
|> push_event("resume_board", %{})}
|
||||
|
||||
other ->
|
||||
{:noreply,
|
||||
socket
|
||||
|> assign(:awaiting_reply, false)
|
||||
|> assign(:status, :blocked)
|
||||
|> assign(:blocked_reason, blocked_reason(other))}
|
||||
end
|
||||
end
|
||||
else
|
||||
{:noreply, socket}
|
||||
end
|
||||
end
|
||||
|
||||
def fen_invalid(socket, %{"fen" => fen, "message" => message}) do
|
||||
{:noreply,
|
||||
put_flash(
|
||||
socket,
|
||||
:error,
|
||||
"Endgame FEN is invalid and the board cannot be loaded: #{message} (#{fen})"
|
||||
)}
|
||||
end
|
||||
|
||||
def reset(socket) do
|
||||
socket =
|
||||
socket
|
||||
|> assign(:plies, [])
|
||||
|> assign(:reviewing, false)
|
||||
|> assign(:review_index, 0)
|
||||
|> assign(:pending_reply, nil)
|
||||
|> assign(:snapshots, %{})
|
||||
|> assign(:line, [])
|
||||
|> assign(:review_tablebase, nil)
|
||||
|> assign(:review_blocked, nil)
|
||||
|> assign(:awaiting_best_line, false)
|
||||
|> assign(:pending_best_move, nil)
|
||||
|> assign(:last_san, "None yet")
|
||||
|> assign(:last_from_to, "None yet")
|
||||
|> assign(:last_grade, nil)
|
||||
|> assign(:last_rating_delta, nil)
|
||||
|
||||
{:noreply, load_attempt(socket)}
|
||||
end
|
||||
|
||||
def review(socket) do
|
||||
if socket.assigns.status in [:solved, :failed] do
|
||||
socket =
|
||||
socket
|
||||
|> assign(:reviewing, true)
|
||||
|> assign(:line, socket.assigns.plies)
|
||||
|> set_review_index(length(socket.assigns.plies))
|
||||
|
||||
{:noreply, push_review_position(socket)}
|
||||
else
|
||||
{:noreply, socket}
|
||||
end
|
||||
end
|
||||
|
||||
def review_prev(socket), do: step_review(socket, -1)
|
||||
|
||||
def review_next(socket), do: step_review(socket, 1)
|
||||
|
||||
def review_step(socket, index) do
|
||||
if socket.assigns.reviewing do
|
||||
last = length(socket.assigns.line)
|
||||
index = parse_index(index) |> max(0) |> min(last)
|
||||
|
||||
{:noreply, push_review_position(set_review_index(socket, index))}
|
||||
else
|
||||
{:noreply, socket}
|
||||
end
|
||||
end
|
||||
|
||||
def play_best_line(socket) do
|
||||
with true <- socket.assigns.reviewing,
|
||||
%Tablebase{} = tablebase <- socket.assigns.review_tablebase,
|
||||
%Tablebase.Move{} = move <- pick_best_move(tablebase) do
|
||||
# Branch the review line at the current position, then play one best move.
|
||||
{:noreply,
|
||||
socket
|
||||
|> assign(:line, Enum.take(socket.assigns.line, socket.assigns.review_index))
|
||||
|> assign(:awaiting_best_line, true)
|
||||
|> assign(:pending_best_move, move)
|
||||
|> push_event("best_line_move", reply_payload(move))}
|
||||
else
|
||||
_ -> {:noreply, socket}
|
||||
end
|
||||
end
|
||||
|
||||
def best_line_move_applied(socket, %{"fen" => fen}) do
|
||||
if socket.assigns.awaiting_best_line do
|
||||
move = socket.assigns.pending_best_move
|
||||
|
||||
line =
|
||||
socket.assigns.line ++
|
||||
[
|
||||
%{
|
||||
index: length(socket.assigns.line),
|
||||
san: move.san,
|
||||
fen_after: fen,
|
||||
grade: nil,
|
||||
best_line: true
|
||||
}
|
||||
]
|
||||
|
||||
socket =
|
||||
socket
|
||||
|> assign(:line, line)
|
||||
|> assign(:awaiting_best_line, false)
|
||||
|> assign(:pending_best_move, nil)
|
||||
|> set_review_index(length(line))
|
||||
|
||||
{:noreply, push_review_position(socket)}
|
||||
else
|
||||
{:noreply, socket}
|
||||
end
|
||||
end
|
||||
|
||||
def back_to_game(socket) do
|
||||
if socket.assigns.reviewing do
|
||||
socket =
|
||||
socket
|
||||
|> assign(:line, socket.assigns.plies)
|
||||
|> set_review_index(length(socket.assigns.plies))
|
||||
|
||||
{:noreply, push_review_position(socket)}
|
||||
else
|
||||
{:noreply, socket}
|
||||
end
|
||||
end
|
||||
|
||||
@doc "The best available move as a display string, or nil."
|
||||
def best_move_text(tablebase) do
|
||||
san =
|
||||
tablebase
|
||||
|> best_moves()
|
||||
|> Enum.map(& &1.san)
|
||||
|> Enum.reject(&is_nil/1)
|
||||
|> Enum.take(3)
|
||||
|> Enum.join(", ")
|
||||
|
||||
if san == "", do: nil, else: san
|
||||
end
|
||||
|
||||
defp load_attempt(socket) do
|
||||
fen = socket.assigns.endgame.fen
|
||||
|
||||
socket =
|
||||
socket
|
||||
|> assign(:fen, fen)
|
||||
|> assign(:awaiting_reply, false)
|
||||
|> assign(:best_move, nil)
|
||||
|
||||
if connected?(socket) do
|
||||
case Tablebase.new(fen) do
|
||||
{:ok, tablebase} ->
|
||||
{:ok, endgame} = Endgames.record_attempt(socket.assigns.endgame)
|
||||
|
||||
socket
|
||||
|> assign(:endgame, endgame)
|
||||
|> assign(:tablebase, tablebase)
|
||||
|> snapshot(fen, tablebase)
|
||||
|> assign(:status, :playing)
|
||||
|> assign(:blocked_reason, nil)
|
||||
|> push_init_board(fen)
|
||||
|
||||
other ->
|
||||
socket
|
||||
|> assign(:tablebase, nil)
|
||||
|> assign(:status, :blocked)
|
||||
|> assign(:blocked_reason, blocked_reason(other))
|
||||
|> push_init_board(fen)
|
||||
end
|
||||
else
|
||||
assign(socket, :status, :loading)
|
||||
end
|
||||
end
|
||||
|
||||
defp push_init_board(socket, fen) do
|
||||
push_event(socket, "init_board", %{
|
||||
fen: fen,
|
||||
orientation: Atom.to_string(socket.assigns.endgame.color),
|
||||
player_color: Atom.to_string(socket.assigns.endgame.color),
|
||||
blocked: socket.assigns.status == :blocked
|
||||
})
|
||||
end
|
||||
|
||||
defp blocked_reason({:cooldown, remaining_ms}) do
|
||||
seconds = max(div(remaining_ms + 999, 1000), 1)
|
||||
"The tablebase is rate-limited. Try again in about #{seconds}s."
|
||||
end
|
||||
|
||||
defp blocked_reason({:error, {:too_many_requests, _, _}}) do
|
||||
"The tablebase is rate-limited. Try again in a minute."
|
||||
end
|
||||
|
||||
defp blocked_reason({:error, {:client_error, 404, _}}) do
|
||||
"This position is not covered by the tablebase."
|
||||
end
|
||||
|
||||
defp blocked_reason({:error, :not_covered}) do
|
||||
"This position is not covered by the tablebase."
|
||||
end
|
||||
|
||||
defp blocked_reason({:error, reason}) do
|
||||
"The tablebase is unavailable (#{inspect(reason)})."
|
||||
end
|
||||
|
||||
defp grade_and_record(socket, from, to, promotion, san, fen_after, draw) do
|
||||
case find_move(socket.assigns.tablebase, from, to, promotion) do
|
||||
nil ->
|
||||
{:noreply, put_flash(socket, :error, "Could not identify that move in the tablebase.")}
|
||||
|
||||
move ->
|
||||
grade = grade_move(socket.assigns.tablebase, move)
|
||||
|
||||
ply = %{
|
||||
index: length(socket.assigns.plies),
|
||||
san: san,
|
||||
fen_after: fen_after,
|
||||
grade: grade
|
||||
}
|
||||
|
||||
socket =
|
||||
socket
|
||||
|> assign(:last_from_to, "#{from} ➔ #{to}")
|
||||
|> assign(:last_san, san)
|
||||
|> assign(:last_grade, grade)
|
||||
|> assign(:plies, socket.assigns.plies ++ [ply])
|
||||
|
||||
cond do
|
||||
grade == :losing ->
|
||||
fail_attempt(socket)
|
||||
|
||||
grade not in [:optimal, :winning] ->
|
||||
{:noreply, socket}
|
||||
|
||||
draw and socket.assigns.endgame.result == :draw ->
|
||||
# A drawn-by-rule position is the goal of a draw puzzle.
|
||||
solve_attempt(socket)
|
||||
|
||||
socket.assigns.endgame.result == :win and not is_nil(promotion) ->
|
||||
# Conversion cutoff: a promotion that keeps the win ends a win puzzle.
|
||||
solve_attempt(socket)
|
||||
|
||||
not same_position?(fen_after, socket.assigns.fen) ->
|
||||
start_opponent_reply(socket, fen_after)
|
||||
|
||||
true ->
|
||||
{:noreply, socket}
|
||||
end
|
||||
end
|
||||
end
|
||||
|
||||
defp start_opponent_reply(socket, fen_after) do
|
||||
case Tablebase.new(fen_after) do
|
||||
{:ok, tablebase} ->
|
||||
socket = snapshot(socket, fen_after, tablebase)
|
||||
reply_to(socket, tablebase)
|
||||
|
||||
other ->
|
||||
{:noreply,
|
||||
socket
|
||||
|> assign(:status, :blocked)
|
||||
|> assign(:blocked_reason, blocked_reason(other))}
|
||||
end
|
||||
end
|
||||
|
||||
defp reply_to(socket, %Tablebase{checkmate: true}), do: solve_attempt(socket)
|
||||
|
||||
defp reply_to(socket, %Tablebase{moves: [reply | _]}) do
|
||||
{:noreply,
|
||||
socket
|
||||
|> assign(:awaiting_reply, true)
|
||||
|> assign(:pending_reply, %{san: reply.san, uci: reply.uci})
|
||||
|> push_event("opponent_move", reply_payload(reply))}
|
||||
end
|
||||
|
||||
defp reply_to(socket, %Tablebase{}) do
|
||||
# Terminal non-mate position (stalemate/insufficient): no reply to play.
|
||||
{:noreply, socket}
|
||||
end
|
||||
|
||||
defp solve_attempt(socket) do
|
||||
{:ok, endgame} = Endgames.record_solve(socket.assigns.endgame)
|
||||
|
||||
socket =
|
||||
socket
|
||||
|> assign(:endgame, endgame)
|
||||
|> record_attempt(:solved)
|
||||
|
||||
{:noreply,
|
||||
socket
|
||||
|> assign(:status, :solved)
|
||||
|> assign(:awaiting_reply, false)
|
||||
|> assign(:best_move, nil)}
|
||||
end
|
||||
|
||||
defp fail_attempt(socket) do
|
||||
socket = record_attempt(socket, :failed)
|
||||
|
||||
{:noreply,
|
||||
socket
|
||||
|> assign(:status, :failed)
|
||||
|> assign(:awaiting_reply, false)
|
||||
|> assign(:best_move, best_move_text(socket.assigns.tablebase))}
|
||||
end
|
||||
|
||||
defp record_attempt(socket, outcome) do
|
||||
case Attempts.record_attempt(socket.assigns.current_scope, socket.assigns.endgame, outcome) do
|
||||
{:ok, attempt} ->
|
||||
case Ratings.rate_attempt(attempt) do
|
||||
{:ok, %{user: user, endgame: endgame, user_delta: delta}} ->
|
||||
socket
|
||||
|> assign(:endgame, endgame)
|
||||
|> assign(:user_rating, user.rating)
|
||||
|> assign(:last_rating_delta, delta)
|
||||
|
||||
{:skipped, _attempt} ->
|
||||
socket
|
||||
|> assign(:last_rating_delta, nil)
|
||||
|> put_flash(
|
||||
:info,
|
||||
"Replay recorded. Your rating is unchanged because you played this recently."
|
||||
)
|
||||
end
|
||||
|
||||
_ ->
|
||||
assign(socket, :last_rating_delta, nil)
|
||||
end
|
||||
end
|
||||
|
||||
defp user_rating(%{user: %{rating: rating}}), do: rating
|
||||
defp user_rating(_), do: nil
|
||||
|
||||
defp pick_best_move(tablebase), do: tablebase |> best_moves() |> List.first()
|
||||
|
||||
defp best_moves(%Tablebase{moves: moves} = tablebase) when is_list(moves) do
|
||||
case {outcome_rank(tablebase.category), moves} do
|
||||
{nil, _} ->
|
||||
[]
|
||||
|
||||
{_best_rank, []} ->
|
||||
[]
|
||||
|
||||
{best_rank, [best | _]} ->
|
||||
Enum.filter(moves, fn move ->
|
||||
outcome_rank(mover_outcome(move.category)) == best_rank and move.dtz == best.dtz
|
||||
end)
|
||||
end
|
||||
end
|
||||
|
||||
defp best_moves(_tablebase), do: []
|
||||
|
||||
defp record_opponent_ply(socket, fen, client_san) do
|
||||
san =
|
||||
case socket.assigns.pending_reply do
|
||||
%{san: san} when is_binary(san) -> san
|
||||
_ -> client_san || "…"
|
||||
end
|
||||
|
||||
ply = %{
|
||||
index: length(socket.assigns.plies),
|
||||
san: san,
|
||||
fen_after: fen,
|
||||
grade: nil
|
||||
}
|
||||
|
||||
socket
|
||||
|> assign(:plies, socket.assigns.plies ++ [ply])
|
||||
|> assign(:pending_reply, nil)
|
||||
end
|
||||
|
||||
defp reply_payload(%Tablebase.Move{uci: uci, san: san}) do
|
||||
%{
|
||||
from: String.slice(uci, 0, 2),
|
||||
to: String.slice(uci, 2, 2),
|
||||
promotion: String.at(uci, 4),
|
||||
san: san
|
||||
}
|
||||
end
|
||||
|
||||
defp find_move(%Tablebase{moves: moves}, from, to, promotion) when is_list(moves) do
|
||||
uci = "#{from}#{to}#{promotion || ""}"
|
||||
Enum.find(moves, &(&1.uci == uci))
|
||||
end
|
||||
|
||||
defp find_move(_tablebase, _from, _to, _promotion), do: nil
|
||||
|
||||
# Compare only the board and side to move: chess.js may normalise the rest
|
||||
# (castling/en-passant/halfmove/fullmove) differently from the stored FEN.
|
||||
defp same_position?(fen_a, fen_b), do: position_key(fen_a) == position_key(fen_b)
|
||||
|
||||
defp position_key(fen) do
|
||||
case String.split(fen, " ") do
|
||||
[board, active | _] -> {board, active}
|
||||
_ -> fen
|
||||
end
|
||||
end
|
||||
|
||||
defp grade_move(%Tablebase{moves: []}, _move), do: :unknown
|
||||
|
||||
defp grade_move(%Tablebase{category: position_category, moves: [best | _]}, move) do
|
||||
best_rank = outcome_rank(position_category)
|
||||
move_rank = outcome_rank(mover_outcome(move.category))
|
||||
|
||||
cond do
|
||||
is_nil(best_rank) or is_nil(move_rank) -> :unknown
|
||||
move_rank < best_rank -> :losing
|
||||
move.dtz == best.dtz -> :optimal
|
||||
true -> :winning
|
||||
end
|
||||
end
|
||||
|
||||
# The mover's outcome is the flip of `category`, which is reported from the
|
||||
# perspective of the side to move *after* the move.
|
||||
defp mover_outcome(:loss), do: :win
|
||||
defp mover_outcome(:win), do: :loss
|
||||
defp mover_outcome(:draw), do: :draw
|
||||
defp mover_outcome(_), do: :unknown
|
||||
|
||||
defp outcome_rank(:win), do: 2
|
||||
defp outcome_rank(:draw), do: 1
|
||||
defp outcome_rank(:loss), do: 0
|
||||
defp outcome_rank(_), do: nil
|
||||
|
||||
defp positions(start_fen, plies), do: [start_fen | Enum.map(plies, & &1.fen_after)]
|
||||
|
||||
defp push_review_position(socket) do
|
||||
fen =
|
||||
socket.assigns.endgame.fen
|
||||
|> positions(socket.assigns.line)
|
||||
|> Enum.at(socket.assigns.review_index)
|
||||
|
||||
push_event(socket, "review_position", %{fen: fen})
|
||||
end
|
||||
|
||||
defp set_review_index(socket, index) do
|
||||
socket
|
||||
|> assign(:review_index, index)
|
||||
|> update_review_tablebase()
|
||||
end
|
||||
|
||||
defp update_review_tablebase(socket) do
|
||||
fen =
|
||||
socket.assigns.endgame.fen
|
||||
|> positions(socket.assigns.line)
|
||||
|> Enum.at(socket.assigns.review_index)
|
||||
|
||||
case snapshot_or_fetch(socket, fen) do
|
||||
{:ok, tablebase, socket} ->
|
||||
assign(socket, review_tablebase: tablebase, review_blocked: nil)
|
||||
|
||||
{:unavailable, reason, socket} ->
|
||||
assign(socket, review_tablebase: nil, review_blocked: reason)
|
||||
end
|
||||
end
|
||||
|
||||
defp snapshot_or_fetch(socket, fen) do
|
||||
case Map.fetch(socket.assigns.snapshots, fen) do
|
||||
{:ok, tablebase} ->
|
||||
{:ok, tablebase, socket}
|
||||
|
||||
:error ->
|
||||
case Tablebase.new(fen) do
|
||||
{:ok, tablebase} -> {:ok, tablebase, snapshot(socket, fen, tablebase)}
|
||||
other -> {:unavailable, blocked_reason(other), socket}
|
||||
end
|
||||
end
|
||||
end
|
||||
|
||||
defp snapshot(socket, fen, tablebase) do
|
||||
assign(socket, :snapshots, Map.put(socket.assigns.snapshots, fen, tablebase))
|
||||
end
|
||||
|
||||
defp step_review(socket, delta) do
|
||||
if socket.assigns.reviewing do
|
||||
last = length(socket.assigns.line)
|
||||
index = (socket.assigns.review_index + delta) |> max(0) |> min(last)
|
||||
|
||||
{:noreply, socket |> set_review_index(index) |> push_review_position()}
|
||||
else
|
||||
{:noreply, socket}
|
||||
end
|
||||
end
|
||||
|
||||
defp parse_index(index) when is_integer(index), do: index
|
||||
defp parse_index(index) when is_binary(index), do: String.to_integer(index)
|
||||
end
|
||||
@@ -0,0 +1,300 @@
|
||||
defmodule ChesstrainerWeb.EndgameLive.Train do
|
||||
@moduledoc """
|
||||
A training session: choose a difficulty, then play a run of puzzles in place.
|
||||
|
||||
The session (difficulty, start time, rating baseline, completed count and
|
||||
timing) lives only in this LiveView. Each puzzle's move grading, opponent
|
||||
reply and review come from `ChesstrainerWeb.EndgameLive.PlayCore`.
|
||||
"""
|
||||
|
||||
use ChesstrainerWeb, :live_view
|
||||
|
||||
alias Chesstrainer.Puzzles
|
||||
alias ChesstrainerWeb.EndgameLive.PlayCore
|
||||
alias ChesstrainerWeb.PlayComponents
|
||||
|
||||
@impl true
|
||||
def render(assigns) do
|
||||
~H"""
|
||||
<Layouts.app flash={@flash}>
|
||||
<.header>
|
||||
Train
|
||||
<:subtitle>
|
||||
<%= if @session do %>
|
||||
{difficulty_label(@session.difficulty)} · Play a run of endgame puzzles.
|
||||
<% else %>
|
||||
Choose a difficulty to start a session.
|
||||
<% end %>
|
||||
</:subtitle>
|
||||
<:actions>
|
||||
<.button :if={@session} phx-click="stop_session">
|
||||
<.icon name="hero-x-mark" /> Stop session
|
||||
</.button>
|
||||
<.button navigate={~p"/endgames"}>
|
||||
<.icon name="hero-arrow-left" /> Endgames
|
||||
</.button>
|
||||
</:actions>
|
||||
</.header>
|
||||
|
||||
<%= if @session do %>
|
||||
<div
|
||||
id="session-bar"
|
||||
class="mb-4 flex flex-wrap items-center gap-x-6 gap-y-2 rounded-lg bg-canvas-raised p-3 text-sm"
|
||||
>
|
||||
<span>
|
||||
<span class="text-muted">Difficulty</span>
|
||||
<span class="font-semibold">{difficulty_label(@session.difficulty)}</span>
|
||||
</span>
|
||||
<span>
|
||||
<span class="text-muted">Time</span>
|
||||
<span
|
||||
id={"session-clock-#{@session.started_at_ms}"}
|
||||
phx-hook="SessionClock"
|
||||
data-started-at={@session.started_at_ms}
|
||||
class="font-mono"
|
||||
>
|
||||
{format_duration(elapsed_ms(@session))}
|
||||
</span>
|
||||
</span>
|
||||
<span>
|
||||
<span class="text-muted">Avg/puzzle</span>
|
||||
<span class="font-mono">{format_duration(avg_ms(@session))}</span>
|
||||
</span>
|
||||
<span>
|
||||
<span class="text-muted">Rating</span>
|
||||
<span class={["font-mono", gain_class(net_gain(@session, @user_rating))]}>
|
||||
{format_delta(net_gain(@session, @user_rating))}
|
||||
</span>
|
||||
</span>
|
||||
<span :if={@last_rating_delta}>
|
||||
<span class="text-muted">Last</span>
|
||||
<span class={["font-mono", gain_class(@last_rating_delta)]}>
|
||||
{format_delta(@last_rating_delta)}
|
||||
</span>
|
||||
</span>
|
||||
</div>
|
||||
|
||||
<PlayComponents.play_surface
|
||||
session={true}
|
||||
endgame={@endgame}
|
||||
status={@status}
|
||||
blocked_reason={@blocked_reason}
|
||||
best_move={@best_move}
|
||||
plies={@plies}
|
||||
line={@line}
|
||||
reviewing={@reviewing}
|
||||
review_index={@review_index}
|
||||
review_tablebase={@review_tablebase}
|
||||
review_blocked={@review_blocked}
|
||||
awaiting_reply={@awaiting_reply}
|
||||
last_grade={@last_grade}
|
||||
awaiting_best_line={@awaiting_best_line}
|
||||
/>
|
||||
<% else %>
|
||||
<div class="fixed inset-0 z-50 flex items-center justify-center bg-black/50 p-4">
|
||||
<div id="difficulty-picker" class="w-full max-w-md rounded-xl bg-base-100 p-6 shadow-xl">
|
||||
<h2 class="text-lg font-semibold">Choose a difficulty</h2>
|
||||
<p class="mt-1 text-sm text-muted">
|
||||
Your rating: {round(@user_rating)} · bands of ±{Puzzles.band_width()}
|
||||
</p>
|
||||
<div class="mt-4 grid gap-2">
|
||||
<%= for {difficulty, label, description} <- difficulty_options(@user_rating) do %>
|
||||
<.button
|
||||
id={"difficulty-#{difficulty}"}
|
||||
phx-click="start_session"
|
||||
phx-value-difficulty={Atom.to_string(difficulty)}
|
||||
variant={if difficulty == :medium, do: "primary", else: "secondary"}
|
||||
class="w-full justify-between"
|
||||
>
|
||||
<span>{label}</span>
|
||||
<span class="text-xs font-normal opacity-80">{description}</span>
|
||||
</.button>
|
||||
<% end %>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<% end %>
|
||||
</Layouts.app>
|
||||
"""
|
||||
end
|
||||
|
||||
@impl true
|
||||
def mount(_params, _session, socket) do
|
||||
{:ok,
|
||||
socket
|
||||
|> assign(:page_title, "Train")
|
||||
|> assign(:session, nil)
|
||||
|> assign(:puzzle_started_mono, nil)
|
||||
|> assign(:puzzle_counted, false)
|
||||
|> assign(:user_rating, socket.assigns.current_scope.user.rating)}
|
||||
end
|
||||
|
||||
@impl true
|
||||
def handle_event("start_session", %{"difficulty" => difficulty}, socket) do
|
||||
difficulty = parse_difficulty(difficulty)
|
||||
|
||||
case Puzzles.next_endgame(selection_user(socket), difficulty) do
|
||||
nil ->
|
||||
{:noreply, put_flash(socket, :error, "No puzzles are available right now.")}
|
||||
|
||||
endgame ->
|
||||
session = %{
|
||||
difficulty: difficulty,
|
||||
started_at_ms: System.system_time(:millisecond),
|
||||
baseline: socket.assigns.user_rating,
|
||||
count: 0,
|
||||
sum_ms: 0
|
||||
}
|
||||
|
||||
socket =
|
||||
socket
|
||||
|> assign(:session, session)
|
||||
|> assign(:puzzle_started_mono, System.monotonic_time(:millisecond))
|
||||
|> assign(:puzzle_counted, false)
|
||||
|> assign(:last_rating_delta, nil)
|
||||
|> PlayCore.init(endgame, page_title: "Train")
|
||||
|
||||
{:noreply, socket}
|
||||
end
|
||||
end
|
||||
|
||||
def handle_event("next_puzzle", _params, socket) do
|
||||
session = socket.assigns.session
|
||||
|
||||
if session do
|
||||
case Puzzles.next_endgame(selection_user(socket), session.difficulty,
|
||||
exclude_ids: [socket.assigns.endgame.id]
|
||||
) do
|
||||
nil ->
|
||||
{:noreply, put_flash(socket, :info, "No more puzzles at this difficulty.")}
|
||||
|
||||
endgame ->
|
||||
socket =
|
||||
socket
|
||||
|> assign(:puzzle_started_mono, System.monotonic_time(:millisecond))
|
||||
|> assign(:puzzle_counted, false)
|
||||
|> assign(:last_rating_delta, nil)
|
||||
|> PlayCore.init(endgame, page_title: "Train")
|
||||
|
||||
{:noreply, socket}
|
||||
end
|
||||
else
|
||||
{:noreply, socket}
|
||||
end
|
||||
end
|
||||
|
||||
def handle_event("stop_session", _params, socket) do
|
||||
{:noreply, assign(socket, :session, nil)}
|
||||
end
|
||||
|
||||
def handle_event("endgame_move_played", params, socket) do
|
||||
{:noreply, socket} = PlayCore.move_played(socket, params)
|
||||
{:noreply, account_completion(socket)}
|
||||
end
|
||||
|
||||
def handle_event("opponent_reply_applied", params, socket) do
|
||||
{:noreply, socket} = PlayCore.opponent_reply_applied(socket, params)
|
||||
{:noreply, account_completion(socket)}
|
||||
end
|
||||
|
||||
def handle_event("chess_fen_invalid", params, socket),
|
||||
do: PlayCore.fen_invalid(socket, params)
|
||||
|
||||
def handle_event("reset", _params, socket), do: PlayCore.reset(socket)
|
||||
|
||||
def handle_event("review", _params, socket), do: PlayCore.review(socket)
|
||||
|
||||
def handle_event("review_prev", _params, socket), do: PlayCore.review_prev(socket)
|
||||
|
||||
def handle_event("review_next", _params, socket), do: PlayCore.review_next(socket)
|
||||
|
||||
def handle_event("review_step", %{"index" => index}, socket),
|
||||
do: PlayCore.review_step(socket, index)
|
||||
|
||||
def handle_event("play_best_line", _params, socket), do: PlayCore.play_best_line(socket)
|
||||
|
||||
def handle_event("best_line_move_applied", params, socket),
|
||||
do: PlayCore.best_line_move_applied(socket, params)
|
||||
|
||||
def handle_event("back_to_game", _params, socket), do: PlayCore.back_to_game(socket)
|
||||
|
||||
# A completed puzzle contributes one first-attempt time to the average. A
|
||||
# retry happens after this point and is deliberately ignored.
|
||||
defp account_completion(socket) do
|
||||
session = socket.assigns.session
|
||||
status = socket.assigns.status
|
||||
started = socket.assigns.puzzle_started_mono
|
||||
|
||||
if session && not socket.assigns.puzzle_counted && is_integer(started) &&
|
||||
status in [:solved, :failed] do
|
||||
duration = max(System.monotonic_time(:millisecond) - started, 0)
|
||||
count = session.count + 1
|
||||
sum_ms = session.sum_ms + duration
|
||||
|
||||
socket
|
||||
|> assign(:session, %{session | count: count, sum_ms: sum_ms})
|
||||
|> assign(:puzzle_counted, true)
|
||||
else
|
||||
socket
|
||||
end
|
||||
end
|
||||
|
||||
# Selection uses the rating this session has reached, not the stale rating the
|
||||
# scope carried in at mount.
|
||||
defp selection_user(socket) do
|
||||
user = socket.assigns.current_scope.user
|
||||
%{user | rating: socket.assigns.user_rating || user.rating}
|
||||
end
|
||||
|
||||
defp parse_difficulty(value) when value in ~w(easy medium hard),
|
||||
do: String.to_existing_atom(value)
|
||||
|
||||
defp parse_difficulty(_value), do: :medium
|
||||
|
||||
defp difficulty_options(rating) do
|
||||
width = Puzzles.band_width()
|
||||
|
||||
[
|
||||
{:easy, "Easy", "below #{round(rating - width)}"},
|
||||
{:medium, "Medium", "#{round(rating - width)}–#{round(rating + width)}"},
|
||||
{:hard, "Hard", "above #{round(rating + width)}"}
|
||||
]
|
||||
end
|
||||
|
||||
defp difficulty_label(:easy), do: "Easy"
|
||||
defp difficulty_label(:medium), do: "Medium"
|
||||
defp difficulty_label(:hard), do: "Hard"
|
||||
|
||||
defp net_gain(%{baseline: baseline}, rating) when is_number(rating), do: rating - baseline
|
||||
defp net_gain(_session, _rating), do: nil
|
||||
|
||||
defp avg_ms(%{count: 0}), do: nil
|
||||
defp avg_ms(%{count: count, sum_ms: sum}), do: div(sum, count)
|
||||
|
||||
defp elapsed_ms(%{started_at_ms: started_at}),
|
||||
do: max(System.system_time(:millisecond) - started_at, 0)
|
||||
|
||||
defp format_duration(nil), do: "—"
|
||||
|
||||
defp format_duration(ms) when is_integer(ms) do
|
||||
total = div(max(ms, 0), 1000)
|
||||
minutes = String.pad_leading(Integer.to_string(div(total, 60)), 2, "0")
|
||||
seconds = String.pad_leading(Integer.to_string(rem(total, 60)), 2, "0")
|
||||
"#{minutes}:#{seconds}"
|
||||
end
|
||||
|
||||
defp format_delta(nil), do: "—"
|
||||
|
||||
defp format_delta(delta) when is_number(delta) do
|
||||
rounded = round(delta)
|
||||
|
||||
cond do
|
||||
rounded > 0 -> "+#{rounded}"
|
||||
true -> Integer.to_string(rounded)
|
||||
end
|
||||
end
|
||||
|
||||
defp gain_class(delta) when is_number(delta) and delta > 0, do: "text-success-text"
|
||||
defp gain_class(delta) when is_number(delta) and delta < 0, do: "text-error"
|
||||
defp gain_class(_delta), do: "text-muted"
|
||||
end
|
||||
Reference in New Issue
Block a user