rbs 3.9.4 → 4.2.0

data/.github/workflows/wasm.yml

@@ -0,0 +1,55 @@
+name: WebAssembly
+
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+    paths:
+      - ".github/workflows/wasm.yml"
+      - "Rakefile"
+      - "include/**"
+      - "src/**"
+      - "wasm/**"
+  # `merge_group` has no `paths` filter, so this runs on every queue entry.
+  merge_group: {}
+
+permissions:
+  contents: read
+
+env:
+  # Pinned so the smoke test is reproducible. Bump together when upgrading.
+  WASI_SDK_VERSION: "33"
+  WASI_SDK_RELEASE: "33.0"
+  WASMTIME_VERSION: "v47.0.2"
+
+jobs:
+  build:
+    name: wasm:check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+      - run: git fetch --depth=1 origin +refs/tags/*:refs/tags/*
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@95ef2b042f9d7a56d8268cba8559e2842e2ad01b # v1.321.0
+        with:
+          ruby-version: ruby
+          bundler: none
+      - name: Update rubygems & bundler
+        run: gem update --system
+      - name: Install gems
+        run: |
+          bundle config set --local without libs:profilers
+          bundle install --jobs 4 --retry 3
+      - name: Install the WASI SDK
+        run: |
+          url="https://github.com/WebAssembly/wasi-sdk/releases/download/wasi-sdk-${WASI_SDK_VERSION}/wasi-sdk-${WASI_SDK_RELEASE}-x86_64-linux.tar.gz"
+          mkdir -p "$HOME/wasi-sdk"
+          curl -sSL "$url" | tar xz --strip-components=1 -C "$HOME/wasi-sdk"
+          echo "WASI_SDK_PATH=$HOME/wasi-sdk" >> "$GITHUB_ENV"
+      - name: Install wasmtime
+        uses: bytecodealliance/actions/wasmtime/setup@9152e710e9f7182e4c29ad218e4f335a7b203613 # v1.1.3
+        with:
+          version: ${{ env.WASMTIME_VERSION }}
+      - name: Build and smoke-test the WebAssembly module
+        run: bundle exec rake wasm:check

data/.github/workflows/windows.yml

@@ -7,17 +7,20 @@ on:
   pull_request: {}
   merge_group: {}
 
+permissions:
+  contents: read
+
 jobs:
   compile:
     runs-on: "windows-latest"
     strategy:
       fail-fast: false
       matrix:
-        ruby: ['3.2', '3.3', ucrt, mswin]
+        ruby: ['4.0', ucrt, mswin]
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
       - name: load ruby
-        uses: ruby/setup-ruby@v1
+        uses: ruby/setup-ruby@95ef2b042f9d7a56d8268cba8559e2842e2ad01b # v1.321.0
         with:
           ruby-version: ${{ matrix.ruby }}
 
@@ -33,8 +36,11 @@ jobs:
 
             res = URI.parse("https://stdgems.org/bundled_gems.json").read
             bundled_gems = JSON.parse(res)["gems"].map{_1["gem"]}
-            system "gem uninstall --force #{bundled_gems.join(" ")}", exception: true
+            system "gem uninstall #{bundled_gems.join(" ")} --force", exception: true
           '
+      - name: Ignore Gemfile.lock's BUNDLED WITH on dev Ruby
+        if: ${{ matrix.ruby == 'ucrt' || matrix.ruby == 'mswin' }}
+        run: bundle config set --local version system
       - name: bundle install
         run: |
           bundle config set without profilers libs

data/.gitignore

@@ -21,3 +21,19 @@ lib/**/*.dll
 doc/
 
 **/*.gem
+
+# For clangd's editor integration
+ext/rbs_extension/compile_commands.json
+ext/rbs_extension/.cache
+
+# Rust crate vendored RBS source (managed by rake rust:rbs:sync or rust:rbs:symlink)
+rust/ruby-rbs-sys/vendor/rbs/
+rust/ruby-rbs/vendor/rbs/
+
+# Compiled WebAssembly module (built by rake wasm:build)
+wasm/*.wasm
+
+# JRuby runtime artifact (built by rake wasm:jruby_setup, bundled in the -java
+# gem). The require_jar file lib/rbs_jars.rb is committed; the Chicory/ASM jars
+# themselves live in ~/.m2 (jar-dependencies), not here.
+lib/rbs/wasm/*.wasm

data/.rubocop.yml

@@ -1,9 +1,8 @@
-require:
+plugins:
   - rubocop-rubycw
   - rubocop-on-rbs
 
 AllCops:
-  TargetRubyVersion: 3.1
   DisabledByDefault: true
   Exclude:
     - 'vendor/bundle/**/*'

data/CHANGELOG.md

@@ -1,5 +1,507 @@
 # CHANGELOG
 
