schemacop 3.0.36 → 3.0.37

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9494f9a5a921664fae74b99ecba0830775d160ae91250465b4b88ba1d1fdf970
-  data.tar.gz: 2263f93913342b872ac56c52ddd65dd6c34f34711d3624c52c6ffc2d5a9a516a
+  metadata.gz: 56a24074bd3792c20ee7e2f0bb1a8c3f4aa6d411a9a4c8010c9a52f0e828e6a3
+  data.tar.gz: ca4a752be493fe721122a77c5fb6844098c968dddf860fdcb0e33ef9a98880c3
 SHA512:
-  metadata.gz: 3712232ba9d867f723ee462d80db875d6e0adbd6cd0579d798908df58f9fd9b5448389e2cc9829fe979bdcd972efa209a4b2ae6a27766d8d7884fa3a7189c4ab
-  data.tar.gz: fd5c87120fb0c2d1a1e13122013b08d902d37a32154d1196385ad6f2fb5fec28b54c0170f129533c7ce116ccadd13c7c653832f2102cfc4c63da62257170ee3a
+  metadata.gz: da3e3672206befe40e6487677c6c879192a3fdaf450e3621566be86dd1ccc9c487571a70cf7f1933294d5de9cd86094791e22cd659109a97baa432917138f296
+  data.tar.gz: 69d79cf5ad0702b80f930a9227f9279c2f758b3cb51965596145d82ec735b0fe8bb6648f219b6c1858d82f8a339ccdc388db71c3767573a074562a063eefcade

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Change log
 
+## 3.0.37 (2026-02-24)
+
+* Add inline ref support for hash nodes via `ref! nil, :SchemaName`. This
+  unpacks the referenced schema's properties directly into the parent hash
+  instead of nesting them under a key. Produces `allOf` with `$ref` in the
+  JSON/Swagger output.
+
+  Internal reference: `#146962`.
+
 ## 3.0.36 (2026-01-05)
 
 * Fix `v3_default_options` not being applied when schemas are eager loaded in

data/LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright © 2016 - 2024 Sitrox
+Copyright © 2016 - 2026 Sitrox
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -122,4 +122,4 @@ To run tests:
 
 ## Copyright
 
-Copyright © 2016 - 2025 Sitrox. See `LICENSE` for further details.
+Copyright © 2016 - 2026 Sitrox. See `LICENSE` for further details.

data/README_V3.md

