Feature/game update

[HannoZ]

This pull request introduces several improvements and new features to the Lexicala.NET demo projects, with a focus on expanding and documenting the Sense Sprint demo game and adding support for a new Translation Quiz game mode. The changes include enhancements to API contracts, service interfaces, and documentation to support language selection, improved round management, and clearer development instructions.

Key changes:

Demo Game Enhancements

• Added a new React + TypeScript + Vite demo game (sense-sprint-web) under source/Demo/, with updated documentation and clearer instructions for setup and usage in both the .github/instructions/repository-information.instructions.md and README.md files. [1] [2]
• Updated the Sense Sprint API and frontend documentation to reflect support for multiple languages and to provide links to detailed game documentation. [1] [2]

Sense Sprint Game Service Improvements

• Modified the ISenseSprintGameService and SenseSprintGameService to support creating rounds in a user-selected language (defaulting to English if none is provided), and updated the round creation flow to include the language in the response. [1] [2] [3] [4] [5] [6]
• Improved the GiveUpAsync method to distinguish between expired and lost rounds, providing more accurate feedback to the user.
• Refactored rate limit extraction logic into a reusable helper (GameServiceHelpers). [1] [2]

Translation Quiz Game Mode

• Introduced a new ITranslationQuizGameService interface and related API contracts (TranslationQuizContracts.cs) to support a translation quiz game mode, including round creation, answer submission, and round expiration. [1] [2]

Documentation and Developer Experience

• Expanded the repository documentation to include setup steps for API keys, clearer instructions for running both backend and frontend demos, and updated endpoint descriptions to reflect new and changed features. [1] [2]
• Clarified project structure and the purpose of demonstration projects in .github/instructions/repository-information.instructions.md.

These changes collectively improve the flexibility, usability, and documentation of the demo projects, making it easier for developers to run, extend, and understand the Sense Sprint and Translation Quiz games.

[Copilot]

Pull request overview

This PR expands the Lexicala.NET demo experience by enhancing the existing Sense Sprint backend/frontend flow (language selection, better round lifecycle UX) and introducing a new Translation Quiz game mode end-to-end (API + frontend + tests), alongside updated documentation for running the demos.

Changes:

• Added Translation Quiz game mode: new backend service + minimal-API endpoints + Playwright E2E tests and UI.
• Enhanced Sense Sprint to support per-round language selection and improved client-side session/stats handling.
• Improved developer docs and added Playwright tooling/config for the web demo.

Reviewed changes

Copilot reviewed 23 out of 24 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
source/Lexicala.NET.Tests/TranslationQuizGameServiceTests.cs	New unit tests for Translation Quiz service behavior and caching.
source/Lexicala.NET.Tests/SenseSprintGameServiceTests.cs	New unit tests for Sense Sprint service argument/round behaviors.
source/Lexicala.NET.Tests/Lexicala.NET.Tests.csproj	Adds Demo API project reference so game services can be tested.
source/Demo/sense-sprint-web/vite.config.ts	Proxies /languages to the backend during local dev.
source/Demo/sense-sprint-web/tests/e2e/translation-quiz.spec.ts	New Playwright E2E coverage for Translation Quiz UI flows.
source/Demo/sense-sprint-web/tests/e2e/sense-sprint.spec.ts	New Playwright E2E coverage for Sense Sprint language/lifecycle edge cases.
source/Demo/sense-sprint-web/tests/e2e/mocks.ts	Shared Playwright mock payloads for /languages and game endpoints.
source/Demo/sense-sprint-web/src/App.tsx	Major UI refactor: tabs for modes, languages caching, stats/session persistence, Translation Quiz UI + API calls.
source/Demo/sense-sprint-web/src/App.css	Styling for tabs, quiz UI, and expanded stats/celebration UI.
source/Demo/sense-sprint-web/README.md	Updated web demo documentation (setup, features, gameplay).
source/Demo/sense-sprint-web/playwright.config.ts	Adds Playwright test runner configuration for the web demo.
source/Demo/sense-sprint-web/package.json	Adds test:e2e script and Playwright dependency.
source/Demo/sense-sprint-web/package-lock.json	Locks Playwright + dependencies.
source/Demo/sense-sprint-web/.gitignore	Ignores Playwright artifacts (playwright-report, test-results).
source/Demo/Lexicala.NET.Demo.Api/Program.cs	Registers TranslationQuiz service; adds endpoints; Sense Sprint create-round now accepts language in body.
source/Demo/Lexicala.NET.Demo.Api/Game/TranslationQuizGameService.cs	New backend game service implementing Translation Quiz round generation/answer/expire logic with caching.
source/Demo/Lexicala.NET.Demo.Api/Game/TranslationQuizContracts.cs	DTO contracts for Translation Quiz endpoints.
source/Demo/Lexicala.NET.Demo.Api/Game/SenseSprintGameService.cs	Adds language support for round creation; refactors rate limit handling; improves give-up status messaging.
source/Demo/Lexicala.NET.Demo.Api/Game/SenseSprintContracts.cs	Adds language to Sense Sprint create-round response and request body DTO.
source/Demo/Lexicala.NET.Demo.Api/Game/ITranslationQuizGameService.cs	New interface for Translation Quiz service.
source/Demo/Lexicala.NET.Demo.Api/Game/ISenseSprintGameService.cs	Updates Sense Sprint interface to accept optional language.
source/Demo/Lexicala.NET.Demo.Api/Game/GameServiceHelpers.cs	Extracted helper for building rate-limit debug info.
README.md	Updates repo-level demo instructions and points to the web demo docs.
.github/instructions/repository-information.instructions.md	Documents the new web demo location under source/Demo/.

Files not reviewed (1)

• source/Demo/sense-sprint-web/package-lock.json: Language not supported

Comments suppressed due to low confidence (1)

source/Demo/Lexicala.NET.Demo.Api/Program.cs:120

• The create-round endpoint only catches InvalidOperationException. If the client supplies an invalid Language (e.g., not a 2-letter code), ILexicalaClient.FlukySearchAsync can throw ArgumentException, which will currently bubble up as a 500. Consider catching ArgumentException here and returning a 400 (ProblemDetails) for invalid input.

                    catch (InvalidOperationException ex)
                    {
                        return Results.Problem(ex.Message, statusCode: StatusCodes.Status503ServiceUnavailable);
                    }