mumble_game 1.0.0

data/lib/mumble.rb

@@ -0,0 +1,340 @@
+# frozen_string_literal: true
+
+require_relative "mumble/version"
+require_relative "mumble/colors"
+require_relative "mumble/cursor"
+require_relative "mumble/screen"
+require_relative "mumble/box"
+require_relative "mumble/input"
+require_relative "mumble/layout"
+require_relative "mumble/storage"
+require_relative "mumble/config"
+require_relative "mumble/high_scores"
+require_relative "mumble/word_cache"
+require_relative "mumble/word_service"
+require_relative "mumble/scorer"
+require_relative "mumble/grid"
+require_relative "mumble/hangman"
+require_relative "mumble/animations"
+require_relative "mumble/error_handler"
+
+# Screens
+require_relative "mumble/screens/base"
+require_relative "mumble/screens/splash"
+require_relative "mumble/screens/main_menu"
+require_relative "mumble/screens/rules"
+require_relative "mumble/screens/high_scores"
+require_relative "mumble/screens/profile"
+require_relative "mumble/screens/name_input"
+require_relative "mumble/screens/quit_confirm"
+require_relative "mumble/screens/gameplay"
+require_relative "mumble/screens/win"
+require_relative "mumble/screens/lose"
+require_relative "mumble/screens/play_again"
+
+module Mumble
+  class Error < StandardError; end
+
+  class << self
+    # Boots the game - called from bin/mumble executable
+    def start
+      Game.new.run
+    end
+  end
+
+  # Main game controller
+  class Game
+    def initialize
+      @config = Config.load
+      @session_stats = { games: 0, won: 0, score: 0 }
+      @current_level = 1
+      setup_signal_handlers
+    end
+
+    def run
+      ErrorHandler.check_terminal_size!
+      show_splash
+      check_first_time
+      main_loop
+    rescue Interrupt
+      # Ctrl+C pressed - exit gracefully
+      graceful_exit
+    rescue StandardError => e
+      ErrorHandler.fatal(e, context: "Main game loop")
+    end
+
+    private
+
+    # Handle Ctrl+C and other signals
+    def setup_signal_handlers
+      # Ctrl+C - graceful exit
+      Signal.trap("INT") { graceful_exit }
+
+      # Terminal resize - check size is still valid
+      Signal.trap("WINCH") { handle_resize } if Signal.list.key?("WINCH")
+    rescue StandardError
+      # Some signals might not be available on all platforms
+      nil
+    end
+
+    def graceful_exit
+      Cursor.clear_screen
+      Cursor.show
+      Cursor.move_to(Screen.center_row, Screen.center_col(25))
+      print Colors.cyan("Thanks for playing!")
+      Cursor.move_to(Screen.center_row + 2, 1)
+      exit(0)
+    end
+
+    def handle_resize
+      # rubocop:disable Style/GuardClause
+      unless Screen.valid_size?
+        Cursor.clear_screen
+        Cursor.move_to(1, 1)
+        print Colors.yellow("Terminal too small! Please resize.")
+      end
+      # rubocop:enable Style/GuardClause
+    end
+
+    def show_splash
+      Screens::Splash.new(@config).show
+    end
+
+    def check_first_time
+      return if Config.exists?
+
+      name = Screens::NameInput.new(@config, mode: :new).show
+      @config = Config.update_name(@config, name) if name
+    end
+
+    def main_loop
+      loop do
+        case show_main_menu
+        when :new_game
+          @current_level = 1
+          play_game_loop
+        when :high_scores
+          show_high_scores
+        when :profile
+          handle_profile
+        when :rules
+          show_rules
+        when :quit
+          break if confirm_quit
+        end
+      end
+
+      goodbye
+    end
+
+    def show_main_menu
+      Screens::MainMenu.new(@config).show
+    end
+
+    # Main game loop - handles level progression
+    def play_game_loop
+      loop do
+        result = play_single_game
+
+        if result[:won]
+          # Show win screen and get score
+          score = Screens::Win.new(
+            guesses: result[:guesses],
+            time: result[:time],
+            level: @current_level,
+            word: result[:word]
+          ).show
+
+          # Update stats
+          update_stats(won: true, score: score)
+
+          # Show play again prompt
+          choice = Screens::PlayAgain.new(won: true, level: @current_level, score: score).show
+
+          case choice
+          when :next_level
+            @current_level += 1
+          when :menu
+            break
+          when :quit
+            goodbye
+            exit
+          end
+        else
+          # Show lose screen
+          Screens::Lose.new(
+            word: result[:word],
+            level: @current_level,
+            guesses: result[:guesses]
+          ).show
+
+          # Update stats
+          update_stats(won: false, score: 0)
+
+          # Show play again prompt
+          choice = Screens::PlayAgain.new(won: false, level: @current_level).show
+
+          case choice
+          when :retry
+            # Same level, try again
+            next
+          when :menu
+            break
+          when :quit
+            goodbye
+            exit
+          end
+        end
+      end
+    end
+
+    # Play a single round
+    def play_single_game
+      # Fetch a word for this game
+      word = fetch_word
+
+      # Run gameplay screen
+      gameplay = Screens::Gameplay.new(level: @current_level, target_word: word)
+      result = gameplay.show
+
+      # Add the word to the result
+      result[:word] = word
+      result
+    end
+
+    # Fetch a word from the word service
+    def fetch_word
+      # Show loading spinner while fetching
+      word = nil
+
+      if WordCache.needs_refresh?
+        Cursor.clear_screen
+        word = Animations.spinner(message: "Fetching words") do
+          WordService.next_word
+        end
+      else
+        word = WordService.next_word
+      end
+
+      # Fallback if service fails
+      word || fallback_words.sample
+    end
+
+    # Emergency fallback words if API and cache both fail
+    def fallback_words
+      %w[CRANE HOUSE PLANT BREAD CHAIR MUSIC WATER LIGHT STONE DREAM]
+    end
+
+    # Update session and persistent stats
+    def update_stats(won:, score:)
+      @session_stats[:games] += 1
+      @session_stats[:won] += 1 if won
+      @session_stats[:score] += score
+
+      # Update persistent config
+      @config = Config.record_game(@config, won: won, score: score, level: @current_level)
+
+      # Check for high score
+      return unless won && score.positive?
+
+      player_name = @config[:player_name]
+      HighScores.add(name: player_name, score: score, level: @current_level)
+    end
+
+    def show_high_scores
+      Screens::HighScoresScreen.new(@config).show
+    end
+
+    def handle_profile
+      loop do
+        case Screens::Profile.new(@config).show
+        when :change_name
+          change_name
+        when :reset_stats
+          reset_stats
+        when :delete_all
+          delete_all_data
+          break
+        when :back
+          break
+        end
+      end
+    end
+
+    def change_name
+      name = Screens::NameInput.new(@config, mode: :change).show
+      @config = Config.update_name(@config, name) if name
+    end
+
+    def reset_stats
+      Cursor.clear_screen
+      Cursor.move_to(Screen.center_row, Screen.center_col(30))
+      print Colors.yellow("Reset all statistics? (y/n)")
+
+      loop do
+        key = Input.read_key.to_s.downcase
+        if key == "y"
+          @config = Config.reset_stats(@config)
+          break
+        elsif %w[n escape].include?(key)
+          break
+        end
+      end
+    end
+
+    def delete_all_data
+      Cursor.clear_screen
+      Cursor.move_to(Screen.center_row - 2, Screen.center_col(45))
+      print Colors.red("WARNING: This will delete ALL your data!")
+      Cursor.move_to(Screen.center_row, Screen.center_col(35))
+      print Colors.yellow("Type DELETE to confirm: ")
+      Cursor.show
+
+      input = ""
+      loop do
+        key = Input.read_key
+        case key
+        when :enter
+          break
+        when :escape
+          return
+        when :backspace
+          input = input[0...-1]
+        else
+          input += key.to_s if key.is_a?(String)
+        end
+
+        Cursor.move_to(Screen.center_row, Screen.center_col(35) + 24)
+        print "#{input}    "
+      end
+
+      Cursor.hide
+
+      return unless input == "DELETE"
+
+      Config.delete
+      HighScores.clear
+      WordCache.clear
+      @config = Config.load
+    end
+
+    def show_rules
+      Screens::Rules.new(@config).show
+    end
+
+    def confirm_quit
+      result = Screens::QuitConfirm.new(@config, session_stats: @session_stats).show
+      result == :quit
+    end
+
+    def goodbye
+      Cursor.clear_screen
+      Cursor.move_to(Screen.center_row, Screen.center_col(30))
+      print Colors.cyan("Thanks for playing Mumble!")
+      Cursor.move_to(Screen.center_row + 2, Screen.center_col(15))
+      print Colors.dim("See you soon! 👋")
+      Cursor.move_to(Screen.center_row + 5, 1)
+      Cursor.show
+    end
+  end
+end

