From a4a42488bb8b23954174a1ffc1607c093468e56e Mon Sep 17 00:00:00 2001 From: Stefan Date: Sun, 23 Nov 2025 13:36:10 +0100 Subject: [PATCH] i18n --- Dockerfile | 64 ++++ README.md | 80 ++++- docker-compose.yml | 35 ++ jest.setup.ts | 4 + next.config.ts | 2 +- nginx.conf.example | 96 ++++++ src/app/api/health/route.ts | 12 + src/app/favicon.ico | Bin 25931 -> 4286 bytes src/app/layout.tsx | 4 +- src/app/page.tsx | 18 +- src/components/ChessGame.tsx | 619 ++++++++++++++++++++--------------- src/components/Header.tsx | 67 ++++ src/components/Tutor.tsx | 43 ++- 13 files changed, 743 insertions(+), 301 deletions(-) create mode 100644 Dockerfile create mode 100644 docker-compose.yml create mode 100644 jest.setup.ts create mode 100644 nginx.conf.example create mode 100644 src/app/api/health/route.ts create mode 100644 src/components/Header.tsx diff --git a/Dockerfile b/Dockerfile new file mode 100644 index 0000000..bdb7c63 --- /dev/null +++ b/Dockerfile @@ -0,0 +1,64 @@ +# Multi-stage build for optimal production image + +# Stage 1: Dependencies +FROM node:20-alpine AS deps +RUN apk add --no-cache libc6-compat +WORKDIR /app + +# Copy package files +COPY package.json package-lock.json ./ + +# Install all dependencies (including dev dependencies needed for build) +RUN npm ci + +# Stage 2: Builder +FROM node:20-alpine AS builder +WORKDIR /app + +# Copy dependencies from deps stage +COPY --from=deps /app/node_modules ./node_modules +COPY . . + +# Set environment variable for build (optional - can be overridden at runtime) +ARG NEXT_PUBLIC_GEMINI_API_KEY +ENV NEXT_PUBLIC_GEMINI_API_KEY=$NEXT_PUBLIC_GEMINI_API_KEY + +# Build Next.js application with standalone output +ENV NEXT_TELEMETRY_DISABLED=1 +RUN npm run build + +# Stage 3: Runner +FROM node:20-alpine AS runner +WORKDIR /app + +ENV NODE_ENV=production +ENV NEXT_TELEMETRY_DISABLED=1 + +# Create non-root user for security +RUN addgroup --system --gid 1001 nodejs +RUN adduser --system --uid 1001 nextjs + +# Copy necessary files from builder +COPY --from=builder /app/public ./public +COPY --from=builder /app/.next/standalone ./ +COPY --from=builder /app/.next/static ./.next/static + +# Set ownership to non-root user +RUN chown -R nextjs:nodejs /app + +# Switch to non-root user +USER nextjs + +# Expose port 3050 +EXPOSE 3050 + +# Set port environment variable +ENV PORT=3050 +ENV HOSTNAME="0.0.0.0" + +# Health check +HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \ + CMD node -e "require('http').get('http://localhost:3050/api/health', (r) => {process.exit(r.statusCode === 200 ? 0 : 1)})" || exit 1 + +# Start the application +CMD ["node", "server.js"] diff --git a/README.md b/README.md index a241014..fb593fe 100644 --- a/README.md +++ b/README.md @@ -99,6 +99,84 @@ You have two options for providing your Gemini API key: > [!NOTE] > You can update your API key anytime by clicking the key icon in the bottom-right corner of the application. +## Docker Deployment + +### Quick Start with Docker + +The easiest way to deploy Chess Tutor is using Docker Compose: + +```bash +# Clone the repository +git clone https://github.com/your-username/chess_tutor.git +cd chess_tutor + +# (Optional) Create .env file with your API key +echo "NEXT_PUBLIC_GEMINI_API_KEY=your_api_key_here" > .env + +# Build and start the container +docker-compose up -d + +# View logs +docker-compose logs -f +``` + +The application will be available at `http://localhost:3050` + +### Environment Variables + +You have two options for providing the Gemini API key: + +1. **Environment Variable** (recommended for server deployment): + - Create a `.env` file in the project root + - Add: `NEXT_PUBLIC_GEMINI_API_KEY=your_api_key_here` + - The application will automatically use this key + +2. **Browser Storage** (fallback): + - If no environment variable is set, users will be prompted to enter their API key + - The key is stored in browser localStorage + +> [!NOTE] +> The API key is never logged or exposed in application logs. It's only used for API calls to Google Gemini. + +### Nginx Reverse Proxy + +For production deployment behind nginx, use the provided `nginx.conf.example`: + +```bash +# Copy the example configuration +sudo cp nginx.conf.example /etc/nginx/sites-available/chess-tutor + +# Edit the configuration +sudo nano /etc/nginx/sites-available/chess-tutor +# Update: server_name, SSL certificates (if using HTTPS) + +# Enable the site +sudo ln -s /etc/nginx/sites-available/chess-tutor /etc/nginx/sites-enabled/ + +# Test nginx configuration +sudo nginx -t + +# Reload nginx +sudo systemctl reload nginx +``` + +### Manual Docker Build + +If you prefer to build manually: + +```bash +# Build the image +docker build -t chess-tutor:latest . + +# Run the container +docker run -d \ + --name chess-tutor \ + -p 3050:3050 \ + -e NEXT_PUBLIC_GEMINI_API_KEY=your_api_key_here \ + --restart unless-stopped \ + chess-tutor:latest +``` + ## Credits - Opening collection originally by [ragizaki/ChessOpeningsRecommender](https://github.com/ragizaki/ChessOpeningsRecommender) - Chess engine: [Stockfish](https://stockfishchess.org/) @@ -119,7 +197,7 @@ pnpm dev bun dev ``` -Open [http://localhost:3000](http://localhost:3050) with your browser to see the result. +Open [http://localhost:3050](http://localhost:3050) with your browser to see the result. You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file. diff --git a/docker-compose.yml b/docker-compose.yml new file mode 100644 index 0000000..208c1e8 --- /dev/null +++ b/docker-compose.yml @@ -0,0 +1,35 @@ +version: '3.8' + +services: + chess-tutor: + build: + context: . + dockerfile: Dockerfile + args: + # Optional: Set API key at build time (not recommended for security) + # NEXT_PUBLIC_GEMINI_API_KEY: ${NEXT_PUBLIC_GEMINI_API_KEY} + image: chess-tutor:latest + container_name: chess-tutor + restart: unless-stopped + ports: + - "3050:3050" + environment: + # Optional: Set API key at runtime (recommended approach) + # Users can still use browser-based API key if this is not set + - NEXT_PUBLIC_GEMINI_API_KEY=${NEXT_PUBLIC_GEMINI_API_KEY:-} + - NODE_ENV=production + healthcheck: + test: ["CMD", "node", "-e", "require('http').get('http://localhost:3050', (r) => {process.exit(r.statusCode === 200 ? 0 : 1)})"] + interval: 30s + timeout: 10s + retries: 3 + start_period: 40s + # Optional: Add volumes for persistent data if needed + # volumes: + # - ./data:/app/data + networks: + - chess-tutor-network + +networks: + chess-tutor-network: + driver: bridge diff --git a/jest.setup.ts b/jest.setup.ts new file mode 100644 index 0000000..4c92e15 --- /dev/null +++ b/jest.setup.ts @@ -0,0 +1,4 @@ +import '@testing-library/jest-dom' + +// Mock scrollIntoView for JSDOM +window.HTMLElement.prototype.scrollIntoView = jest.fn(); diff --git a/next.config.ts b/next.config.ts index e9ffa30..225e495 100644 --- a/next.config.ts +++ b/next.config.ts @@ -1,7 +1,7 @@ import type { NextConfig } from "next"; const nextConfig: NextConfig = { - /* config options here */ + output: 'standalone', }; export default nextConfig; diff --git a/nginx.conf.example b/nginx.conf.example new file mode 100644 index 0000000..b1c7374 --- /dev/null +++ b/nginx.conf.example @@ -0,0 +1,96 @@ +# Example nginx configuration for reverse proxy +# Copy this file to your nginx sites-available directory and modify as needed +# Example: /etc/nginx/sites-available/chess-tutor + +upstream chess_tutor { + server localhost:3050; + keepalive 64; +} + +server { + listen 80; + listen [::]:80; + server_name your-domain.com www.your-domain.com; + + # Redirect HTTP to HTTPS (uncomment when SSL is configured) + # return 301 https://$server_name$request_uri; + + # If not using HTTPS, use this location block instead: + location / { + proxy_pass http://chess_tutor; + proxy_http_version 1.1; + proxy_set_header Upgrade $http_upgrade; + proxy_set_header Connection 'upgrade'; + proxy_set_header Host $host; + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_set_header X-Forwarded-Proto $scheme; + proxy_cache_bypass $http_upgrade; + + # Timeouts + proxy_connect_timeout 60s; + proxy_send_timeout 60s; + proxy_read_timeout 60s; + } + + # Gzip compression + gzip on; + gzip_vary on; + gzip_min_length 1024; + gzip_proxied any; + gzip_types text/plain text/css text/xml text/javascript application/x-javascript application/xml+rss application/json application/javascript; + gzip_disable "MSIE [1-6]\."; +} + +# HTTPS configuration (uncomment and configure when you have SSL certificates) +# server { +# listen 443 ssl http2; +# listen [::]:443 ssl http2; +# server_name your-domain.com www.your-domain.com; +# +# # SSL certificate paths (use Let's Encrypt or your own certificates) +# ssl_certificate /etc/letsencrypt/live/your-domain.com/fullchain.pem; +# ssl_certificate_key /etc/letsencrypt/live/your-domain.com/privkey.pem; +# +# # SSL configuration +# ssl_protocols TLSv1.2 TLSv1.3; +# ssl_ciphers HIGH:!aNULL:!MD5; +# ssl_prefer_server_ciphers on; +# ssl_session_cache shared:SSL:10m; +# ssl_session_timeout 10m; +# +# # Security headers +# add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always; +# add_header X-Frame-Options "SAMEORIGIN" always; +# add_header X-Content-Type-Options "nosniff" always; +# add_header X-XSS-Protection "1; mode=block" always; +# +# location / { +# proxy_pass http://chess_tutor; +# proxy_http_version 1.1; +# proxy_set_header Upgrade $http_upgrade; +# proxy_set_header Connection 'upgrade'; +# proxy_set_header Host $host; +# proxy_set_header X-Real-IP $remote_addr; +# proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; +# proxy_set_header X-Forwarded-Proto $scheme; +# proxy_cache_bypass $http_upgrade; +# +# # Timeouts +# proxy_connect_timeout 60s; +# proxy_send_timeout 60s; +# proxy_read_timeout 60s; +# } +# +# # Gzip compression +# gzip on; +# gzip_vary on; +# gzip_min_length 1024; +# gzip_proxied any; +# gzip_types text/plain text/css text/xml text/javascript application/x-javascript application/xml+rss application/json application/javascript; +# gzip_disable "MSIE [1-6]\."; +# +# # Rate limiting (optional but recommended) +# # limit_req_zone $binary_remote_addr zone=chess_tutor_limit:10m rate=10r/s; +# # limit_req zone=chess_tutor_limit burst=20 nodelay; +# } diff --git a/src/app/api/health/route.ts b/src/app/api/health/route.ts new file mode 100644 index 0000000..b60c0a2 --- /dev/null +++ b/src/app/api/health/route.ts @@ -0,0 +1,12 @@ +import { NextResponse } from 'next/server'; + +export async function GET() { + return NextResponse.json( + { + status: 'ok', + timestamp: new Date().toISOString(), + service: 'chess-tutor' + }, + { status: 200 } + ); +} diff --git a/src/app/favicon.ico b/src/app/favicon.ico index 718d6fea4835ec2d246af9800eddb7ffb276240c..1d98fcdba8749de5560fc2bb477f6ddbe765a479 100644 GIT binary patch literal 4286 zcmdT|4@^~67{6v~wP{+ZYo+zf+3?RWB~40+)czP5lobjhAOepEYG{)2XRX2%UD*g` zn=4TiZKGuQSpSuXqA<$T5n-n0hD|ofB6uk8{rbM|z9Y|g@80`tjr!Pk&b{CH&iQ@+ z&N=s?X#?obX4AOUb`RCG5t^oj5R*uYBxbn~jg1M_Sr=%U2Y^2&v0r&0UDmfkm(2Hg z2!kd4LmtK_?l1a3;k(^#^z>YSyQhaZP_M>l+}&duR;&JBZjQ|6N%fiJ-$Q;g)xNg_ z+lp49VpA@5zOtqd?;sg-#jCm4zF{>!s3_I_H(1|_{~U9svh}MlZ!L&sR1SE`12OvD4A~-Iqvym?)iHOV@=aurO>vX1K|%aXA6Wl)ydl0%U9NmI6uXKG z@czycBup8E}8t{|0qn7Jub`-okst|5|4S z;ZyDLzN7m4iSm&hH34ZeZWP(F2gZsW`EfJR)!Cur`}pA#5PghVh4J?>epmI!`RDzA zqUA8ssopZYb)UB&Tx!rUi}oVL-G1LKcsgo4em(WGEN6QDl9myP)q zSze4MLI#NccCG=&CVSZTg`rnt-@97{`@;Ed>5Uq*`14$Kj=uIxJd)_1JALvfDmNEm z5#=Fq>QKSvvmqgDFxJ!g-0kWTNF%?LO{`<4r|>(@wPR)UB&0^%j32)J0xgFQVEe`# z%7qOnl>c)2_E2QB=adfjR`6L*<&p37ms00qKE=O~`s2;tqnh#&Ggd?Ei56CsZ$x>p z&{)OirBp5Qb6xe@$d8Y}a=LR)9c#jt7qifGpq7Wo*1+eDDEKtN;QL$q?3q@yx1E+1 z`Hl>hg2mU@_sI9RZ;pMRgR$ZA@Ou$_=ks&0WM%&ayJj%@{}p_>hxnH;p9j9Z{`Rl5 O94Gc){U4ye`o91g4te4L literal 25931 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 LrJugUA?W`A8`#=m diff --git a/src/app/layout.tsx b/src/app/layout.tsx index e9454a2..e4e550c 100644 --- a/src/app/layout.tsx +++ b/src/app/layout.tsx @@ -13,8 +13,8 @@ const geistMono = Geist_Mono({ }); export const metadata: Metadata = { - title: "Create Next App", - description: "Generated by create next app", + title: "Chess Tutor - Learn Chess with AI", + description: "Learn chess with AI-powered tutoring from Gemini and Stockfish engine analysis", }; export default function RootLayout({ diff --git a/src/app/page.tsx b/src/app/page.tsx index 1a7cc50..70f78db 100644 --- a/src/app/page.tsx +++ b/src/app/page.tsx @@ -1,21 +1,5 @@ import ChessGame from "@/components/ChessGame"; export default function Home() { - return ( -
-
-

