gemba 0.1.0

data/lib/gemba/input_mappings.rb

@@ -0,0 +1,214 @@
+# frozen_string_literal: true
+
+require 'set'
+
+module Gemba
+  # Virtual keyboard device that tracks key press/release state.
+  # Presents the same interface as an SDL gamepad: +button?+ and +closed?+.
+  class VirtualKeyboard
+    def initialize
+      @held = Set.new
+    end
+
+    def press(keysym)   = @held.add(keysym)
+    def release(keysym) = @held.delete(keysym)
+    def button?(keysym) = @held.include?(keysym)
+    def closed? = false
+  end
+
+  # GBA button label → bitmask (shared by KeyboardMap and GamepadMap)
+  GBA_BTN_BITS = {
+    a: KEY_A, b: KEY_B,
+    l: KEY_L, r: KEY_R,
+    up: KEY_UP, down: KEY_DOWN,
+    left: KEY_LEFT, right: KEY_RIGHT,
+    start: KEY_START, select: KEY_SELECT,
+  }.freeze
+
+  # Manages keyboard keysym → GBA bitmask mappings.
+  #
+  # Shares the same interface as {GamepadMap} so that Player can
+  # delegate to either without knowing which device type is active.
+  class KeyboardMap
+    DEFAULT_MAP = {
+      'z'         => KEY_A,
+      'x'         => KEY_B,
+      'BackSpace' => KEY_SELECT,
+      'Return'    => KEY_START,
+      'Right'     => KEY_RIGHT,
+      'Left'      => KEY_LEFT,
+      'Up'        => KEY_UP,
+      'Down'      => KEY_DOWN,
+      'a'         => KEY_L,
+      's'         => KEY_R,
+    }.freeze
+
+    def initialize(config)
+      @config = config
+      @map = DEFAULT_MAP.dup
+      @device = nil
+      load_config
+    end
+
+    attr_writer :device
+
+    def mask
+      return 0 unless @device
+      m = 0
+      @map.each { |key, bit| m |= bit if @device.button?(key) }
+      m
+    end
+
+    def set(gba_btn, input_key)
+      bit = GBA_BTN_BITS[gba_btn] or return
+      @map.delete_if { |_, v| v == bit }
+      @map[input_key.to_s] = bit
+    end
+
+    def reset!
+      @map = DEFAULT_MAP.dup
+    end
+
+    def load_config
+      cfg = @config.mappings(Config::KEYBOARD_GUID)
+      if cfg.empty?
+        @map = DEFAULT_MAP.dup
+      else
+        @map = {}
+        cfg.each do |gba_str, keysym|
+          bit = GBA_BTN_BITS[gba_str.to_sym]
+          next unless bit
+          @map[keysym] = bit
+        end
+      end
+    end
+
+    def reload!
+      @config.reload!
+      load_config
+    end
+
+    def labels
+      result = {}
+      @map.each do |input, bit|
+        gba_btn = GBA_BTN_BITS.key(bit)
+        result[gba_btn] = input if gba_btn
+      end
+      result
+    end
+
+    def save_to_config
+      @map.each do |input, bit|
+        gba_btn = GBA_BTN_BITS.key(bit)
+        @config.set_mapping(Config::KEYBOARD_GUID, gba_btn, input) if gba_btn
+      end
+    end
+
+    def supports_deadzone? = false
+    def dead_zone_pct = 0
+
+    def set_dead_zone(_)
+      raise NotImplementedError, "keyboard does not support dead zones"
+    end
+  end
+
+  # Manages SDL gamepad button → GBA bitmask mappings.
+  #
+  # Shares the same interface as {KeyboardMap} so that Player can
+  # delegate to either without knowing which device type is active.
+  class GamepadMap
+    DEFAULT_MAP = {
+      a:              KEY_A,
+      b:              KEY_B,
+      back:           KEY_SELECT,
+      start:          KEY_START,
+      dpad_up:        KEY_UP,
+      dpad_down:      KEY_DOWN,
+      dpad_left:      KEY_LEFT,
+      dpad_right:     KEY_RIGHT,
+      left_shoulder:  KEY_L,
+      right_shoulder: KEY_R,
+    }.freeze
+
+    DEFAULT_DEAD_ZONE = 8000
+
+    def initialize(config)
+      @config = config
+      @map = DEFAULT_MAP.dup
+      @device = nil
+      @dead_zone = DEFAULT_DEAD_ZONE
+    end
+
+    attr_accessor :device
+    attr_reader :dead_zone
+
+    def mask
+      return 0 unless @device && !@device.closed?
+      m = 0
+      @map.each { |btn, bit| m |= bit if @device.button?(btn) }
+      m
+    end
+
+    def set(gba_btn, gp_btn)
+      bit = GBA_BTN_BITS[gba_btn] or return
+      @map.delete_if { |_, v| v == bit }
+      @map[gp_btn] = bit
+    end
+
+    def reset!
+      @map = DEFAULT_MAP.dup
+      @dead_zone = DEFAULT_DEAD_ZONE
+    end
+
+    def load_config
+      return unless @device
+      guid = @device.guid rescue return
+      gp_cfg = @config.gamepad(guid, name: @device.name)
+
+      @map = {}
+      gp_cfg['mappings'].each do |gba_str, gp_str|
+        bit = GBA_BTN_BITS[gba_str.to_sym]
+        next unless bit
+        @map[gp_str.to_sym] = bit
+      end
+
+      pct = gp_cfg['dead_zone']
+      @dead_zone = (pct / 100.0 * 32767).round
+    end
+
+    def reload!
+      @config.reload!
+      load_config
+    end
+
+    def labels
+      result = {}
+      @map.each do |input, bit|
+        gba_btn = GBA_BTN_BITS.key(bit)
+        result[gba_btn] = input.to_s if gba_btn
+      end
+      result
+    end
+
+    def save_to_config
+      return unless @device
+      guid = @device.guid rescue return
+      @config.gamepad(guid, name: @device.name)
+      @config.set_dead_zone(guid, dead_zone_pct)
+      @map.each do |gp_btn, bit|
+        gba_btn = GBA_BTN_BITS.key(bit)
+        @config.set_mapping(guid, gba_btn, gp_btn) if gba_btn
+      end
+    end
+
+    def supports_deadzone? = true
+
+    def dead_zone_pct
+      (@dead_zone.to_f / 32767 * 100).round
+    end
+
+    def set_dead_zone(threshold)
+      @dead_zone = threshold.to_i
+    end
+  end
+end

