reflexion 0.3.15 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8766cf5812e53e4f488c3001691e2635435d0e40a92b336df21a86341d7e810c
-  data.tar.gz: 294139e6497bf2418f1e8f7b0a216b614825d5403ea0badb758e8ac522ca278d
+  metadata.gz: 8781c6a2e533488f1529b59cdb98ed7922909330e254bdbd80b7ce67f40a8252
+  data.tar.gz: 449a81f9c5ba57c2daa68af18cc6e42d90319703beab674dee431e5bc2923d4b
 SHA512:
-  metadata.gz: 872e3a7813e25cc17f481c57baf736204bae91a4f43e03b5f3b5b0273bd5892b8cd018c6cbba2c041d721afdea6103383ea8d54752bf3e01f208107591e72956
-  data.tar.gz: baa908a9c4f4286abc4cf3aa0888ba280e15434348848a21c333f5462a8d4548a4cc3d4fa99b95a89fde45e8b865959307050a6a7cdc2ebb8396aee5cf99e3a5
+  metadata.gz: c746ba6a4b32c05eca98a2bd3c7ab5e459e44222d80794323757a8516401a91404c76aa4e7dbb08b084126bf08d65bf310ab8f3095f06bd2df29577fa7989604
+  data.tar.gz: 928aa64c73861dcb0848dc6c6ea6d770ccb3dff1e9e06ba6bb3cf470cb5104311af6ecfc543d4ca015f8efdc3a12d9bb6662b80014f9fc57a2bbc16c74bf5e43

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

@@ -152,13 +152,13 @@ VALUE get_key(VALUE self)
 		CASE(LCONTROL):
 		CASE(RCONTROL): SYMBOL1(control);
 		CASE(ALT):
-#if !defined(LINUX)
+#if !defined(IOS) && !defined(LINUX) && !defined(WASM)
 		CASE(LALT):
 #endif
 		CASE(RALT):     SYMBOL1(alt);
 		CASE(LWIN):
 		CASE(RWIN):     SYMBOL1(win);
-#if !defined(LINUX)
+#if !defined(IOS) && !defined(LINUX) && !defined(WASM)
 		CASE(LCOMMAND):
 		CASE(RCOMMAND): SYMBOL1(command);
 		CASE(LOPTION):
@@ -198,7 +198,7 @@ VALUE get_key(VALUE self)
 		CASE(NUM_EQUAL):    SYMBOL1(equal);
 		CASE(NUM_COMMA):    SYMBOL1(comma);
 		CASE(NUM_DECIMAL):  SYMBOL1(decimal);
-#if !defined(LINUX)
+#if !defined(IOS) && !defined(LINUX) && !defined(WASM)
 		CASE(NUM_CLEAR):    SYMBOL1(clear);
 #endif
 		CASE(NUM_ENTER):    SYMBOL1(enter);

data/.github/workflows/release-gem.yml

@@ -36,23 +36,9 @@ jobs:
           echo path=$(ruby -e 'print Dir.glob("*.gem").first') >> $GITHUB_OUTPUT
 
       - name: create github release
-        id: release
-        uses: actions/create-release@v1
         env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        with:
-          tag_name: ${{ github.ref }}
-          release_name: ${{ github.ref }}
-
-      - name: upload to github release
-        uses: actions/upload-release-asset@v1
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        with:
-          upload_url: ${{ steps.release.outputs.upload_url }}
-          asset_path: ./${{ steps.gem.outputs.path }}
-          asset_name:   ${{ steps.gem.outputs.path }}
-          asset_content_type: application/zip
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: ruby -I.github/workflows -rutils -e 'release(*ARGV)' ./${{ steps.gem.outputs.path }}
 
       - name: upload to rubygems
         env:

data/ChangeLog.md

@@ -1,6 +1,19 @@
 # reflex ChangeLog
 
 
+## [v0.4.0] - 2026-05-17
+
+- [BREAKING] Normalize wheel Y delta to top-left origin convention
+
+- Add keyboard event handling on iOS
+- Add mouse event handling on iOS
+- Rewrite README.md
+- CI: Migrate release-gem.yml from actions/create-release to gh release create
+- Refresh hello sample Xcode projects
+
+- Skip duplicate KEY_CODE aliases on WASM build
+
+
 ## [v0.3.15] - 2026-05-10
 
 - Support WebAssembly

data/README.md

