everythingrb 0.9.1 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7361ef45ed502564c8e27fd3b2173702320f2076665ae9f495f5645fc7b57587
-  data.tar.gz: 411dc777df9851c7204903dde8ce12ce6951cf2308d9c02e6184bf0fef67a056
+  metadata.gz: c1aaf48c681b67675cfd4a3e053086163c755a47fc3941507ac0b08bb33ddf09
+  data.tar.gz: 2e9389e279e225463b03d0ccaac1db55444aa3d5c99f4ec06c5d86e89a235efa
 SHA512:
-  metadata.gz: 548f88f645e3d1731ccbe258e9e8d4157003f9b5f584942f8a2b14657bab1c04de965c16bd2a7bb0f2305edfc92c3e73c5bcd7a07f9627cccd3eef46e5488076
-  data.tar.gz: fb00c066860dc38a4b8b1091978618af0d6ee06bc477dbdb9d2a8603e043e0de8b7b93aab09964035f13efae77e0ec0a05fa00ea6caa3a70ad9d1c32b577c8d4
+  metadata.gz: 16cdf21b81457e94d393b246dd762c33400de2e39b01435be9334946cdb2b0639583db9064fdac7c2053e6bc533f3b699fcdd5fe7c119e3052f1b51e8cb911ae
+  data.tar.gz: fc9e95bbd7b0dd0fdbc5a8474f00ffccc0968e703b45c63a7aef1ddc8b6f0418123dfb7474813ce03e889f35244c6e7bf42cab368d31e5db4174551a93ee9f20

data/CHANGELOG.md

@@ -15,11 +15,26 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Removed
 -->
 
-## [0.9.1] - 12026-01-22
+## [1.0.0] - 12026-03-21
+
+### Added
+
+- **Added `from:` option to `attr_predicate`** - Map a predicate to a differently-named source. Use `@` prefix for instance variables (e.g., `from: :@started_at`), omit for methods (e.g., `from: :error_messages`). This enables patterns like `attr_predicate :started, from: :@started_at` and `attr_predicate :errored, from: :error_messages`.
+- **Added `private:` option to `attr_predicate`** - Define predicates as private methods with `attr_predicate :verified, private: true`.
 
 ### Changed
 
-- **Deprecated `Hash.new_nested_hash`** - This method is now deprecated and will be removed in v1.0.0. Consider using `Hash.new { |h, k| h[k] = Hash.new(&h.default_proc) }` instead.
+- **BREAKING: Renamed `Hash#value_where` to `Hash#find_value` and `Hash#values_where` to `Hash#select_values`** - The new names better align with Ruby conventions and clearly express the methods' purpose of finding values that match a condition.
+- **BREAKING: Renamed `String#to_h` to `String#parse_json`** - This change improves compatibility with Ruby's type coercion expectations and avoids conflicts with methods like `Array(obj)` that rely on standard `to_a`/`to_h` behavior. The method parses JSON strings with symbolized keys by default and returns `nil` for invalid JSON.
+- **Fixed Ruby 3.4+ compatibility** - Added `require "date"` to ensure Date and DateTime classes are properly loaded before extending them.
+- **BREAKING: `attr_predicate` no longer falls back to method calls** - For performance reasons (~5x faster), `attr_predicate` now assumes direct instance variable access by default. The previous behavior checked `instance_variable_defined?` and `respond_to?` on every call, which was slow. Struct, OpenStruct, and Data classes are automatically detected and use method access. For other cases where you need method delegation, use the new `from:` option explicitly (e.g., `attr_predicate :errored, from: :error_messages`).
+- **Improved `attr_predicate` empty value handling** - Without ActiveSupport, values responding to `empty?` (arrays, hashes, strings) now return `false` when empty. Previously, an empty array would return `true` since `!![]` is truthy. With ActiveSupport, behavior is unchanged (uses `present?`).
+
+### Removed
+
+- **BREAKING: Removed `Hash.new_nested_hash`** - Use Ruby's built-in `Hash.new { |h, k| h[k] = Hash.new(&h.default_proc) }` instead.
+- **BREAKING: Removed `#to_deep_h` from all classes** - This method has been removed from String, Hash, Array, Struct, OpenStruct, and Data classes. If you need this functionality, implement it locally in your project.
+- **Removed `String#to_a`** - This method was removed along with the JSON parsing refactor.
 
 ## [0.9.0] - 12025-08-01
 
