reflexion 0.3.10 → 0.3.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a97dc146f447fdbb146f25134371e56e3aa589769d9972c922c52ec12476c9ac
-  data.tar.gz: bb35dfed3abf245004e67c1b7e044ee99c940d5e56a8af8a4ef712a8bf18d03a
+  metadata.gz: 93447fb2ba3583e6befbfcb29b591333eeec2078be0ecf37416f9234071410d4
+  data.tar.gz: d73dcb8975948b4d6452c16b21a9ad8ef0fb9f7d0fef67a9e75bf3958f398db3
 SHA512:
-  metadata.gz: 4244aa39f3a5aab1ccca7bf747ae2aa5e6b919c787cba215057c20a2b5f27d4712e4be08e02c63642583859761eceaa085db785ba2e56bbb74bfb05973269c57
-  data.tar.gz: a76ee0ccf4fc1c348b0e08bb24a6090de1e04ec20cfdc4e82aa77a9c137691840dbfe01c652c56a8a5650b640a560d55beed0f40af2988f89a52139b765ae19b
+  metadata.gz: 01e2a180d314a339f07a108c55f051ac9a234b88fd23a404a8e0be94ff42db8159087cd9d0af7d838512c6dc820a52ef999c9ba6bf33441711d6173422b4fffc
+  data.tar.gz: ca60885fadd6e947ad3c740d767a821c825b9c5093c1c575c75461897a9960c923c64d45a91da0df01fd1f3d2882514ba518f82aab4e2c9829c92c4a2612462b

data/.doc/ext/reflex/key_event.cpp

@@ -119,7 +119,7 @@ VALUE get_key(VALUE self)
 		CASE(LBRACKET):   SYMBOL1(lbracket);
 		CASE(RBRACKET):   SYMBOL1(rbracket);
 
-#if defined(OSX) || defined(IOS) || defined(WIN32)
+#if defined(OSX) || defined(IOS) || defined(WIN32) || defined(LINUX)
 		CASE(ENTER):     SYMBOL1(enter);
 #else
 		CASE(ENTER):     SYMBOL1(enter);
@@ -141,12 +141,12 @@ VALUE get_key(VALUE self)
 		CASE(PAGEUP):   SYMBOL1(pageup);
 		CASE(PAGEDOWN): SYMBOL1(pagedown);
 
-#if !defined(OSX) && !defined(IOS)
+#if !defined(OSX) && !defined(IOS) && !defined(LINUX)
 		CASE(SHIFT):
 #endif
 		CASE(LSHIFT):
 		CASE(RSHIFT):   SYMBOL1(shift);
-#if !defined(OSX) && !defined(IOS)
+#if !defined(OSX) && !defined(IOS) && !defined(LINUX)
 		CASE(CONTROL):
 #endif
 		CASE(LCONTROL):

data/.doc/ext/reflex/native.cpp

@@ -47,11 +47,7 @@ void Init_reflex_image_view ();
 
 
 extern "C" void