- Chess Tutor with Gemini & Stockfish -

-
- -
- -
- -
- -
-
- ); + return ; } diff --git a/src/components/ChessGame.tsx b/src/components/ChessGame.tsx index 5d9011f..fb5f59d 100644 --- a/src/components/ChessGame.tsx +++ b/src/components/ChessGame.tsx @@ -8,6 +8,9 @@ import { Tutor } from "./Tutor"; import { APIKeyInput } from "./APIKeyInput"; import { EvaluationBar } from "./EvaluationBar"; import { Personality, PERSONALITIES } from "@/lib/personalities"; +import Header from "./Header"; +import { useTranslation } from "@/lib/i18n/useTranslation"; +import { SupportedLanguage } from "@/lib/i18n/translations"; import { lookupOpening, OpeningMetadata } from "@/lib/openings"; @@ -36,12 +39,16 @@ export default function ChessGame() { const [stockfishDepth, setStockfishDepth] = useState(15); // New States - const [language, setLanguage] = useState<'en' | 'de' | 'fr' | 'it'>('en'); + const [language, setLanguage] = useState('en'); const [gameStarted, setGameStarted] = useState(false); const [showNewGameOptions, setShowNewGameOptions] = useState(false); const [showAnalysisModal, setShowAnalysisModal] = useState(false); const [customFen, setCustomFen] = useState(""); + // Color Selection State + const [colorSelection, setColorSelection] = useState<'white' | 'black' | 'random'>('white'); + const [playerColor, setPlayerColor] = useState<'white' | 'black'>('white'); + // Game Over & History State const [gameOverState, setGameOverState] = useState<{ result: string, winner: "White" | "Black" | "Draw" } | null>(null); const [moveHistory, setMoveHistory] = useState([]); @@ -49,6 +56,9 @@ export default function ChessGame() { // Personality State const [selectedPersonality, setSelectedPersonality] = useState(null); + // Translation + const t = useTranslation(language); + useEffect(() => { const sf = new Stockfish(); setStockfish(sf); @@ -251,6 +261,12 @@ export default function ChessGame() { setFen(startFen); setSelectedPersonality(personality); + // Determine player color (resolve random) + let finalPlayerColor: 'white' | 'black' = colorSelection === 'random' + ? (Math.random() < 0.5 ? 'white' : 'black') + : colorSelection; + setPlayerColor(finalPlayerColor); + // Reset Analysis State setUserMove(null); setComputerMove(null); @@ -262,6 +278,31 @@ export default function ChessGame() { setGameStarted(true); setCustomFen(""); // Clear input + + // If player is Black, computer moves first + if (finalPlayerColor === 'black' && stockfish) { + setTimeout(() => { + stockfish.evaluate(startFen, stockfishDepth).then(evalResult => { + const computerMoveData = { + from: evalResult.bestMove.substring(0, 2), + to: evalResult.bestMove.substring(2, 4), + promotion: evalResult.bestMove.length > 4 ? evalResult.bestMove.substring(4, 5) : "q" + }; + + const compResult = makeAMove(computerMoveData); + if (compResult) { + setComputerMove(compResult.result); + const { newFen: fenAfterComp } = compResult; + setFen(fenAfterComp); + + // Evaluate position after computer's first move + stockfish.evaluate(fenAfterComp, stockfishDepth).then(p0Eval => { + setEvalP0(p0Eval); + }).catch(err => console.error("Initial eval failed:", err)); + } + }).catch(err => console.error("Computer first move failed:", err)); + }, 500); + } } catch (e) { alert("Invalid FEN string"); } @@ -276,293 +317,337 @@ export default function ChessGame() { const hasSavedGame = fen !== "rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR w KQkq - 0 1"; return ( -
-

Chess Tutor AI

+ <> +
+
+

{t.start.title}

-
- {/* Step 1: Language & API Key */} -
-

1. Settings

+
+ {/* Step 1: Language & API Key */} +
+

{t.start.settings}

-
-
- -
- {['en', 'de', 'fr', 'it'].map((lang) => ( - - ))} +
+
+ +
+ {(['en', 'de', 'fr', 'it'] as SupportedLanguage[]).map((lang) => ( + + ))} +
+
+ +
+ + setApiKey(e.target.value)} + className="w-full p-2 border rounded dark:bg-gray-700 dark:border-gray-600" + /> +