data/lib/gemba/locale.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+require 'yaml'
+
+module Gemba
+  # Lightweight YAML-backed localization. No external gem dependencies.
+  #
+  # @example
+  #   Locale.load('ja')
+  #   Locale.translate('menu.file')           #=> "ファイル"
+  #   Locale.translate('toast.state_saved', slot: 3)  #=> "スロット3にステートをセーブしました"
+  module Locale
+    # Load translations for the given language code.
+    # Falls back to English if the requested locale file doesn't exist.
+    #
+    # @param lang [String, nil] two-letter language code (e.g. 'en', 'ja').
+    #   When nil, auto-detects from the OS environment.
+    # @return [String] the language code that was loaded
+    def self.load(lang = nil)
+      lang = detect_language if lang.nil? || lang == 'auto'
+      path = locale_path(lang)
+      path = locale_path('en') unless File.exist?(path)
+      @strings = YAML.safe_load_file(path)
+      @lang = lang
+    end
+
+    # Look up a translation by dot-separated key, with optional variable
+    # interpolation. Returns the key itself if no translation is found.
+    #
+    # @param key [String] dot-separated path (e.g. 'menu.file', 'toast.state_saved')
+    # @param vars [Hash] interpolation variables — replaces `{name}` in the string
+    # @return [String]
+    def self.translate(key, **vars)
+      parts = key.split('.')
+      str = @strings&.dig(*parts)
+      return key unless str.is_a?(String)
+
+      vars.each { |k, v| str = str.gsub("{#{k}}", v.to_s) }
+      str
+    end
+
+    class << self
+      alias_method :t, :translate
+    end
+
+    # @return [String] the currently loaded language code
+    def self.language
+      @lang
+    end
+
+    # @return [Array<String>] sorted list of available language codes
+    def self.available_languages
+      Dir[locale_path('*')].map { |f| File.basename(f, '.yml') }.sort
+    end
+
+    # Detect the user's preferred language from environment variables.
+    # @return [String] two-letter language code (e.g. 'en', 'ja')
+    # @api private
+    private_class_method def self.detect_language
+      env = ENV['LANG'] || ENV['LC_ALL'] || ENV['LANGUAGE'] || 'en'
+      env[0, 2].downcase
+    end
+
+    # @api private
+    private_class_method def self.locale_path(lang)
+      File.join(__dir__, 'locales', "#{lang}.yml")
+    end
+
+    # Auto-load English on first require so translate() always works,
+    # even when loaded outside the full Gemba boot path.
+    load('en') unless @strings
+
+    # Mixin for classes that need translation access.
+    # Include this to call `translate` / `t` as instance methods.
+    #
+    # @example
+    #   class Player
+    #     include Gemba::Locale::Translatable
+    #     def build_menu
+    #       label: translate('menu.file')
+    #     end
+    #   end
+    module Translatable
+      private
+
+      def translate(key, **vars)
+        Locale.translate(key, **vars)
+      end
+      alias_method :t, :translate
+    end
+  end
+end

