castkit 0.3.1 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f048458a9f967984b6b590c1e6bf2348a43c90936374b4d8755c6f7151057fe8
-  data.tar.gz: 182e73cec494a329bc670999cceab4a3c1e057eb6108097c759989102232ec94
+  metadata.gz: 1202666103d91222c67462e90710b701128129cdbdb2b1363ed5be3603b04cc9
+  data.tar.gz: a64630cb20e6cca047cb3b5c0a68a251b33fdd92265d077aaf9c04e7e501ab81
 SHA512:
-  metadata.gz: 4d8bc7bdd0ed6c26f7fb7a621306995b4fbfbbe6d1d331ffa813ffc4c13a2d2795b72af9f977bc618e950c8dfdc5b017bb95563a436520e4e545efdf1a9a0b50
-  data.tar.gz: 196ed35dd105ad854ac74fa4540cbfbb04de30885069719ab80bb84d5a41b8ea8e64df1e085753477dab3bf54f998db20684b5cd6460af4c87447594c320edd3
+  metadata.gz: b8d1f485109363ccab35aa46cf605d0c06d96b31257168878422e89bf19c4e44c315fb5481fef72b45192cc133258621657b82a98fc173da2f755d541eabc3a8
+  data.tar.gz: 841d82b75c79858208296e300e86b9e4405546d90df7e7cee1cf6071b3811f7c3e05abcb43e78962ae07a01f681ff82817a40b98631590ff960abb2d4e30c5a8

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 ## [Unreleased]
 
+# v0.4.0
+
+- Refactored Castkit internals to build on Cattri registries for attributes, configuration, contracts, and attribute definitions
+- Added Cattri-powered introspection helpers, serialization toggle behavior and enhanced type/validator DSLs, plus coverage for the new plugin helpers
+
 ## [0.3.0] - 2025-04-16
 
 ### Added

data/README.md

@@ -60,14 +60,14 @@ Castkit comes with built-in support for primitive types and allows registration
 
 ```ruby
 {
-        array: Castkit::Types::Collection,
-        boolean: Castkit::Types::Boolean,
-        date: Castkit::Types::Date,
-        datetime: Castkit::Types::DateTime,
-        float: Castkit::Types::Float,
-        hash: Castkit::Types::Base,
-        integer: Castkit::Types::Integer,
-        string: Castkit::Types::String
+    array: Castkit::Types::Collection,
+    boolean: Castkit::Types::Boolean,
+    date: Castkit::Types::Date,
+    datetime: Castkit::Types::DateTime,
+    float: Castkit::Types::Float,
+    hash: Castkit::Types::Base,
+    integer: Castkit::Types::Integer,
+    string: Castkit::Types::String
 }
 ```
 

data/castkit.gemspec

@@ -33,6 +33,7 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
 
   # Runtime dependencies
+  spec.add_dependency "cattri", ">=0.2.3"
   spec.add_dependency "thor"
 
   # Development dependencies
@@ -40,5 +41,6 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "rubocop"
   spec.add_development_dependency "simplecov"
   spec.add_development_dependency "simplecov-cobertura"
+  spec.add_development_dependency "simplecov-html"
   spec.add_development_dependency "yard"
 end

data/lib/castkit/attribute.rb

@@ -23,6 +23,11 @@ module Castkit
   # @see Castkit::DSL::Attribute::Validation
   class Attribute
     include Castkit::DSL::Attribute
+    include Cattri
+
+    cattri :field, nil, expose: :read, final: true
+    cattri :type, nil, expose: :read, final: true
+    cattri :options, nil, expose: :read, final: true
 
     class << self
       # Defines a reusable attribute definition via a DSL wrapper.
@@ -71,15 +76,6 @@ module Castkit
       end
     end
 
