sfml3-rb 0.2.1-x86-linux-gnu → 0.3.0-x86-linux-gnu

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 84809cc4c794953cd58bf5e6b31f3385c6ea182a598ed088b0182e988df24b5b
-  data.tar.gz: cfe291ff0fadfcaf2c42d494ab93d848086b63e33b39d32458436f65d25ca9af
+  metadata.gz: 519b659696edf580859c4b1d648d67befe964cda1b2e2fcabff9695a0d84024f
+  data.tar.gz: 2af12270fff878dbeda6c6dae4a5c9ea1c73d0b6f3e2d24815d1ce5d528d5a28
 SHA512:
-  metadata.gz: 57d54f51846fe483d5b7b271309b91790bba97732246c53f4ebe2be5573956ee637a4aa023cf3b39838274fe4b905901d850473eb83ba74a98b8ad372558ba1e
-  data.tar.gz: 59fee398a04effffa6fb60d0cd7cb4cbe58fd5ae787ee5a8b302d1c9df88c32b02c9188060731d494164aa59badc1dcc0902e47b8bab5abeb2a6827cf3a90d64
+  metadata.gz: fd11b7c1a2da069e4f8da9fa79ad2623f126f19bd970420f98561127a9e785c63f6acff50aabc94a5c6d75766fe95927031d4cf7907f1141941690f5c548488f
+  data.tar.gz: 200a5fbcec6896e072cf437ce7c2f53473915eaa3eccfc6416affa79e49d4b75efe73b54ac9dc69f1ab0a670cabade4bc1d6c06ddc6e359d5bcc0c8b123efa02

data/.yardopts

@@ -0,0 +1,9 @@
+--markup markdown
+--output-dir doc
+--title sfml3-rb
+--readme README.md
+ext/**/*.c
+-
+CHANGELOG.md
+TODO.md
+LICENSE.md

data/CHANGELOG.md

@@ -6,6 +6,53 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 
 ## [Unreleased]
 