@@ -212,10 +227,6 @@ This change aligns our method signatures with Ruby's conventions and matches our
   - `#rename_keys!` - Same as `#rename_keys` but modifies the hash in place
   - `#rename_key_unordered` - Renames a key without preserving element order (faster operation)
   - `#rename_key_unordered!` - Same as `#rename_key_unordered` but modifies the hash in place
-- Added `to_deep_h` to core Ruby classes for consistent deep hash conversion:
-  - `Struct#to_deep_h` - Recursively converts Struct objects and all nested values to hashes
-  - `OpenStruct#to_deep_h` - Recursively converts OpenStruct objects and all nested values to hashes
-  - `Data#to_deep_h` - Recursively converts Data objects and all nested values to hashes
 - Added `depth` parameter to `Hash.new_nested_hash` to control nesting behaviors
 
 ### Changed
@@ -241,7 +252,6 @@ This change aligns our method signatures with Ruby's conventions and matches our
 
 - Added `Array#to_or_sentence`, creates a sentence with "or" connector between items
 - Added `#with_key` method to `Hash#transform_values` and `Hash#transform_values!`, grants access to both keys and values during transformations
-- Added `Array#to_deep_h` and `Hash#to_deep_h`, recursively converts underlying values to hashes
 - Added `Enumerable#group_by_key`, group an array of hashes by their keys
 - Added `Hash#new_nested_hash`, creates a new Hash that automatically initializes the value to a hash
 - Added `Hash#value_where` and `Hash#values_where`, easily find values in a hash based on key-value conditions
@@ -341,15 +351,14 @@ This change aligns our method signatures with Ruby's conventions and matches our
   - `join_map` method consistent with Array/Hash implementations
 - Enhanced `String` class with:
   - `to_h` and `to_a` methods for JSON parsing with `nil` fallback on error
-  - `to_deep_h` for recursive JSON string parsing
   - `to_istruct`, `to_ostruct`, and `to_struct` conversion methods
 
 ### Changed
 
 - Added alias `each` to `each_pair` in OpenStruct for better enumerable compatibility
 
-[unreleased]: https://github.com/itsthedevman/everythingrb/compare/v0.9.1...HEAD
-[0.9.1]: https://github.com/itsthedevman/everythingrb/compare/v0.9.0...v0.9.1
+[unreleased]: https://github.com/itsthedevman/everythingrb/compare/v1.0.0...HEAD
+[1.0.0]: https://github.com/itsthedevman/everythingrb/compare/v0.9.0...v1.0.0
 [0.9.0]: https://github.com/itsthedevman/everythingrb/compare/v0.8.3...v0.9.0
 [0.8.3]: https://github.com/itsthedevman/everythingrb/compare/v0.8.2...v0.8.3
 [0.8.3]: https://github.com/itsthedevman/everythingrb/compare/v0.8.2...v0.8.3

data/README.md