data/lib/gemba/locales/en.yml

@@ -0,0 +1,157 @@
+menu:
+  file: "File"
+  open_rom: "Open ROM…"
+  recent: "Recent"
+  quit: "Quit"
+  settings: "Settings"
+  view: "View"
+  fullscreen: "Fullscreen"
+  rom_info: "ROM Info…"
+  emulation: "Emulation"
+  pause: "Pause"
+  resume: "Resume"
+  reset: "Reset"
+  quick_save: "Quick Save"
+  quick_load: "Quick Load"
+  save_states: "Save States…"
+  start_recording: "Start Recording"
+  stop_recording: "Stop Recording"
+
+toast:
+  save_blocked: "Save blocked (too fast)"
+  state_saved: "State saved to slot {slot}"
+  save_failed: "Failed to save state"
+  no_state: "No state in slot {slot}"
+  state_loaded: "State loaded from slot {slot}"
+  load_failed: "Failed to load state"
+  loaded_sav: "Loaded {name}"
+  created_sav: "Created {name}"
+  screenshot_saved: "Screenshot saved: {name}"
+  screenshot_failed: "Screenshot failed"
+  rewound: "Rewound"
+  no_rewind: "No rewind data"
+  paused: "Paused"
+  waiting_for: "Waiting for {label}…"
+  recording_started: "Recording started"
+  recording_stopped: "Recorded {frames} frames"
+
+dialog:
+  game_running_title: "Game Running"
+  game_running_msg: "Another game is running. Switch to {name}?"
+  drop_error_title: "Drop Error"
+  drop_single_file_only: "Please drop a single ROM file."
+  drop_unsupported_type: "Unsupported file type: {ext}"
+  no_rom_in_zip: "No ROM file found in {name}"
+  multiple_roms_in_zip: "Multiple ROM files found in {name}"
+  zip_read_error: "Cannot read ZIP file: {detail}"
+  rom_not_found_title: "ROM Not Found"
+  rom_not_found_msg: "The ROM file no longer exists:\n{path}"
+  reset_gamepad_title: "Reset Gamepad"
+  reset_gamepad_msg: "Reset all gamepad mappings and dead zone to defaults?"
+  reset_hotkeys_title: "Reset Hotkeys"
+  reset_hotkeys_msg: "Reset all hotkey bindings to defaults?"
+  key_conflict_title: "Key Conflict"
+
+settings:
+  video: "Video"
+  audio: "Audio"
+  gamepad: "Gamepad"
+  save_states: "Save States"
+  window_scale: "Window Scale:"
+  turbo_speed: "Turbo Speed:"
+  toast_duration: "Toast Duration:"
+  maintain_aspect: "Maintain aspect ratio"
+  show_fps: "Show FPS"
+  pause_on_focus_loss: "Pause when window loses focus"
+  volume: "Volume:"
+  mute: "Mute"
+  dead_zone: "Dead zone:"
+  undo: "Undo"
+  reset_defaults: "Reset to Defaults"
+  quick_save_slot: "Quick Save Slot:"
+  keep_backup: "Keep backup of previous save state"
+  save: "Save"
+  key_up: "↑ Up"
+  key_down: "↓ Down"
+  key_left: "← Left"
+  key_right: "→ Right"
+  keyboard_only: "Keyboard Only"
+  no_gamepad: "No gamepad detected"
+  uncapped: "Uncapped"
+  press: "Press…"
+  open_config_folder: "Open Config Folder…"
+  hotkeys: "Hotkeys"
+  hk_quit: "Quit"
+  hk_pause: "Pause"
+  hk_fast_forward: "Fast Forward"
+  hk_fullscreen: "Fullscreen"
+  hk_show_fps: "Show FPS"
+  hk_quick_save: "Quick Save"
+  hk_quick_load: "Quick Load"
+  hk_save_states: "Save States"
+  hk_screenshot: "Screenshot"
+  hk_rewind: "Rewind"
+  hk_record: "Record"
+  hk_reset_defaults: "Reset to Defaults"
+  pixel_filter: "Pixel Filter:"
+  filter_nearest: "Nearest Neighbor"
+  filter_linear: "Bilinear"
+  integer_scale: "Integer scaling (no fractional pixels)"
+  color_correction: "GBA color correction"
+  frame_blending: "Frame blending (LCD ghosting)"
+  rewind: "Rewind (jump back in time)"
+  tip_rewind: "Saves periodic snapshots during gameplay.\nPress the rewind hotkey to jump back ~10 seconds."
+  per_game: "Per-game settings"
+  tip_pixel_filter: "Nearest: sharp pixels (original look). Bilinear: smoothed, slightly blurry."
+  tip_integer_scale: "Scales by whole numbers only to avoid blurry sub-pixel artifacts."
+  tip_color_correction: "Adjusts colors to match the original GBA LCD gamma and color crosstalk."
+  tip_frame_blending: "Blends consecutive frames to simulate the GBA LCD's slow pixel response.\nFixes flickering transparency effects in some games (Golden Sun, F-Zero)."
+  tip_dead_zone: "How far the analog stick must move before registering input.\nIncrease if you experience phantom inputs."
+  tip_keep_backup: "Saves a backup copy before overwriting a save state."
+  tip_per_game: "Save separate video, audio, and save state settings for each ROM."
+  tip_turbo_speed: "Fast-forward speed when holding the turbo hotkey."
+  tip_toast_duration: "How long on-screen notifications stay visible."
+  recording: "Recording"
+  recording_compression: "Compression:"
+  tip_recording_compression: "Zlib level for .grec files.\n1 = fastest (default), 6+ has diminishing returns."
+  recordings_folder: "Recordings folder:"
+  open_recordings_folder: "Open Recordings Folder…"
+  gp_a: "A"
+  gp_b: "B"
+  gp_l: "L"
+  gp_r: "R"
+  gp_up: "Up"
+  gp_down: "Down"
+  gp_left: "Left"
+  gp_right: "Right"
+  gp_start: "Start"
+  gp_select: "Select"
+
+picker:
+  title: "Save States"
+  empty: "Empty"
+  no_preview: "No preview"
+  slot: "Slot {n}"
+  close: "Close"
+
+rom_info:
+  title: "ROM Info"
+  field_title: "Title:"
+  game_code: "Game Code:"
+  publisher: "Publisher:"
+  platform: "Platform:"
+  rom_size: "ROM Size:"
+  checksum: "Checksum:"
+  rom_file: "ROM File:"
+  save_file: "Save File:"
+  resolution: "Resolution:"
+  close: "Close"
+  na: "N/A"
+
+player:
+  open_rom_hint: "File > Open ROM…"
+  fps: "{fps} fps"
+  ff: ">> {speed}x"
+  ff_max: ">> MAX"
+  none: "(none)"
+  clear: "Clear"