@@ -1,4 +1,4 @@
-# Reflex - A Graphical User Interface Tool Kit for Ruby.
+# Reflex - A GUI toolkit for Ruby
 
 [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/xord/reflex)
 ![License](https://img.shields.io/github/license/xord/reflex)
@@ -21,19 +21,38 @@ Thanks for your support! 🙌
 
 ## 🚀 About
 
-**Reflex** is a graphical user interface (GUI) toolkit for Ruby.
+**Reflex** is a cross-platform GUI toolkit for Ruby. It gives you a `Window` with a tree of `View` objects, an event-driven runtime (`Application` / `on_draw`, `on_update`, `on_pointer`, ...), and bindings to a 2D physics engine, MIDI I/O, and live camera capture — all sitting on top of the [Rays](https://github.com/xord/rays) drawing engine.
 
-It is designed to help developers create intuitive and responsive user interfaces for their Ruby applications.
-**Reflex** provides core components such as Window and View, making it easier to build the foundation of your GUI applications.
+It is the application layer underneath [Processing](https://github.com/xord/processing), [RubySketch](https://github.com/xord/rubysketch), and [Reight](https://github.com/xord/reight). Like the rest of the `xord/*` family, Reflex is primarily developed for our own use, but it also works as a standalone GUI / creative-coding toolkit.
+
+> **The gem name is `reflexion`** (not `reflex`) — `gem install reflexion`. The Ruby namespace is `Reflex`.
+
+## 📋 Requirements
+
+- Ruby **3.0.0** or later
+- A C++ compiler with C++20 support
+- [Xot](https://rubygems.org/gems/xot), [Rucy](https://rubygems.org/gems/rucy), and [Rays](https://rubygems.org/gems/rays) (declared as runtime dependencies)
+- Platform GUI backend:
+  - **macOS** — AppKit (bundled with the OS)
+  - **iOS** — UIKit (bundled with the OS)
+  - **Windows** — native Win32
+  - **Linux** — `libsdl2-dev`
+
+The following third-party libraries are cloned from GitHub and statically linked while the native extension is being built:
+
+| Library                                       | Role                                |
+| --------------------------------------------- | ----------------------------------- |
+| [Box2D](https://github.com/erincatto/box2d)   | 2D physics simulation (`View` bodies, `ContactEvent`, gravity, fixtures) |
+| [RtMidi](https://github.com/thestk/rtmidi)    | MIDI I/O — exposes `MidiEvent`, `NoteEvent`, `ControlChangeEvent` to views |
 
 ## 📦 Installation
 
 Add this line to your Gemfile:
 ```ruby
-$ gem 'reflexion'
+gem 'reflexion'
 ```
 
-Then, install gem:
+Then install:
 ```bash
 $ bundle install
 ```
@@ -43,7 +62,187 @@ Or install it directly:
 $ gem install reflexion
 ```
 
+`require 'reflex'` automatically calls `Reflex.init!` (and `Rays.init!`) and registers `Reflex.fin!` at exit. Set `$REFLEX_NOAUTOINIT = true` before requiring if you want to manage the lifetime yourself.
+
+## 📚 What's Included
+
+### Application / Window / View
+
+| Class                    | Purpose                                                                 |
+| ------------------------ | ----------------------------------------------------------------------- |
+| `Reflex::Application`    | Run loop; created and started by `Reflex.start { ... }`                 |
+| `Reflex::Window`         | OS-level window with title, frame, flags (closable / resizable / fullscreen / portrait / landscape) |
+| `Reflex::View`           | Recursive UI node: position, size, transform, styles, child views, optional clipping / caching |
+| `Reflex::Screen`         | Information about a display monitor                                     |
+| `Reflex::Timer`          | One-shot or interval timer that delivers `TimerEvent`                   |
+
+### Shapes (drawing + physics body)
+
+A view can carry one or more `Shape` objects that act both as its drawn appearance and as its physics fixture. Built-ins:
+
+- `Reflex::RectShape`
+- `Reflex::EllipseShape`
+- `Reflex::LineShape`
+- `Reflex::PolygonShape` — wraps a `Rays::Polygon`
+
+### Events
+
+Every event class inherits from `Reflex::Event`. Views receive them via `on_<name>` hooks (or `on(:name)` / `before(:name)` / `after(:name)` from `Xot::Hookable`).
+
+| Event class                                          | View hook            | When it fires                                       |
+| ---------------------------------------------------- | -------------------- | --------------------------------------------------- |
+| `UpdateEvent`                                        | `on_update`          | Every frame, before drawing                         |
+| `DrawEvent`                                          | `on_draw`            | Every frame, to render with `e.painter`             |
+| `FrameEvent`                                         | `on_frame_*`         | Frame resize / move                                 |
+| `FocusEvent`                                         | `on_focus`           | Keyboard focus gained / lost                        |
+| `KeyEvent`                                           | `on_key`             | Key down / up / repeat                              |
+| `PointerEvent`                                       | `on_pointer`         | Mouse / touch down / move / up                      |
+| `WheelEvent`                                         | `on_wheel`           | Scroll wheel / trackpad scroll                      |
+| `ScrollEvent`                                        | `on_scroll`          | The view itself scrolled                            |
+| `MidiEvent` / `NoteEvent` / `ControlChangeEvent`     | `on_midi` / `on_note` / `on_control_change` | Incoming MIDI message |
+| `CaptureEvent`                                       | `on_capture`         | New frame from a `Rays::Camera`                     |
+| `TimerEvent`                                         | `on_timer`           | Fired by `start_timer` / `start_interval`           |
+| `ContactEvent`                                       | `on_contact_*`       | Two physics bodies began / ended overlapping        |
+| `DeviceEvent` / `MotionEvent`                        | various              | Device-level signals (accelerometer / gyro / connection) |
+
+### Styling and selectors
+
+`Reflex::Style` and `Reflex::Selector` (with `HasSelector`) provide a lightweight CSS-style mechanism for setting background, padding, layout, etc., on views.
+
+### Two ways to use the gem
+
+The gem ships **two complementary APIs**:
+
+1. **`require 'reflex'`** — the full OO API. Subclass `Reflex::Window`, override `on_draw` / `on_update` / `on_pointer`, build a view hierarchy, etc.
+2. **`require 'reflexion/include'`** — a single-file, Processing-style API that exposes top-level `setup`, `draw`, `update`, `key`, `pointer`, `motion` blocks and auto-starts the application on `at_exit`.
+
+## 💡 Usage
+
+### Hello, Reflex (OO style)
+
+```ruby
+require 'reflex'
+
+class HelloWindow < Reflex::Window
+  def initialize
+    super title: 'Hello Reflex!', frame: [100, 100, 320, 240]
+    painter.font = Reflex::Font.new('Menlo', 32)
+    painter.background = 0
+    painter.fill = 1
+  end
+
+  def on_draw(e)
+    e.painter.text 'hello world!', 5, 5
+  end
+
+  def on_update(e)
+    painter.background = rand, rand, rand
+    redraw
+  end
+end
+
+Reflex.start do
+  HelloWindow.new.show
+end
+```
+
+### Block / DSL style
+
+```ruby
+require 'reflex'
+
+Reflex.start do
+  Reflex::Window.show title: 'Shapes', frame: [100, 100, 500, 300] do
+    def on_draw(e)
+      e.painter.push do
+        fill   :pink
+        stroke 1
+        stroke_width 2
+        rect    10, 10, 80, 80, 10
+        ellipse 120, 10, 80, 80
+      end
+    end
+  end
+end
+```
+
+### Reflexion (Processing-style single-file)
+
+```ruby
+require 'reflexion/include'
+
+setup do
+  window.title = 'Reflexion!'
+end
+
+draw do |p|
+  p.background 0
+  p.fill 1
+  p.text 'hello from reflexion', 10, 30
+end
+
+pointer do |e|
+  puts "pointer at #{e.pos.to_a.inspect}"
+end
+# Reflexion.start is called automatically at_exit
+```
+
+### 2D physics with Box2D
+
+```ruby
+require 'reflex'
+
+Reflex.start name: 'Physics' do |app|
+  Reflex::Window.show title: app.name, frame: [100, 100, 500, 500] do
+    gravity 0, 9.8 * meter
+
+    50.times do
+      add Reflex::View.new {
+        pos        rand(10..400), rand(10..100)
+        size       rand(5..50)
+        background [:red, :green, :blue, :yellow, :orange].sample
+        dynamic    true
+        shape      Reflex::EllipseShape.new(density: 1)
+      }
+    end
+
+    add Reflex::View.new {     # a static ground
+      pos        0, 480
+      size       500, 20
+      background :darkgray
+      static     true
+    }
+
+    on :pointer do |e|
+      if e.down? || e.drag?
+        add Reflex::View.new(pos: e.pos, size: 10, dynamic: true,
+                             shape: Reflex::EllipseShape.new(density: 1))
+      end
+    end
+  end
+end
+```
+
+See the [`samples/`](./samples) directory for more examples covering shapes, layout, models, MIDI, camera capture, etc.
+
+## 🛠️ Development
+
+```bash
+$ rake vendor   # clone Box2D and RtMidi into vendor/
+$ rake lib      # build the native C++ library (libreflex)
+$ rake ext      # build the Ruby C extension
+$ rake test     # run the test suite
+$ rake doc      # generate RDoc from C++ sources
+$ rake          # default: builds the extension
+```
+
+The test suite requires a windowing system, so CI only runs it on macOS. The `test_reflex_init.rb` test must run in its own process and is listed in `TESTS_ALONE`.
+
+In the [`xord/all`](https://github.com/xord/all) monorepo you can scope by module, e.g. `rake reflex test`.
+
 ## 📜 License
 
 **Reflex** is licensed under the MIT License.
 See the [LICENSE](./LICENSE) file for details.
+
+The third-party libraries listed above retain their own licenses (Box2D: MIT, RtMidi: MIT-style).

data/VERSION

@@ -1 +1 @@
-0.3.15
+0.4.0

data/ext/reflex/key_event.cpp

@@ -156,13 +156,13 @@ RUCY_DEF0(get_key)
 		CASE(LCONTROL):
 		CASE(RCONTROL): SYMBOL1(control);
 		CASE(ALT):
-#if !defined(LINUX)
+#if !defined(IOS) && !defined(LINUX) && !defined(WASM)
 		CASE(LALT):
 #endif
 		CASE(RALT):     SYMBOL1(alt);
 		CASE(LWIN):
 		CASE(RWIN):     SYMBOL1(win);
-#if !defined(LINUX)
+#if !defined(IOS) && !defined(LINUX) && !defined(WASM)
 		CASE(LCOMMAND):
 		CASE(RCOMMAND): SYMBOL1(command);
 		CASE(LOPTION):
@@ -202,7 +202,7 @@ RUCY_DEF0(get_key)
 		CASE(NUM_EQUAL):    SYMBOL1(equal);
 		CASE(NUM_COMMA):    SYMBOL1(comma);
 		CASE(NUM_DECIMAL):  SYMBOL1(decimal);
-#if !defined(LINUX)
+#if !defined(IOS) && !defined(LINUX) && !defined(WASM)
 		CASE(NUM_CLEAR):    SYMBOL1(clear);
 #endif
 		CASE(NUM_ENTER):    SYMBOL1(enter);

data/include/reflex/defs.h

@@ -77,12 +77,12 @@ namespace Reflex
 
 		KEY_NONE = -1,
 
-		#if defined(WIN32)
-			#define NATIVE_VK(darwin, win32, sdl) win32
-		#elif defined(LINUX)
-			#define NATIVE_VK(darwin, win32, sdl) sdl
+		#if defined(OSX)
+			#define NATIVE_VK(darwin, win32, hid) darwin
+		#elif defined(WIN32)
+			#define NATIVE_VK(darwin, win32, hid) win32
 		#else
-			#define NATIVE_VK(darwin, win32, sdl) darwin
+			#define NATIVE_VK(darwin, win32, hid) hid
 		#endif
 
 		KEY_A = NATIVE_VK(0x00, 0x41, 0x04),
@@ -231,16 +231,16 @@ namespace Reflex
 		KEY_SECTION     = NATIVE_VK(0x0A, 0xE2, 0x64),
 		KEY_HELP        = NATIVE_VK(0x72, 0x2F, 0x75),
 
-		KEY_EISU           = NATIVE_VK(0x66, -33,  -4),
-		KEY_KANA           = NATIVE_VK(0x68, 0x15, -5),
-		KEY_KANJI          = NATIVE_VK(-18,  0x19, -6),
-		KEY_IME_ON         = NATIVE_VK(-19,  0x16, -7),
-		KEY_IME_OFF        = NATIVE_VK(-20,  0x1A, -8),
-		KEY_IME_MODECHANGE = NATIVE_VK(-21,  0x1F, -9),
-		KEY_CONVERT        = NATIVE_VK(-22,  0x1C, -10),
-		KEY_NONCONVERT     = NATIVE_VK(-23,  0x1D, -11),
-		KEY_ACCEPT         = NATIVE_VK(-24,  0x1E, -12),
-		KEY_PROCESS        = NATIVE_VK(-25,  0xE5, -13),
+		KEY_EISU           = NATIVE_VK(0x66, -33,  0x90),
+		KEY_KANA           = NATIVE_VK(0x68, 0x15, 0x91),
+		KEY_KANJI          = NATIVE_VK(-18,  0x19, 0x94),
+		KEY_IME_ON         = NATIVE_VK(-19,  0x16, -4),
+		KEY_IME_OFF        = NATIVE_VK(-20,  0x1A, -5),
+		KEY_IME_MODECHANGE = NATIVE_VK(-21,  0x1F, -6),
+		KEY_CONVERT        = NATIVE_VK(-22,  0x1C, -7),
+		KEY_NONCONVERT     = NATIVE_VK(-23,  0x1D, -8),
+		KEY_ACCEPT         = NATIVE_VK(-24,  0x1E, -9),
+		KEY_PROCESS        = NATIVE_VK(-25,  0xE5, -10),
 
 		KEY_VOLUME_UP   = NATIVE_VK(0x48, 0xAF, 0x80),
 		KEY_VOLUME_DOWN = NATIVE_VK(0x49, 0xAE, 0x81),
@@ -248,19 +248,19 @@ namespace Reflex
 
 		KEY_SLEEP  = NATIVE_VK(-26, 0x5F, 0x11A),
 		KEY_EXEC   = NATIVE_VK(-27, 0x2B, 0x74),
-		KEY_PRINT  = NATIVE_VK(-28, 0x2A, -14),
+		KEY_PRINT  = NATIVE_VK(-28, 0x2A, -11),
 		KEY_APPS   = NATIVE_VK(-29, 0x5D, 0x65),
 		KEY_SELECT = NATIVE_VK(-30, 0x29, 0x77),
 		KEY_CLEAR  = NATIVE_VK(-31, 0x0C, 0x9C),
 
-		KEY_NAVIGATION_VIEW   = NATIVE_VK(-32, 0x88, -15),
-		KEY_NAVIGATION_MENU   = NATIVE_VK(-33, 0x89, -16),
-		KEY_NAVIGATION_UP     = NATIVE_VK(-34, 0x8A, -17),
-		KEY_NAVIGATION_DOWN   = NATIVE_VK(-35, 0x8B, -18),
-		KEY_NAVIGATION_LEFT   = NATIVE_VK(-36, 0x8C, -19),
-		KEY_NAVIGATION_RIGHT  = NATIVE_VK(-37, 0x8D, -20),
-		KEY_NAVIGATION_ACCEPT = NATIVE_VK(-38, 0x8E, -21),
-		KEY_NAVIGATION_CANCEL = NATIVE_VK(-39, 0x8F, -22),
+		KEY_NAVIGATION_VIEW   = NATIVE_VK(-32, 0x88, -12),
+		KEY_NAVIGATION_MENU   = NATIVE_VK(-33, 0x89, -13),
+		KEY_NAVIGATION_UP     = NATIVE_VK(-34, 0x8A, -14),
+		KEY_NAVIGATION_DOWN   = NATIVE_VK(-35, 0x8B, -15),
+		KEY_NAVIGATION_LEFT   = NATIVE_VK(-36, 0x8C, -16),
+		KEY_NAVIGATION_RIGHT  = NATIVE_VK(-37, 0x8D, -17),
+		KEY_NAVIGATION_ACCEPT = NATIVE_VK(-38, 0x8E, -18),
+		KEY_NAVIGATION_CANCEL = NATIVE_VK(-39, 0x8F, -19),
 
 		KEY_BROWSER_BACK      = NATIVE_VK(-40, 0xA6, 0x10E),
 		KEY_BROWSER_FORWARD   = NATIVE_VK(-41, 0xA7, 0x10F),

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.12'
-  s.add_dependency 'rucy',  '~> 0.3.12'
-  s.add_dependency 'rays',  '~> 0.3.12'
+  s.add_dependency 'xot',   '~> 0.3.13'
+  s.add_dependency 'rucy',  '~> 0.3.13'
+  s.add_dependency 'rays',  '~> 0.3.13'
 
   s.files            = `git ls-files`.split $/
   s.executables      = s.files.grep(%r{^bin/}) {|f| File.basename f}

data/samples/bats.rb

@@ -24,7 +24,7 @@ win = Reflex::Window.new do
       angle = 0
       speed = (rand * 2 - 1) * 30
 
-      on :update do
+      on :update do |e|
         move_by rand(5) - 2, rand(5) - 2
         angle += speed
         angle %= 360
@@ -71,7 +71,7 @@ win = Reflex::Window.new do
   end
 
   add Reflex::TextView.new {
-    set name: :count, pos: [10, 10], model: model
+    set name: :count, frame: [10, 10, 100, 30], model: model
   }
 
   root.on :draw do |e|

data/samples/ios/hello/hello/main.cpp

@@ -21,7 +21,7 @@ class Win : public Window
 
 		void on_draw (DrawEvent* e)
 		{
-			e->painter->text(stringf("%f", e->fps), 10, 10);
+			e->painter()->text(stringf("%f", e->fps()), 10, 10);
 		}
 
 };// Window
@@ -64,8 +64,8 @@ class App : public Application
 
 				win->root()->add_child(view);
 
-				view->body()->set_dynamic(true);
-				view->body()->set_density(1);
+				view->set_dynamic(true);
+				view->set_density(1);
 			}
 		}