+## 4.2.0 (2026-08-23)
+
+RBS 4.2 accepts non-ASCII characters in identifiers. Method names, instance variable names and parameter names can be written in any script, and other names may contain non-ASCII characters as long as they start with an ASCII letter, which is what tells a constant from a method name.
+
+```rbs
+class Greeter
+  @挨拶: String
+
+  def こんにちは: () -> String
+end
+```
+
+The parser and the AST support Ruby-style `...` forwarding parameters in method types, but the layers built on top of the parser do not yet. The syntax is disabled by default in 4.2 and is not enabled by the public `RBS::Parser` API, so it cannot be used in regular RBS signatures yet.
+
+Ruby 3.2 reached EOL on 2026-04-01, and this release requires Ruby 3.3 or later. Applications on 3.2 stay on the 4.1 line.
+
+### Signature updates
+
+**Updated classes/modules/methods:** `ERB`, `ERB::DefMethod`, `IO`, `Monitor`, `MonitorMixin::ConditionVariable`, `Singleton`, `StringIO`, `Zlib::GzipFile`, `Zlib::GzipWriter`
+
+* Replace deterministic `untyped` return types with concrete types ([#2966](https://github.com/ruby/rbs/pull/2966))
+* Declare Singleton::SingletonInstanceMethods ([#3037](https://github.com/ruby/rbs/pull/3037))
+
+### Language updates
+
+* Gate forwarding parameter syntax behind parser option ([#3087](https://github.com/ruby/rbs/pull/3087))
+* Support non-ASCII identifiers ([#3082](https://github.com/ruby/rbs/pull/3082))
+* Support forwarding parameters in method types ([#3042](https://github.com/ruby/rbs/pull/3042))
+
+### Library changes
+
+* Drop runtime support for Ruby 3.2 ([#3095](https://github.com/ruby/rbs/pull/3095))
+* Stop the lexer reading past the end of a byte_range ([#3040](https://github.com/ruby/rbs/pull/3040))
+* Exclude CR from comment tokens to fix an off-by-one Location#end_line on CRLF files ([#3069](https://github.com/ruby/rbs/pull/3069))
+* Handle the NULL parser in the WebAssembly shim ([#3085](https://github.com/ruby/rbs/pull/3085))
+* Reject a byte position the lexer cannot start on ([#3083](https://github.com/ruby/rbs/pull/3083))
+* Don't use Clang nullability qualifiers in strict ISO C mode ([#3074](https://github.com/ruby/rbs/pull/3074))
+* Avoid eagerly inspecting call traces in type assertions ([#3073](https://github.com/ruby/rbs/pull/3073))
+* Fix TypeParam.rename to substitute variables in bounds and default types ([#3068](https://github.com/ruby/rbs/pull/3068))
+* Extract per-declaration type param alignment into entry-level align_params ([#3070](https://github.com/ruby/rbs/pull/3070))
+* Align type params across declarations in module-self types and superclass validation ([#3067](https://github.com/ruby/rbs/pull/3067))
+* Build the wasm module with -DNDEBUG ([#3066](https://github.com/ruby/rbs/pull/3066))
+* Rename NODISCARD macro to RBS_NODISCARD ([#3065](https://github.com/ruby/rbs/pull/3065))
+
+### Miscellaneous
+
+* Omit forwarding parameter tests on JRuby ([#3092](https://github.com/ruby/rbs/pull/3092))
+* Skip JSON 2-only tests with JSON 3 ([#3084](https://github.com/ruby/rbs/pull/3084))
+* Pin GitHub Actions to commit hashes ([#3020](https://github.com/ruby/rbs/pull/3020))
+
+## 4.1.3 (2026-08-10)
+
+### Miscellaneous
+
+* Don't use Clang nullability qualifiers in strict ISO C mode ([#3074](https://github.com/ruby/rbs/pull/3074), Backported in [#3075](https://github.com/ruby/rbs/pull/3075))
+* Avoid eagerly inspecting call traces in type assertions ([#3073](https://github.com/ruby/rbs/pull/3073), Backported in [#3076](https://github.com/ruby/rbs/pull/3076))
+
+## 4.1.2 (2026-08-03)
+
+### Miscellaneous
+
+* Keep GC disabled during GC_test#test_stress_and_stress= ([#3061](https://github.com/ruby/rbs/pull/3061))
+* Fix GC_test#test_enable leaving GC disabled for the rest of the suite ([#3059](https://github.com/ruby/rbs/pull/3059))
+
+## 4.1.1 (2026-07-30)
+
+### Library changes
+
+* Include the trailing `?` in a keyword key's symbol location ([#3043](https://github.com/ruby/rbs/pull/3043))
+* Mark `type_name` as optional on the alias annotations ([#3039](https://github.com/ruby/rbs/pull/3039))
+
+### Miscellaneous
+
+* Fix template drift for ext/rbs_extension/ast_translation.c ([#3038](https://github.com/ruby/rbs/pull/3038))
+
+## 4.1.0 (2026-07-27)
+
+RBS 4.1 ships with JRuby support. The RBS parser is written in plain C without depending on the Ruby C API, so it is compiled to WebAssembly and runs on a Wasm runtime, with the parsed AST serialized in a binary format and decoded into RBS objects. The full test suite runs on JRuby in CI.
+
+The inline RBS syntax gets three new features: singleton method definitions (`def self.`), the `module-self` constraint, and instance variable annotations in `module` declarations. Note that RBS inline is still experimental and may change in future releases.
+
+This release also introduces `RBS::Rewriter`, an API to edit RBS source text while preserving the surrounding content, which `rbs annotate` is now built on. Parsing performance is improved by interning type names in a shared trie and reducing allocations per node.
+
+`RBS::Prototype::Runtime`, the RDoc plugin parser, and the top-level `float` type alias are deprecated in this release.
+
+### Signature updates
+
+**Updated classes/modules/methods:** `ARGF`, `Array`, `CSV`, `Class`, `Delegator`, `Digest`, `ERB`, `Enumerable`, `Enumerator`, `Enumerator::Product`, `Etc`, `File`, `File::Constants`, `File::Stat`, `FileUtils`, `Float`, `Gem`, `Hash`, `IO`, `IPAddr`, `Integer`, `JSON`, `Kernel`, `MatchData`, `Module`, `Monitor`, `Numeric`, `ObjectSpace::WeakKeyMap`, `OpenSSL`, `Pathname`, `RBS::Ops`, `Ractor`, `Range`, `Resolv`, `RubyVM::InstructionSequence`, `Set`, `Shellwords`, `String`, `StringIO`, `StringScanner`, `Struct`, `Tempfile`, `Thread`, `Timeout`, `TSort`, `URI::Generic`, `Zlib::GzipReader`, `Zlib::ZStream`
+
+* Remove stale Float constants and add a constant drift test ([#2994](https://github.com/ruby/rbs/pull/2994))
+* Update RDoc comments with Ruby 4.0.6 ([#3035](https://github.com/ruby/rbs/pull/3035))
+* Add a dependency on tempfile. ([#3025](https://github.com/ruby/rbs/pull/3025))
+* Support `%a{implicitly-returns-nil}` on `MatchData#[]` ([#2990](https://github.com/ruby/rbs/pull/2990))
+* Update `Array` ([#2987](https://github.com/ruby/rbs/pull/2987))
+* Allow nil output buffers for reader methods ([#3002](https://github.com/ruby/rbs/pull/3002))
+* Add stdlib signature tests for #2967 ([#2989](https://github.com/ruby/rbs/pull/2989))
+* Update `Integer`, phase 1 ([#2995](https://github.com/ruby/rbs/pull/2995))
+* Add RBS::Ops  ([#2934](https://github.com/ruby/rbs/pull/2934))
+* Update Module ([#2933](https://github.com/ruby/rbs/pull/2933))
+* Correct core/stdlib signatures to match Ruby 4.0 ([#2967](https://github.com/ruby/rbs/pull/2967))
+* Revert Digest::Class method changes ([#2980](https://github.com/ruby/rbs/pull/2980))
+* Add stdlib tests for updated StringScanner signatures ([#2968](https://github.com/ruby/rbs/pull/2968))
+* Update `StringScanner` signatures to match strscan 3.1.6 ([#2959](https://github.com/ruby/rbs/pull/2959))
+* Remove StringScanner methods absent from the latest Ruby release ([#2961](https://github.com/ruby/rbs/pull/2961))
+* Fix `Resolv#initialize` signature: array of resolvers + `use_ipv6:` ([#2960](https://github.com/ruby/rbs/pull/2960))
+* [Hash] Update Hash's signatures and tests to be correct ([#2694](https://github.com/ruby/rbs/pull/2694))
+* update rbs signatures to be more consistent with generics ([#2867](https://github.com/ruby/rbs/pull/2867))
+* Use top-level `path` in fileutils.rbs to suppress deprecation warning ([#2949](https://github.com/ruby/rbs/pull/2949))
+* Update File::Constants and File::Stat ([#2942](https://github.com/ruby/rbs/pull/2942))
+* Add signature for `RubyVM::InstructionSequence.of` ([#2916](https://github.com/ruby/rbs/pull/2916))
+* fix OpenSSL#session_new_cb signature ([#2924](https://github.com/ruby/rbs/pull/2924))
+* [Class] update class.rbs ([#2898](https://github.com/ruby/rbs/pull/2898))
+* Deprecate top-level float ([#2695](https://github.com/ruby/rbs/pull/2695))
+* [Kernel] Updated querying methods ([#2685](https://github.com/ruby/rbs/pull/2685))
+
+### Library changes
+
+* Convert character offset to byte offset in parse_inline_*_annotation ([#2945](https://github.com/ruby/rbs/pull/2945))
+* Guard against underflow when sysconf(_SC_PAGESIZE) returns 0 ([#3031](https://github.com/ruby/rbs/pull/3031))
+* Report invalid UTF-8 byte in a comment as a parsing error ([#2983](https://github.com/ruby/rbs/pull/2983))
+* Fetch Chicory/ASM jars from Maven instead of bundling in gem ([#3019](https://github.com/ruby/rbs/pull/3019))
+* Add write barrier protection to RBS Location objects ([#3022](https://github.com/ruby/rbs/pull/3022))
+* Rename parameter in rbs_intern_type_name for clarity ([#3023](https://github.com/ruby/rbs/pull/3023))
+* Deprecate RDoc plugin parser ([#3016](https://github.com/ruby/rbs/pull/3016))
+* Run the test suite on JRuby (JRuby support, step 4) ([#3008](https://github.com/ruby/rbs/pull/3008))
+* Run the RBS parser on JRuby via WebAssembly (JRuby support, step 3) ([#3000](https://github.com/ruby/rbs/pull/3000))
+* Add binary serialization of the parsed AST (JRuby support, step 2) ([#2999](https://github.com/ruby/rbs/pull/2999))
+* Build the RBS parser as a WebAssembly module (JRuby support, step 1) ([#2998](https://github.com/ruby/rbs/pull/2998))
+* Reject reversed position ranges in parser/lexer entrypoints ([#2974](https://github.com/ruby/rbs/pull/2974))
+* Fix lexer infinite loop / abort on invalid UTF-8 byte ([#2973](https://github.com/ruby/rbs/pull/2973))
+* Flyweight TypeName / Namespace cached in a shared trie ([#2957](https://github.com/ruby/rbs/pull/2957))
+* Reduce Hash allocation per `Node` creation ([#2946](https://github.com/ruby/rbs/pull/2946))
+* Tidy `ast_translation.c` ([#2947](https://github.com/ruby/rbs/pull/2947))
+* Auto-generate rbs_ast_ruby_annotations_t union from config.yml ([#2939](https://github.com/ruby/rbs/pull/2939))
+* Speed up RBS::InlineParser on large sources with non-ASCII characters ([#2950](https://github.com/ruby/rbs/pull/2950))
+* Support `def self.method_name` singleton method in inline parser ([#2935](https://github.com/ruby/rbs/pull/2935))
+* This is not prism ([#2951](https://github.com/ruby/rbs/pull/2951))
+* Add RBS::Rewriter and use it in rbs annotate ([#2927](https://github.com/ruby/rbs/pull/2927))
+* Add nullability annotations to AST pointer types ([#2922](https://github.com/ruby/rbs/pull/2922))
+* Support `module-self` inline annotation ([#2921](https://github.com/ruby/rbs/pull/2921))
+* Inline instance variable annotation in module declaration ([#2919](https://github.com/ruby/rbs/pull/2919))
+
+#### rbs prototype
+
+* Fix nested declarations in rbs prototype rbi ([#3029](https://github.com/ruby/rbs/pull/3029))
+* Deprecate prototype runtime ([#2956](https://github.com/ruby/rbs/pull/2956))
+
+#### rbs collection
+
+* Clean up partial clone before falling back to full clone ([#2978](https://github.com/ruby/rbs/pull/2978))
+* Suppress spurious warning for non-gem stdlib libraries ([#2929](https://github.com/ruby/rbs/pull/2929))
+
+### Miscellaneous
+
+* Fix Lint/DuplicateMethods in StringIO_test.rb ([#3010](https://github.com/ruby/rbs/pull/3010))
+* Compressed files must be opened in binary mode ([#2981](https://github.com/ruby/rbs/pull/2981))
+* Fix flaky DirSingletonTest GC failures in test_fchdir and test_for_fd ([#3004](https://github.com/ruby/rbs/pull/3004))
+* Add TruffleRuby CI job ([#2996](https://github.com/ruby/rbs/pull/2996))
+* Update the target Ruby version notes to the latest release ([#2962](https://github.com/ruby/rbs/pull/2962))
+* Update docs/inline.md to match current inline parser behavior ([#2953](https://github.com/ruby/rbs/pull/2953))
+* ci: skip Gemfile.lock BUNDLED WITH on ruby-head ([#2952](https://github.com/ruby/rbs/pull/2952))
+* Remove `logger` from sig dependencies ([#2904](https://github.com/ruby/rbs/pull/2904))
+
+## 4.0.3 (2026-06-18)
+
+### Miscellaneous
+
+* Fix Ruby CI failure with compressed `Zlib::GzipReader` test fixtures. ([#3005](https://github.com/ruby/rbs/pull/3005))
+* Fix flaky `DirSingletonTest#test_fchdir` and `DirSingletonTest#test_for_fd` under aggressive GC. ([#3005](https://github.com/ruby/rbs/pull/3005))
+* Fix Ruby head CI failure caused by the lockfile-pinned Bundler version. ([#3005](https://github.com/ruby/rbs/pull/3005))
+
+## 4.0.2 (2026-03-25)
+
+### Library changes
+
+#### rbs collection
+
+* Fix: pathname not written to lockfile. ([#2889](https://github.com/ruby/rbs/pull/2889))
+
+### Miscellaneous
+
+* Fix test failure on Windows in `ruby/ruby` ([#2900](https://github.com/ruby/rbs/pull/2900))
+* Fix test for Ruby 4.1 ([#2899](https://github.com/ruby/rbs/pull/2899))
+
+## 4.0.1 (2026-03-23)
+
+This is a minor release to fix Ruby CI failure, which was caused by symlinks included in the `rust` directory.
+
+### Library changes
+
+* Fix `() -> (void)` being rejected as SyntaxError ([#2884](https://github.com/ruby/rbs/pull/2884))
+
+### Miscellaneous
+
+* Drop crates ([#2887](https://github.com/ruby/rbs/pull/2887))
+* Add newline at eof ([#2885](https://github.com/ruby/rbs/pull/2885))
+
+## 4.0.0 (2026-03-16)
+
+RBS 4.0 ships with experimental RBS inline syntax support, allowing you to write type annotations directly in Ruby source files. See [docs/inline.md](docs/inline.md) for the syntax details.
+
+```ruby
+class Calculator
+  # @rbs (Integer, Integer) -> Integer
+  def add(a, b) = a + b
+end
+```
+
+Note: RBS inline is still experimental and may change in future releases.
+
+This release also introduces two language changes: type argument support for singleton types (`singleton(T)[S]`) mainly for Sorbet integration, and generic type parameter lower bounds (`T < S`).
+
+### Signature updates
+
+**Updated classes/modules/methods:** `Addrinfo`, `Array`, `BasicObject`, `BigDecimal`, `Binding`, `CGI`, `Comparable`, `Complex`, `Digest::SHA2`, `Encoding::Converter`, `Enumerable`, `Enumerator`, `Enumerator::ArithmeticSequence`, `Enumerator::Lazy`, `Fiber`, `File`, `FileUtils`, `Float`, `Hash`, `IO`, `IO::TimeoutError`, `Integer`, `JSON`, `Kernel`, `Kconv`, `Math`, `Method`, `Minitest`, `Module`, `Numeric`, `ObjectSpace`, `Open3`, `OpenURI`, `OptionParser`, `PStore`, `Pathname`, `Proc`, `Process::Status`, `Psych`, `Ractor`, `Random`, `Random::Formatter`, `Range`, `Rational`, `RBS::Unnamed::TopLevelSelfClass`, `Ripper::Lexer::Elem`, `Ruby`, `RubyVM`, `SecureRandom`, `Set`, `Socket`, `String`, `StringScanner`, `TCPSocket`, `Thread`, `URI`, `URI::Generic`, `Zlib::GzipReader`, `Zlib::GzipWriter`
+
+* Remove deprecated types ([#2880](https://github.com/ruby/rbs/pull/2880))
+* Add type `RBS::Unnamed::TopLevelSelfClass` to core ([#2362](https://github.com/ruby/rbs/pull/2362))
+* Graduate bundled gems from Ruby v4.0 ([#2852](https://github.com/ruby/rbs/pull/2852))
+* stdlib: Add missing Psych methods and exception classes ([#2850](https://github.com/ruby/rbs/pull/2850))
+* Add variants with positional argument to `Hash#transform_keys` ([#2848](https://github.com/ruby/rbs/pull/2848))
+* add extra kwarg options for File#initialize and derivatives ([#2798](https://github.com/ruby/rbs/pull/2798))
+* pstore: fixes types, treat it as a collection ([#2806](https://github.com/ruby/rbs/pull/2806))
+* Add signatures for `{Module,Proc}#ruby2_keywords` ([#2805](https://github.com/ruby/rbs/pull/2805))
+* Make Zlib::GzipWriter.new level and strategy parameters optional ([#2810](https://github.com/ruby/rbs/pull/2810))
+* URI.(s) does string coercion ([#2825](https://github.com/ruby/rbs/pull/2825))
+* Fix String#append_as_bytes to accept Integer ([#2817](https://github.com/ruby/rbs/pull/2817))
+* [Comparable] Add in Comparable::_CompareToZero ([#2697](https://github.com/ruby/rbs/pull/2697))
+* [Kernel] Add Kernel.trace_var and Kernel.untrace_var ([#2682](https://github.com/ruby/rbs/pull/2682))
+* Add signature for `Module#method_undefined` ([#2804](https://github.com/ruby/rbs/pull/2804))
+* Fix Zlib::GzipWriter signatures ([#2803](https://github.com/ruby/rbs/pull/2803))
+* GzipWriter#initialize only takes 1 required positional arg ([#2799](https://github.com/ruby/rbs/pull/2799))
+* Fix accessibility of method in Module ([#2802](https://github.com/ruby/rbs/pull/2802))
+* Graduate kconv ([#2794](https://github.com/ruby/rbs/pull/2794))
+* Fix test related to pathname ([#2789](https://github.com/ruby/rbs/pull/2789))
+* Split pathname to core and stdlib ([#2777](https://github.com/ruby/rbs/pull/2777))
+* [Kernel] Narrow `caller_locations` ([#2745](https://github.com/ruby/rbs/pull/2745))
+* Ruby 4.1 changed `source_location` type ([#2784](https://github.com/ruby/rbs/pull/2784))
+* Remove ObjectSpace.count_nodes ([#2779](https://github.com/ruby/rbs/pull/2779))
+* Support selector for `String#strip` family. ([#2775](https://github.com/ruby/rbs/pull/2775))
+* Add `Ruby`, `Array#find`, and `Array#rfind` ([#2767](https://github.com/ruby/rbs/pull/2767))
+* Update minitest ([#2761](https://github.com/ruby/rbs/pull/2761))
+* Support BigDecimal v4 ([#2758](https://github.com/ruby/rbs/pull/2758))
+* Update rdoc and comments ([#2733](https://github.com/ruby/rbs/pull/2733))
+* Update cgi and cgi/escape type definitions ([#2728](https://github.com/ruby/rbs/pull/2728))
+* Update RBS files for Ruby 4 ([#2731](https://github.com/ruby/rbs/pull/2731))
+* Update existing docs ([#2724](https://github.com/ruby/rbs/pull/2724))
+* Remove reference to `JSON.deep_const_get` ([#2701](https://github.com/ruby/rbs/pull/2701))
+* Remove deprecated methods in `JSON` ([#2366](https://github.com/ruby/rbs/pull/2366))
+* Update FileUtils to v1.8.0 ([#2700](https://github.com/ruby/rbs/pull/2700))
+* Avoid overloading where arguments are identical ([#2559](https://github.com/ruby/rbs/pull/2559))
+* Move Pathname to core from stdlib ([#2705](https://github.com/ruby/rbs/pull/2705))
+* Remove undocumented `#nonzero?` ([#2543](https://github.com/ruby/rbs/pull/2543))
+* Add signature for `OptionParser#raise_unknown` ([#2735](https://github.com/ruby/rbs/pull/2735))
+* Add signature for `Open3.popen2` ([#2734](https://github.com/ruby/rbs/pull/2734))
+* Add RFC2396_PARSER to URI module ([#2727](https://github.com/ruby/rbs/pull/2727))
+* Add signature for `Open3.capture3` ([#2714](https://github.com/ruby/rbs/pull/2714))
+* Remove sig for IO#{ready?,nread} ([#2710](https://github.com/ruby/rbs/pull/2710))
+* Accept `nil` state parameter in `to_json` type signatures ([#2691](https://github.com/ruby/rbs/pull/2691))
+* Add type of `Open3.popen3` ([#2699](https://github.com/ruby/rbs/pull/2699))
+* `unsetenv_others` and `close_others` only allows bool. ([#2698](https://github.com/ruby/rbs/pull/2698))
+* Add deprecated annotation to `attr` with bool args ([#2693](https://github.com/ruby/rbs/pull/2693))
+* Update open3 ([#2692](https://github.com/ruby/rbs/pull/2692))
+* Add signature for `SecureRandom.bytes` ([#2690](https://github.com/ruby/rbs/pull/2690))
+* Set %a{deprecated} to deprecated core methods ([#2664](https://github.com/ruby/rbs/pull/2664))
+* Migrate usages of ::_ToPath to use ::path instead ([#2677](https://github.com/ruby/rbs/pull/2677))
+* Add missing signatures for `Random::Formatter` ([#2680](https://github.com/ruby/rbs/pull/2680))
+* Split `Random::Formatter` to core and stdlib ([#2661](https://github.com/ruby/rbs/pull/2661))
+* Skip test cases of developing methods for Pathname ([#2648](https://github.com/ruby/rbs/pull/2648))
+* Add signature `Random.seed` ([#2649](https://github.com/ruby/rbs/pull/2649))
+* Update `string.rbs` to avoid deprecation warning in Steep ([#2655](https://github.com/ruby/rbs/pull/2655))
+* Add sig `IO#pread` and `IO#pwrite` ([#2647](https://github.com/ruby/rbs/pull/2647))
+* Refine signature of `Numeric#step` and add type of `Enumerator::ArithmeticSequence` ([#2600](https://github.com/ruby/rbs/pull/2600))
+* Remove undocumented override methods ([#2622](https://github.com/ruby/rbs/pull/2622))
+* Add docs ([#2625](https://github.com/ruby/rbs/pull/2625))
+* Remove undocumented methods for `imaginary` ([#2620](https://github.com/ruby/rbs/pull/2620))
+* Update securerandom ([#2619](https://github.com/ruby/rbs/pull/2619))
+* Drop undocumented `#eql?` ([#2618](https://github.com/ruby/rbs/pull/2618))
+* Just use `Numeric#+@` and return self ([#2597](https://github.com/ruby/rbs/pull/2597))
+* Drop undocumented `#dup` ([#2598](https://github.com/ruby/rbs/pull/2598))
+* Add signature for `Digest::SHA2` ([#2573](https://github.com/ruby/rbs/pull/2573))
+* Add signatures for `OpenURI` ([#2574](https://github.com/ruby/rbs/pull/2574))
+* Add signature for `IO::TimeoutError` ([#2571](https://github.com/ruby/rbs/pull/2571))
+* Add signatures for `Set` ([#2570](https://github.com/ruby/rbs/pull/2570))
+* Add signature for `Enumerator#+` ([#2567](https://github.com/ruby/rbs/pull/2567))
+* Add signature for `Enumerator::Lazy#eager` ([#2568](https://github.com/ruby/rbs/pull/2568))
+* Add signature for `Fiber#blocking` ([#2566](https://github.com/ruby/rbs/pull/2566))
+* Support BasicObject to avoid NoMethodError for `RBS::Test::TypeCheck` ([#2565](https://github.com/ruby/rbs/pull/2565))
+* Add documentation for `Range#{minmax,count,to_a,entries}` ([#2562](https://github.com/ruby/rbs/pull/2562))
+* Delegate to `Enumerable` from `Range#{min,max}` ([#2540](https://github.com/ruby/rbs/pull/2540))
+* Add URI::Generic#+ ([#2535](https://github.com/ruby/rbs/pull/2535))
+* Make IO.binread, IO.binwrite, IO.read and IO.write accept _ToPath ([#2378](https://github.com/ruby/rbs/pull/2378))
+* Support pattern argument for Enumerable#{all,any,none,one}? ([#2368](https://github.com/ruby/rbs/pull/2368))
+* fixing sig for addrinfo ([#2464](https://github.com/ruby/rbs/pull/2464))
+
+### Language updates
+
+* Add type arguments support to singleton types ([#2502](https://github.com/ruby/rbs/pull/2502))
+* Move the note about lower bound ([#2517](https://github.com/ruby/rbs/pull/2517))
+* Add support for lower bounds in type parameters ([#2490](https://github.com/ruby/rbs/pull/2490))
+
+### Library changes
+
+* Add `#type_fingerprint` methods ([#2879](https://github.com/ruby/rbs/pull/2879))
+* `top` for membership predicates of collection types ([#2878](https://github.com/ruby/rbs/pull/2878))
+* Add block parameter (`&block`) type declaration ([#2875](https://github.com/ruby/rbs/pull/2875))
+* Add splat (`*a`) and double-splat (`**a`) parameter support ([#2873](https://github.com/ruby/rbs/pull/2873))
+* Add parameter type inline annotation ([#2443](https://github.com/ruby/rbs/pull/2443))
+* Reduce compile warnings ([#2871](https://github.com/ruby/rbs/pull/2871))
+* Specify input range by byte offsets ([#2863](https://github.com/ruby/rbs/pull/2863))
+* add `extern "C"` wrapping to `rbs.h` when using C++ ([#2855](https://github.com/ruby/rbs/pull/2855))
+* Automatically inherits super method type if unannotated ([#2858](https://github.com/ruby/rbs/pull/2858))
+* Add `...` syntax to method type inline annotation syntax ([#2856](https://github.com/ruby/rbs/pull/2856))
+* Fix for string reference corruption issue ([#2836](https://github.com/ruby/rbs/pull/2836))
+* Use unreleased steep for `rake typecheck_test` ([#2842](https://github.com/ruby/rbs/pull/2842))
+* Fix breaking references after GC.compact ([#2822](https://github.com/ruby/rbs/pull/2822))
+* Fix special methods accessibility. ([#2546](https://github.com/ruby/rbs/pull/2546))
+* Fix allocation alignment ([#2788](https://github.com/ruby/rbs/pull/2788))
+* Skip `set` and `pathname` from `manifest.yaml` ([#2773](https://github.com/ruby/rbs/pull/2773))
+* Fix C++ compiler warnings ([#2755](https://github.com/ruby/rbs/pull/2755))
+* Better encoding ([#2675](https://github.com/ruby/rbs/pull/2675))
+* Move `require_eof` handling to C API ([#2678](https://github.com/ruby/rbs/pull/2678))
+* Delete debug print ([#2753](https://github.com/ruby/rbs/pull/2753))
+* Make assertions macro ([#2729](https://github.com/ruby/rbs/pull/2729))
+* Remove deprecated method `Kernel#Namespace`. Also remove `Kernel#TypeName`. ([#2480](https://github.com/ruby/rbs/pull/2480))
+* Update rdoc to 6.13.1 ([#2355](https://github.com/ruby/rbs/pull/2355))
+* Allow `self` for inline `@rbs @ivar: self` ([#2633](https://github.com/ruby/rbs/pull/2633))
+* Normalize modules during type name resolution ([#2670](https://github.com/ruby/rbs/pull/2670))
+* Only load extconf_compile_commands_json when compiling through Rake  ([#2498](https://github.com/ruby/rbs/pull/2498))
+* Use `malloc` based allocator ([#2666](https://github.com/ruby/rbs/pull/2666))
+* Add another parser benchmark script ([#2668](https://github.com/ruby/rbs/pull/2668))
+* Reuse empty array and hash ([#2667](https://github.com/ruby/rbs/pull/2667))
+* Faster lexical analyzer ([#2665](https://github.com/ruby/rbs/pull/2665))
+* Introduce `type_fingerprint` ([#2644](https://github.com/ruby/rbs/pull/2644))
+* Add module-class alias declaration ([#2636](https://github.com/ruby/rbs/pull/2636))
+* Inline constant declaration ([#2635](https://github.com/ruby/rbs/pull/2635))
+* `self` type is rejected depending on the context ([#2627](https://github.com/ruby/rbs/pull/2627))
+* Add instance variable declaration annotation ([#2632](https://github.com/ruby/rbs/pull/2632))
+* Module-self allow void once ([#2626](https://github.com/ruby/rbs/pull/2626))
+* Support inheritance in Inline RBS declaration ([#2630](https://github.com/ruby/rbs/pull/2630))
+* Inline attribute/method definitions have comments ([#2624](https://github.com/ruby/rbs/pull/2624))
+* Inline RBS declaration for attributes (`attr_***`) ([#2623](https://github.com/ruby/rbs/pull/2623))
+* Fix bad scaling in `rbs_comment_t` tokens ([#2578](https://github.com/ruby/rbs/pull/2578))
+* Update parser so that `void` type is rejected depending on the context ([#2590](https://github.com/ruby/rbs/pull/2590))
+* Implement mixin in inline RBS declarations ([#2614](https://github.com/ruby/rbs/pull/2614))
+* Validate type args given to non-generic ancestor ([#2615](https://github.com/ruby/rbs/pull/2615))
+* Add name locations to AST ([#2595](https://github.com/ruby/rbs/pull/2595))
+* Move `exit` calls to `exe/rbs` ([#2591](https://github.com/ruby/rbs/pull/2591))
+* Fix locator ([#2588](https://github.com/ruby/rbs/pull/2588))
+* Introduce standalone C parser for RBS with arena allocation ([#2398](https://github.com/ruby/rbs/pull/2398))
+* Fix subtraction of civar ([#2369](https://github.com/ruby/rbs/pull/2369))
+* Buffer with empty string ([#2551](https://github.com/ruby/rbs/pull/2551))
+* Fix unavailable MAP_ANONYMOUS ([#2470](https://github.com/ruby/rbs/pull/2470))
+* Inline minor fix ([#2514](https://github.com/ruby/rbs/pull/2514))
+* Enable `-Wc++-compat` ([#2463](https://github.com/ruby/rbs/pull/2463))
+* Expose a method to parse type parameters ([#2457](https://github.com/ruby/rbs/pull/2457))
+* Expose and fix `Block#location` ([#2456](https://github.com/ruby/rbs/pull/2456))
+* Restore RBS::Environment#declarations for backwards-compatibility ([#2393](https://github.com/ruby/rbs/pull/2393))
+* Implement `@rbs return: T` annotation ([#2406](https://github.com/ruby/rbs/pull/2406))
+* Add `@rbs skip` annotation ([#2405](https://github.com/ruby/rbs/pull/2405))
+* Inline annotations ([#2403](https://github.com/ruby/rbs/pull/2403))
+* Inline `def` support ([#2392](https://github.com/ruby/rbs/pull/2392))
+* Suppress to GCC warning with multi-line comment ([#2383](https://github.com/ruby/rbs/pull/2383))
+* Add inline class/module declaration ([#2390](https://github.com/ruby/rbs/pull/2390))
+* Add `RBS::Source::RBS` ([#2380](https://github.com/ruby/rbs/pull/2380))
+
+#### rbs prototype
+
+* [prototype runtime] Find redefined methods ([#2542](https://github.com/ruby/rbs/pull/2542))
+
+#### rbs collection
+
+### Miscellaneous
+
+* bundle update (2026-01-20) ([#2818](https://github.com/ruby/rbs/pull/2818))
+* Ruby 4.0.1 ([#2823](https://github.com/ruby/rbs/pull/2823))
+* [rbs/test] Check type arguments size ([#2809](https://github.com/ruby/rbs/pull/2809))
+* Add tsort to testing dependencies ([#2795](https://github.com/ruby/rbs/pull/2795))
+* Update ruby to 4.0 ([#2776](https://github.com/ruby/rbs/pull/2776))
+* Ruby 4.0.0 preview3 ([#2764](https://github.com/ruby/rbs/pull/2764))
+* Remove test code for bundled gems ([#2760](https://github.com/ruby/rbs/pull/2760))
+* Fix `nil` size `Enumerator` test ([#2749](https://github.com/ruby/rbs/pull/2749))
+* Fix tests for rbs_skip_tests in ruby repo ([#2725](https://github.com/ruby/rbs/pull/2725))
+* Update rdoc to v6.16 ([#2721](https://github.com/ruby/rbs/pull/2721))
+* Run CI with "4.0.0-preview2" ([#2718](https://github.com/ruby/rbs/pull/2718))
+* Minor typo fix ([#2676](https://github.com/ruby/rbs/pull/2676))
+* Add -j option to make ([#2658](https://github.com/ruby/rbs/pull/2658))
+* Allows the use of a path list as RBS_SKIP_TESTS ([#2612](https://github.com/ruby/rbs/pull/2612))
+* Fix clang-format ([#2589](https://github.com/ruby/rbs/pull/2589))
+* Restrict the execution of the valgrind task to when the C code has been modified. ([#2552](https://github.com/ruby/rbs/pull/2552))
+* Set force_ruby_platform for bundler when head ([#2555](https://github.com/ruby/rbs/pull/2555))
+* More skip paths with valgrind ([#2557](https://github.com/ruby/rbs/pull/2557))
+* Run the `Encoding::Converter` test ([#2550](https://github.com/ruby/rbs/pull/2550))
+* Fix CI ([#2527](https://github.com/ruby/rbs/pull/2527))
+* Replace reference with official documentation ([#2453](https://github.com/ruby/rbs/pull/2453))
+* Add clangd integration for improved C extension development ([#2481](https://github.com/ruby/rbs/pull/2481))
+* Setup clang format for C code ([#2437](https://github.com/ruby/rbs/pull/2437))
+* Add `super` calls in `setup` ([#2484](https://github.com/ruby/rbs/pull/2484))
+* Suppress warnings during testing ([#2370](https://github.com/ruby/rbs/pull/2370))
+* Update rubocop-on-rbs and use plugins ([#2345](https://github.com/ruby/rbs/pull/2345))
+* Fix error at Ruby CI ([#2445](https://github.com/ruby/rbs/pull/2445))
+* Use `erb` instead of `set` for load path testing ([#2439](https://github.com/ruby/rbs/pull/2439))
+* Skip loading ruby_memcheck ([#2349](https://github.com/ruby/rbs/pull/2349))
+* Forcibly uninstall gems even if there is a dependency problem. ([#2346](https://github.com/ruby/rbs/pull/2346))
+
+## 3.10.4 (2026-03-25)
+
+### Library changes
+
+#### rbs collection
+
+* [Backport] [3.10] Fix: pathname not written to lockfile. ([#2896](https://github.com/ruby/rbs/pull/2896))
+
+## 3.10.3 (2026-01-30)
+
+This is a minor fix around the dependency to `tsort`.
+
+## Pull Requests
+
+* Merge pull request #2601 from ima1zumi/add-tsort-dep ([#2834](https://github.com/ruby/rbs/pull/2834))
+
+## 3.10.2 (2026-01-07)
+
+This is a minor fix on arena allocator alignment.
+
+### Pull Requests
+
+* Merge pull request #2788 from ruby/fix-alloc-alignment ([#2790](https://github.com/ruby/rbs/pull/2790))
+
+## 3.10.1 (2026-01-07)
+
+This is a follow-up release for Ruby 4.0.0 with documentation update based on Ruby 4.0.0, and bugfixes related to set/pathname library loading.
+
+### Pull Requests
+
+* Merge pull request #2777 from ksss/pathname-ext ([#2786](https://github.com/ruby/rbs/pull/2786))
+* Ruby 4.0.0 backports ([#2785](https://github.com/ruby/rbs/pull/2785))
+* [Backport] Fix subtraction of civar ([#2783](https://github.com/ruby/rbs/pull/2783))
+* [Backport] Update ruby to 4.0 ([#2778](https://github.com/ruby/rbs/pull/2778))
+
+## 3.10.0 (2025-12-23)
+
+RBS 3.10.0 ships with a pure C parser implementation, signature updates for Ruby 4.0, and various bug fixes.
+
+### Pure C parser implementation
+
+The new parser implementation was announced at [RubyKaigi 2025](https://rubykaigi.org/2025/presentations/amomchilov.html) and is finally shipped as a RubyGem!
+
+The new parser is faster than the one in 3.9 and is portable — it is independent of the Ruby runtime and is used to implement Sorbet’s RBS support.
+
+### Type definition of bundled gems
+
+The type definitions of `cgi` have been moved to [gem_rbs_collection](https://github.com/ruby/gem_rbs_collection/tree/main/gems/cgi), as it has been migrated to a bundled gem in Ruby 4.0
+
+`cgi-escape` has been added to `stdlib`. You may need to declare a dependency on `cgi-escape` in your `manifest.yaml`, add `-r cgi-escape` to your command line, or update your type checker configuration.
+
+```yaml
+dependencies:
+  - name: cgi-escape
+```
+
+The type definitions for `pathname` have also been moved from `stdlib` to `core`, as it is now implemented as part of the core library.
+
+### Pull Requests
+
+* [Backport] Support rdoc v7 ([#2770](https://github.com/ruby/rbs/pull/2770))
+* [Backport] Check tuple type length ([#2766](https://github.com/ruby/rbs/pull/2766))
+* Backport update to 4.0.0-preview3 ([#2768](https://github.com/ruby/rbs/pull/2768))
+* [Backport] Remove test code for bundled gems ([#2762](https://github.com/ruby/rbs/pull/2762))
+* Merge pull request #2761 from ruby/update-minitest ([#2763](https://github.com/ruby/rbs/pull/2763))
+* [Backport] Support BigDecimal v4 ([#2759](https://github.com/ruby/rbs/pull/2759))
+* Parser/lexer backports ([#2756](https://github.com/ruby/rbs/pull/2756))
+* Merge pull request #2753 from ruby/delete-printf ([#2754](https://github.com/ruby/rbs/pull/2754))
+* Backports ([#2751](https://github.com/ruby/rbs/pull/2751))
+* Merge pull request #2728 from ruby/cgi ([#2747](https://github.com/ruby/rbs/pull/2747))
+* Merge pull request #2729 from ruby/rbs-assert ([#2748](https://github.com/ruby/rbs/pull/2748))
+* Merge pull request #2749 from ruby/fix-test ([#2750](https://github.com/ruby/rbs/pull/2750))
+* Backport RBS file updates ([#2742](https://github.com/ruby/rbs/pull/2742))
+* Backport JSON PRs ([#2740](https://github.com/ruby/rbs/pull/2740))
+* Merge pull request #2718 from ruby/ruby-4 ([#2741](https://github.com/ruby/rbs/pull/2741))
+* [Backport] Move Pathname to core from stdlib ([#2730](https://github.com/ruby/rbs/pull/2730))
+* Backport rdoc 6.16 ([#2722](https://github.com/ruby/rbs/pull/2722))
+* Backport rdoc support ([#2719](https://github.com/ruby/rbs/pull/2719))
+* Backport "Remove sig for IO#{ready?,nread}" ([#2720](https://github.com/ruby/rbs/pull/2720))
+* Backport more pure C parsers ([#2679](https://github.com/ruby/rbs/pull/2679))
+* Backport module name normalization ([#2673](https://github.com/ruby/rbs/pull/2673))
+* Backport pure-C parser ([#2671](https://github.com/ruby/rbs/pull/2671))
+* Fix test failure ([#2672](https://github.com/ruby/rbs/pull/2672))
+
+## 3.9.5 (2025-09-08)
+
+### Signature updates
+
+* Merge pull request #2655 from ruby/silence-string-deprecation ([#2656](https://github.com/ruby/rbs/pull/2656))
+
+### Miscellaneous
+
+* Allows the use of a path list as RBS_SKIP_TESTS ([#2641](https://github.com/ruby/rbs/pull/2641))
+* Suppress to GCC warning with multi-line comment ([#2646](https://github.com/ruby/rbs/pull/2646))
+* Backport to 3.9 ([#2487](https://github.com/ruby/rbs/pull/2487))
+* Use erb instead of set for load path testing ([#2468](https://github.com/ruby/rbs/pull/2468))
+
 ## 3.9.4 (2025-05-15)
 
 ### Miscellaneous