@@ -1494,6 +1494,131 @@ schema.validate!([{first_name: 'Joe', last_name: 'Doe'}]) # => [{"first_name"=>"
 schema.validate!([id: 42, first_name: 'Joe'])             # => Schemacop::Exceptions::ValidationError: /[0]/last_name: Value must be given. /[0]: Obsolete property "id".
 ```
 
+#### Inline References
+
+By passing `nil` as the name, you can "inline" a referenced schema into the
+parent hash. Instead of nesting the referenced properties under a key, they are
+unpacked directly into the parent:
+
+```ruby
+schema = Schemacop::Schema3.new :hash do
+  scm :BasicInfo do
+    int! :id
+    str! :name
+  end
+
+  ref! nil, :BasicInfo
+  str! :extra
+end
+
+# Properties from the referenced schema are validated at the top level
+schema.validate!({id: 1, name: 'John', extra: 'info'})
+# => {"id"=>1, "name"=>"John", "extra"=>"info"}
+
+# Required properties from the ref are enforced
+schema.validate!({extra: 'info'})
+# => Schemacop::Exceptions::ValidationError: /id: Value must be given. /name: Value must be given.
+
+# Unknown properties are still rejected
+schema.validate!({id: 1, name: 'John', extra: 'info', unknown: 'value'})
+# => Schemacop::Exceptions::ValidationError: /: Obsolete property "unknown".
+```
+
+Casting works as expected — values from the inline ref are cast according to the
+referenced schema's types:
+
+```ruby
+schema = Schemacop::Schema3.new :hash do
+  scm :BasicInfo do
+    str! :born_at, format: :date
+    str! :name
+  end
+
+  ref! nil, :BasicInfo
+  str! :extra
+end
+
+result = schema.validate!({born_at: '1990-01-13', name: 'John', extra: 'info'})
+result[:born_at] # => Date<"Sat, 13 Jan 1990">
+```
+
+You can also use multiple inline refs in the same hash:
+
+```ruby
+schema = Schemacop::Schema3.new :hash do
+  scm :BasicInfo do
+    int! :id
+    str! :name
+  end
+
+  scm :Timestamps do
+    str! :created_at, format: :date
+  end
+
+  ref! nil, :BasicInfo
+  ref! nil, :Timestamps
+  str! :extra
+end
+
+schema.validate!({id: 1, name: 'John', created_at: '2024-01-01', extra: 'info'})
+# => {"id"=>1, "name"=>"John", "created_at"=>Mon, 01 Jan 2024, "extra"=>"info"}
+```
+
+If a direct property has the same name as one from the inline ref, the direct
+property takes precedence:
+
+```ruby
+schema = Schemacop::Schema3.new :hash do
+  scm :BasicInfo do
+    str! :name
+  end
+
+  ref! nil, :BasicInfo
+  int! :name  # Direct property takes precedence
+end
+
+schema.validate!({name: 42})      # => {"name"=>42}
+schema.validate!({name: 'John'})
+# => Schemacop::Exceptions::ValidationError: /name: Invalid type, got type "String", expected "integer".
+```
+
+In the JSON / Swagger output, inline refs produce an `allOf` array containing
+the `$ref` entries alongside the hash's own properties:
+
+```ruby
+schema = Schemacop::Schema3.new :hash do
+  scm :BasicInfo do
+    int! :id
+    str! :name
+  end
+
+  ref! nil, :BasicInfo
+  str! :extra
+end
+
+schema.as_json
+# => {
+#   "allOf" => [
+#     { "$ref" => "#/definitions/BasicInfo" },
+#     {
+#       "type" => "object",
+#       "properties" => { "extra" => { "type" => "string" } },
+#       "additionalProperties" => false,
+#       "required" => ["extra"]
+#     }
+#   ],
+#   "definitions" => {
+#     "BasicInfo" => {
+#       "properties" => { "id" => { "type" => "integer" }, "name" => { "type" => "string" } },
+#       "additionalProperties" => false,
+#       "required" => ["id", "name"],
+#       "type" => "object"
+#     }
+#   },
+#   "type" => "object"
+# }
+```
+
 ## Context
 
 Schemacop also features the concept of a `Context`. You can define schemas in a

data/VERSION

@@ -1 +1 @@
-3.0.36
+3.0.37

data/lib/schemacop/v3/hash_node.rb

@@ -12,6 +12,7 @@ module Schemacop
       supports_children(name: true)
 
       attr_reader :properties
+      attr_reader :inline_refs
 
       def self.allowed_options
         super + ATTRIBUTES - %i[dependencies] + %i[additional_properties ignore_obsolete_properties parse_json]
@@ -22,8 +23,13 @@ module Schemacop
       end
 
       def add_child(node)
-        unless node.name
-          fail Exceptions::InvalidSchemaError, 'Child nodes must have a name.'
+        if node.name.nil?
+          if node.is_a?(ReferenceNode)
+            @inline_refs << node
+            return
+          else
+            fail Exceptions::InvalidSchemaError, 'Child nodes must have a name.'
+          end
         end
 
         @properties[node.name] = node
@@ -54,6 +60,10 @@ module Schemacop
           end
         end
 
+        if @inline_refs.any?
+          return as_json_with_inline_refs(properties, pattern_properties)
+        end
+
         json = {}
         json[:properties] = properties.values.map { |p| [p.name, p.as_json] }.to_h if properties.any?
         json[:patternProperties] = pattern_properties.values.map { |p| [V3.sanitize_exp(p.name), p.as_json] }.to_h if pattern_properties.any?
@@ -122,8 +132,29 @@ module Schemacop
           end
         end
 
+        # Validate inline ref properties #
+        inline_ref_property_names = Set.new
+
+        @inline_refs.each do |inline_ref|
+          target = inline_ref.target
+          next unless target
+
+          target.properties.each_value do |prop|
+            next if prop.name.is_a?(Regexp)
+            next if @properties.key?(prop.name)
+            next if inline_ref_property_names.include?(prop.name)
+
+            inline_ref_property_names << prop.name
+
+            result.in_path(prop.name) do
+              result.error "Key #{prop.name} must be given." if prop.require_key? && !data_hash.include?(prop.name)
+              prop._validate(data_hash[prop.name], result: result)
+            end
+          end
+        end
+
         # Validate additional properties #
-        specified_properties = @properties.keys.to_set
+        specified_properties = @properties.keys.to_set + inline_ref_property_names
         additional_properties = data_hash.reject { |k, _v| specified_properties.include?(k.to_s) }
 
         property_patterns = {}
@@ -173,7 +204,7 @@ module Schemacop
       end
 
       def children
-        @properties.values
+        @properties.values + @inline_refs
       end
 
       def cast(data)
@@ -208,8 +239,36 @@ module Schemacop
           end
         end
 
+        # Cast inline ref properties
+        inline_ref_property_names = Set.new
+
+        @inline_refs.each do |inline_ref|
+          target = inline_ref.target
+          next unless target
+
+          target.properties.each_value do |prop|
+            next if prop.name.is_a?(Regexp)
+            next if @properties.key?(prop.name)
+            next if inline_ref_property_names.include?(prop.name)
+
+            inline_ref_property_names << prop.name
+
+            prop_name = prop.as&.to_s || prop.name
+
+            casted_data = prop.cast(data_hash[prop.name])
+
+            if !casted_data.nil? || data_hash.include?(prop.name)
+              result[prop_name] = casted_data
+            end
+
+            if result[prop_name].nil? && !data_hash.include?(prop.name)
+              result.delete(prop_name)
+            end
+          end
+        end
+
         # Handle regex properties
-        specified_properties = @properties.keys.to_set
+        specified_properties = @properties.keys.to_set + inline_ref_property_names
         additional_properties = data_hash.reject { |k, _v| specified_properties.include?(k.to_s.to_sym) }
 
         if additional_properties.any? && property_patterns.any?
@@ -224,8 +283,8 @@ module Schemacop
         if options[:additional_properties].is_a?(TrueClass)
           result = data_hash.merge(result)
         elsif options[:additional_properties].is_a?(Node)
-          specified_properties = @properties.keys.to_set
-          additional_properties = data_hash.reject { |k, _v| specified_properties.include?(k.to_s.to_sym) }
+          add_prop_specified = @properties.keys.to_set + inline_ref_property_names
+          additional_properties = data_hash.reject { |k, _v| add_prop_specified.include?(k.to_s.to_sym) }
           if additional_properties.any?
             additional_properties_result = {}
             additional_properties.each do |key, value|
@@ -240,8 +299,42 @@ module Schemacop
 
       protected
 
+      def as_json_with_inline_refs(properties, pattern_properties)
+        all_of = []
+
+        # Add each inline ref
+        @inline_refs.each do |inline_ref|
+          all_of << inline_ref.as_json
+        end
+
+        # Add own properties schema if any direct properties exist
+        if properties.any? || pattern_properties.any?
+          own_schema = {}
+          own_schema[:type] = :object
+          own_schema[:properties] = properties.values.map { |p| [p.name, p.as_json] }.to_h if properties.any?
+          own_schema[:patternProperties] = pattern_properties.values.map { |p| [V3.sanitize_exp(p.name), p.as_json] }.to_h if pattern_properties.any?
+
+          if options[:additional_properties].is_a?(TrueClass)
+            own_schema[:additionalProperties] = true
+          elsif options[:additional_properties].is_a?(Node)
+            own_schema[:additionalProperties] = options[:additional_properties].as_json
+          else
+            own_schema[:additionalProperties] = false
+          end
+
+          required_properties = @properties.values.select(&:required?).map(&:name)
+          own_schema[:required] = required_properties if required_properties.any?
+
+          all_of << own_schema
+        end
+
+        json = { allOf: all_of }
+        return process_json(ATTRIBUTES, json)
+      end
+
       def init
         @properties = {}
+        @inline_refs = []
         @options[:type] = :object
         unless @options[:additional_properties].nil? || @options[:additional_properties].is_a?(TrueClass) || @options[:additional_properties].is_a?(FalseClass)
           fail Schemacop::Exceptions::InvalidSchemaError, 'Option "additional_properties" must be a boolean value'

data/schemacop.gemspec

@@ -1,14 +1,14 @@
 # -*- encoding: utf-8 -*-
-# stub: schemacop 3.0.36 ruby lib
+# stub: schemacop 3.0.37 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "schemacop".freeze
-  s.version = "3.0.36".freeze
+  s.version = "3.0.37".freeze
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib".freeze]
   s.authors = ["Sitrox".freeze]
-  s.date = "2026-01-05"
+  s.date = "2026-02-24"
   s.files = [".github/workflows/ruby.yml".freeze, ".gitignore".freeze, ".releaser_config".freeze, ".rubocop.yml".freeze, ".yardopts".freeze, "CHANGELOG.md".freeze, "Gemfile".freeze, "LICENSE".freeze, "README.md".freeze, "README_V2.md".freeze, "README_V3.md".freeze, "RUBY_VERSION".freeze, "Rakefile".freeze, "VERSION".freeze, "lib/schemacop.rb".freeze, "lib/schemacop/base_schema.rb".freeze, "lib/schemacop/exceptions.rb".freeze, "lib/schemacop/railtie.rb".freeze, "lib/schemacop/schema.rb".freeze, "lib/schemacop/schema2.rb".freeze, "lib/schemacop/schema3.rb".freeze, "lib/schemacop/scoped_env.rb".freeze, "lib/schemacop/v2.rb".freeze, "lib/schemacop/v2/caster.rb".freeze, "lib/schemacop/v2/collector.rb".freeze, "lib/schemacop/v2/dupper.rb".freeze, "lib/schemacop/v2/field_node.rb".freeze, "lib/schemacop/v2/node.rb".freeze, "lib/schemacop/v2/node_resolver.rb".freeze, "lib/schemacop/v2/node_supporting_field.rb".freeze, "lib/schemacop/v2/node_supporting_type.rb".freeze, "lib/schemacop/v2/node_with_block.rb".freeze, "lib/schemacop/v2/validator/array_validator.rb".freeze, "lib/schemacop/v2/validator/boolean_validator.rb".freeze, "lib/schemacop/v2/validator/float_validator.rb".freeze, "lib/schemacop/v2/validator/hash_validator.rb".freeze, "lib/schemacop/v2/validator/integer_validator.rb".freeze, "lib/schemacop/v2/validator/nil_validator.rb".freeze, "lib/schemacop/v2/validator/number_validator.rb".freeze, "lib/schemacop/v2/validator/object_validator.rb".freeze, "lib/schemacop/v2/validator/string_validator.rb".freeze, "lib/schemacop/v2/validator/symbol_validator.rb".freeze, "lib/schemacop/v3.rb".freeze, "lib/schemacop/v3/all_of_node.rb".freeze, "lib/schemacop/v3/any_of_node.rb".freeze, "lib/schemacop/v3/array_node.rb".freeze, "lib/schemacop/v3/boolean_node.rb".freeze, "lib/schemacop/v3/combination_node.rb".freeze, "lib/schemacop/v3/context.rb".freeze, "lib/schemacop/v3/dsl_scope.rb".freeze, "lib/schemacop/v3/global_context.rb".freeze, "lib/schemacop/v3/hash_node.rb".freeze, "lib/schemacop/v3/integer_node.rb".freeze, "lib/schemacop/v3/is_not_node.rb".freeze, "lib/schemacop/v3/node.rb".freeze, "lib/schemacop/v3/node_registry.rb".freeze, "lib/schemacop/v3/number_node.rb".freeze, "lib/schemacop/v3/numeric_node.rb".freeze, "lib/schemacop/v3/object_node.rb".freeze, "lib/schemacop/v3/one_of_node.rb".freeze, "lib/schemacop/v3/reference_node.rb".freeze, "lib/schemacop/v3/result.rb".freeze, "lib/schemacop/v3/string_node.rb".freeze, "lib/schemacop/v3/symbol_node.rb".freeze, "schemacop.gemspec".freeze, "test/lib/test_helper.rb".freeze, "test/schemas/nested/group.rb".freeze, "test/schemas/user.rb".freeze, "test/unit/schemacop/v2/casting_test.rb".freeze, "test/unit/schemacop/v2/collector_test.rb".freeze, "test/unit/schemacop/v2/custom_check_test.rb".freeze, "test/unit/schemacop/v2/custom_if_test.rb".freeze, "test/unit/schemacop/v2/defaults_test.rb".freeze, "test/unit/schemacop/v2/empty_test.rb".freeze, "test/unit/schemacop/v2/nil_dis_allow_test.rb".freeze, "test/unit/schemacop/v2/node_resolver_test.rb".freeze, "test/unit/schemacop/v2/short_forms_test.rb".freeze, "test/unit/schemacop/v2/types_test.rb".freeze, "test/unit/schemacop/v2/validator_array_test.rb".freeze, "test/unit/schemacop/v2/validator_boolean_test.rb".freeze, "test/unit/schemacop/v2/validator_float_test.rb".freeze, "test/unit/schemacop/v2/validator_hash_test.rb".freeze, "test/unit/schemacop/v2/validator_integer_test.rb".freeze, "test/unit/schemacop/v2/validator_nil_test.rb".freeze, "test/unit/schemacop/v2/validator_number_test.rb".freeze, "test/unit/schemacop/v2/validator_object_test.rb".freeze, "test/unit/schemacop/v2/validator_string_test.rb".freeze, "test/unit/schemacop/v2/validator_symbol_test.rb".freeze, "test/unit/schemacop/v3/all_of_node_test.rb".freeze, "test/unit/schemacop/v3/any_of_node_test.rb".freeze, "test/unit/schemacop/v3/array_node_test.rb".freeze, "test/unit/schemacop/v3/boolean_node_test.rb".freeze, "test/unit/schemacop/v3/global_context_test.rb".freeze, "test/unit/schemacop/v3/hash_node_test.rb".freeze, "test/unit/schemacop/v3/integer_node_test.rb".freeze, "test/unit/schemacop/v3/is_not_node_test.rb".freeze, "test/unit/schemacop/v3/node_test.rb".freeze, "test/unit/schemacop/v3/number_node_test.rb".freeze, "test/unit/schemacop/v3/object_node_test.rb".freeze, "test/unit/schemacop/v3/one_of_node_test.rb".freeze, "test/unit/schemacop/v3/reference_node_test.rb".freeze, "test/unit/schemacop/v3/string_node_test.rb".freeze, "test/unit/schemacop/v3/symbol_node_test.rb".freeze]
   s.homepage = "https://github.com/sitrox/schemacop".freeze
   s.licenses = ["MIT".freeze]

data/test/unit/schemacop/v3/reference_node_test.rb

@@ -362,6 +362,404 @@ module Schemacop
 
         assert_cast({ person: { born_at: '1990-01-13' } }, { person: { born_at: Date.new(1990, 1, 13) } }.with_indifferent_access)
       end
+
+      # --- Inline ref tests ---
+
+      def test_inline_ref_schema_builds_without_error
+        schema do
+          scm :BasicInfo do
+            int! :id
+            str! :name
+          end
+
+          ref! nil, :BasicInfo
+        end
+
+        assert_equal [], @schema.root.properties.keys
+        assert_equal 1, @schema.root.inline_refs.size
+      end
+
+      def test_inline_ref_validation
+        schema do
+          scm :BasicInfo do
+            int! :id
+            str! :name
+          end
+
+          ref! nil, :BasicInfo
+          str! :extra
+        end
+
+        assert_validation(id: 1, name: 'John', extra: 'info')
+      end
+
+      def test_inline_ref_validation_errors
+        schema do
+          scm :BasicInfo do
+            int! :id
+            str! :name
+          end
+
+          ref! nil, :BasicInfo
+          str! :extra
+        end
+
+        assert_validation(extra: 'info') do
+          error '/id', 'Value must be given.'
+          error '/name', 'Value must be given.'
+        end
+      end
+
+      def test_inline_ref_validation_type_errors
+        schema do
+          scm :BasicInfo do
+            int! :id
+            str! :name
+          end
+
+          ref! nil, :BasicInfo
+        end
+
+        assert_validation(id: 'not_an_int', name: 42) do
+          error '/id', 'Invalid type, got type "String", expected "integer".'
+          error '/name', 'Invalid type, got type "Integer", expected "string".'
+        end
+      end
+
+      def test_inline_ref_validation_obsolete_properties
+        schema do
+          scm :BasicInfo do
+            int! :id
+            str! :name
+          end
+
+          ref! nil, :BasicInfo
+        end
+
+        # Properties from inline ref are accepted
+        assert_validation(id: 1, name: 'John')
+
+        # Unknown properties are still rejected
+        assert_validation(id: 1, name: 'John', unknown: 'value') do
+          error '/', 'Obsolete property "unknown".'
+        end
+      end
+
+      def test_inline_ref_cast
+        schema do
+          scm :BasicInfo do
+            str! :born_at, format: :date
+            str! :name
+          end
+
+          ref! nil, :BasicInfo
+          str! :extra
+        end
+
+        assert_cast(
+          { born_at: '1990-01-13', name: 'John', extra: 'info' },
+          { born_at: Date.new(1990, 1, 13), name: 'John', extra: 'info' }.with_indifferent_access
+        )
+      end
+
+      def test_inline_ref_with_defaults
+        schema do
+          scm :BasicInfo do
+            str? :name, default: 'Anonymous'
+          end
+
+          ref! nil, :BasicInfo
+        end
+
+        assert_cast({}, { name: 'Anonymous' }.with_indifferent_access)
+      end
+
+      def test_inline_ref_with_optional_properties
+        schema do
+          scm :BasicInfo do
+            int! :id
+            str? :nickname
+          end
+
+          ref! nil, :BasicInfo
+        end
+
+        assert_validation(id: 1)
+        assert_validation(id: 1, nickname: 'Johnny')
+      end
+
+      def test_inline_ref_as_json
+        schema do
+          scm :BasicInfo do
+            int! :id
+            str! :name
+          end
+
+          ref! nil, :BasicInfo
+          str! :extra
+        end
+
+        assert_json({
+                      definitions: {
+                        BasicInfo: {
+                          properties:           {
+                            id:   { type: :integer },
+                            name: { type: :string }
+                          },
+                          additionalProperties: false,
+                          required:             %w[id name],
+                          type:                 :object
+                        }
+                      },
+                      type:        :object,
+                      allOf:       [
+                        { '$ref' => '#/definitions/BasicInfo' },
+                        {
+                          type:                 :object,
+                          properties:           {
+                            extra: { type: :string }
+                          },
+                          additionalProperties: false,
+                          required:             %w[extra]
+                        }
+                      ]
+                    })
+      end
+
+      def test_inline_ref_as_json_no_own_properties
+        schema do
+          scm :BasicInfo do
+            int! :id
+            str! :name
+          end
+
+          ref! nil, :BasicInfo
+        end
+
+        assert_json({
+                      definitions: {
+                        BasicInfo: {
+                          properties:           {
+                            id:   { type: :integer },
+                            name: { type: :string }
+                          },
+                          additionalProperties: false,
+                          required:             %w[id name],
+                          type:                 :object
+                        }
+                      },
+                      type:        :object,
+                      allOf:       [
+                        { '$ref' => '#/definitions/BasicInfo' }
+                      ]
+                    })
+      end
+
+      def test_inline_ref_swagger_json
+        schema do
+          scm :BasicInfo do
+            int! :id
+            str! :name
+          end
+
+          ref! nil, :BasicInfo
+          str! :extra
+        end
+
+        assert_swagger_json({
+                              type:  :object,
+                              allOf: [
+                                { '$ref' => '#/components/schemas/BasicInfo' },
+                                {
+                                  type:                 :object,
+                                  properties:           {
+                                    extra: { type: :string }
+                                  },
+                                  additionalProperties: false,
+                                  required:             %w[extra]
+                                }
+                              ]
+                            })
+      end
+
+      def test_inline_ref_multiple
+        schema do
+          scm :BasicInfo do
+            int! :id
+            str! :name
+          end
+
+          scm :Timestamps do
+            str! :created_at, format: :date
+          end
+
+          ref! nil, :BasicInfo
+          ref! nil, :Timestamps
+          str! :extra
+        end
+
+        # Validation
+        assert_validation(id: 1, name: 'John', created_at: '2024-01-01', extra: 'info')
+        assert_validation(extra: 'info') do
+          error '/id', 'Value must be given.'
+          error '/name', 'Value must be given.'
+          error '/created_at', 'Value must be given.'
+        end
+
+        # Casting
+        assert_cast(
+          { id: 1, name: 'John', created_at: '2024-01-01', extra: 'info' },
+          { id: 1, name: 'John', created_at: Date.new(2024, 1, 1), extra: 'info' }.with_indifferent_access
+        )
+
+        # JSON
+        assert_json({
+                      definitions: {
+                        BasicInfo:  {
+                          properties:           {
+                            id:   { type: :integer },
+                            name: { type: :string }
+                          },
+                          additionalProperties: false,
+                          required:             %w[id name],
+                          type:                 :object
+                        },
+                        Timestamps: {
+                          properties:           {
+                            created_at: { type: :string, format: :date }
+                          },
+                          additionalProperties: false,
+                          required:             %w[created_at],
+                          type:                 :object
+                        }
+                      },
+                      type:        :object,
+                      allOf:       [
+                        { '$ref' => '#/definitions/BasicInfo' },
+                        { '$ref' => '#/definitions/Timestamps' },
+                        {
+                          type:                 :object,
+                          properties:           {
+                            extra: { type: :string }
+                          },
+                          additionalProperties: false,
+                          required:             %w[extra]
+                        }
+                      ]
+                    })
+      end
+
+      def test_inline_ref_with_external_schema
+        context = Context.new
+
+        context.schema :BasicInfo do
+          int! :id
+          str! :name
+        end
+
+        with_context context do
+          schema do
+            ref! nil, :BasicInfo
+            str! :extra
+          end
+
+          assert_validation(id: 1, name: 'John', extra: 'info')
+          assert_validation(extra: 'info') do
+            error '/id', 'Value must be given.'
+            error '/name', 'Value must be given.'
+          end
+        end
+      end
+
+      def test_inline_ref_used_external_schemas
+        context = Context.new
+
+        context.schema :BasicInfo do
+          int! :id
+          str! :name
+        end
+
+        with_context context do
+          schema do
+            ref! nil, :BasicInfo
+            str! :extra
+          end
+
+          assert_equal %i[BasicInfo], @schema.root.used_external_schemas
+        end
+      end
+
+      def test_inline_ref_with_additional_properties_true
+        schema do
+          scm :BasicInfo do
+            int! :id
+            str! :name
+          end
+
+          ref! nil, :BasicInfo
+          str! :extra
+        end
+
+        # Without additional_properties: true, unknown props are rejected
+        assert_validation(id: 1, name: 'John', extra: 'info', unknown: 'value') do
+          error '/', 'Obsolete property "unknown".'
+        end
+      end
+
+      def test_inline_ref_property_name_collision
+        schema do
+          scm :BasicInfo do
+            str! :name
+            str? :description
+          end
+
+          ref! nil, :BasicInfo
+          int! :name # Direct property takes precedence
+        end
+
+        # Direct property (int!) takes precedence — string should fail
+        assert_validation(name: 42)
+        assert_validation(name: 'John') do
+          error '/name', 'Invalid type, got type "String", expected "integer".'
+        end
+
+        # Optional description from inline ref still works
+        assert_validation(name: 42, description: 'A description')
+      end
+
+      def test_inline_ref_collision_between_inline_refs
+        schema do
+          scm :BasicInfo do
+            str! :name
+            str? :description
+          end
+
+          scm :ExtraInfo do
+            int! :name # Clashes with BasicInfo's :name
+            str! :extra
+          end
+
+          ref! nil, :BasicInfo # First inline ref wins for :name
+          ref! nil, :ExtraInfo
+        end
+
+        # First inline ref wins: :name is validated as str! (from BasicInfo)
+        assert_validation(name: 'John', extra: 'info')
+        assert_validation(name: 42, extra: 'info') do
+          error '/name', 'Invalid type, got type "Integer", expected "string".'
+        end
+
+        # Properties unique to second inline ref still work
+        assert_validation(name: 'John') do
+          error '/extra', 'Value must be given.'
+        end
+
+        # Casting uses first inline ref's definition for :name
+        assert_cast(
+          { name: 'John', description: 'A desc', extra: 'info' },
+          { name: 'John', description: 'A desc', extra: 'info' }.with_indifferent_access
+        )
+      end
     end
   end
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: schemacop
 version: !ruby/object:Gem::Version
-  version: 3.0.36
+  version: 3.0.37
 platform: ruby
 authors:
 - Sitrox
 bindir: bin
 cert_chain: []
-date: 2026-01-05 00:00:00.000000000 Z
+date: 2026-02-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport