sorbet-schema 0.9.2 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4546ee5b80f3b538d7c3f9813501f066ef1f033693f5328f8789f26f9d7537dc
-  data.tar.gz: 3c658049c62dcd8ab506bc3cc72fa926731fd8a712c1436f0277339edc88d290
+  metadata.gz: b0c3bb89fee8f842f919e0cf1f53d8f97fb12e4464effb88c7e821134c531a1f
+  data.tar.gz: a78684855bb1bd76e6688b0daa04f026fcb55c23fd2f354daaea8e7a2f0f5cd3
 SHA512:
-  metadata.gz: a2f8a6bec49a48abd11c0d6ee1eac7eb9d2a85965a02633635b9361d82bad46bedb6c02d213cf226f6cb644e803c575ded85e3eaf6c06cbe9ae34068e7dd1985
-  data.tar.gz: db1a6c0bf48b2fd6628b77dd324e06b42d9cb7e8e222b54523e0beeb7e10395b5a86d2a3fd7b3afe36453f2b8386f3bde758cbd9893aefee9e8d1fca8490f533
+  metadata.gz: 28656d268e7861ae7e069ff30b024a2d063ee33f5824ca9bc1319cbe91555b2e80b402ee2438b975d299c58f624c4e8afba1ba8649a62c8d05a6efc3fa10fbac
+  data.tar.gz: 9faf4f7458d56d9a66645d1d25aa4d70a83eea9abba3e1021a5fe58a5978d0c309a987d20e5af1dfc538f5d0a550f40ed1afa6a35c39ff2e5173a9b44a6cd118

data/.ruby-version

@@ -1 +1 @@
-3.3.4
+3.4.7

data/AGENTS.md