@@ -4,7 +4,7 @@
 ![Ruby Version](https://img.shields.io/badge/ruby-3.3.7-ruby)
 [![Tests](https://github.com/itsthedevman/everythingrb/actions/workflows/main.yml/badge.svg)](https://github.com/everythingrb/sortsmith/actions/workflows/main.yml)
 
-Super handy extensions to Ruby core classes that make your code more expressive, readable, and fun to write. Stop writing boilerplate and start writing code that _actually matters_!
+Practical extensions to Ruby core classes that let your code say what it means.
 
 ## Express Your Intent, Not Your Logic
 
@@ -33,8 +33,6 @@ users.join_map(", ") { |u| u[:name] if u[:role] == "admin" }
 
 _Methods used: [`join_map`](https://itsthedevman.com/docs/everythingrb/Array.html#join_map-instance_method)_
 
-Because life's too short to write all that boilerplate!
-
 ## Installation
 
 ```ruby
@@ -68,7 +66,7 @@ config.server.port  # => 443
 
 #### Cherry-Pick Extensions
 
-If you only need specific extensions (or you're a minimalist at heart):
+If you only need specific extensions:
 
 ```ruby
 require "everythingrb/prelude"  # Required base module
@@ -87,7 +85,7 @@ Available modules:
 
 - `array`: Array extensions (join_map, key_map, etc.)
 - `boolean`: Boolean extensions (in_quotes, with_quotes)
-- `data`: Data extensions (to_deep_h, in_quotes)
+- `data`: Data extensions (in_quotes)
 - `date`: Date and DateTime extensions (in_quotes)
 - `enumerable`: Enumerable extensions (join_map, group_by_key)
 - `hash`: Hash extensions (to_ostruct, transform_values(with_key: true), etc.)
@@ -98,14 +96,14 @@ Available modules:
 - `ostruct`: OpenStruct extensions (map, join_map, etc.)
 - `range`: Range extensions (in_quotes)
 - `regexp`: Regexp extensions (in_quotes)
-- `string`: String extensions (to_h, to_ostruct, to_camelcase, etc.)
-- `struct`: Struct extensions (to_deep_h, in_quotes)
+- `string`: String extensions (parse_json, to_ostruct, to_camelcase, etc.)
+- `struct`: Struct extensions (in_quotes)
 - `symbol`: Symbol extensions (with_quotes)
 - `time`: Time extensions (in_quotes)
 
 ### Rails Applications
 
-EverythingRB works out of the box with Rails! Just add it to your Gemfile and you're all set.
+EverythingRB works out of the box with Rails. Just add it to your Gemfile and you're all set.
 
 If you only want specific extensions, configure them in an initializer:
 
@@ -122,8 +120,6 @@ By default (when `config.everythingrb.extensions` is not set), all extensions ar
 
 ### Data Structure Conversions
 
-Stop writing complicated parsers and nested transformations:
-
 ```ruby
 # BEFORE
 json_string = '{"user":{"name":"Alice","roles":["admin"]}}'
@@ -137,8 +133,6 @@ result = OpenStruct.new(
 result.user.name  # => "Alice"
 ```
 
-With EverythingRB, it's one elegant step:
-
 ```ruby
 # AFTER
 '{"user":{"name":"Alice","roles":["admin"]}}'.to_ostruct.user.name  # => "Alice"
@@ -146,7 +140,7 @@ With EverythingRB, it's one elegant step:
 
 _Methods used: [`to_ostruct`](https://itsthedevman.com/docs/everythingrb/String.html#to_ostruct-instance_method)_
 
-Convert between data structures with ease:
+Convert between data structures:
 
 ```ruby
 # BEFORE
@@ -164,31 +158,11 @@ config.server.host  # => "example.com"
 
 _Methods used: [`to_struct`](https://itsthedevman.com/docs/everythingrb/Hash.html#to_struct-instance_method)_
 
-Deep conversion to plain hashes is just as easy:
-
-```ruby
-# BEFORE
-data = OpenStruct.new(user: Data.define(:name).new(name: "Bob"))
-result = {
-  user: {
-    name: data.user.name
-  }
-}
-```
-
-```ruby
-# AFTER
-data = OpenStruct.new(user: Data.define(:name).new(name: "Bob"))
-data.to_deep_h  # => {user: {name: "Bob"}}
-```
-
-_Methods used: [`to_deep_h`](https://itsthedevman.com/docs/everythingrb/OpenStruct.html#to_deep_h-instance_method)_
-
-**Extensions:** [`to_struct`](https://itsthedevman.com/docs/everythingrb/Hash.html#to_struct-instance_method), [`to_ostruct`](https://itsthedevman.com/docs/everythingrb/Hash.html#to_ostruct-instance_method), [`to_istruct`](https://itsthedevman.com/docs/everythingrb/Hash.html#to_istruct-instance_method), [`to_h`](https://itsthedevman.com/docs/everythingrb/String.html#to_h-instance_method), [`to_deep_h`](https://itsthedevman.com/docs/everythingrb/Hash.html#to_deep_h-instance_method)
+**Extensions:** [`to_struct`](https://itsthedevman.com/docs/everythingrb/Hash.html#to_struct-instance_method), [`to_ostruct`](https://itsthedevman.com/docs/everythingrb/Hash.html#to_ostruct-instance_method), [`to_istruct`](https://itsthedevman.com/docs/everythingrb/Hash.html#to_istruct-instance_method), [`parse_json`](https://itsthedevman.com/docs/everythingrb/String.html#parse_json-instance_method)
 
 ### Collection Processing
 
-Extract and transform data with elegant, expressive code:
+Extract and transform data:
 
 ```ruby
 # BEFORE
@@ -223,7 +197,7 @@ users.dig_map(:user, :profile, :name)  # => ["Alice", "Bob"]
 
 _Methods used: [`dig_map`](https://itsthedevman.com/docs/everythingrb/Array.html#dig_map-instance_method)_
 
-Combine filter, map, and join operations in one step:
+Combine filter, map, and join in one step:
 
 ```ruby
 # BEFORE
@@ -240,7 +214,7 @@ result = data.compact.filter_map { |n| "Item #{n}" if n.odd? }.join(" | ")
 
 _Methods used: [`join_map`](https://itsthedevman.com/docs/everythingrb/Array.html#join_map-instance_method)_
 
-Need position-aware processing? Both Array and Hash support `with_index`:
+Both Array and Hash support `with_index` when you need position-aware processing:
 
 ```ruby
 # BEFORE
@@ -257,7 +231,7 @@ users.join_map(", ", with_index: true) { |(k, v), i| "#{i + 1}. #{v}" }
 
 _Methods used: [`join_map`](https://itsthedevman.com/docs/everythingrb/Hash.html#join_map-instance_method)_
 
-Group elements with natural syntax:
+Group by a nested key path directly:
 
 ```ruby
 # BEFORE
@@ -278,7 +252,7 @@ users.group_by_key(:department, :name)
 
 _Methods used: [`group_by_key`](https://itsthedevman.com/docs/everythingrb/Enumerable.html#group_by_key-instance_method)_
 
-Create natural language lists:
+Build 'or'-joined lists:
 
 ```ruby
 # BEFORE
@@ -305,9 +279,11 @@ _Methods used: [`to_or_sentence`](https://itsthedevman.com/docs/everythingrb/Arr
 
 **Extensions:** [`join_map`](https://itsthedevman.com/docs/everythingrb/Array.html#join_map-instance_method), [`key_map`](https://itsthedevman.com/docs/everythingrb/Array.html#key_map-instance_method), [`dig_map`](https://itsthedevman.com/docs/everythingrb/Array.html#dig_map-instance_method), [`to_or_sentence`](https://itsthedevman.com/docs/everythingrb/Array.html#to_or_sentence-instance_method), [`group_by_key`](https://itsthedevman.com/docs/everythingrb/Enumerable.html#group_by_key-instance_method)
 
-### Hash Convenience
+Here's just that section with the fixes:
+
+---
 
-Work with hashes more intuitively.
+### Hash Convenience
 
 Transform values with access to their keys:
 
@@ -344,13 +320,13 @@ admins = users.select { |_k, v| v[:role] == "admin" }.values
 
 ```ruby
 # AFTER
-users.values_where { |_k, v| v[:role] == "admin" }
+users.select_values { |_k, v| v[:role] == "admin" }
 # => [{name: "Alice", role: "admin"}, {name: "Charlie", role: "admin"}]
 ```
 
-_Methods used: [`values_where`](https://itsthedevman.com/docs/everythingrb/Hash.html#values_where-instance_method)_
+_Methods used: [`select_values`](https://itsthedevman.com/docs/everythingrb/Hash.html#select_values-instance_method)_
 
-Just want the first match? Even simpler:
+Just want the first match?
 
 ```ruby
 # BEFORE
@@ -360,11 +336,11 @@ users.find { |_k, v| v[:role] == "admin" }&.last
 
 ```ruby
 # AFTER
-users.value_where { |_k, v| v[:role] == "admin" }
+users.find_value { |_k, v| v[:role] == "admin" }
 # => {name: "Alice", role: "admin"}
 ```
 
-_Methods used: [`value_where`](https://itsthedevman.com/docs/everythingrb/Hash.html#value_where-instance_method)_
+_Methods used: [`find_value`](https://itsthedevman.com/docs/everythingrb/Hash.html#find_value-instance_method)_
 
 Rename keys while preserving order:
 
@@ -374,14 +350,10 @@ config = {api_key: "secret", timeout: 30}
 new_config = config.each_with_object({}) do |(key, value), hash|
   new_key =
     case key
-    when :api_key
-      :key
-    when :timeout
-      :request_timeout
-    else
-      key
+    when :api_key then :key
+    when :timeout then :request_timeout
+    else key
     end
-
   hash[new_key] = value
 end
 # => {key: "secret", request_timeout: 30}
@@ -396,65 +368,45 @@ config.rename_keys(api_key: :key, timeout: :request_timeout)
 
 _Methods used: [`rename_keys`](https://itsthedevman.com/docs/everythingrb/Hash.html#rename_keys-instance_method)_
 
-Conditionally merge hashes with clear intent:
-
-```ruby
-# BEFORE
-user_params = {name: "Alice", role: "user"}
-filtered = {verified: true, admin: true}.select { |k, v| v == true && k == :verified }
-user_params.merge(filtered)
-# => {name: "Alice", role: "user", verified: true}
-```
-
-```ruby
-# AFTER
-user_params = {name: "Alice", role: "user"}
-user_params.merge_if(verified: true, admin: true) { |k, v| v == true && k == :verified }
-# => {name: "Alice", role: "user", verified: true}
-```
-
-_Methods used: [`merge_if`](https://itsthedevman.com/docs/everythingrb/Hash.html#merge_if-instance_method)_
-
-The nil-filtering pattern we've all written dozens of times:
+Merge while dropping nils:
 
 ```ruby
 # BEFORE
 params = {sort: "created_at"}
-filtered = {filter: "active", search: nil}.compact
-params.merge(filtered)
+search_params = {filter: "active", search: nil}.compact
+params.merge(search_params)
 # => {sort: "created_at", filter: "active"}
 ```
 
 ```ruby
 # AFTER
-params = {sort: "created_at"}
-params.compact_merge(filter: "active", search: nil)
+search_params = {filter: "active", search: nil}
+params.compact_merge(search_params)
 # => {sort: "created_at", filter: "active"}
 ```
 
 _Methods used: [`compact_merge`](https://itsthedevman.com/docs/everythingrb/Hash.html#compact_merge-instance_method)_
 
-Filter out blank values too when ActiveSupport is loaded:
+Merge while dropping nils and blank values (requires ActiveSupport):
 
 ```ruby
 # BEFORE
-config = {api_key: "secret", timeout: 30}
-user_settings = {timeout: "", retries: nil, debug: true, tags: []}
-clean_settings = user_settings.reject { |k, v| v.blank? }
-config.merge(clean_settings)
-# => {api_key: "secret", timeout: 30, debug: true}
+params = {sort: "created_at"}
+search_params = {filter: "active", search: nil, query: ""}.reject { |_k, v| v.blank? }
+params.merge(search_params)
+# => {sort: "created_at", filter: "active"}
 ```
 
 ```ruby
 # AFTER
-config = {api_key: "secret", timeout: 30}
-config.compact_blank_merge(timeout: "", retries: nil, debug: true, tags: [])
-# => {api_key: "secret", timeout: 30, debug: true}
+search_params = {filter: "active", search: nil, query: ""}
+params.compact_blank_merge(search_params)
+# => {sort: "created_at", filter: "active"}
 ```
 
 _Methods used: [`compact_blank_merge`](https://itsthedevman.com/docs/everythingrb/Hash.html#compact_blank_merge-instance_method)_
 
-**Extensions:** [`transform_values(with_key: true)`](https://itsthedevman.com/docs/everythingrb/Hash.html#transform_values-instance_method), [`value_where`](https://itsthedevman.com/docs/everythingrb/Hash.html#value_where-instance_method), [`values_where`](https://itsthedevman.com/docs/everythingrb/Hash.html#values_where-instance_method), [`rename_key`](https://itsthedevman.com/docs/everythingrb/Hash.html#rename_key-instance_method), [`rename_keys`](https://itsthedevman.com/docs/everythingrb/Hash.html#rename_keys-instance_method), [`merge_if`](https://itsthedevman.com/docs/everythingrb/Hash.html#merge_if-instance_method), [`merge_if!`](https://itsthedevman.com/docs/everythingrb/Hash.html#merge_if%21-instance_method), [`merge_if_values`](https://itsthedevman.com/docs/everythingrb/Hash.html#merge_if_values-instance_method), [`merge_if_values!`](https://itsthedevman.com/docs/everythingrb/Hash.html#merge_if_values%21-instance_method), [`compact_merge`](https://itsthedevman.com/docs/everythingrb/Hash.html#compact_merge-instance_method), [`compact_merge!`](https://itsthedevman.com/docs/everythingrb/Hash.html#compact_merge%21-instance_method), [`compact_blank_merge`](https://itsthedevman.com/docs/everythingrb/Hash.html#compact_blank_merge-instance_method), [`compact_blank_merge!`](https://itsthedevman.com/docs/everythingrb/Hash.html#compact_blank_merge%21-instance_method)
+**Extensions:** [`transform_values(with_key: true)`](https://itsthedevman.com/docs/everythingrb/Hash.html#transform_values-instance_method), [`find_value`](https://itsthedevman.com/docs/everythingrb/Hash.html#find_value-instance_method), [`select_values`](https://itsthedevman.com/docs/everythingrb/Hash.html#select_values-instance_method), [`rename_key`](https://itsthedevman.com/docs/everythingrb/Hash.html#rename_key-instance_method), [`rename_keys`](https://itsthedevman.com/docs/everythingrb/Hash.html#rename_keys-instance_method), [`merge_if`](https://itsthedevman.com/docs/everythingrb/Hash.html#merge_if-instance_method), [`merge_if!`](https://itsthedevman.com/docs/everythingrb/Hash.html#merge_if%21-instance_method), [`merge_if_values`](https://itsthedevman.com/docs/everythingrb/Hash.html#merge_if_values-instance_method), [`merge_if_values!`](https://itsthedevman.com/docs/everythingrb/Hash.html#merge_if_values%21-instance_method), [`compact_merge`](https://itsthedevman.com/docs/everythingrb/Hash.html#compact_merge-instance_method), [`compact_merge!`](https://itsthedevman.com/docs/everythingrb/Hash.html#compact_merge%21-instance_method), [`compact_blank_merge`](https://itsthedevman.com/docs/everythingrb/Hash.html#compact_blank_merge-instance_method), [`compact_blank_merge!`](https://itsthedevman.com/docs/everythingrb/Hash.html#compact_blank_merge%21-instance_method)
 
 ### Array Cleaning
 
@@ -474,7 +426,7 @@ data.drop_while(&:nil?).reverse.drop_while(&:nil?).reverse
 
 _Methods used: [`trim_nils`](https://itsthedevman.com/docs/everythingrb/Array.html#trim_nils-instance_method)_
 
-With ActiveSupport, remove blank values too:
+With ActiveSupport, remove blank values from the edges too:
 
 ```ruby
 # BEFORE
@@ -494,7 +446,7 @@ _Methods used: [`trim_blanks`](https://itsthedevman.com/docs/everythingrb/Array.
 
 ### String Formatting
 
-Format strings and other values consistently:
+Format values consistently without a helper method:
 
 ```ruby
 # BEFORE
@@ -533,7 +485,7 @@ message = "You selected #{selection.in_quotes}"
 
 _Methods used: [`in_quotes`](https://itsthedevman.com/docs/everythingrb/Everythingrb/InspectQuotable.html#in_quotes-instance_method), [`with_quotes`](https://itsthedevman.com/docs/everythingrb/Everythingrb/InspectQuotable.html#with_quotes-instance_method)_
 
-Convert strings to camelCase with ease:
+Convert strings to camelCase:
 
 ```ruby
 # BEFORE
@@ -554,7 +506,7 @@ camel_case
 "user_profile_settings".to_camelcase       # => "UserProfileSettings"
 "user_profile_settings".to_camelcase(:lower)  # => "userProfileSettings"
 
-# Handles all kinds of input consistently
+# Handles mixed input consistently
 "please-WAIT while_loading...".to_camelcase  # => "PleaseWaitWhileLoading"
 ```
 
@@ -564,7 +516,7 @@ _Methods used: [`to_camelcase`](https://itsthedevman.com/docs/everythingrb/Strin
 
 ### Boolean Methods
 
-Create predicate methods with minimal code:
+Define predicate methods from any attribute:
 
 ```ruby
 # BEFORE
@@ -595,6 +547,39 @@ user.admin?  # => true
 
 _Methods used: [`attr_predicate`](https://itsthedevman.com/docs/everythingrb/Module.html#attr_predicate-instance_method)_
 
+Map predicates to differently-named sources with `from:`:
+
+```ruby
+# BEFORE
+class Task
+  attr_accessor :started_at, :stopped_at
+
+  def started?
+    !@started_at.nil?
+  end
+
+  def finished?
+    !@stopped_at.nil?
+  end
+end
+```
+
+```ruby
+# AFTER
+class Task
+  attr_accessor :started_at, :stopped_at
+  attr_predicate :started, from: :@started_at
+  attr_predicate :finished, from: :@stopped_at
+end
+
+task = Task.new
+task.started?      # => false
+task.started_at = Time.now
+task.started?      # => true
+```
+
+_Methods used: [`attr_predicate`](https://itsthedevman.com/docs/everythingrb/Module.html#attr_predicate-instance_method)_
+
 Works with Data objects too:
 
 ```ruby
@@ -619,7 +604,7 @@ _Methods used: [`attr_predicate`](https://itsthedevman.com/docs/everythingrb/Mod
 
 ### Value Transformation
 
-Chain transformations with a more descriptive syntax:
+An alias for `then`/`yield_self` that reads more naturally in transformation chains:
 
 ```ruby
 # BEFORE
@@ -649,10 +634,4 @@ Bug reports and pull requests are welcome! This project is intended to be a safe
 
 ## License
 
-[MIT License](LICENSE.txt)
-
-## Looking for a Software Engineer?
-
-I'm currently looking for opportunities where I can tackle meaningful problems and help build reliable software while mentoring the next generation of developers. If you're looking for a senior engineer with full-stack Rails expertise and a passion for clean, maintainable code, let's talk!
-
-[bryan@itsthedevman.com](mailto:bryan@itsthedevman.com)
+[MIT License](LICENSE.txt)

data/Rakefile

@@ -17,3 +17,27 @@ require "standard/rake"
 
 task test: [:test_regular, :test_active_support]
 task default: %i[test standard]
+
+# Benchmark tasks
+namespace :benchmark do
+  desc "Run all benchmarks"
+  task :all do
+    ruby "benchmarks/run_all.rb"
+  end
+
+  desc "Run all benchmarks with ActiveSupport"
+  task :all_with_active_support do
+    ENV["LOAD_ACTIVE_SUPPORT"] = "true"
+    ruby "benchmarks/run_all.rb"
+  end
+
+  %w[array hash string enumerable ostruct module kernel quotable].each do |name|
+    desc "Run #{name} benchmarks"
+    task name.to_sym do
+      ruby "benchmarks/#{name}_benchmark.rb"
+    end
+  end
+end
+
+desc "Run all benchmarks"
+task benchmark: "benchmark:all"

data/benchmarks/array_benchmark.rb

@@ -0,0 +1,108 @@
+# frozen_string_literal: true
+
+require_relative "benchmark_helper"
+
+BenchmarkHelper.header("Array Extension Benchmarks")
+
+# Test data
+small_array = (1..10).to_a
+medium_array = (1..100).to_a
+large_array = (1..1000).to_a
+
+small_hashes = [{name: "Alice", age: 30}, {name: "Bob", age: 25}, {name: "Charlie", age: 35}]
+medium_hashes = (1..100).map { |i| {name: "User#{i}", age: 20 + (i % 50)} }
+large_hashes = (1..1000).map { |i| {name: "User#{i}", age: 20 + (i % 50)} }
+
+nested_hashes = [
+  {user: {profile: {name: "Alice"}}},
+  {user: {profile: {name: "Bob"}}},
+  {user: {profile: {name: "Charlie"}}}
+]
+
+array_with_nils_prefix = [nil, nil, nil, 1, 2, 3, nil, 4, 5]
+array_with_nils_suffix = [1, 2, 3, nil, 4, 5, nil, nil, nil]
+array_with_nils_both = [nil, nil, 1, 2, nil, 3, 4, nil, nil]
+
+# ============================================================================
+# join_map benchmarks
+# ============================================================================
+
+BenchmarkHelper.run("join_map - small array (10 elements)") do |x|
+  x.report("join_map") { small_array.join_map(", ") { |n| n.to_s if n.even? } }
+  x.report("join_map(with_index)") { small_array.join_map(", ", with_index: true) { |n, i| "#{i}:#{n}" } }
+end
+
+BenchmarkHelper.run("join_map - medium array (100 elements)") do |x|
+  x.report("join_map") { medium_array.join_map(", ") { |n| n.to_s if n.even? } }
+  x.report("join_map(with_index)") { medium_array.join_map(", ", with_index: true) { |n, i| "#{i}:#{n}" } }
+end
+
+BenchmarkHelper.run("join_map - large array (1000 elements)") do |x|
+  x.report("join_map") { large_array.join_map(", ") { |n| n.to_s if n.even? } }
+  x.report("join_map(with_index)") { large_array.join_map(", ", with_index: true) { |n, i| "#{i}:#{n}" } }
+end
+
+# ============================================================================
+# key_map benchmarks
+# ============================================================================
+
+BenchmarkHelper.run("key_map - small array of hashes (3 elements)") do |x|
+  x.report("key_map") { small_hashes.key_map(:name) }
+end
+
+BenchmarkHelper.run("key_map - medium array of hashes (100 elements)") do |x|
+  x.report("key_map") { medium_hashes.key_map(:name) }
+end
+
+BenchmarkHelper.run("key_map - large array of hashes (1000 elements)") do |x|
+  x.report("key_map") { large_hashes.key_map(:name) }
+end
+
+# ============================================================================
+# dig_map benchmarks
+# ============================================================================
+
+BenchmarkHelper.run("dig_map - nested hashes") do |x|
+  x.report("dig_map(:user, :profile, :name)") { nested_hashes.dig_map(:user, :profile, :name) }
+end
+
+# ============================================================================
+# compact_prefix / compact_suffix / trim_nils benchmarks
+# ============================================================================
+
+BenchmarkHelper.run("nil trimming operations") do |x|
+  x.report("compact_prefix") { array_with_nils_prefix.compact_prefix }
+  x.report("compact_suffix") { array_with_nils_suffix.compact_suffix }
+  x.report("trim_nils") { array_with_nils_both.trim_nils }
+end
+
+# ============================================================================
+# in_quotes benchmarks
+# ============================================================================
+
+BenchmarkHelper.run("in_quotes / with_quotes") do |x|
+  x.report("small array in_quotes") { small_array.in_quotes }
+  x.report("medium array in_quotes") { medium_array.in_quotes }
+end
+
+# ============================================================================
+# ActiveSupport-only benchmarks
+# ============================================================================
+
+if BenchmarkHelper.active_support?
+  array_with_blanks = ["", nil, "foo", "", "bar", nil, ""]
+  words = %w[red blue green]
+
+  BenchmarkHelper.run("compact_blank_prefix / compact_blank_suffix / trim_blanks") do |x|
+    x.report("compact_blank_prefix") { array_with_blanks.compact_blank_prefix }
+    x.report("compact_blank_suffix") { array_with_blanks.compact_blank_suffix }
+    x.report("trim_blanks") { array_with_blanks.trim_blanks }
+  end
+
+  BenchmarkHelper.run("to_or_sentence") do |x|
+    x.report("to_or_sentence") { words.to_or_sentence }
+    x.report("to_or_sentence(custom)") { words.to_or_sentence(locale: :en) }
+  end
+else
+  puts "\n[SKIPPED] ActiveSupport benchmarks - run with LOAD_ACTIVE_SUPPORT=true"
+end

data/benchmarks/benchmark_helper.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require "bundler/setup"
+require "benchmark/ips"
+
+# Load ActiveSupport first if requested
+if ENV["LOAD_ACTIVE_SUPPORT"] == "true"
+  require "active_support"
+  require "active_support/core_ext"
+end
+
+require "everythingrb"
+
+# Helper module for benchmark formatting and utilities
+module BenchmarkHelper
+  class << self
+    def header(title)
+      puts "\n" + "=" * 70
+      puts title.center(70)
+      puts "=" * 70
+    end
+
+    def section(title)
+      puts "\n#{"-" * 30}"
+      puts title
+      puts "-" * 30
+    end
+
+    def run(title, warmup: 2, time: 5, &block)
+      section(title)
+
+      Benchmark.ips do |x|
+        x.config(warmup:, time:)
+        block.call(x)
+      end
+    end
+
+    def active_support?
+      defined?(ActiveSupport)
+    end
+  end
+end