data/lib/gemba/locales/ja.yml

@@ -0,0 +1,157 @@
+menu:
+  file: "ファイル"
+  open_rom: "ROMを開く…"
+  recent: "最近使ったファイル"
+  quit: "終了"
+  settings: "設定"
+  view: "表示"
+  fullscreen: "フルスクリーン"
+  rom_info: "ROM情報…"
+  emulation: "エミュレーション"
+  pause: "一時停止"
+  resume: "再開"
+  reset: "リセット"
+  quick_save: "クイックセーブ"
+  quick_load: "クイックロード"
+  save_states: "ステートセーブ…"
+  start_recording: "録画開始"
+  stop_recording: "録画停止"
+
+toast:
+  save_blocked: "セーブ制限中（間隔が短すぎます）"
+  state_saved: "スロット{slot}にステートをセーブしました"
+  save_failed: "ステートセーブに失敗しました"
+  no_state: "スロット{slot}にステートがありません"
+  state_loaded: "スロット{slot}からステートをロードしました"
+  load_failed: "ステートロードに失敗しました"
+  loaded_sav: "{name}を読み込みました"
+  created_sav: "{name}を作成しました"
+  screenshot_saved: "スクリーンショットを保存: {name}"
+  screenshot_failed: "スクリーンショットに失敗しました"
+  rewound: "巻き戻しました"
+  no_rewind: "巻き戻しデータがありません"
+  paused: "一時停止"
+  waiting_for: "{label}を待機中…"
+  recording_started: "録画を開始しました"
+  recording_stopped: "{frames}フレームを録画しました"
+
+dialog:
+  game_running_title: "ゲーム実行中"
+  game_running_msg: "別のゲームが実行中です。{name}に切り替えますか？"
+  drop_error_title: "ドロップエラー"
+  drop_single_file_only: "ROMファイルを1つだけドロップしてください。"
+  drop_unsupported_type: "対応していないファイル形式: {ext}"
+  no_rom_in_zip: "{name}にROMファイルが見つかりません"
+  multiple_roms_in_zip: "{name}に複数のROMファイルがあります"
+  zip_read_error: "ZIPファイルを読み込めません: {detail}"
+  rom_not_found_title: "ROMが見つかりません"
+  rom_not_found_msg: "ROMファイルが存在しません:\n{path}"
+  reset_gamepad_title: "ゲームパッドをリセット"
+  reset_gamepad_msg: "すべてのゲームパッド設定をデフォルトに戻しますか？"
+  reset_hotkeys_title: "ホットキーをリセット"
+  reset_hotkeys_msg: "すべてのホットキー設定をデフォルトに戻しますか？"
+  key_conflict_title: "キーの競合"
+
+settings:
+  video: "映像"
+  audio: "音声"
+  gamepad: "ゲームパッド"
+  save_states: "ステートセーブ"
+  window_scale: "ウィンドウ倍率:"
+  turbo_speed: "早送り速度:"
+  toast_duration: "通知表示時間:"
+  maintain_aspect: "アスペクト比を維持"
+  show_fps: "FPSを表示"
+  pause_on_focus_loss: "ウィンドウのフォーカスが外れたら一時停止"
+  volume: "音量:"
+  mute: "ミュート"
+  dead_zone: "デッドゾーン:"
+  undo: "元に戻す"
+  reset_defaults: "デフォルトに戻す"
+  quick_save_slot: "クイックセーブスロット:"
+  keep_backup: "ステートセーブのバックアップを保持"
+  save: "保存"
+  key_up: "↑ 上"
+  key_down: "↓ 下"
+  key_left: "← 左"
+  key_right: "→ 右"
+  keyboard_only: "キーボードのみ"
+  no_gamepad: "ゲームパッドが検出されません"
+  uncapped: "無制限"
+  press: "入力待ち…"
+  open_config_folder: "設定フォルダを開く…"
+  hotkeys: "ホットキー"
+  hk_quit: "終了"
+  hk_pause: "一時停止"
+  hk_fast_forward: "早送り"
+  hk_fullscreen: "フルスクリーン"
+  hk_show_fps: "FPS表示"
+  hk_quick_save: "クイックセーブ"
+  hk_quick_load: "クイックロード"
+  hk_save_states: "ステートセーブ"
+  hk_screenshot: "スクリーンショット"
+  hk_rewind: "巻き戻し"
+  hk_record: "録画"
+  hk_reset_defaults: "デフォルトに戻す"
+  pixel_filter: "ピクセルフィルタ:"
+  filter_nearest: "ニアレストネイバー"
+  filter_linear: "バイリニア"
+  integer_scale: "整数スケーリング（端数ピクセルなし）"
+  color_correction: "GBA色補正"
+  frame_blending: "フレームブレンド（LCD残像）"
+  rewind: "巻き戻し（過去に戻る）"
+  tip_rewind: "プレイ中に定期的にスナップショットを保存します。\n巻き戻しホットキーで約10秒前に戻れます。"
+  per_game: "ゲーム別設定"
+  tip_pixel_filter: "ニアレスト: シャープなピクセル（原寸）。バイリニア: 滑らか、やや不鮮明。"
+  tip_integer_scale: "整数倍のみでスケーリングし、ぼやけたサブピクセルを防止します。"
+  tip_color_correction: "GBA液晶のガンマとカラークロストークに合わせて色を補正します。"
+  tip_frame_blending: "連続フレームをブレンドしてGBA液晶の遅い応答を再現します。\n一部のゲーム（黄金の太陽、F-Zero）のちらつき透明効果を修正します。"
+  tip_dead_zone: "入力を認識するまでのアナログスティックの遊び幅。\n誤入力が発生する場合は増やしてください。"
+  tip_keep_backup: "ステートを上書きする前にバックアップを保存します。"
+  tip_per_game: "ROM毎に映像・音声・ステートセーブの設定を個別に保存します。"
+  tip_turbo_speed: "早送りホットキー使用時の速度。"
+  tip_toast_duration: "画面上の通知の表示時間。"
+  recording: "録画"
+  recording_compression: "圧縮レベル:"
+  tip_recording_compression: ".grecファイルのzlib圧縮レベル。\n1 = 最速（デフォルト）、6以上は効果が小さくなります。"
+  recordings_folder: "録画フォルダ:"
+  open_recordings_folder: "録画フォルダを開く…"
+  gp_a: "A"
+  gp_b: "B"
+  gp_l: "L"
+  gp_r: "R"
+  gp_up: "上"
+  gp_down: "下"
+  gp_left: "左"
+  gp_right: "右"
+  gp_start: "スタート"
+  gp_select: "セレクト"
+
+picker:
+  title: "ステートセーブ"
+  empty: "空"
+  no_preview: "プレビューなし"
+  slot: "スロット{n}"
+  close: "閉じる"
+
+rom_info:
+  title: "ROM情報"
+  field_title: "タイトル:"
+  game_code: "ゲームコード:"
+  publisher: "メーカー:"
+  platform: "プラットフォーム:"
+  rom_size: "ROMサイズ:"
+  checksum: "チェックサム:"
+  rom_file: "ROMファイル:"
+  save_file: "セーブファイル:"
+  resolution: "解像度:"
+  close: "閉じる"
+  na: "N/A"
+
+player:
+  open_rom_hint: "ファイル > ROMを開く…"
+  fps: "{fps} fps"
+  ff: ">> {speed}x"
+  ff_max: ">> 最大"
+  none: "(なし)"
+  clear: "クリア"