+ {t.start.getApiKey} +

+
-
- - setApiKey(e.target.value)} - className="w-full p-2 border rounded dark:bg-gray-700 dark:border-gray-600" - /> -

- Get free key -

-
+ {/* Step 2: Game Actions */} +
+

{t.start.startGame}

+ + {!apiKey ? ( +
+ {t.start.apiKeyRequired} +
+ ) : ( +
+ {/* Resume Option */} + {hasSavedGame && !showNewGameOptions && ( +
+ + +
+ )} + + {/* New Game Options */} + {(!hasSavedGame || showNewGameOptions) && ( +
+ {/* Color Selection */} +
+ +
+ + + +
+
+ + {/* FEN Import */} +
+ + setCustomFen(e.target.value)} + className="w-full p-2 border rounded dark:bg-gray-700 dark:border-gray-600 font-mono text-sm" + /> +
+ + {/* Personality Grid */} +
+

{t.start.chooseCoach}

+
+ {PERSONALITIES.map(p => ( + + ))} +
+
+ + {hasSavedGame && ( + + )} +
+ )} +
+ )}
- - {/* Step 2: Game Actions */} -
-

2. Start Game

- - {!apiKey ? ( -
- Please enter a valid API Key to continue. -
- ) : ( -
- {/* Resume Option */} - {hasSavedGame && !showNewGameOptions && ( -
- - -
- )} - - {/* New Game Options */} - {(!hasSavedGame || showNewGameOptions) && ( -
- {/* FEN Import */} -
- - setCustomFen(e.target.value)} - className="w-full p-2 border rounded dark:bg-gray-700 dark:border-gray-600 font-mono text-sm" - /> -
- - {/* Personality Grid */} -
-

Choose Your Coach:

-
- {PERSONALITIES.map(p => ( - - ))} -
-
- - {hasSavedGame && ( - - )} -
- )} -
- )} -
-
+ ); } return ( -
- {/* API Key Input is now handled in start screen, but we keep the button for updates */} - {/* */} + <> +
+
+ {/* API Key Input is now handled in start screen, but we keep the button for updates */} + {/* */} -
- {/* Header with Back Button */} -
- -
- Playing as White vs {selectedPersonality?.name} -
-
- -
-
{/* Match board height roughly */} - -
-
- onDrop({ sourceSquare, targetSquare }), - darkSquareStyle: { backgroundColor: '#779954' }, - lightSquareStyle: { backgroundColor: '#e9edcc' }, - animationDurationInMs: 200 - }} - /> -
-
- -
-
- +
+ {/* Header with Back Button */} +
+
+ {t.game.playingAs} {playerColor === 'white' ? t.game.white : t.game.black} {t.game.vs} {selectedPersonality?.name} +
- setStockfishDepth(parseInt(e.target.value))} - className="w-full h-2 bg-gray-200 rounded-lg appearance-none cursor-pointer dark:bg-gray-700" + +
+
{/* Match board height roughly */} + +
+
+ onDrop({ sourceSquare, targetSquare }), + darkSquareStyle: { backgroundColor: '#779954' }, + lightSquareStyle: { backgroundColor: '#e9edcc' }, + animationDurationInMs: 200, + boardOrientation: playerColor // Set board orientation based on player color + }} + /> +
+
+ +
+
+ + +
+ setStockfishDepth(parseInt(e.target.value))} + className="w-full h-2 bg-gray-200 rounded-lg appearance-none cursor-pointer dark:bg-gray-700" + /> +
+ + {/* PGN Display */} + {/* Game History (Scrollable List) */} +
+
+

