gemba 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 33c95c309c99b4b2f8161eb0c9d605ab6e42ffc600831799e4565590d3b651c1
+  data.tar.gz: ae2e108992b45760a77d60a21a4aebaf3f20dce42d4f5b0b4b770b310b10d3b2
+SHA512:
+  metadata.gz: c5725d01740bf6646f955163579e9a210a433736bb83a043ac6c4b82348da9a219152163299429276c12ad9a2d8c1a0e32c1684674088a10b22c5729062102f1
+  data.tar.gz: cdaca542e525412429b9692a72b556368b4d121dbebed77b017e87d24801da37808abe8345fe6b3648950f2a6661119775977e275048901460cd08f0f3da904a

data/THIRD_PARTY_NOTICES

@@ -0,0 +1,113 @@
+gemba bundles the following third-party fonts in the assets/ directory.
+Both are licensed under the SIL Open Font License, Version 1.1.
+
+================================================================================
+JetBrains Mono NL
+================================================================================
+
+Copyright 2020 The JetBrains Mono Project Authors
+https://github.com/JetBrains/JetBrainsMono
+
+Licensed under the SIL Open Font License, Version 1.1.
+https://scripts.sil.org/OFL
+
+Used for: FPS overlay and monospaced on-screen indicators.
+
+================================================================================
+Ark Pixel Font (12px, Proportional, Japanese)
+================================================================================
+
+Copyright 2021 TakWolf
+https://github.com/TakWolf/ark-pixel-font
+
+Licensed under the SIL Open Font License, Version 1.1.
+https://scripts.sil.org/OFL
+
+Used for: Toast notifications and UI text overlays (CJK-capable).
+
+================================================================================
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+================================================================================
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The fonts covered by the Open Font License can be used, studied, modified
+and redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply to any
+document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

data/bin/gemba

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# When running from a development checkout (not installed as a gem),
+# add lib/ to the load path and activate Bundler for gem dependencies.
+if File.exist?(File.expand_path("../lib/gemba.rb", __dir__))
+  require "bundler/setup"
+  path = File.expand_path("../lib", __dir__)
+  $LOAD_PATH.unshift(path) unless $LOAD_PATH.include?(path)
+end
+
+require_relative "../lib/gemba/cli"
+
+Gemba::CLI.run

data/ext/gemba/extconf.rb