+## [0.3.0] - 2026-09-19
+
+### Added
+* **Four more experimental binary-gem targets**: `aarch64-linux-musl`, `arm-linux-gnu`
+  (ARMv7 hard-float), `arm-linux-musl`, and `aarch64-mingw-ucrt` (64-bit Windows on ARM).
+  All four ride the same rake-compiler-dock cross-compilation this project already uses for
+  its other targets; none has been run on its target hardware yet, so all are
+  `experimental` in `publish.yaml` like `aarch64-linux-gnu`, `x86_64-darwin` and
+  `arm64-darwin` already were. `script/provision.sh` gained matching cases for the two new
+  glibc/musl Linux targets.
+* `rakelib/package.rake`'s `EXPECTED_ABIS` gained an entry for `aarch64-mingw-ucrt`: its
+  rake-compiler-dock image carries no cross Ruby older than 3.4, so that gem has no floor
+  below it — the same kind of upstream gap `x86-mingw32` already has at the top end.
+* `aarch64-linux-gnu` is now additionally run — not just cross-compiled — by a new
+  `test-arm64.yaml` workflow, on GitHub's hosted `ubuntu-24.04-arm` runner. It stays
+  `experimental` in `publish.yaml` for now; this is the evidence that will eventually
+  justify dropping that flag.
+* ARMv6 (32-bit), RISC-V (rv64gc), PowerPC (ppc64le), and any BSD are deliberately not
+  covered by a binary gem: rake-compiler-dock ships no cross-compilation image for any of
+  them, and building custom cross-toolchain infrastructure for them is a much larger,
+  separate undertaking. The source-gem fallback remains the only path there, unchanged.
+
+### Fixed
+* **A GC race in the audio bindings aborted the process on arm64.** `Sound`, `Music` and
+  `SoundStream` released the GVL inside their `dfree`, but their data types were marked
+  `RUBY_TYPED_FREE_IMMEDIATELY`, so the free could run *during* garbage collection: another
+  thread (Ruby's `Timeout` thread, in the test suite) could then allocate while GC was mid-cycle
+  and Ruby aborted with "object allocation during garbage collection phase". Dropping the flag
+  defers the free to a safe point; releasing the GVL is still what keeps `sf*_destroy` from
+  deadlocking against the audio thread.
+
+### Documentation
+* **Every public class, module, method and constant is documented**, with the
+  result rendered on [rubydoc.info](https://rubydoc.info/gems/sfml3-rb). The
+  comments live beside each binding in `ext/**/*.c`; `rake yard` builds them
+  into `doc/`. Previously the comments carried `call-seq` and `@return` tags
+  but little prose, so rubydoc.info showed a signature with a blank
+  description; every such method now has a sentence of its own.
+* RBS type signatures for the same surface ship in `sig/**/*.rbs`, for IDE
+  completion (Solargraph, RubyMine) and static checking (Sorbet, Steep);
+  `rake rbs` validates them.
+* `.yardopts` ships in the gem, so rubydoc.info generates with the same title,
+  README and extra files as `rake yard`.
+* `rake doc:undoc` fails when a method is left without a description, so the
+  coverage cannot regress silently (`yard stats` uses `blank?` and passes for
+  tag-only comments, which is how the blanks went unnoticed).
+
 ## [0.2.1]
 
 ### Added

data/README.md

@@ -2,12 +2,40 @@
 
 Ruby bindings for [SFML 3](https://www.sfml-dev.org/), via its C API, [CSFML](https://github.com/SFML/CSFML).
 
-## Status
-
-Latest release: **0.2.1**. Bound against **CSFML 3**. See [TODO.md](TODO.md) for which parts of the
-SFML 3 API are ported so far, and [CHANGELOG.md](CHANGELOG.md) for what changed recently.
-
-## Install
+[![Ruby](https://img.shields.io/badge/ruby-3.1%2B-red?style=flat-square)](https://www.ruby-lang.org/)
+[![Test](https://github.com/algaves/sfml3.rb/actions/workflows/test.yaml/badge.svg)](https://github.com/algaves/sfml3.rb/actions/workflows/test.yaml)
+[![Check](https://github.com/algaves/sfml3.rb/actions/workflows/check.yaml/badge.svg)](https://github.com/algaves/sfml3.rb/actions/workflows/check.yaml)
+[![Gem Version](https://img.shields.io/gem/v/sfml3-rb?style=flat-square)](https://rubygems.org/gems/sfml3-rb)
+[![Gem Downloads](https://img.shields.io/gem/dt/sfml3-rb?style=flat-square)](https://rubygems.org/gems/sfml3-rb)
+[![License](https://img.shields.io/badge/license-0BSD-green?style=flat-square)](LICENSE.md)
+
+Latest release: **0.3.0**, bound against **CSFML 3**.
+
+## Features
+
+* **Broad coverage of SFML 3**, bound through CSFML: windows and events, graphics, audio, network,
+  and the system layer, with every `sf*` entry point tracked in [TODO.md](TODO.md).
+* **Precompiled binary gems** for common platforms, with FreeType, SFML 3 and CSFML 3 statically
+  linked in — no toolchain and nothing to install system-wide.
+* **A source fallback everywhere else**, which downloads and builds the pinned, checksum-verified
+  dependencies at install time, so the gem works on macOS, ARM and the BSDs out of the box.
+* **Complete API documentation and types**: every class, module, method and constant is documented
+  on [rubydoc.info](https://rubydoc.info/gems/sfml3-rb) and covered by RBS signatures shipped in
+  the gem.
+* **A close fit to SFML's own model**: classes mirror the C++ types (Window, Texture, Sprite,
+  Sound, ...) minus the parts that only exist in C++, like `std::string` and exceptions.
+
+## Table of Contents
+
+* [Installation](#installation)
+* [Quick Start](#quick-start)
+* [Documentation](#documentation)
+* [Development](#development)
+* [Contributing](#contributing)
+* [Acknowledgements](#acknowledgements)
+* [License](#license)
+
+## Installation
 
 ```sh
 gem install sfml3-rb
@@ -24,11 +52,18 @@ already linked in — no toolchain, no build, nothing to install system-wide:
 | `x86-linux-musl` | 3.1 – 4.0 | 32-bit musl |
 | `x64-mingw-ucrt` | 3.1 – 4.0 | 64-bit Windows, RubyInstaller 3.1+ |
 | `x86-mingw32` | 3.1 – **3.4** | 32-bit Windows |
-| `aarch64-linux-gnu`, `x86_64-darwin`, `arm64-darwin` | 3.1 – 4.0 | experimental, not yet built |
+| `aarch64-linux-gnu` | 3.1 – 4.0 | experimental, cross-built and run on a native arm64 CI runner |
+| `aarch64-linux-musl`, `arm-linux-gnu`, `arm-linux-musl` | 3.1 – 4.0 | experimental, not yet built |
+| `aarch64-mingw-ucrt` | 3.4 – **4.0** | experimental, 64-bit Windows on ARM |
+| `x86_64-darwin`, `arm64-darwin` | 3.1 – 4.0 | experimental, not yet built |
+
+Each gem carries one extension per Ruby ABI. Three gaps come from upstream rather than from this
+project: **RubyInstaller publishes no 32-bit Ruby 4.0**, so `x86-mingw32` stops at 3.4; 64-bit
+Windows before Ruby 3.1 used a different platform (`x64-mingw32`), which is not built; and the
+cross-compilation image for `aarch64-mingw-ucrt` carries no cross Ruby older than 3.4, so that
+gem has no floor below it.
 
-Each gem carries one extension per Ruby ABI. Two gaps come from upstream rather than from this
-project: **RubyInstaller publishes no 32-bit Ruby 4.0**, so `x86-mingw32` stops at 3.4; and 64-bit
-Windows before Ruby 3.1 used a different platform (`x64-mingw32`), which is not built.
+### Building from source
 
 Anywhere else — macOS, ARM, the BSDs — RubyGems falls back to the source gem, which downloads and
 builds FreeType, SFML 3 and CSFML 3 from pinned, checksum-verified tarballs at install time. That
@@ -37,36 +72,39 @@ takes a few minutes and needs:
 * Ruby >= 3.1
 * A C/C++ toolchain and CMake >= 3.22
 * On Linux, the X11/udev/OpenGL development headers SFML links against — these can't be bundled.
-  On Fedora:
 
-  ```sh
-  sudo dnf install cmake gcc-c++ libX11-devel \
-    libXrandr-devel libXcursor-devel libXi-devel systemd-devel libglvnd-devel
-  ```
+On Fedora:
+
+```sh
+sudo dnf install cmake gcc-c++ libX11-devel \
+  libXrandr-devel libXcursor-devel libXi-devel systemd-devel libglvnd-devel
+```
 
-  or on Debian/Ubuntu:
+On Debian/Ubuntu:
 
-  ```sh
-  sudo apt-get install cmake build-essential libx11-dev \
-    libxrandr-dev libxcursor-dev libxi-dev libudev-dev libgl1-mesa-dev
-  ```
+```sh
+sudo apt-get install cmake build-essential libx11-dev \
+  libxrandr-dev libxcursor-dev libxi-dev libudev-dev libgl1-mesa-dev
+```
 
 Each installed gem version builds its own copy; there's no build cache shared across versions.
 
+### Linking against system libraries
+
 To link against a system CSFML 3 instead (no download, no build):
 
 ```sh
 gem install sfml3-rb -- --enable-system-libraries
 ```
 
-## Usage
+## Quick Start
 
 ```ruby
 require 'sfml'
 include SFML
 
 window = Window.new VideoMode.new(640, 480, 32), 'SFML'
-event = Event.new
+event  = Event.new
 
 while window.is_open?
   while window.poll_event! event
@@ -78,7 +116,20 @@ while window.is_open?
 end
 ```
 
-See [`test/hello-world.rb`](test/hello-world.rb) for a fuller example with shapes and transforms.
+Event types are strings (`'closed'`, `'resized'`, `'key-pressed'`, ...); keys and buttons are enums.
+
+See [`test/hello-world.rb`](test/hello-world.rb) for a fuller example with shapes and transforms,
+and [`test/matrix-transformable.rb`](test/matrix-transformable.rb) for a visual demo. Neither is
+part of the test suite.
+
+## Documentation
+
+* [API reference](https://rubydoc.info/gems/sfml3-rb) — every class, module, method and constant,
+  built from the YARD comments in `ext/**/*.c`.
+* RBS type signatures (`sig/**/*.rbs`) ship in the gem for IDE completion (Solargraph, RubyMine)
+  and static type-checking (Sorbet, Steep). Validate them with `rake rbs`.
+* [CHANGELOG.md](CHANGELOG.md) — what changed in each release.
+* [TODO.md](TODO.md) — module-by-module porting coverage and what is deliberately unbound.
 
 ## Development
 
@@ -87,6 +138,8 @@ rake ports    # build the vendored FreeType + SFML 3 + CSFML 3 (rake compile doe
 rake compile  # build the C extension into lib/sfml/
 rake test     # compile, then run the test suite
 rake gem      # build the source gem into pkg/
+rake yard     # build API docs into doc/
+rake rbs      # validate sig/**/*.rbs
 ```
 
 `rake githooks:install` points your checkout at the committed `.githooks/` pre-commit hook, which
@@ -131,9 +184,31 @@ mingw toolchain and the osxcross SDK already provide.
 Binary gems carry one extension per Ruby ABI under `lib/sfml/<major.minor>/`; `lib/sfml.rb` prefers
 that and falls back to the single `lib/sfml/sfml_ext.so` a source build installs.
 
+## Contributing
+
+Bug reports and pull requests are welcome on
+[GitHub](https://github.com/algaves/sfml3.rb/issues). Before opening a pull request:
+
+```sh
+bundle install
+bundle exec rake test   # build the extension and run the suite
+bundle exec rubocop     # lint Ruby (CI enforces this)
+```
+
+Install the pre-commit hook with `bundle exec rake githooks:install` so staged Ruby is linted and
+staged C is formatted automatically. The C build is warning-clean under `SFML_STRICT=1`; keep it
+that way.
+
+## Acknowledgements
+
+This gem would not exist without [SFML](https://www.sfml-dev.org/) and its C binding,
+[CSFML](https://github.com/SFML/CSFML), both maintained by the SFML team. The source build also
+vendors and links FreeType, Ogg, Vorbis and FLAC; see [`ext/ports.rb`](ext/ports.rb) and the
+[LICENSE](LICENSE.md) for their terms.
+
 ## License
 
-[0BSD](LICENSE.md)
+This project is licensed under the BSD Zero Clause License (0BSD) - see the [LICENSE](LICENSE.md) file for details.
 
 ---
 

data/lib/sfml/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SFML
-  VERSION = '0.2.1'
+  VERSION = '0.3.0'
 end

data/sig/audio/audio_enums.rbs

@@ -0,0 +1,30 @@
+module SFML
+  module SoundStatus
+    STOPPED: Integer
+    PAUSED: Integer
+    PLAYING: Integer
+  end
+
+  module SoundChannel
+    UNSPECIFIED: Integer
+    MONO: Integer
+    FRONT_LEFT: Integer
+    FRONT_RIGHT: Integer
+    FRONT_CENTER: Integer
+    FRONT_LEFT_OF_CENTER: Integer
+    FRONT_RIGHT_OF_CENTER: Integer
+    LOW_FREQUENCY_EFFECTS: Integer
+    BACK_LEFT: Integer
+    BACK_RIGHT: Integer
+    BACK_CENTER: Integer
+    SIDE_LEFT: Integer
+    SIDE_RIGHT: Integer
+    TOP_CENTER: Integer
+    TOP_FRONT_LEFT: Integer
+    TOP_FRONT_RIGHT: Integer
+    TOP_FRONT_CENTER: Integer
+    TOP_BACK_LEFT: Integer
+    TOP_BACK_RIGHT: Integer
+    TOP_BACK_CENTER: Integer
+  end
+end

data/sig/audio/listener.rbs

@@ -0,0 +1,16 @@
+module SFML
+  module Listener
+    def self.global_volume: () -> Float
+    def self.global_volume=: (Float value) -> Float
+    def self.position: () -> Vector3
+    def self.position=: (Vector3 value) -> Vector3
+    def self.direction: () -> Vector3
+    def self.direction=: (Vector3 value) -> Vector3
+    def self.velocity: () -> Vector3
+    def self.velocity=: (Vector3 value) -> Vector3
+    def self.up_vector: () -> Vector3
+    def self.up_vector=: (Vector3 value) -> Vector3
+    def self.cone: () -> SoundSourceCone
+    def self.cone=: (SoundSourceCone value) -> SoundSourceCone
+  end
+end

data/sig/audio/music.rbs

@@ -0,0 +1,56 @@
+module SFML
+  class Music
+    def self.from_file: (String path) -> Music
+    def self.from_memory: (String data) -> Music
+    def self.from_stream: (untyped stream) -> Music
+
+    def duration: () -> Time
+    def channel_count: () -> Integer
+    def sample_rate: () -> Integer
+    def channel_map: () -> Array[Symbol]
+    def loop_points: () -> [Time, Time]
+    def loop_points=: ([Time, Time] value) -> [Time, Time]
+
+    def play: () -> self
+    def pause: () -> self
+    def stop: () -> self
+    def status: () -> (:stopped | :paused | :playing)
+    def looping?: () -> bool
+    def looping=: (bool value) -> bool
+    def pitch: () -> Float
+    def pitch=: (Float value) -> Float
+    def pan: () -> Float
+    def pan=: (Float value) -> Float
+    def volume: () -> Float
+    def volume=: (Float value) -> Float
+    def spatialization_enabled?: () -> bool
+    def spatialization_enabled=: (bool value) -> bool
+    def position: () -> Vector3
+    def position=: (Vector3 value) -> Vector3
+    def direction: () -> Vector3
+    def direction=: (Vector3 value) -> Vector3
+    def velocity: () -> Vector3
+    def velocity=: (Vector3 value) -> Vector3
+    def cone: () -> SoundSourceCone
+    def cone=: (SoundSourceCone value) -> SoundSourceCone
+    def doppler_factor: () -> Float
+    def doppler_factor=: (Float value) -> Float
+    def directional_attenuation_factor: () -> Float
+    def directional_attenuation_factor=: (Float value) -> Float
+    def relative_to_listener?: () -> bool
+    def relative_to_listener=: (bool value) -> bool
+    def min_distance: () -> Float
+    def min_distance=: (Float value) -> Float
+    def max_distance: () -> Float
+    def max_distance=: (Float value) -> Float
+    def min_gain: () -> Float
+    def min_gain=: (Float value) -> Float
+    def max_gain: () -> Float
+    def max_gain=: (Float value) -> Float
+    def attenuation: () -> Float
+    def attenuation=: (Float value) -> Float
+    def playing_offset: () -> Time
+    def playing_offset=: (Time value) -> Time
+    def effect_processor=: (Proc proc) -> Proc
+  end
+end

data/sig/audio/sound.rbs

@@ -0,0 +1,51 @@
+module SFML
+  class Sound
+    def self.new: (SoundBuffer buffer) -> Sound
+
+    def copy: () -> Sound
+    def buffer: () -> SoundBuffer
+    def buffer=: (SoundBuffer value) -> SoundBuffer
+
+    def play: () -> self
+    def pause: () -> self
+    def stop: () -> self
+    def status: () -> (:stopped | :paused | :playing)
+    def looping?: () -> bool
+    def looping=: (bool value) -> bool
+    def pitch: () -> Float
+    def pitch=: (Float value) -> Float
+    def pan: () -> Float
+    def pan=: (Float value) -> Float
+    def volume: () -> Float
+    def volume=: (Float value) -> Float
+    def spatialization_enabled?: () -> bool
+    def spatialization_enabled=: (bool value) -> bool
+    def position: () -> Vector3
+    def position=: (Vector3 value) -> Vector3
+    def direction: () -> Vector3
+    def direction=: (Vector3 value) -> Vector3
+    def velocity: () -> Vector3
+    def velocity=: (Vector3 value) -> Vector3
+    def cone: () -> SoundSourceCone
+    def cone=: (SoundSourceCone value) -> SoundSourceCone
+    def doppler_factor: () -> Float
+    def doppler_factor=: (Float value) -> Float
+    def directional_attenuation_factor: () -> Float
+    def directional_attenuation_factor=: (Float value) -> Float
+    def relative_to_listener?: () -> bool
+    def relative_to_listener=: (bool value) -> bool
+    def min_distance: () -> Float
+    def min_distance=: (Float value) -> Float
+    def max_distance: () -> Float
+    def max_distance=: (Float value) -> Float
+    def min_gain: () -> Float
+    def min_gain=: (Float value) -> Float
+    def max_gain: () -> Float
+    def max_gain=: (Float value) -> Float
+    def attenuation: () -> Float
+    def attenuation=: (Float value) -> Float
+    def playing_offset: () -> Time
+    def playing_offset=: (Time value) -> Time
+    def effect_processor=: (Proc proc) -> Proc
+  end
+end

data/sig/audio/sound_buffer.rbs

@@ -0,0 +1,17 @@
+module SFML
+  class SoundBuffer
+    def self.from_file: (String path) -> SoundBuffer
+    def self.from_memory: (String data) -> SoundBuffer
+    def self.from_stream: (untyped stream) -> SoundBuffer
+    def self.from_samples: (Array[Integer] | String samples, Integer channel_count, Integer sample_rate, ?Array[Symbol] channel_map) -> SoundBuffer
+
+    def copy: () -> SoundBuffer
+    def save_to_file: (String path) -> bool
+    def samples: () -> Array[Integer]
+    def sample_count: () -> Integer
+    def sample_rate: () -> Integer
+    def channel_count: () -> Integer
+    def channel_map: () -> Array[Symbol]
+    def duration: () -> Time
+  end
+end

data/sig/audio/sound_buffer_recorder.rbs

@@ -0,0 +1,14 @@
+module SFML
+  class SoundBufferRecorder
+    def self.new: () -> SoundBufferRecorder
+
+    def start: (Integer sample_rate) -> bool
+    def stop: () -> self
+    def sample_rate: () -> Integer
+    def buffer: () -> SoundBuffer
+    def device: () -> String
+    def device=: (String value) -> bool
+    def channel_count: () -> Integer
+    def channel_count=: (Integer value) -> Integer
+  end
+end

data/sig/audio/sound_recorder.rbs

@@ -0,0 +1,17 @@
+module SFML
+  class SoundRecorder
+    def self.new: () -> SoundRecorder
+    def self.available?: () -> bool
+    def self.available_devices: () -> Array[String]
+    def self.default_device: () -> String?
+
+    def start: (Integer sample_rate) -> bool
+    def stop: () -> self
+    def sample_rate: () -> Integer
+    def device: () -> String?
+    def device=: (String value) -> bool
+    def channel_count: () -> Integer
+    def channel_count=: (Integer value) -> Integer
+    def channel_map: () -> Array[Symbol]
+  end
+end

data/sig/audio/sound_source_cone.rbs

@@ -0,0 +1,14 @@
+module SFML
+  class SoundSourceCone
+    def self.new: (Float inner_angle, Float outer_angle, Float outer_gain) -> SoundSourceCone
+
+    def inner_angle: () -> Float
+    def inner_angle=: (Float value) -> Float
+    def outer_angle: () -> Float
+    def outer_angle=: (Float value) -> Float
+    def outer_gain: () -> Float
+    def outer_gain=: (Float value) -> Float
+    def to_a: () -> [Float, Float, Float]
+    def ==: (untyped other) -> bool
+  end
+end

data/sig/audio/sound_stream.rbs

@@ -0,0 +1,51 @@
+module SFML
+  class SoundStream
+    def self.new: (Integer channel_count, Integer sample_rate, ?Array[Symbol] channel_map) -> SoundStream
+
+    def channel_count: () -> Integer
+    def sample_rate: () -> Integer
+    def channel_map: () -> Array[Symbol]
+
+    def play: () -> self
+    def pause: () -> self
+    def stop: () -> self
+    def status: () -> (:stopped | :paused | :playing)
+    def looping?: () -> bool
+    def looping=: (bool value) -> bool
+    def pitch: () -> Float
+    def pitch=: (Float value) -> Float
+    def pan: () -> Float
+    def pan=: (Float value) -> Float
+    def volume: () -> Float
+    def volume=: (Float value) -> Float
+    def spatialization_enabled?: () -> bool
+    def spatialization_enabled=: (bool value) -> bool
+    def position: () -> Vector3
+    def position=: (Vector3 value) -> Vector3
+    def direction: () -> Vector3
+    def direction=: (Vector3 value) -> Vector3
+    def velocity: () -> Vector3
+    def velocity=: (Vector3 value) -> Vector3
+    def cone: () -> SoundSourceCone
+    def cone=: (SoundSourceCone value) -> SoundSourceCone
+    def doppler_factor: () -> Float
+    def doppler_factor=: (Float value) -> Float
+    def directional_attenuation_factor: () -> Float
+    def directional_attenuation_factor=: (Float value) -> Float
+    def relative_to_listener?: () -> bool
+    def relative_to_listener=: (bool value) -> bool
+    def min_distance: () -> Float
+    def min_distance=: (Float value) -> Float
+    def max_distance: () -> Float
+    def max_distance=: (Float value) -> Float
+    def min_gain: () -> Float
+    def min_gain=: (Float value) -> Float
+    def max_gain: () -> Float
+    def max_gain=: (Float value) -> Float
+    def attenuation: () -> Float
+    def attenuation=: (Float value) -> Float
+    def playing_offset: () -> Time
+    def playing_offset=: (Time value) -> Time
+    def effect_processor=: (Proc proc) -> Proc
+  end
+end

data/sig/graphics/blend_mode.rbs

@@ -0,0 +1,29 @@
+module SFML
+  class BlendMode
+    def self.new: () -> BlendMode
+                 | (Symbol | Integer color_src_factor, Symbol | Integer color_dst_factor,
+                    Symbol | Integer color_equation, Symbol | Integer alpha_src_factor,
+                    Symbol | Integer alpha_dst_factor, Symbol | Integer alpha_equation) -> BlendMode
+
+    def color_src_factor: () -> Symbol
+    def color_src_factor=: (Symbol | Integer value) -> Symbol
+    def color_dst_factor: () -> Symbol
+    def color_dst_factor=: (Symbol | Integer value) -> Symbol
+    def color_equation: () -> Symbol
+    def color_equation=: (Symbol | Integer value) -> Symbol
+    def alpha_src_factor: () -> Symbol
+    def alpha_src_factor=: (Symbol | Integer value) -> Symbol
+    def alpha_dst_factor: () -> Symbol
+    def alpha_dst_factor=: (Symbol | Integer value) -> Symbol
+    def alpha_equation: () -> Symbol
+    def alpha_equation=: (Symbol | Integer value) -> Symbol
+    def ==: (untyped other) -> bool
+
+    NONE: BlendMode
+    ALPHA: BlendMode
+    ADD: BlendMode
+    MULTIPLY: BlendMode
+    MIN: BlendMode
+    MAX: BlendMode
+  end
+end

data/sig/graphics/circle.rbs

@@ -0,0 +1,44 @@
+module SFML
+  class Circle
+    include Drawable
+
+    def self.new: (?Float radius) -> Circle
+
+    def copy: () -> Circle
+    def move: (Vector2 | Array[Float] offset) -> self
+    def rotate: (Float angle) -> self
+    def scale!: (Vector2 | Array[Float] factors) -> self
+    def draw: (untyped target, RenderState state) -> nil
+
+    def radius=: (Float value) -> Float
+    def position=: (Vector2 | Array[Float] value) -> Vector2
+    def rotation=: (Float value) -> Float
+    def scale=: (Vector2 | Array[Float] value) -> Vector2
+    def origin=: (Vector2 | Array[Float] value) -> Vector2
+    def fill_color=: (Color value) -> Color
+    def outline_color=: (Color value) -> Color
+    def outline_thickness=: (Float value) -> Float
+    def texture=: (Texture? value) -> Texture?
+    def texture_rect=: (Rect value) -> Rect
+    def point_count=: (Integer value) -> self
+
+    def radius: () -> Float
+    def position: () -> Vector2
+    def rotation: () -> Float
+    def scale: () -> Vector2
+    def origin: () -> Vector2
+    def fill_color: () -> Color
+    def outline_color: () -> Color
+    def outline_thickness: () -> Float
+    def texture: () -> (Texture | nil)
+    def texture_rect: () -> Rect
+    def point_count: () -> Integer
+    def point: (Integer index) -> Vector2
+    def geometric_center: () -> Vector2
+    def local_bounds: () -> Rect
+    def global_bounds: () -> Rect
+    def transform: () -> Array[untyped]
+    def inverse_transform: () -> Array[untyped]
+    def matrix: () -> Array[untyped]
+  end
+end