-#ifdef COCOAPODS
-	Init_reflex_native ()
-#else
-	Init_native ()
-#endif
+Init_reflex_ext ()
 {
 	RUCY_TRY
 

data/CLAUDE.md

@@ -0,0 +1,30 @@
+# Reflex
+
+GUI toolkit for Ruby. Event-driven architecture centered on Window and View.
+
+## Gem Name
+
+The published gem name is **`reflexion`** (not `reflex`).
+
+## External Libraries
+
+- Box2D v2.4.1 — Physics engine
+- RtMidi 6.0.0 — MIDI device support
+
+## Platform-Specific Code
+
+Under `src/`:
+- `src/osx/` — macOS
+- `src/ios/` — iOS
+- `src/win32/` — Windows
+- `src/sdl/` — Linux (SDL2)
+
+## Event System
+
+19+ event types (KeyEvent, PointerEvent, DrawEvent, MidiEvent, etc.).
+View hook methods: `on_draw`, `on_update`, `on_key`, `on_pointer`, etc.
+
+## Testing
+
+- `test_reflex_init.rb` must run alone (`TESTS_ALONE`)
+- CI runs on macOS only (requires GUI)

data/ChangeLog.md

@@ -1,6 +1,26 @@
 # reflex ChangeLog
 
 
+## [v0.3.12] - 2026-04-10
+
+- Work around macOS 15 HID gamepad Y-axis inversion
+
+
+## [v0.3.11] - 2026-04-09
+
+- Add minimal support for SDL2
+- Add 'apt' for install_packages()
+- Check is_blocked() before dispatching wheel event
+- Change C-Extension name from 'native.so' to 'reflex_ext.so'
+- Captured key and pointer events cannot prevent the event from being sent to the window
+- Update dependencies
+
+- Fix coordinate transformation for wheel event
+- Fix touch continuity by using UITouch address as system ID (UP event coords may shift on iOS)
+- Fix USB gamepad not detected on macOS 11+
+- Fix inverted Y-axis stick button events in HID gamepad
+
+
 ## [v0.3.10] - 2025-07-06
 
 - Add deepwiki badge

data/Rakefile

@@ -16,6 +16,8 @@ EXTENSIONS  = [Xot, Rucy, Rays, Reflex]
 GEMNAME     = 'reflexion'
 TESTS_ALONE = ['test/test_reflex_init.rb']
 
+install_packages apt: %w[libsdl2-dev]
+
 use_external_library 'https://github.com/erincatto/box2d',
   tag:    'v2.4.1',
   incdirs: %w[include src],
@@ -29,6 +31,7 @@ use_external_library 'https://github.com/thestk/rtmidi',
     case
     when osx?   then '__MACOSX_CORE__'
     when win32? then '__WINDOWS_MM__'
+    when linux? then '__LINUX_ALSA__'
     end
   }.call,
   &proc {sh %( mkdir rtmidi && cp RtMidi.* rtmidi )}

data/VERSION

@@ -1 +1 @@
-0.3.10
+0.3.12

data/ext/reflex/extconf.rb

@@ -15,13 +15,13 @@ Xot::ExtConf.new Xot, Rucy, Rays, Reflex do
     headers    << 'ruby.h'
     libs.unshift 'gdi32', 'winmm', 'opengl32', 'glew32', 'xinput' if win32?
     frameworks << 'Cocoa' << 'GameController'                     if osx?
-    $LDFLAGS   << ' -Wl,--out-implib=native.dll.a'                if mingw? || cygwin?
+    $LDFLAGS   << ' -Wl,--out-implib=reflex_ext.dll.a'            if mingw? || cygwin?
 
-    unless osx?
+    unless osx? || linux?
       lib_dirs << Rays::Extension.ext_dir
-      libs     << 'rays/native'
+      libs     << 'rays_ext'
     end
   end
 
-  create_makefile 'reflex/native'
+  create_makefile 'reflex_ext'
 end

data/ext/reflex/key_event.cpp

@@ -123,7 +123,7 @@ RUCY_DEF0(get_key)
 		CASE(LBRACKET):   SYMBOL1(lbracket);
 		CASE(RBRACKET):   SYMBOL1(rbracket);
 
-#if defined(OSX) || defined(IOS) || defined(WIN32)
+#if defined(OSX) || defined(IOS) || defined(WIN32) || defined(LINUX)
 		CASE(ENTER):     SYMBOL1(enter);
 #else
 		CASE(ENTER):     SYMBOL1(enter);
@@ -145,12 +145,12 @@ RUCY_DEF0(get_key)
 		CASE(PAGEUP):   SYMBOL1(pageup);
 		CASE(PAGEDOWN): SYMBOL1(pagedown);
 
-#if !defined(OSX) && !defined(IOS)
+#if !defined(OSX) && !defined(IOS) && !defined(LINUX)
 		CASE(SHIFT):
 #endif
 		CASE(LSHIFT):
 		CASE(RSHIFT):   SYMBOL1(shift);
-#if !defined(OSX) && !defined(IOS)
+#if !defined(OSX) && !defined(IOS) && !defined(LINUX)
 		CASE(CONTROL):
 #endif
 		CASE(LCONTROL):