@@ -0,0 +1,185 @@
+# frozen_string_literal: true
+
+require 'mkmf'
+
+# On Windows (MinGW/UCRT), Ruby's win32.h and mingw-w64's sys/time.h both
+# declare gettimeofday() with incompatible signatures.  Defining this guard
+# suppresses mingw-w64's declaration so Ruby's is the only one in scope.
+# See: https://github.com/rake-compiler/rake-compiler-dock/issues/32
+if RbConfig::CONFIG['host_os'] =~ /mingw|mswin/
+  $CPPFLAGS << ' -D_GETTIMEOFDAY_DEFINED'
+end
+
+# Diagnostic dump for CI debugging — written before any search so we can
+# always see what the environment looks like, even when the build fails.
+def dump_mgba_search_diagnostics
+  puts "=" * 60
+  puts "gemba extconf.rb diagnostics"
+  puts "=" * 60
+  puts "RUBY_PLATFORM:            #{RUBY_PLATFORM}"
+  puts "RbConfig host_os:         #{RbConfig::CONFIG['host_os']}"
+  puts "RbConfig prefix:          #{RbConfig::CONFIG['prefix']}"
+  puts "RbConfig sitearchdir:     #{RbConfig::CONFIG['sitearchdir']}"
+  puts "MGBA_DIR env:             #{ENV['MGBA_DIR'].inspect}"
+  puts "PKG_CONFIG_PATH env:      #{ENV['PKG_CONFIG_PATH'].inspect}"
+  puts "PATH (first 3):           #{ENV['PATH']&.split(File::PATH_SEPARATOR)&.first(3)&.join(', ')}"
+
+  # Check common locations for mgba headers/libs
+  candidates = [
+    RbConfig::CONFIG['prefix'],
+    "#{RbConfig::CONFIG['prefix']}/msys64/ucrt64",
+    '/ucrt64',
+    '/usr',
+    '/usr/local',
+    '/opt/homebrew',
+  ]
+
+  candidates.each do |prefix|
+    inc = "#{prefix}/include/mgba/core/core.h"
+    libs = Dir.glob("#{prefix}/lib/*mgba*") rescue []
+    bins = Dir.glob("#{prefix}/bin/*mgba*") rescue []
+    next if !File.exist?(inc) && libs.empty? && bins.empty?
+    puts "\n  #{prefix}/"
+    puts "    header: #{File.exist?(inc) ? 'FOUND' : 'missing'} (#{inc})"
+    puts "    libs:   #{libs.empty? ? 'none' : libs.join(', ')}"
+    puts "    bins:   #{bins.empty? ? 'none' : bins.join(', ')}"
+  end
+
+  # On Windows, also check what pacman says
+  if RbConfig::CONFIG['host_os'] =~ /mingw|mswin/
+    msys2_root = "#{RbConfig::CONFIG['prefix']}/msys64"
+    pacman = "#{msys2_root}/usr/bin/pacman"
+    if File.exist?(pacman)
+      puts "\npacman -Q mgba:"
+      puts `"#{pacman}" -Q 2>&1`.lines.grep(/mgba/i).map { |l| "  #{l}" }.join
+      puts "pacman -Ql mgba (headers/libs only):"
+      ql = `"#{pacman}" -Ql mingw-w64-ucrt-x86_64-mgba 2>&1`
+      puts ql.lines.grep(/\.(h|a|dll|lib|pc)/).first(20).map { |l| "  #{l}" }.join
+    else
+      puts "\npacman not found at #{pacman}"
+    end
+  end
+
+  puts "=" * 60
+end
+
+dump_mgba_search_diagnostics
+
+def add_mgba_deps
+  # Common dependencies of libmgba (needed when linking statically)
+  $libs << " -lz" unless $libs.include?('-lz')
+  $libs << " -lm" unless $libs.include?('-lm')
+  $libs << " -lpthread" unless $libs.include?('-lpthread')
+
+  # libmgba's static build also links libpng and libzip
+  pkg_config('libpng') || ($libs << " -lpng" unless $libs.include?('-lpng'))
+  pkg_config('libzip') || ($libs << " -lzip" unless $libs.include?('-lzip'))
+
+  # macOS: CoreFoundation for config directory resolution
+  if RUBY_PLATFORM =~ /darwin/
+    $LDFLAGS << " -framework CoreFoundation" unless $LDFLAGS.include?('CoreFoundation')
+  end
+end
+
+def check_mgba
+  have_header('mgba/core/core.h') or return false
+  # Try with deps first (needed for static linking on macOS where
+  # -undefined dynamic_lookup hides missing symbols until runtime)
+  saved_libs = $libs.dup
+  add_mgba_deps
+  return true if have_library('mgba')
+  # Fall back without deps (shared lib on Linux — deps baked into .so)
+  $libs = saved_libs
+  have_library('mgba')
+end
+
+def find_mgba
+  # 1. MGBA_DIR env var (explicit override)
+  if ENV['MGBA_DIR']
+    dir = ENV['MGBA_DIR']
+    $INCFLAGS << " -I#{dir}/include"
+    $LDFLAGS << " -L#{dir}/lib"
+    if check_mgba
+      return true
+    end
+    abort "MGBA_DIR=#{dir} set but libmgba not found there"
+  end
+
+  # 2. Vendor install (from `rake mgba:deps`)
+  vendor_install = File.expand_path('../../vendor/install', __dir__)
+  if File.directory?(vendor_install)
+    $INCFLAGS << " -I#{vendor_install}/include"
+    $LDFLAGS << " -L#{vendor_install}/lib"
+    if check_mgba
+      return true
+    end
+  end
+
+  # 3. pkg-config
+  if pkg_config('mgba')
+    add_mgba_deps
+    return true
+  end
+
+  # 4. Homebrew / common prefix paths (macOS) / system paths (Linux)
+  search_prefixes = [
+    '/opt/homebrew',      # Apple Silicon
+    '/usr/local',         # Intel Homebrew / manual builds
+    '/usr'                # System
+  ]
+
+  # Debian/Ubuntu multiarch lib dirs (e.g. /usr/lib/aarch64-linux-gnu)
+  multiarch_dirs = Dir.glob('/usr/lib/*-linux-gnu').select { |d| File.directory?(d) }
+
+  search_prefixes.each do |prefix|
+    inc = "#{prefix}/include"
+    if File.exist?("#{inc}/mgba/core/core.h")
+      $INCFLAGS << " -I#{inc}"
+      multiarch_dirs.each { |d| $LDFLAGS << " -L#{d}" unless $LDFLAGS.include?(d) }
+      $LDFLAGS << " -L#{prefix}/lib" unless $LDFLAGS.include?("#{prefix}/lib")
+      if check_mgba
+        return true
+      end
+    end
+  end
+
+  # 5. MSYS2/MinGW (Windows) — mgba has no .pc file so pkg-config won't find it
+  if RbConfig::CONFIG['host_os'] =~ /mingw|mswin/
+    ruby_prefix = RbConfig::CONFIG['prefix']
+    msys2_prefixes = [
+      "#{ruby_prefix}/msys64/ucrt64",  # UCRT64 env inside Ruby's MSYS2
+      "#{ruby_prefix}/msys64/mingw64", # MINGW64 env
+      ruby_prefix,                      # Direct prefix (standalone MSYS2)
+    ]
+
+    msys2_prefixes.each do |prefix|
+      inc = "#{prefix}/include"
+      lib = "#{prefix}/lib"
+      if File.exist?("#{inc}/mgba/core/core.h")
+        $INCFLAGS << " -I#{inc}"
+        $LDFLAGS << " -L#{lib}"
+        if check_mgba
+          return true
+        end
+      end
+    end
+  end
+
+  false
+end
+
+unless find_mgba
+  abort <<~MSG
+    libmgba not found. Install it:
+
+      macOS:   rake deps   (builds from source)
+      Debian:  sudo apt install libmgba-dev
+      Windows: pacman -S mingw-w64-ucrt-x86_64-mgba  (MSYS2)
+
+    Or set MGBA_DIR=/path/to/mgba/install
+  MSG
+end
+
+$srcs = ['gemba_ext.c']
+
+create_makefile('gemba_ext')