Game History

+ +
+
+ + + + + + + + + + {(() => { + const history = gameRef.current.history(); + const rows = []; + for (let i = 0; i < history.length; i += 2) { + rows.push( + + + + + + ); + } + if (rows.length === 0) { + return ( + + + + ); + } + return rows; + })()} + +
#WhiteBlack
{Math.floor(i / 2) + 1}.{history[i]}{history[i + 1] || ""}
+ No moves yet. +
+ {/* Auto-scroll anchor */} +
el?.scrollIntoView({ behavior: "smooth" })} /> +
+
+
+ +
+ { }} + apiKey={apiKey} + personality={selectedPersonality!} + language={language} + playerColor={playerColor} />
- {/* PGN Display */} - {/* Game History (Scrollable List) */} -
-
-

Game History

- -
-
- - - - - - - - - - {(() => { - const history = gameRef.current.history(); - const rows = []; - for (let i = 0; i < history.length; i += 2) { - rows.push( - - - - - - ); - } - if (rows.length === 0) { - return ( - - - - ); - } - return rows; - })()} - -
#WhiteBlack
{Math.floor(i / 2) + 1}.{history[i]}{history[i + 1] || ""}
- No moves yet. -
- {/* Auto-scroll anchor */} -
el?.scrollIntoView({ behavior: "smooth" })} /> -
-
+ {/* Analysis Modal */} + {showAnalysisModal && ( + setShowAnalysisModal(false)} + /> + )} + + {/* Game Over Modal */} + {gameOverState && ( + setGameOverState(null)} + onNewGame={() => handleNewGame(selectedPersonality!)} + /> + )}
- -
- { }} - apiKey={apiKey} - personality={selectedPersonality!} - language={language} - /> -
- - {/* Analysis Modal */} - {showAnalysisModal && ( - setShowAnalysisModal(false)} - /> - )} - - {/* Game Over Modal */} - {gameOverState && ( - setGameOverState(null)} - onNewGame={() => handleNewGame(selectedPersonality!)} - /> - )} -
+ ); } diff --git a/src/components/Header.tsx b/src/components/Header.tsx new file mode 100644 index 0000000..70e04d1 --- /dev/null +++ b/src/components/Header.tsx @@ -0,0 +1,67 @@ +import React from 'react'; +import { useTranslation } from '@/lib/i18n/useTranslation'; +import { SupportedLanguage } from '@/lib/i18n/translations'; + +interface HeaderProps { + language: SupportedLanguage; +} + +export default function Header({ language }: HeaderProps) { + const t = useTranslation(language); + + return ( +
+
+
+ {/* App Title/Branding */} +
+
♞
+

+ Chess Tutor +

+ + {t.header.tagline} + +
+ + {/* Action Buttons */} +
+ {/* Buy Me a Beer Button */} + + 🍺 + {t.header.buyMeABeer} + + + {/* GitHub Button */} + + + {t.header.github} + +
+
+
+
+ ); +} diff --git a/src/components/Tutor.tsx b/src/components/Tutor.tsx index 9bf818d..ff34e0f 100644 --- a/src/components/Tutor.tsx +++ b/src/components/Tutor.tsx @@ -10,6 +10,9 @@ import clsx from "clsx"; import { Personality } from "@/lib/personalities"; import { OpeningMetadata } from "@/lib/openings"; +import { useTranslation } from '@/lib/i18n/useTranslation'; +import { SupportedLanguage } from '@/lib/i18n/translations'; + interface TutorProps { currentFen: string; userMove: Move | null; @@ -21,7 +24,8 @@ interface TutorProps { onAnalysisComplete: () => void; apiKey: string | null; personality: Personality; - language: 'en' | 'de' | 'fr' | 'it'; + language: SupportedLanguage; + playerColor: 'white' | 'black'; } interface Message { @@ -30,15 +34,20 @@ interface Message { timestamp: number; } -export function Tutor({ currentFen, userMove, computerMove, stockfish, evalP0, evalP2, openingData, onAnalysisComplete, apiKey, personality, language }: TutorProps) { - const [messages, setMessages] = useState([ - { role: "model", text: "Hello! I am " + personality.name + ". " + personality.description + " Let's play!", timestamp: Date.now() } - ]); +export function Tutor({ currentFen, userMove, computerMove, stockfish, evalP0, evalP2, openingData, onAnalysisComplete, apiKey, personality, language, playerColor }: TutorProps) { + const [messages, setMessages] = useState([]); const [input, setInput] = useState(""); const [isLoading, setIsLoading] = useState(false); const [chatSession, setChatSession] = useState(null); const messagesEndRef = useRef(null); + const t = useTranslation(language); + + // Determine tutor color (opposite of player) + const tutorColor = playerColor === 'white' ? 'black' : 'white'; + const playerColorName = playerColor === 'white' ? 'White' : 'Black'; + const tutorColorName = tutorColor === 'white' ? 'White' : 'Black'; + // Initialize chat session with Personality System Prompt useEffect(() => { if (apiKey) { @@ -57,7 +66,7 @@ PERSONALITY: ${personality.systemPrompt} INSTRUCTIONS: -- You are the opponent (Black). You are playing against the User (White). +- You are the opponent (${tutorColorName}). You are playing against the User (${playerColorName}). - You are NOT an AI assistant analyzing a game. You ARE the player. - Refer to the moves as YOUR moves ("I played e5", "My response was..."). - Refer to the evaluation as YOUR thoughts/assessment ("I think I'm winning", "I missed that"). @@ -73,15 +82,23 @@ INSTRUCTIONS: }, { role: "model", - parts: [{ text: `Understood. I am the player (Black). I will speak in ${language} and never mention the engine.` }] + parts: [{ text: `Understood. I am the player (${tutorColorName}). I will speak in ${language} and never mention the engine.` }] } ], }); setChatSession(session); - // Reset messages on language/personality change - setMessages([{ role: "model", text: `Hello! I am ${personality.name}. Let's play!`, timestamp: Date.now() }]); + + // Get initial greeting in the selected language + session.sendMessage(`Introduce yourself briefly to start our game. Keep it short and in ${language}.`).then(result => { + const greetingText = result.response.text(); + setMessages([{ role: "model", text: greetingText, timestamp: Date.now() }]); + }).catch(err => { + console.error("Failed to get greeting:", err); + // Fallback to English if greeting fails + setMessages([{ role: "model", text: `Hello! I am ${personality.name}. Let's play!`, timestamp: Date.now() }]); + }); } - }, [apiKey, personality, language]); + }, [apiKey, personality, language, playerColor]); // Scroll to bottom useEffect(() => { @@ -276,13 +293,13 @@ React to this exchange as the player. onClick={() => sendMessageToChat("Give me a hint")} className="flex items-center gap-1 px-3 py-1 text-xs bg-yellow-100 text-yellow-800 rounded-full hover:bg-yellow-200 dark:bg-yellow-900 dark:text-yellow-200" > - Hint + {t.tutor.hint}
@@ -292,7 +309,7 @@ React to this exchange as the player. type="text" value={input} onChange={(e) => setInput(e.target.value)} - placeholder="Ask your coach..." + placeholder={t.tutor.askCoach} className="flex-1 p-2 border rounded-lg dark:bg-gray-700 dark:border-gray-600 focus:outline-none focus:ring-2 focus:ring-blue-500" disabled={isLoading} />