metadata

@@ -0,0 +1,137 @@
+--- !ruby/object:Gem::Specification
+name: mumble_game
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Hady Mohamed
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: pastel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+- !ruby/object:Gem::Dependency
+  name: tty-cursor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+- !ruby/object:Gem::Dependency
+  name: tty-reader
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: tty-screen
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+description: Mumble combines Wordle-style word guessing with classic hangman. Guess
+  the 5-letter word before the hangman is complete! Features colorful terminal UI,
+  high scores, and statistics tracking.
+email:
+- devhady87@gmail.com
+executables:
+- mumble
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- bin/mumble
+- lib/mumble.rb
+- lib/mumble/animations.rb
+- lib/mumble/box.rb
+- lib/mumble/colors.rb
+- lib/mumble/config.rb
+- lib/mumble/cursor.rb
+- lib/mumble/error_handler.rb
+- lib/mumble/grid.rb
+- lib/mumble/hangman.rb
+- lib/mumble/high_scores.rb
+- lib/mumble/input.rb
+- lib/mumble/layout.rb
+- lib/mumble/scorer.rb
+- lib/mumble/screen.rb
+- lib/mumble/screens/base.rb
+- lib/mumble/screens/gameplay.rb
+- lib/mumble/screens/high_scores.rb
+- lib/mumble/screens/lose.rb
+- lib/mumble/screens/main_menu.rb
+- lib/mumble/screens/name_input.rb
+- lib/mumble/screens/play_again.rb
+- lib/mumble/screens/profile.rb
+- lib/mumble/screens/quit_confirm.rb
+- lib/mumble/screens/rules.rb
+- lib/mumble/screens/splash.rb
+- lib/mumble/screens/win.rb
+- lib/mumble/storage.rb
+- lib/mumble/version.rb
+- lib/mumble/word_cache.rb
+- lib/mumble/word_service.rb
+homepage: https://github.com/hadym/mumble_game
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/hadym/mumble_game
+  source_code_uri: https://github.com/hadym/mumble_game/tree/main
+  changelog_uri: https://github.com/hadym/mumble_game/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.7.2
+specification_version: 4
+summary: A terminal-based word guessing game with hangman
+test_files: []