data/ext/reflex/native.cpp

@@ -47,11 +47,7 @@ void Init_reflex_image_view ();
 
 
 extern "C" void
-#ifdef COCOAPODS
-	Init_reflex_native ()
-#else
-	Init_native ()
-#endif
+Init_reflex_ext ()
 {
 	RUCY_TRY
 

data/include/reflex/pointer.h

@@ -21,7 +21,7 @@ namespace Reflex
 
 		public:
 
-			typedef int ID;
+			typedef uintptr_t ID;
 
 			enum Type
 			{

data/lib/reflex/ext.rb

@@ -1,2 +1,2 @@
 require 'rays/ext'
-require 'reflex/native'
+require 'reflex_ext'

data/reflex.gemspec

@@ -25,9 +25,9 @@ Gem::Specification.new do |s|
   s.platform              = Gem::Platform::RUBY
   s.required_ruby_version = '>= 3.0.0'
 
-  s.add_dependency 'xot',   '~> 0.3.9', '>= 0.3.9'
-  s.add_dependency 'rucy',  '~> 0.3.9', '>= 0.3.9'
-  s.add_dependency 'rays',  '~> 0.3.9', '>= 0.3.9'
+  s.add_dependency 'xot',   '~> 0.3.10'
+  s.add_dependency 'rucy',  '~> 0.3.10'
+  s.add_dependency 'rays',  '~> 0.3.10'
 
   s.files            = `git ls-files`.split $/
   s.executables      = s.files.grep(%r{^bin/}) {|f| File.basename f}

data/src/event.cpp

@@ -1,6 +1,7 @@
 #include "event.h"
 
 
+#include <string.h>
 #include <algorithm>
 #include "reflex/device.h"
 #include "reflex/timer.h"

data/src/gamepad.cpp

@@ -1,6 +1,7 @@
 #include "gamepad.h"
 
 
+#include <string.h>
 #include <algorithm>
 #include "reflex/exception.h"
 #include "application.h"
@@ -87,6 +88,21 @@ namespace Reflex
 		return it->get();
 	}
 
+	Gamepad*
+	Gamepad_find_by_name (const char* name)
+	{
+		if (!name)
+			return NULL;
+
+		auto it = std::find_if(
+			gamepads.begin(), gamepads.end(),
+			[&](auto& gamepad) {return strcmp(gamepad->name(), name) == 0;});
+		if (it == gamepads.end())
+			return NULL;
+
+		return it->get();
+	}
+
 	float
 	Gamepad_get_button_press_threshold ()
 	{

data/src/gamepad.h

@@ -58,6 +58,8 @@ namespace Reflex
 
 	Gamepad* Gamepad_find (void* handle);
 
+	Gamepad* Gamepad_find_by_name (const char* name);
+
 	float Gamepad_get_button_press_threshold ();
 
 

data/src/ios/event.mm

@@ -92,6 +92,7 @@ namespace Reflex
 				(uint) touch.tapCount,
 				action == Pointer::MOVE,
 				touch.timestamp);
+			Pointer_set_system_id(&pointer, (Pointer::ID) touch);
 
 			if (pointer.action() != Pointer::DOWN)
 			{

data/src/midi.cpp

@@ -316,6 +316,7 @@ namespace Reflex
 		if (!manager)
 			invalid_state_error(__FILE__, __LINE__);
 
+		midis.clear();
 		manager.reset();
 	}
 

data/src/osx/gamepad_gc.mm

@@ -149,7 +149,7 @@ namespace Reflex
 	handle_gamepad_events (Gamepad* gamepad, GCController* controller)
 	{
 		GCExtendedGamepad* g = controller.extendedGamepad;
-		if (!gamepad) return;
+		if (!g) return;
 
 		static const Gamepad::Index L = Gamepad::INDEX_LEFT, R = Gamepad::INDEX_RIGHT;
 

data/src/osx/gamepad_hid.mm

@@ -9,6 +9,7 @@
 #import <IOKit/hid/IOHIDDevice.h>
 #import <GameController/GameController.h>
 #include <xot/util.h>
+#include "reflex/application.h"
 #include "reflex/exception.h"
 #include "reflex/debug.h"
 #include "event.h"
@@ -247,7 +248,7 @@ namespace Reflex
 	}
 
 	static void
-	handle_disconnect_event (void* context, IOReturn result, void* sender)
+	unregister_device (void* context, IOReturn result, void* sender)
 	{
 		IOHIDDeviceRef device = (IOHIDDeviceRef) context;
 
@@ -255,6 +256,62 @@ namespace Reflex
 		unregister_to_device_map(device);
 	}
 
+	static void
+	register_device (Application* app, IOHIDDeviceRef device)
+	{
+		IOHIDDeviceRegisterRemovalCallback(device, unregister_device, device);
+		register_to_device_map(device);
+		add_gamepad(app, device);
+	}
+
+	struct PendingDevice
+	{
+
+		Application::Ref app;
+
+		IOHIDDeviceRef device;
+
+		String name;
+
+		PendingDevice (Application* app, IOHIDDeviceRef device, const char* name)
+		:	app(app), device(device), name(name)
+		{
+			CFRetain(device);
+		}
+
+		~PendingDevice ()
+		{
+			CFRelease(device);
+		}
+
+	};// PendingDevice
+
+	static std::vector<std::shared_ptr<PendingDevice>> pending_devices;
+
+	static void
+	register_pending_devices ()
+	{
+		for (auto& pending : pending_devices)
+		{
+			if (!Gamepad_find_by_name(pending->name.c_str()))
+				register_device(pending->app, pending->device);
+		}
+		pending_devices.clear();
+	}
+
+	static void
+	queue_device (Application* app, IOHIDDeviceRef device, const char* name)
+	{
+		pending_devices.push_back(std::make_shared<PendingDevice>(app, device, name));
+		if (pending_devices.size() == 1)
+		{
+			dispatch_after(
+				dispatch_time(DISPATCH_TIME_NOW, (int64_t) (0.5 * NSEC_PER_SEC)),
+				dispatch_get_main_queue(),
+				^{register_pending_devices();});
+		}
+	}
+
 	static void
 	handle_connect_event (
 		void* context, IOReturn result, void* sender, IOHIDDeviceRef device)
@@ -267,13 +324,13 @@ namespace Reflex
 		if (@available(macOS 11.0, *))
 		{
 			if ([GCController supportsHIDDevice: device])
-				return;
+			{
+				String name = get_string_property(device, CFSTR(kIOHIDProductKey));
+				return queue_device(app, device, name);
+			}
 		}
 
-		IOHIDDeviceRegisterRemovalCallback(device, handle_disconnect_event, device);
-
-		register_to_device_map(device);
-		add_gamepad(app, device);
+		register_device(app, device);
 	}
 
 	enum
