Bump minor version.

Author: ioquatix

context/getting-started.md

@@ -163,6 +163,38 @@ Fiber.schedule do
 end
 ~~~
 
+### Deep Transfer with Traversal
+
+By default, `transfer` only transfers the object itself (shallow). For collections like `Array`, `Hash`, and `Set`, the gem automatically traverses and transfers contained objects:
+
+~~~ ruby
+bodies = [Body.new, Body.new]
+
+Async::Safe.transfer(bodies)  # Transfers array AND all bodies inside
+~~~
+
+Custom classes can define traversal behavior using `async_safe_traverse`:
+
+~~~ ruby
+class Request
+  async_safe!(false)
+  attr_accessor :body, :headers
+  
+  def self.async_safe_traverse(instance, &block)
+    yield instance.body
+    yield instance.headers
+  end
+end
+
+request = Request.new
+request.body = Body.new
+request.headers = Headers.new
+
+Async::Safe.transfer(request)  # Transfers request, body, AND headers.
+~~~
+
+**Note:** Shareable objects (`async_safe? -> true`) are never traversed or transferred, as they can be safely shared across fibers.
+
 ## Integration with Tests
 
 Add to your test helper (e.g., `config/sus.rb` or `spec/spec_helper.rb`):

lib/async/safe/version.rb

@@ -5,7 +5,7 @@
 
 module Async
 	module Safe
-		VERSION = "0.3.2"
+		VERSION = "0.4.0"
 	end
 end
 

readme.md

@@ -22,6 +22,10 @@ Please see the [project documentation](https://socketry.github.io/async-safe/) f
 
 Please see the [project releases](https://socketry.github.io/async-safe/releases/index) for all releases.
 
+### v0.4.0
+
+  - Improved `Async::Safe.transfer` to recursively transfer ownership of tracked instance variables.
+
 ### v0.3.2
 
   - Better error message.
@@ -32,6 +36,9 @@ Please see the [project releases](https://socketry.github.io/async-safe/releases
   - Added flexible `ASYNC_SAFE` constant support: boolean, hash, or array configurations.
   - Added `Class#async_safe!` method for marking classes.
   - Added `Class#async_safe?(method)` method for querying safety.
+  - Added `Class.async_safe_traverse` for custom deep transfer traversal (opt-in).
+  - Improved `Async::Safe.transfer` to use shallow transfer by default with opt-in deep traversal.
+  - Mark built-in collections (`Array`, `Hash`, `Set`) as single-owner with deep traversal support.
   - Removed logger feature: always raises `ViolationError` exceptions.
   - Removed `Async::Safe::Concurrent` module: use `async_safe!` instead.
 

releases.md

@@ -1,6 +1,6 @@
 # Releases
 
-## Unreleased
+## v0.4.0
 
   - Improved `Async::Safe.transfer` to recursively transfer ownership of tracked instance variables.
 
@@ -10,15 +10,15 @@
 
 ## v0.3.0
 
-- Inverted default model: classes are async-safe by default, use `ASYNC_SAFE = false` to enable tracking.
-- Added flexible `ASYNC_SAFE` constant support: boolean, hash, or array configurations.
-- Added `Class#async_safe!` method for marking classes.
-- Added `Class#async_safe?(method)` method for querying safety.
-- Added `Class.async_safe_traverse` for custom deep transfer traversal (opt-in).
-- Improved `Async::Safe.transfer` to use shallow transfer by default with opt-in deep traversal.
-- Mark built-in collections (`Array`, `Hash`, `Set`) as single-owner with deep traversal support.
-- Removed logger feature: always raises `ViolationError` exceptions.
-- Removed `Async::Safe::Concurrent` module: use `async_safe!` instead.
+  - Inverted default model: classes are async-safe by default, use `ASYNC_SAFE = false` to enable tracking.
+  - Added flexible `ASYNC_SAFE` constant support: boolean, hash, or array configurations.
+  - Added `Class#async_safe!` method for marking classes.
+  - Added `Class#async_safe?(method)` method for querying safety.
+  - Added `Class.async_safe_traverse` for custom deep transfer traversal (opt-in).
+  - Improved `Async::Safe.transfer` to use shallow transfer by default with opt-in deep traversal.
+  - Mark built-in collections (`Array`, `Hash`, `Set`) as single-owner with deep traversal support.
+  - Removed logger feature: always raises `ViolationError` exceptions.
+  - Removed `Async::Safe::Concurrent` module: use `async_safe!` instead.
 
 ## v0.2.0