-    # @return [Symbol] the attribute name
-    attr_reader :field
-
-    # @return [Symbol, Class, Array] the declared or normalized type
-    attr_reader :type
-
-    # @return [Hash] full option hash, including merged defaults
-    attr_reader :options
-
     # Initializes a new attribute definition.
     #
     # @param field [Symbol] the attribute name
@@ -87,10 +83,13 @@ module Castkit
     # @param default [Object, Proc, nil] optional static or callable default
     # @param options [Hash] additional attribute options
     def initialize(field, type, default: nil, **options)
-      @field = field
-      @type = self.class.normalize_type(type)
+      super()
+
+      cattri_variable_set(:field, field, final: true)
+      cattri_variable_set(:type, self.class.normalize_type(type), final: true)
+
       @default = default
-      @options = populate_options(options)
+      cattri_variable_set(:options, populate_options(options), final: true)
 
       validate!
     end

data/lib/castkit/castkit.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require "cattri"
 require_relative "core/attribute_types"
 
 # Castkit is a lightweight, type-safe data object system for Ruby.

data/lib/castkit/configuration.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require_relative "types"
+require "cattri"
 
 module Castkit
   # Configuration container for global Castkit settings.
@@ -8,6 +9,8 @@ module Castkit
   # This includes type registration, validation, and enforcement flags
   # used throughout Castkit's attribute system.
   class Configuration
+    include Cattri
+
     # Default mapping of primitive type definitions.
     #
     # @return [Hash{Symbol => Castkit::Types::Base}]
@@ -36,56 +39,30 @@ module Castkit
       uuid: :string
     }.freeze
 
-    # @return [Hash{Symbol => Castkit::Types::Base}] registered types
-    attr_reader :types
-
-    # Set default plugins that will be used globally in all Castkit::DataObject subclasses.
-    # This is equivalent to calling `enable_plugins` in every class.
-    #
-    # @return [Array<Symbol>] default plugin names to be applied to all DataObject subclasses
-    attr_accessor :default_plugins
-
-    # Whether to raise an error if values should be validated before deserializing, e.g. true -> "true"
-    # @return [Boolean]
-    attr_accessor :enforce_typing
-
-    # Whether to raise an error if access mode is not recognized.
-    # @return [Boolean]
-    attr_accessor :enforce_attribute_access
-
-    # Whether to raise an error if a prefix is defined without `unwrapped: true`.
-    # @return [Boolean]
-    attr_accessor :enforce_unwrapped_prefix
-
-    # Whether to raise an error if an array attribute is missing the `of:` type.
-    # @return [Boolean]
-    attr_accessor :enforce_array_options
-
-    # Whether to raise an error for unknown and invalid type definitions.
-    # @return [Boolean]
-    attr_accessor :raise_type_errors
-
-    # Whether to emit warnings when Castkit detects misconfigurations.
-    # @return [Boolean]
-    attr_accessor :enable_warnings
-
-    # Whether the strict flag is enabled by default for all DataObjects and Contracts.
-    # @return [Boolean]
-    attr_accessor :strict_by_default
+    cattri :types, -> { DEFAULT_TYPES.dup }, expose: :read_write
+    cattri :default_plugins, [], expose: :read_write
+    cattri :enforce_typing, true, expose: :read_write
+    cattri :enforce_attribute_access, true, expose: :read_write
+    cattri :enforce_unwrapped_prefix, true, expose: :read_write
+    cattri :enforce_array_options, true, expose: :read_write
+    cattri :raise_type_errors, true, expose: :read_write
+    cattri :enable_warnings, true, expose: :read_write
+    cattri :strict_by_default, true, expose: :read_write
 
     # Initializes the configuration with default types and enforcement flags.
     #
     # @return [void]
     def initialize