@@ -388,8 +445,11 @@ namespace Reflex
 		float range = min == max ? max : max - min;
 		if (range == 0) range = 1;
 
-		float linear   = (value - min) / range;
-		float centered = linear * 2 - 1;
+		float linear    = (value - min) / range;
+		float xcentered = linear * 2 - 1;
+		float ycentered = xcentered;
+		if (NSProcessInfo.processInfo.operatingSystemVersion.majorVersion == 15)
+			ycentered = -ycentered;
 
 		#define HANDLE_DPAD(stick, neg, pos, var, value) \
 			handle_stick_dpad_event( \
@@ -410,32 +470,32 @@ namespace Reflex
 			case HIDGamepadData::RSTICK_RxRy:
 				switch (usage)
 				{
-					case kHIDUsage_GD_X:  HANDLE_DPAD(LSTICK, LEFT, RIGHT, sticks[0].x,  centered); break;
-					case kHIDUsage_GD_Y:  HANDLE_DPAD(LSTICK, UP,   DOWN,  sticks[0].y, -centered); break;
-					case kHIDUsage_GD_Rx: HANDLE_DPAD(RSTICK, LEFT, RIGHT, sticks[1].x,  centered); break;
-					case kHIDUsage_GD_Ry: HANDLE_DPAD(RSTICK, UP,   DOWN,  sticks[1].y, -centered); break;
-					case kHIDUsage_GD_Z:  HANDLE_TRIGGER(LTRIGGER,         triggers[0],  linear);   break;
-					case kHIDUsage_GD_Rz: HANDLE_TRIGGER(RTRIGGER,         triggers[1],  linear);   break;
+					case kHIDUsage_GD_X:  HANDLE_DPAD(LSTICK, LEFT, RIGHT, sticks[0].x,  xcentered); break;
+					case kHIDUsage_GD_Y:  HANDLE_DPAD(LSTICK, DOWN, UP,    sticks[0].y, -ycentered); break;
+					case kHIDUsage_GD_Rx: HANDLE_DPAD(RSTICK, LEFT, RIGHT, sticks[1].x,  xcentered); break;
+					case kHIDUsage_GD_Ry: HANDLE_DPAD(RSTICK, DOWN, UP,    sticks[1].y, -ycentered); break;
+					case kHIDUsage_GD_Z:  HANDLE_TRIGGER(LTRIGGER,         triggers[0],  linear);    break;
+					case kHIDUsage_GD_Rz: HANDLE_TRIGGER(RTRIGGER,         triggers[1],  linear);    break;
 				}
 				break;
 
 			case HIDGamepadData::RSTICK_ZRz:
 				switch (usage)
 				{
-					case kHIDUsage_GD_X:  HANDLE_DPAD(LSTICK, LEFT, RIGHT, sticks[0].x,  centered); break;
-					case kHIDUsage_GD_Y:  HANDLE_DPAD(LSTICK, UP,   DOWN,  sticks[0].y, -centered); break;
-					case kHIDUsage_GD_Z:  HANDLE_DPAD(RSTICK, LEFT, RIGHT, sticks[1].x,  centered); break;
-					case kHIDUsage_GD_Rz: HANDLE_DPAD(RSTICK, UP,   DOWN,  sticks[1].y, -centered); break;
-					case kHIDUsage_GD_Rx: HANDLE_TRIGGER(LTRIGGER,         triggers[0],  linear);   break;
-					case kHIDUsage_GD_Ry: HANDLE_TRIGGER(RTRIGGER,         triggers[1],  linear);   break;
+					case kHIDUsage_GD_X:  HANDLE_DPAD(LSTICK, LEFT, RIGHT, sticks[0].x,  xcentered); break;
+					case kHIDUsage_GD_Y:  HANDLE_DPAD(LSTICK, DOWN, UP,    sticks[0].y, -ycentered); break;
+					case kHIDUsage_GD_Z:  HANDLE_DPAD(RSTICK, LEFT, RIGHT, sticks[1].x,  xcentered); break;
+					case kHIDUsage_GD_Rz: HANDLE_DPAD(RSTICK, DOWN, UP,    sticks[1].y, -ycentered); break;
+					case kHIDUsage_GD_Rx: HANDLE_TRIGGER(LTRIGGER,         triggers[0],  linear);    break;
+					case kHIDUsage_GD_Ry: HANDLE_TRIGGER(RTRIGGER,         triggers[1],  linear);    break;
 				}
 				break;
 
 			default:
 				switch (usage)
 				{
-					case kHIDUsage_GD_X:  HANDLE_DPAD(LSTICK, LEFT, RIGHT, sticks[0].x,  centered); break;
-					case kHIDUsage_GD_Y:  HANDLE_DPAD(LSTICK, UP,   DOWN,  sticks[0].y, -centered); break;
+					case kHIDUsage_GD_X:  HANDLE_DPAD(LSTICK, LEFT, RIGHT, sticks[0].x,  xcentered); break;
+					case kHIDUsage_GD_Y:  HANDLE_DPAD(LSTICK, DOWN, UP,    sticks[0].y, -ycentered); break;
 				}
 				break;
 		}
@@ -555,6 +615,8 @@ namespace Reflex
 		if (!manager)
 			invalid_state_error(__FILE__, __LINE__);
 
+		pending_devices.clear();
+
 		IOHIDManagerUnscheduleFromRunLoop(
 			manager, CFRunLoopGetCurrent(), kCFRunLoopDefaultMode);
 		IOHIDManagerClose(manager, kIOHIDOptionsTypeNone);

data/src/queue.h

@@ -58,7 +58,7 @@ namespace Reflex
 
 			std::queue<T> queue;
 
-			std::mutex mutex;
+			mutable std::mutex mutex;
 
 			std::condition_variable condvar;
 

data/src/sdl/application.cpp

@@ -0,0 +1,124 @@
+#include "../application.h"
+
+
+#include <SDL.h>
+#include <xot/time.h>
+#include "reflex/exception.h"
+#include "reflex/debug.h"
+#include "window.h"
+
+
+namespace Reflex
+{
+
+
+	struct ApplicationData : public Application::Data
+	{
+
+		bool quit = false;
+
+	};// ApplicationData
+
+
+	static ApplicationData*
+	get_data (Application* app)
+	{
+		return (ApplicationData*) app->self.get();
+	}
+
+	static const ApplicationData*
+	get_data (const Application* app)
+	{
+		return get_data(const_cast<Application*>(app));
+	}
+
+	Application::Data*
+	Application_create_data ()
+	{
+		return new ApplicationData();
+	}
+
+
+	static bool
+	dispatch_window_event (const SDL_Event& event)
+	{
+		SDL_Window* native = SDL_GetWindowFromID(event.key.windowID);
+		if (!native) return false;
+
+		Window* win = Window_from(native);
+		if (!win) return false;
+
+		return Window_dispatch_event(win, event);
+	}
+
+	static bool
+	dispatch_events ()
+	{
+		SDL_Event event;
+		while (SDL_PollEvent(&event))
+		{
+			if (dispatch_window_event(event))
+				continue;
+
+			switch (event.type)
+			{
+				case SDL_QUIT: return false;
+			}
+		}
+
+		return true;
+	}
+
+	static void
+	update_all_windows (Application* app)
+	{
+		for (auto it = app->window_begin(), end = app->window_end(); it != end; ++it)
+			Window_update(it->get());
+	}
+
+	void
+	Application::start ()
+	{
+		Event e;
+		Application_call_start(this, &e);
+
+		ApplicationData* self = get_data(this);
+
+		double prev = Xot::time();
+		while (!self->quit)
+		{
+			if (!dispatch_events()) break;
+
+			static const double INTERVAL  = 1.0 / 60.0;
+			static const double SLEEPABLE = INTERVAL * 0.9;
+
+			double now = Xot::time();
+			double dt  = now - prev;
+			if (dt < INTERVAL)
+			{
+				if (dt < SLEEPABLE) SDL_Delay(1);
+				continue;
+			}
+
+			update_all_windows(this);
+			prev = now;
+		}
+	}
+
+	void
+	Application::quit ()
+	{
+		Event e;
+		Application_call_quit(this, &e);
+		if (e.is_blocked()) return;
+
+		get_data(this)->quit = true;
+	}
+
+	void
+	Application::on_about (Event* e)
+	{
+	}
+
+
+}// Reflex

data/src/sdl/device.cpp

@@ -0,0 +1,18 @@
+#include "reflex/device.h"
+
+
+#include "reflex/exception.h"
+
+
+namespace Reflex
+{
+
+
+	void
+	vibrate ()
+	{
+		not_implemented_error(__FILE__, __LINE__);
+	}
+
+
+}// Reflex

data/src/sdl/gamepad.cpp

@@ -0,0 +1,27 @@
+#include "../gamepad.h"
+
+
+#include "reflex/exception.h"
+
+
+namespace Reflex
+{
+
+
+	void
+	Gamepad_init (Application* app)
+	{
+	}
+
+	void
+	Gamepad_fin (Application* app)
+	{
+	}
+
+	void
+	Gamepad_poll ()
+	{
+	}
+
+
+}// Reflex