@@ -0,0 +1,15 @@
+# Project agent memory
+
+This file is the project's committed home for project-intrinsic agent knowledge: build, test, release, architecture, and sharp-edge notes that should travel with the code.
+
+- Add durable project-specific notes here as they are discovered through real work.
+- Ruby 3.4+ unbundles former stdlib gems (e.g. `csv`) from the default load path, so `require "csv"` is not free — it needs the gem actually installed.
+- Format-specific serializers (`CSVSerializer`, `MessagePackSerializer`, `ActiveRecordSerializer`) treat their backing gem as optional: no top-level `require`, gem is `add_development_dependency` only (not `add_runtime_dependency`), the `require`/gem-presence check happens lazily in `initialize` with a clear `ArgumentError` on failure, and `T::Struct.serializer`'s factory (`lib/sorbet-schema/t/struct.rb`) mirrors that same guard via `defined?(...)`. Follow this pattern for any new serializer/coercer with a non-stdlib dependency; see `lib/typed/csv_serializer.rb` for the exact shape.
+- After adding a new *required* runtime gem dependency (not this optional-serializer case), run `bundle exec tapioca gem` (add the gem to `sorbet/tapioca/require.rb` first if it isn't required anywhere else) so `bundle exec rake` (which runs `srb tc`) has an RBI to check against.
+
+## Maintaining this file
+
+Keep this file for knowledge useful to almost every future agent session in this project.
+Do not repeat what the codebase already shows; point to the authoritative file or command instead.
+Prefer rewriting or pruning existing entries over appending new ones.
+When updating this file, preserve this bar for all agents and keep entries concise.

data/CHANGELOG.md

@@ -4,6 +4,40 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.10.0](https://github.com/maxveldink/sorbet-schema/compare/v0.9.3...v0.10.0) (2026-08-07)
+
+
+### ⚠ BREAKING CHANGES
+
+* bump local Ruby to 3.4, add to matrix ([#138](https://github.com/maxveldink/sorbet-schema/issues/138))
+
+### Features
+
+* add Typed::CSVSerializer ([#12](https://github.com/maxveldink/sorbet-schema/issues/12)) ([#144](https://github.com/maxveldink/sorbet-schema/issues/144)) ([b2377f0](https://github.com/maxveldink/sorbet-schema/commit/b2377f083782c0eb39ab442b14cb4bf18a2a8922))
+* add Typed::MessagePackSerializer ([#145](https://github.com/maxveldink/sorbet-schema/issues/145)) ([d367da8](https://github.com/maxveldink/sorbet-schema/commit/d367da83b2d9e72f5099b70594243178c3df432c))
+* add Typed::YMLSerializer ([#13](https://github.com/maxveldink/sorbet-schema/issues/13)) ([#143](https://github.com/maxveldink/sorbet-schema/issues/143)) ([bcc7eb8](https://github.com/maxveldink/sorbet-schema/commit/bcc7eb810f32b46d454df3a0c19468b0de09f498))
+* **typed:** add ActiveRecord serializer ([#140](https://github.com/maxveldink/sorbet-schema/issues/140)) ([a815f9f](https://github.com/maxveldink/sorbet-schema/commit/a815f9f42cb36c26ead45630384eb6b5022cd43d))
+
+
+### Bug Fixes
+
+* **typed:** make csv and msgpack gem dependencies optional ([#146](https://github.com/maxveldink/sorbet-schema/issues/146)) ([db22258](https://github.com/maxveldink/sorbet-schema/commit/db222586207129fc46d981a8efd28413aea99c7b))
+
+
+### Miscellaneous Chores
+
+* bump local Ruby to 3.4, add to matrix ([#138](https://github.com/maxveldink/sorbet-schema/issues/138)) ([1cf6a5b](https://github.com/maxveldink/sorbet-schema/commit/1cf6a5bdb77137ee34aa5c1bca66dd1ede37f875))
+
+## [0.9.3](https://github.com/maxveldink/sorbet-schema/compare/v0.9.2...v0.9.3) (2025-12-06)
+
+
+### Performance Improvements
+
+* add deserialization benchmark ([#135](https://github.com/maxveldink/sorbet-schema/issues/135)) ([21d23bb](https://github.com/maxveldink/sorbet-schema/commit/21d23bb51c40ee199cb79a54f06184bb15634909))
+* add serialization benchmarks, refactor to helpers ([#137](https://github.com/maxveldink/sorbet-schema/issues/137)) ([dc43409](https://github.com/maxveldink/sorbet-schema/commit/dc434094511f26ddc37f853295b2f07586826f00))
+* Implement caching for serializers and coercers to improve performance ([#136](https://github.com/maxveldink/sorbet-schema/issues/136)) ([d980292](https://github.com/maxveldink/sorbet-schema/commit/d980292b64630c9ee93f886b10b3b9334b694879))
+* Improve coercer performance by using class methods ([#134](https://github.com/maxveldink/sorbet-schema/issues/134)) ([0336299](https://github.com/maxveldink/sorbet-schema/commit/033629914c7ac0e19d21a725336ff7b9dbc8fc90))
+
 ## [0.9.2](https://github.com/maxveldink/sorbet-schema/compare/v0.9.1...v0.9.2) (2024-09-04)
 
 

data/CLAUDE.md

@@ -0,0 +1 @@
+AGENTS.md

data/Gemfile

@@ -6,12 +6,13 @@ source "https://rubygems.org"
 gemspec
 
 group :development do
+  gem "benchmark-ips"
   gem "rake"
   gem "standard"
   gem "standard-performance"
   gem "standard-sorbet"
   gem "sorbet"
-  gem "tapioca", require: false
+  gem "tapioca", "~> 0.16.6", require: false
 end
 
 group :development, :test do
@@ -23,4 +24,7 @@ group :development, :test do
   gem "debug"
 
   gem "sorbet-struct-comparable"
+
+  gem "activerecord", ">= 6.0"
+  gem "sqlite3"
 end

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    sorbet-schema (0.9.2)
+    sorbet-schema (0.10.0)
       sorbet-result (~> 1.1)
       sorbet-runtime (~> 0.5)
       sorbet-struct-comparable (~> 1.3)
@@ -10,14 +10,41 @@ PATH
 GEM
   remote: https://rubygems.org/
   specs:
+    activemodel (8.1.2)
+      activesupport (= 8.1.2)
+    activerecord (8.1.2)
+      activemodel (= 8.1.2)
+      activesupport (= 8.1.2)
+      timeout (>= 0.4.0)
+    activesupport (8.1.2)
+      base64
+      bigdecimal
+      concurrent-ruby (~> 1.0, >= 1.3.1)
+      connection_pool (>= 2.2.5)
+      drb
+      i18n (>= 1.6, < 2)
+      json
+      logger (>= 1.4.2)
+      minitest (>= 5.1)
+      securerandom (>= 0.3)
+      tzinfo (~> 2.0, >= 2.0.5)
+      uri (>= 0.13.1)
     ansi (1.5.0)
     ast (2.4.2)
+    base64 (0.3.0)
+    benchmark-ips (2.14.0)
     bigdecimal (3.1.8)
     builder (3.3.0)
+    concurrent-ruby (1.3.6)
+    connection_pool (3.0.2)
+    csv (3.3.6)
     debug (1.9.2)
       irb (~> 1.10)
       reline (>= 0.3.8)
+    drb (2.2.3)
     erubi (1.13.0)
+    i18n (1.14.8)
+      concurrent-ruby (~> 1.0)
     io-console (0.7.2)
     irb (1.14.0)
       rdoc (>= 4.0.0)
@@ -25,6 +52,7 @@ GEM
     json (2.7.2)
     language_server-protocol (3.17.0.3)
     lint_roller (1.1.0)
+    logger (1.7.0)
     minitest (5.24.1)
     minitest-focus (1.4.0)
       minitest (>= 4, < 6)
@@ -33,20 +61,23 @@ GEM
       builder
       minitest (>= 5.0)
       ruby-progressbar
+    msgpack (1.8.4)
     netrc (0.11.0)
     parallel (1.25.1)
     parser (3.3.3.0)
       ast (~> 2.4.1)
       racc
-    prism (0.30.0)
+    prism (1.6.0)
     psych (5.1.2)
       stringio
     racc (1.8.0)
     rainbow (3.1.1)
     rake (13.2.1)
-    rbi (0.1.13)
-      prism (>= 0.18.0, < 1.0.0)
-      sorbet-runtime (>= 0.5.9204)
+    rbi (0.3.7)
+      prism (~> 1.0)
+      rbs (>= 3.4.4)
+    rbs (3.9.5)
+      logger
     rdoc (6.7.0)
       psych (>= 4.0.0)
     regexp_parser (2.9.2)
@@ -73,6 +104,7 @@ GEM
     rubocop-sorbet (0.7.8)
       rubocop (>= 0.90.0)
     ruby-progressbar (1.13.0)
+    securerandom (0.4.1)
     sorbet (0.5.11475)
       sorbet-static (= 0.5.11475)
     sorbet-result (1.1.0)
@@ -90,6 +122,8 @@ GEM
       prism (>= 0.28.0)
       sorbet-static-and-runtime (>= 0.5.10187)
       thor (>= 0.19.2)
+    sqlite3 (2.9.0-arm64-darwin)
+    sqlite3 (2.9.0-x86_64-linux-gnu)
     standard (1.39.1)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.0)
@@ -107,17 +141,21 @@ GEM
       rubocop-sorbet (~> 0.7.0)
     stringio (3.1.1)
     strscan (3.1.0)
-    tapioca (0.15.0)
+    tapioca (0.16.6)
       bundler (>= 2.2.25)
       netrc (>= 0.11.0)
       parallel (>= 1.21.0)
-      rbi (>= 0.1.4, < 0.2)
+      rbi (~> 0.2)
       sorbet-static-and-runtime (>= 0.5.11087)
       spoom (>= 1.2.0)
       thor (>= 1.2.0)
       yard-sorbet
     thor (1.3.1)
+    timeout (0.6.0)
+    tzinfo (2.0.6)
+      concurrent-ruby (~> 1.0)
     unicode-display_width (2.5.0)
+    uri (1.1.1)
     yard (0.9.36)
     yard-sorbet (0.9.0)
       sorbet-runtime
@@ -127,22 +165,29 @@ GEM
 PLATFORMS
   arm64-darwin-22
   arm64-darwin-23
+  arm64-darwin-25
+  arm64-darwin-27
   x86_64-linux
 
 DEPENDENCIES
+  activerecord (>= 6.0)
+  benchmark-ips
   bigdecimal
+  csv (~> 3.3)
   debug
   minitest
   minitest-focus
   minitest-reporters
+  msgpack (~> 1.7)
   rake
   sorbet
   sorbet-schema!
   sorbet-struct-comparable
+  sqlite3
   standard
   standard-performance
   standard-sorbet
-  tapioca
+  tapioca (~> 0.16.6)
 
 BUNDLED WITH
-   2.5.15
+   2.7.2

data/README.md

@@ -54,6 +54,8 @@ result = max.serialize_to(:json)
 result.payload # == '{"name":"Max","age":29}'
 ```
 
+`:hash`, `:json`, `:csv`, `:yml`, and `:msgpack` are all supported as the first argument to `deserialize_from`/`serialize_to` (and the equivalent `from_hash`/`from_json`/`from_csv`/`from_yml`/`from_msgpack` methods on `Typed::Schema`), corresponding to the built-in serializers below.
+
 Notice that both `deserialize` and `serialize` return `Typed::Result`s (from the [sorbet-result gem](https://github.com/maxveldink/sorbet-result)) that need to be checked for success or failure before being used. Check out that gem's README for more information on how to interact with `Result`s.
 
 One benefit of using `Result`s is we can add much more details information about why a format is unsuccessfully deserialized or serialized, to provide call sites with more information for error handling, messaging and formatting.
@@ -109,6 +111,8 @@ end
 
 These are the currently available serializers. For more information about implementing a custom one (or contributing one back!), see [Custom Coercers](#custom-coercers).
 
+`HashSerializer`, `JSONSerializer`, and `YMLSerializer` work out of the box with no extra dependencies. `CSVSerializer` and `MessagePackSerializer` require you to add the `csv` and `msgpack` gems, respectively, to your own Gemfile - they are not pulled in as runtime dependencies of `sorbet-schema` itself. Referencing `:csv`/`:msgpack` via `serializer`/`deserialize_from`/`serialize_to` without the gem installed raises a clear `ArgumentError` telling you which gem to add.
+
 #### JSONSerializer
 
 See [Getting Started](#getting-started) for more information on how to use the JSONSerializer.
@@ -129,6 +133,86 @@ max = result.payload # == Person.new(name: "Max", age: 29)
 
 By default, the `HashSerializer` will _not_ serialize values when converting to a Hash. For instance, if a field is an `T::Enum` type, when it is serialized to a `Hash` the value will be the `Enum` and not the `String` representation. The `should_serialize_values` option can be passed during initialization to serialize the values when converting to the `Hash`.
 
+#### CSVSerializer
+
+Accepts and returns a CSV string representing a single record, with a header row followed by one data row:
+
+```ruby
+csv_serializer = Typed::CSVSerializer.new(schema: Person.schema)
+
+# Deserialize from target format
+result = csv_serializer.deserialize("name,age\nMax,29\n")
+max = result.payload # == Person.new(name: "Max", age: 29)
+
+# Serialize to target format
+result = csv_serializer.serialize(max)
+result.payload # == "name,age\nMax,29\n"
+```
+
+CSV is a flat, row-based format, so nested `T::Struct`s, `Hash`es, and `Array`s cannot be represented as their own columns. Rather than writing a lossy representation into a cell that can never be parsed back correctly, `CSVSerializer#serialize` returns a `Typed::SerializeError` naming the offending field(s) when a struct has one. Prefer this serializer for schemas with scalar fields only, or use an `inline_serializer` (see [Inline Serializers](#inline-serializers)) to flatten a nested field into a scalar before serializing it to CSV.
+
+#### YMLSerializer
+
+Works just like the `JSONSerializer`, but with YAML strings:
+
+```ruby
+yml_serializer = Typed::YMLSerializer.new(schema: Person.schema)
+
+# Deserialize from target format
+result = yml_serializer.deserialize("---\nname: Max\nage: 29\n")
+max = result.payload # == Person.new(name: "Max", age: 29)
+
+# Serialize to target format
+result = yml_serializer.serialize(max)
+result.payload # == "---\nname: Max\nage: 29\n"
+```
+
+#### MessagePackSerializer
+
+Works just like the `JSONSerializer`, but with [MessagePack](https://msgpack.org/) binary-encoded strings, using the [`msgpack`](https://github.com/msgpack/msgpack-ruby) gem:
+
+```ruby
+message_pack_serializer = Typed::MessagePackSerializer.new(schema: Person.schema)
+
+# Deserialize from target format
+result = message_pack_serializer.deserialize(MessagePack.pack({"name" => "Max", "age" => 29}))
+max = result.payload # == Person.new(name: "Max", age: 29)
+
+# Serialize to target format
+result = message_pack_serializer.serialize(max)
+result.payload # == MessagePack.pack({"name" => "Max", "age" => 29})
+```
+
+Unlike `CSVSerializer`, MessagePack natively supports nested maps and arrays, so nested `T::Struct`s, `Hash`es, and `Array`s round-trip without any `inline_serializer` needed.
+
+#### ActiveRecordSerializer
+
+Requires the `activerecord` gem to be available. This is only checked when going through `.serializer(:activerecord)`, which raises an `ArgumentError` if the gem isn't loaded; calling `Typed::ActiveRecordSerializer.new` directly without ActiveRecord loaded instead raises a `NameError`, since the class itself references the `ActiveRecord` constant. The `Typed::ActiveRecordSerializer` converts between `ActiveRecord::Base` model instances and `T::Struct`s, matching fields by attribute name and mapping associated records through the model's declared associations. It requires a `model_class` option, in addition to `schema`, so it knows which `ActiveRecord::Base` subclass to deserialize from and serialize to:
+
+```ruby
+ar_serializer = Typed::ActiveRecordSerializer.new(schema: Person.schema, model_class: PersonModel)
+
+# Deserialize from target format
+result = ar_serializer.deserialize(PersonModel.new(name: "Max", age: 29))
+max = result.payload # == Person.new(name: "Max", age: 29)
+
+result = ar_serializer.serialize(max)
+result.payload # == PersonModel instance with name: "Max", age: 29
+```
+
+When serializing, only fields that map to a column (or to an association's declared foreign key) on `model_class` are assigned; the rest are ignored.
+
+Nested `belongs_to` associations are deserialized recursively to arbitrary depth, so a `T::Struct` field whose type is itself a `T::Struct` backed by a `belongs_to` association will have its own nested associations resolved too.
+
+Deserializing reads through the model's association readers, so it is subject to the same N+1 query behavior as any other Rails association access. Preloading with `includes` works transparently and is the recommended way to avoid a query per record per association when deserializing a collection:
+
+```ruby
+# 1 query for people + 1 query for locations, instead of 1 + N
+PersonModel.includes(:location).find_each do |person_model|
+  ar_serializer.deserialize(person_model)
+end
+```
+
 ### Customization
 
 From the get-go, Sorbet Schema is designed to be extensible to model more complex data validation requirements and many serialization formats. We try out best to include built-in, battle-tested coercers and serializers from real world use cases and would love to see/upstream any customizations that the community have found useful!

data/benchmarks/helpers.rb

@@ -0,0 +1,238 @@
+# typed: strict
+# frozen_string_literal: true
+
+$LOAD_PATH.unshift(File.expand_path("../lib", __dir__))
+
+require "json"
+require "sorbet-schema"
+
+module BenchmarkHelpers
+  extend T::Sig
+
+  class Rank < T::Enum
+    enums do
+      Ace = new("Ace")
+      King = new("King")
+      Queen = new("Queen")
+      Jack = new("Jack")
+      Ten = new("Ten")
+      Nine = new("Nine")
+      Eight = new("Eight")
+      Seven = new("Seven")
+      Six = new("Six")
+      Five = new("Five")
+      Four = new("Four")
+      Three = new("Three")
+      Two = new("Two")
+    end
+  end
+
+  class Suit < T::Enum
+    enums do
+      Spades = new("Spades")
+      Hearts = new("Hearts")
+      Clubs = new("Clubs")
+      Diamonds = new("Diamonds")
+    end
+  end
+
+  # Define some structs for the benchmark
+  class Card < T::Struct
+    const :rank, Rank
+    const :suit, Suit
+  end
+
+  class Player < T::Struct
+    const :name, String
+    const :hand, T::Array[Card]
+  end
+
+  class Round < T::Struct
+    const :number, Integer
+    const :winner, T.nilable(Player)
+  end
+
+  class Game < T::Struct
+    const :name, String
+    const :players, T::Array[Player]
+    const :rounds, T::Array[Round]
+    const :deck_size, Integer
+    const :shuffled, T::Boolean
+  end
+
+  # Define a struct with MANY fields of the same types that require coercion
+  # This will stress-test coercer caching by reusing the same coercers many times
+  class Humongous < T::Struct
+    const :field_1, Integer
+    const :field_2, Integer
+    const :field_3, Integer
+    const :field_4, Integer
+    const :field_5, Integer
+    const :field_6, Integer
+    const :field_7, Integer
+    const :field_8, Integer
+    const :field_9, Integer
+    const :field_10, Integer
+    const :field_11, Integer
+    const :field_12, Integer
+    const :field_13, Integer
+    const :field_14, Integer
+    const :field_15, Integer
+    const :field_16, Integer
+    const :field_17, Integer
+    const :field_18, Integer
+    const :field_19, Integer
+    const :field_20, Integer
+    const :field_21, Integer
+    const :field_22, Integer
+    const :field_23, Integer
+    const :field_24, Integer
+    const :field_25, Integer
+    const :field_26, Integer
+    const :field_27, Integer
+    const :field_28, Integer
+    const :field_29, Integer
+    const :field_30, Integer
+    const :field_31, Integer
+    const :field_32, Integer
+    const :field_33, Integer
+    const :field_34, Integer
+    const :field_35, Integer
+    const :field_36, Integer
+    const :field_37, Integer
+    const :field_38, Integer
+    const :field_39, Integer
+    const :field_40, Integer
+    const :field_41, Integer
+    const :field_42, Integer
+    const :field_43, Integer
+    const :field_44, Integer
+    const :field_45, Integer
+    const :field_46, Integer
+    const :field_47, Integer
+    const :field_48, Integer
+    const :field_49, Integer
+    const :field_50, Integer
+
+    const :float_1, Float
+    const :float_2, Float
+    const :float_3, Float
+    const :float_4, Float
+    const :float_5, Float
+    const :float_6, Float
+    const :float_7, Float
+    const :float_8, Float
+    const :float_9, Float
+    const :float_10, Float
+    const :float_11, Float
+    const :float_12, Float
+    const :float_13, Float
+    const :float_14, Float
+    const :float_15, Float
+    const :float_16, Float
+    const :float_17, Float
+    const :float_18, Float
+    const :float_19, Float
+    const :float_20, Float
+
+    const :bool_1, T::Boolean
+    const :bool_2, T::Boolean
+    const :bool_3, T::Boolean
+    const :bool_4, T::Boolean
+    const :bool_5, T::Boolean
+    const :bool_6, T::Boolean
+    const :bool_7, T::Boolean
+    const :bool_8, T::Boolean
+    const :bool_9, T::Boolean
+    const :bool_10, T::Boolean
+    const :bool_11, T::Boolean
+    const :bool_12, T::Boolean
+    const :bool_13, T::Boolean
+    const :bool_14, T::Boolean
+    const :bool_15, T::Boolean
+    const :bool_16, T::Boolean
+    const :bool_17, T::Boolean
+    const :bool_18, T::Boolean
+    const :bool_19, T::Boolean
+    const :bool_20, T::Boolean
+
+    const :sym_1, Symbol
+    const :sym_2, Symbol
+    const :sym_3, Symbol
+    const :sym_4, Symbol
+    const :sym_5, Symbol
+    const :sym_6, Symbol
+    const :sym_7, Symbol
+    const :sym_8, Symbol
+    const :sym_9, Symbol
+    const :sym_10, Symbol
+    const :sym_11, Symbol
+    const :sym_12, Symbol
+    const :sym_13, Symbol
+    const :sym_14, Symbol
+    const :sym_15, Symbol
+    const :sym_16, Symbol
+    const :sym_17, Symbol
+    const :sym_18, Symbol
+    const :sym_19, Symbol
+    const :sym_20, Symbol
+  end
+
+  sig { returns(T::Hash[Symbol, T.untyped]) }
+  def self.game_data
+    {
+      name: "Poker",
+      players: Array.new(10) do |i|
+        {
+          name: "Player #{i}",
+          hand: [
+            {rank: "Ace", suit: "Spades"},
+            {rank: "King", suit: "Spades"}
+          ]
+        }
+      end,
+      rounds: Array.new(5) do |i|
+        {
+          number: i + 1,
+          winner: {
+            name: "Player #{i % 2}",
+            hand: [
+              {rank: "Queen", suit: "Hearts"},
+              {rank: "Jack", suit: "Hearts"}
+            ]
+          }
+        }
+      end,
+      deck_size: 52,
+      shuffled: true
+    }
+  end
+
+  sig { returns(T::Hash[Symbol, T.untyped]) }
+  def self.humongous_data
+    {
+      field_1: "1", field_2: "2", field_3: "3", field_4: "4", field_5: "5",
+      field_6: "6", field_7: "7", field_8: "8", field_9: "9", field_10: "10",
+      field_11: "11", field_12: "12", field_13: "13", field_14: "14", field_15: "15",
+      field_16: "16", field_17: "17", field_18: "18", field_19: "19", field_20: "20",
+      field_21: "21", field_22: "22", field_23: "23", field_24: "24", field_25: "25",
+      field_26: "26", field_27: "27", field_28: "28", field_29: "29", field_30: "30",
+      field_31: "31", field_32: "32", field_33: "33", field_34: "34", field_35: "35",
+      field_36: "36", field_37: "37", field_38: "38", field_39: "39", field_40: "40",
+      field_41: "41", field_42: "42", field_43: "43", field_44: "44", field_45: "45",
+      field_46: "46", field_47: "47", field_48: "48", field_49: "49", field_50: "50",
+      float_1: "1.1", float_2: "2.2", float_3: "3.3", float_4: "4.4", float_5: "5.5",
+      float_6: "6.6", float_7: "7.7", float_8: "8.8", float_9: "9.9", float_10: "10.1",
+      float_11: "11.1", float_12: "12.2", float_13: "13.3", float_14: "14.4", float_15: "15.5",
+      float_16: "16.6", float_17: "17.7", float_18: "18.8", float_19: "19.9", float_20: "20.1",
+      bool_1: "true", bool_2: "false", bool_3: "true", bool_4: "false", bool_5: "true",
+      bool_6: "false", bool_7: "true", bool_8: "false", bool_9: "true", bool_10: "false",
+      bool_11: "true", bool_12: "false", bool_13: "true", bool_14: "false", bool_15: "true",
+      bool_16: "false", bool_17: "true", bool_18: "false", bool_19: "true", bool_20: "false",
+      sym_1: "sym1", sym_2: "sym2", sym_3: "sym3", sym_4: "sym4", sym_5: "sym5",
+      sym_6: "sym6", sym_7: "sym7", sym_8: "sym8", sym_9: "sym9", sym_10: "sym10",
+      sym_11: "sym11", sym_12: "sym12", sym_13: "sym13", sym_14: "sym14", sym_15: "sym15",
+      sym_16: "sym16", sym_17: "sym17", sym_18: "sym18", sym_19: "sym19", sym_20: "sym20"
+    }
+  end
+end

data/benchmarks/many_fields_deserialization.rb

@@ -0,0 +1,23 @@
+# typed: strict
+# frozen_string_literal: true
+
+$LOAD_PATH.unshift(File.expand_path("../lib", __dir__))
+
+require "benchmark/ips"
+require_relative "helpers"
+
+humongous_schema = Typed::Schema.from_struct(BenchmarkHelpers::Humongous)
+humongous_data = BenchmarkHelpers.humongous_data
+humongous_json = JSON.generate(humongous_data)
+
+Benchmark.ips do |x|
+  x.report("hash deserialization with many fields") do
+    humongous_schema.from_hash(humongous_data)
+  end
+
+  x.report("json deserialization with many fields") do
+    humongous_schema.from_json(humongous_json)
+  end
+
+  x.compare!
+end

data/benchmarks/many_fields_serialization.rb

@@ -0,0 +1,26 @@
+# typed: strict
+# frozen_string_literal: true
+
+$LOAD_PATH.unshift(File.expand_path("../lib", __dir__))
+
+require "benchmark/ips"
+require_relative "helpers"
+
+humongous_schema = Typed::Schema.from_struct(BenchmarkHelpers::Humongous)
+humongous_data = BenchmarkHelpers.humongous_data
+humongous_struct = humongous_schema.from_hash(humongous_data).payload
+
+hash_serializer = Typed::HashSerializer.new(schema: humongous_schema)
+json_serializer = Typed::JSONSerializer.new(schema: humongous_schema)
+
+Benchmark.ips do |x|
+  x.report("hash serialization with many fields") do
+    hash_serializer.serialize(humongous_struct)
+  end
+
+  x.report("json serialization with many fields") do
+    json_serializer.serialize(humongous_struct)
+  end
+
+  x.compare!
+end

data/benchmarks/simple_deserialization.rb

@@ -0,0 +1,23 @@
+# typed: strict
+# frozen_string_literal: true
+
+$LOAD_PATH.unshift(File.expand_path("../lib", __dir__))
+
+require "benchmark/ips"
+require_relative "helpers"
+
+game_schema = Typed::Schema.from_struct(BenchmarkHelpers::Game)
+game_data = BenchmarkHelpers.game_data
+game_json = JSON.generate(game_data)
+
+Benchmark.ips do |x|
+  x.report("simple hash deserialization") do
+    game_schema.from_hash(game_data)
+  end
+
+  x.report("simple json deserialization") do
+    game_schema.from_json(game_json)
+  end
+
+  x.compare!
+end