-      @types = DEFAULT_TYPES.dup
-      @enforce_typing = true
-      @enforce_attribute_access = true
-      @enforce_unwrapped_prefix = true
-      @enforce_array_options = true
-      @raise_type_errors = true
-      @enable_warnings = true
-      @strict_by_default = true
-      @default_plugins = []
+      super
+      self.types = DEFAULT_TYPES.dup
+      self.enforce_typing = true
+      self.enforce_attribute_access = true
+      self.enforce_unwrapped_prefix = true
+      self.enforce_array_options = true
+      self.raise_type_errors = true
+      self.enable_warnings = true
+      self.strict_by_default = true
+      self.default_plugins = []
 
       apply_type_aliases!
     end
@@ -136,7 +113,7 @@ module Castkit
     # @return [Castkit::Types::Base]
     # @raise [Castkit::TypeError] if the type is not registered
     def fetch_type(type)
-      @types.fetch(type.to_sym) do
+      types.fetch(type.to_sym) do
         raise Castkit::TypeError, "Unknown type `#{type.inspect}`" if raise_type_errors
       end
     end
@@ -146,14 +123,14 @@ module Castkit
     # @param type [Symbol]
     # @return [Boolean]
     def type_registered?(type)
-      @types.key?(type.to_sym)
+      types.key?(type.to_sym)
     end
 
     # Restores the type registry to its default state.
     #
     # @return [void]
     def reset_types!
-      @types = DEFAULT_TYPES.dup
+      self.types = DEFAULT_TYPES.dup
       apply_type_aliases!
     end
 

data/lib/castkit/contract/base.rb

@@ -38,6 +38,8 @@ module Castkit
       ].freeze
 
       class << self
+        include Cattri
+
         # Defines an attribute for the contract.
         #
         # Only a subset of options is allowed inside a contract.
@@ -71,15 +73,9 @@ module Castkit
           Castkit::Contract::Result.new(definition[:name].to_s, input)
         end
 
-        # Returns internal contract metadata.
-        #
-        # @return [Hash]
-        def definition
-          @definition ||= {
-            name: :ephemeral,
-            attributes: {}
-          }
-        end
+        cattri :definition,
+               -> { { name: :ephemeral, attributes: {} } },
+               scope: :class, expose: :read_write
 
         # Returns the defined attributes.
         #
@@ -117,8 +113,8 @@ module Castkit
         def define_from_source(name, source)
           source_attributes = source.attributes.dup
 
-          @definition = {
-            name: name,
+          self.definition = {
+            name: name.to_sym,
             attributes: source_attributes.transform_values do |attr|
               Castkit::Attribute.new(attr.field, attr.type, **attr.options.slice(*ATTRIBUTE_OPTIONS))
             end
@@ -131,7 +127,8 @@ module Castkit
         # @yield [block]
         # @return [void]
         def define_from_block(name, &block)
-          definition[:name] = name
+          contract_name = name ? name.to_sym : :ephemeral
+          self.definition = { name: contract_name, attributes: {} }
 
           @__castkit_contract_dsl = true
           instance_eval(&block)

data/lib/castkit/contract/result.rb

@@ -7,14 +7,16 @@ module Castkit
     # Provides access to the validation outcome, including whether it succeeded or failed,
     # and includes the full list of errors if any.
     class Result
+      include Cattri
+
       # @return [Symbol] the name of the contract
-      attr_reader :contract
+      cattri :contract, nil, expose: :read
 
       # @return [Hash{Symbol => Object}] the validated input
-      attr_reader :input
+      cattri :input, nil, expose: :read
 
       # @return [Hash{Symbol => Object}] the validation error hash
-      attr_reader :errors
+      cattri :errors, {}, expose: :read
 
       # Initializes a new result object.
       #
@@ -22,9 +24,11 @@ module Castkit
       # @param input [Hash{Symbol => Object}] the validated input
       # @param errors [Hash{Symbol => Object}] the validation errors
       def initialize(contract, input, errors: {})
-        @contract = contract.to_sym.freeze
-        @input = input.freeze
-        @errors = errors.freeze
+        super()
+
+        cattri_variable_set(:contract, contract.to_sym.freeze)
+        cattri_variable_set(:input, input.freeze)
+        cattri_variable_set(:errors, errors.freeze)
       end
 
       # A debug-friendly representation of the validation result.

data/lib/castkit/core/attribute_types.rb

@@ -86,7 +86,9 @@ module Castkit
       #
       # @param field [Symbol]
       # @param options [Hash]
-      def hash(field, **options)
+      def hash(field = nil, **options)
+        return super() if field.nil?
+
         attribute(field, :hash, **options)
       end
 

data/lib/castkit/core/attributes.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "cattri"
+
 module Castkit
   module Core
     # Provides DSL and implementation for declaring attributes within a Castkit::DataObject.
@@ -9,7 +11,11 @@ module Castkit
     #
     # This module is included into `Castkit::DataObject` and handles attribute registration,
     # accessor generation, and typed writing behavior.
-    module Attributes
+    module Attributes # rubocop:disable Metrics/ModuleLength
+      def self.extended(base)
+        base.include(Cattri)
+      end
+
       # Declares an attribute on the data object.
       #
       # Accepts either inline options or a reusable attribute definition (`using` or `definition`).
@@ -29,7 +35,7 @@ module Castkit
         type, options = use_definition(field, definition || using&.definition, type, options)
         return define_attribute(field, type, **options) unless options[:transient]
 
-        attr_accessor field
+        define_transient_accessor(field)
       end
 
       # Declares a composite (computed) attribute.
@@ -97,14 +103,14 @@ module Castkit
       #
       # @return [Hash{Symbol => Castkit::Attribute}]
       def attributes
-        @attributes ||= {}
+        cattri_variable_memoize(:__castkit_attributes_registry) { {} }
       end
 
       def inherited(subclass)
         super
 
-        parent_attributes = instance_variable_get(:@attributes)
-        subclass.instance_variable_set(:@attributes, parent_attributes.dup) if parent_attributes
+        parent_attributes = cattri_variable_get(:__castkit_attributes_registry)
+        subclass.cattri_variable_set(:__castkit_attributes_registry, parent_attributes.dup) if parent_attributes
       end
 
       # Alias for {#attribute}
@@ -152,31 +158,27 @@ module Castkit
         attribute = Castkit::Attribute.new(field, type, **options)
         attributes[field] = attribute
 
-        if attribute.full_access?
-          attr_reader field
-
-          define_typed_writer(field, attribute)
-        elsif attribute.writeable?
-          define_typed_writer(field, attribute)
-        elsif attribute.readable?
-          attr_reader field
-        end
+        define_accessors(attribute)
       end
 
-      # Defines a writer method that enforces type coercion.
+      # Creates readers/writers for a defined attribute using Cattri.
       #
-      # @param field [Symbol]
       # @param attribute [Castkit::Attribute]
       # @return [void]
-      def define_typed_writer(field, attribute)
-        define_method("#{field}=") do |value|
-          deserialized_value = Castkit.type_caster(attribute.type.to_sym).call(
-            value,
-            options: attribute.options,
-            context: attribute.field
-          )
-
-          instance_variable_set("@#{field}", deserialized_value)
+      def define_accessors(attribute)
+        expose = exposure_for(attribute)
+        return if expose == :none
+
+        if attribute.writeable?
+          cattri(attribute.field, nil, expose: expose) do |value|
+            Castkit.type_caster(attribute.type.to_sym).call(
+              value,
+              options: attribute.options,
+              context: attribute.field
+            )
+          end
+        else
+          cattri(attribute.field, nil, expose: expose)
         end
       end
 
@@ -189,6 +191,7 @@ module Castkit
       def with_access(access, options = {}, &block)
         @__access_context = access
         @__block_options = options
+
         instance_eval(&block)
       ensure
         @__access_context = nil
@@ -204,6 +207,7 @@ module Castkit
       def with_required(flag, options = {}, &block)
         @__required_context = flag
         @__block_options = options
+
         instance_eval(&block)
       ensure
         @__required_context = nil
@@ -222,6 +226,26 @@ module Castkit
 
         base.merge(options)
       end
+
+      # Maps Castkit access flags onto Cattri's expose option.
+      #
+      # @param attribute [Castkit::Attribute]
+      # @return [Symbol]
+      def exposure_for(attribute)
+        return :read_write if attribute.full_access?
+        return :write if attribute.writeable?
+        return :read if attribute.readable?
+
+        :none
+      end
+
+      # Defines read/write accessors for transient attributes.
+      #
+      # @param field [Symbol]
+      # @return [void]
+      def define_transient_accessor(field)
+        cattri(field, nil, expose: :read_write)
+      end
     end
   end
 end

data/lib/castkit/core/config.rb

@@ -5,6 +5,17 @@ module Castkit
     # Provides per-class configuration for a Castkit::DataObject,
     # including root key handling, strict mode, and unknown key behavior.
     module Config
+      def self.extended(base)
+        super
+
+        base.include(Cattri) unless base.is_a?(Class) && base < Cattri
+        return unless base.respond_to?(:cattri)
+
+        base.cattri :strict_flag, nil, scope: :class, expose: :read_write
+        base.cattri :warn_on_unknown_flag, nil, scope: :class, expose: :read_write
+        base.cattri :allow_unknown_flag, nil, scope: :class, expose: :read_write
+      end
+
       # Sets or retrieves strict mode behavior.
       #
       # In strict mode, unknown keys during deserialization raise errors. If unset, falls back
@@ -13,11 +24,9 @@ module Castkit
       # @param value [Boolean, nil]
       # @return [Boolean]
       def strict(value = nil)
-        if value.nil?
-          @strict.nil? ? Castkit.configuration.strict_by_default : @strict
-        else
-          @strict = !!value
-        end
+        return (strict_flag.nil? ? Castkit.configuration.strict_by_default : strict_flag) if value.nil?
+
+        self.strict_flag = !!value
       end
 
       # Enables or disables ignoring unknown keys during deserialization.
@@ -27,7 +36,7 @@ module Castkit
       # @param value [Boolean]
       # @return [void]
       def ignore_unknown(value = nil)
-        @strict = !value
+        self.strict_flag = !value
       end
 
       # Sets or retrieves whether to emit warnings when unknown keys are encountered.
@@ -35,7 +44,7 @@ module Castkit
       # @param value [Boolean, nil]
       # @return [Boolean, nil]
       def warn_on_unknown(value = nil)
-        value.nil? ? @warn_on_unknown : (@warn_on_unknown = value)
+        value.nil? ? warn_on_unknown_flag : (self.warn_on_unknown_flag = value)
       end
 
       # Sets or retrieves whether to allow unknown keys when they are encountered.
@@ -43,7 +52,7 @@ module Castkit
       # @param value [Boolean, nil]
       # @return [Boolean, nil]
       def allow_unknown(value = nil)
-        value.nil? ? @allow_unknown : (@allow_unknown = value)
+        value.nil? ? allow_unknown_flag : (self.allow_unknown_flag = value)
       end
 
       # Returns a relaxed version of the current class with strict mode off.
@@ -63,11 +72,12 @@ module Castkit
       #
       # @return [Hash{Symbol => Boolean}]
       def validation_rules
-        @validation_rules ||= {
-          strict: strict,
-          allow_unknown: allow_unknown,
-          warn_on_unknown: warn_on_unknown
-        }
+        @validation_rules ||= {}
+        @validation_rules[:strict] = strict
+        @validation_rules[:allow_unknown] = allow_unknown
+        @validation_rules[:warn_on_unknown] = warn_on_unknown
+
+        @validation_rules
       end
     end
   end

data/lib/castkit/data_object.rb

@@ -76,20 +76,23 @@ module Castkit
     end
 
     # @return [Hash{Symbol => Object}] The raw data provided during instantiation.
-    attr_reader :__raw
+    cattri :__raw, nil, expose: :read
 
     # @return [Hash{Symbol => Object}] Undefined attributes provided during instantiation.
-    attr_reader :unknown_attributes
+    cattri :unknown_attributes, nil, expose: :read
 
     # Initializes the DTO from a hash of attributes.
     #
     # @param data [Hash] raw input hash
     # @raise [Castkit::DataObjectError] if strict mode is enabled and unknown keys are present
     def initialize(data = {})
-      @__raw = data.dup.freeze
+      super()
+
+      cattri_variable_set(:__raw, data.dup.freeze)
       data = unwrap_root(data)
 
-      @unknown_attributes = data.reject { |key, _| self.class.attributes.key?(key.to_sym) }.freeze
+      cattri_variable_set(:unknown_attributes,
+                          data.reject { |key, _| self.class.attributes.key?(key.to_sym) }.freeze)
 
       validate_data!(data)
       deserialize_attributes!(data)

data/lib/castkit/dsl/data_object/deserialization.rb

@@ -49,7 +49,7 @@ module Castkit
             next if value.nil? && attribute.optional?
 
             value = deserialize_attribute_value!(attribute, value)
-            instance_variable_set("@#{attribute.field}", value)
+            assign_attribute_value!(attribute, value)
           end
         end
 
@@ -115,6 +115,23 @@ module Castkit
           nil
         end
 
+        # Stores a deserialized value using Cattri's internal store when available.
+        #
+        # @param attribute [Castkit::Attribute]
+        # @param value [Object]
+        # @return [void]
+        def assign_attribute_value!(attribute, value)
+          if respond_to?(:cattri_variable_set, true)
+            cattri_variable_set(
+              attribute.field,
+              value,
+              final: attribute.options[:final]
+            )
+          else
+            instance_variable_set("@#{attribute.field}", value)
+          end
+        end
+
         # Resolves root-wrapped and unwrapped data.
         #
         # @param data [Hash]

data/lib/castkit/dsl/data_object/introspection.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Castkit
+  module DSL
+    module DataObject
+      # Provides opt-in attribute introspection for data objects using Cattri's registry
+      # without overriding Castkit's attribute DSL.
+      module Introspection
+        # Enables introspection helpers on the including class.
+        #
+        # @return [void]
+        def enable_cattri_introspection!
+          extend IntrospectionHelpers
+
+          @cattri_attribute_registry = nil
+        end
+
+        # Class-level helpers that read from Cattri's attribute registry but do not
+        # override Castkit's attribute builder.
+        module IntrospectionHelpers
+          def attribute_defined?(name)
+            !!cattri_attribute(name)
+          end
+
+          def attribute_definitions(with_ancestors: false)
+            cattri_attribute_registry.defined_attributes(with_ancestors: with_ancestors)
+          end
+
+          def attribute_methods
+            cattri_attribute_registry.defined_attributes(with_ancestors: true).transform_values do |attribute|
+              Set.new(attribute.allowed_methods)
+            end
+          end
+
+          def attribute_source(name)
+            cattri_attribute(name)&.defined_in
+          end
+
+          private
+
+          def cattri_attribute_registry
+            @cattri_attribute_registry ||= attribute_registry
+          end
+
+          def cattri_attribute(name)
+            cattri_attribute_registry.defined_attributes(with_ancestors: true)[name.to_sym]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/castkit/dsl/data_object/serialization.rb

@@ -38,7 +38,10 @@ module Castkit
           # @param value [Boolean, nil]
           # @return [Boolean]
           def ignore_blank(value = nil)
-            @ignore_blank = value.nil? || value
+            return (@ignore_blank = true) if value.nil? && !defined?(@ignore_blank)
+            return @ignore_blank if value.nil?
+
+            @ignore_blank = value
           end
         end
 

data/lib/castkit/dsl/data_object.rb

@@ -7,6 +7,7 @@ require_relative "data_object/contract"
 require_relative "data_object/plugins"
 require_relative "data_object/serialization"
 require_relative "data_object/deserialization"
+require_relative "data_object/introspection"
 
 module Castkit
   module DSL
@@ -47,11 +48,14 @@ module Castkit
       # @param base [Class] the including class
       # @return [void]
       def self.included(base)
+        base.include(Cattri)
+
         base.extend(Castkit::Core::Config)
         base.extend(Castkit::Core::Attributes)
         base.extend(Castkit::Core::AttributeTypes)
         base.extend(Castkit::DSL::DataObject::Contract)
         base.extend(Castkit::DSL::DataObject::Plugins)
+        base.extend(Castkit::DSL::DataObject::Introspection)
 
         base.include(Castkit::DSL::DataObject::Serialization)
         base.include(Castkit::DSL::DataObject::Deserialization)

data/lib/castkit/error.rb

@@ -3,8 +3,10 @@
 module Castkit
   # Base error class for all Castkit-related exceptions.
   class Error < StandardError
+    include Cattri
+
     # @return [Hash, Object, nil] contextual data to aid in debugging
-    attr_reader :context
+    cattri :context, nil, expose: :read
 
     # Initializes a Castkit error.
     #
@@ -12,7 +14,8 @@ module Castkit
     # @param context [Object, String, nil] optional data object or hash for context
     def initialize(msg, context: nil)
       super(msg)
-      @context = context
+
+      cattri_variable_set(:context, context, final: true)
     end
   end
 
@@ -44,11 +47,12 @@ module Castkit
 
   # Raised during contract validation.
   class ContractError < Error
-    attr_reader :errors
+    cattri :errors, {}, expose: :read
 
     def initialize(msg, context: nil, errors: nil)
       super(msg, context: context)
-      @errors = errors || {}
+
+      cattri_variable_set(:errors, errors || {})
     end
   end
 end

data/lib/castkit/plugins.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "cattri"
+
 module Castkit
   # Internal registry for Castkit plugin modules.
   #
@@ -19,9 +21,16 @@ module Castkit
   #     enable_plugins :custom, :oj
   #   end
   module Plugins
-    @registered_plugins = {}
+    include Cattri
 
     class << self
+      include Cattri
+      extend Cattri::Dsl
+      extend Cattri::ClassMethods
+      extend Cattri::Visibility
+
+      cattri :registered_plugins, {}, expose: :read_write
+
       # Activates one or more plugins on the given class.
       #
       # Each plugin module is included into the class. If the module responds to `setup!`,
@@ -58,7 +67,7 @@ module Castkit
       # @return [Module] the plugin module
       # @raise [Castkit::Error] if no plugin is found
       def lookup!(name)
-        @registered_plugins[name.to_sym] ||
+        registered_plugins[name.to_sym] ||
           const_get(Castkit::Inflector.pascalize(name.to_s), false)
       rescue NameError
         raise Castkit::Error,
@@ -75,7 +84,7 @@ module Castkit
       # @param plugin [Module] the plugin module to register
       # @return [void]
       def register(name, plugin)
-        @registered_plugins[name] = plugin
+        registered_plugins[name.to_sym] = plugin
       end
     end
   end

data/lib/castkit/serializers/base.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "set"
+require "cattri"
 
 module Castkit
   module Serializers
@@ -21,6 +22,8 @@ module Castkit
     #
     #   CustomSerializer.call(user_dto)
     class Base
+      include Cattri
+
       class << self
         # Entrypoint for serializing an object.
         #
@@ -33,7 +36,7 @@ module Castkit
       end
 
       # @return [Castkit::DataObject] the object being serialized
-      attr_reader :object
+      cattri :object, nil, expose: :read
 
       protected
 
@@ -47,15 +50,17 @@ module Castkit
       private
 
       # @return [Set<Integer>] a set of visited object IDs to detect circular references
-      attr_reader :visited
+      cattri :visited, nil, expose: :read
 
       # Initializes the serializer instance.
       #
       # @param object [Castkit::DataObject]
       # @param visited [Set, nil]
       def initialize(object, visited: nil)
-        @object = object
-        @visited = visited || Set.new
+        super()
+
+        cattri_variable_set(:object, object)
+        cattri_variable_set(:visited, visited || Set.new)
       end
 
       # Subclasses must override this method to implement serialization logic.

data/lib/castkit/serializers/default_serializer.rb

@@ -11,13 +11,13 @@ module Castkit
     # and respects the class-level serialization configuration.
     class DefaultSerializer < Castkit::Serializers::Base
       # @return [Hash{Symbol => Castkit::Attribute}] the attributes to serialize
-      attr_reader :attributes
+      cattri :attributes, nil, expose: :read
 
       # @return [Hash{Symbol => Object}] unrecognized attributes captured during deserialization
-      attr_reader :unknown_attributes
+      cattri :unknown_attributes, nil, expose: :read
 
       # @return [Hash] serialization config flags like :root, :ignore_nil, :allow_unknown
-      attr_reader :options
+      cattri :options, nil, expose: :read
 
       # Serializes the object to a hash.
       #
@@ -41,13 +41,13 @@ module Castkit
         super
 
         @skip_flag = "__castkit_#{object.object_id}"
-        @attributes = object.class.attributes.freeze
-        @unknown_attributes = object.unknown_attributes.freeze
-        @options = {
-          root: object.class.root,
-          ignore_nil: object.class.ignore_nil || false,
-          allow_unknown: object.class.allow_unknown || false
-        }
+        cattri_variable_set(:attributes, object.class.attributes.freeze)
+        cattri_variable_set(:unknown_attributes, object.unknown_attributes.freeze)
+        cattri_variable_set(:options, {
+                              root: object.class.root,
+                              ignore_nil: object.class.ignore_nil || false,
+                              allow_unknown: object.class.allow_unknown || false
+                            })
       end
 
       # Serializes all defined attributes.

data/lib/castkit/validators/collection_validator.rb

@@ -17,11 +17,11 @@ module Castkit
       # Validates that the value is an Array.
       #
       # @param value [Object] the value to validate
-      # @param _options [Hash] unused, for interface consistency
+      # @param options [Hash] unused, for interface consistency
       # @param context [Symbol, String] the field or context for error messaging
       # @return [void]
       # @raise [Castkit::AttributeError] if value is not an Array
-      def call(value, _options:, context:)
+      def call(value, options:, context:) # rubocop:disable Lint/UnusedMethodArgument
         type_error!(:array, value, context: context) unless value.is_a?(::Array)
       end
     end

data/lib/castkit/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Castkit
-  VERSION = "0.3.1"
+  VERSION = "0.4.0"
 end

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: castkit
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.4.0
 platform: ruby
 authors:
 - Nathan Lucas
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-12-09 00:00:00.000000000 Z
+date: 2025-12-14 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: cattri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.2.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.2.3
 - !ruby/object:Gem::Dependency
   name: thor
   requirement: !ruby/object:Gem::Requirement
@@ -80,6 +94,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: simplecov-html
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: yard
   requirement: !ruby/object:Gem::Requirement
@@ -138,6 +166,7 @@ files:
 - lib/castkit/dsl/data_object.rb
 - lib/castkit/dsl/data_object/contract.rb
 - lib/castkit/dsl/data_object/deserialization.rb
+- lib/castkit/dsl/data_object/introspection.rb
 - lib/castkit/dsl/data_object/plugins.rb
 - lib/castkit/dsl/data_object/serialization.rb
 - lib/castkit/error.rb