feat: Add error for using with_options in define_enum_for matcher (#1693)

We're adding an explicit error message when users mistakenly use
with_options instead of with_values in the define_enum_for matcher.
This will help clarify the correct usage and prevent confusion.

Author: matsales28

lib/shoulda/matchers/active_record/define_enum_for_matcher.rb

@@ -320,6 +320,12 @@ def with_values(expected_enum_values)
           self
         end
 
+        def with_options(**)
+          raise NotImplementedError,
+            'with_options is not a valid qualifier for the define_enum_for matcher. '\
+            'Did you mean to use with_values instead?'
+        end
+
         def with_prefix(expected_prefix = true)
           options[:prefix] = expected_prefix
           self

spec/unit/shoulda/matchers/active_record/define_enum_for_matcher_spec.rb

@@ -103,6 +103,26 @@ def self.statuses
     end
   end
 
+  describe 'when with_options is used instead of with_values' do
+    it 'raises an appropriate error' do
+      record = build_record_with_array_values(
+        model_name: 'Example',
+        attribute_name: :attr,
+      )
+
+      assertion = lambda do
+        expect(record).
+          to define_enum_for(:attr).
+          with_options(active: 0, archived: 1)
+      end
+
+      message = 'with_options is not a valid qualifier for the define_enum_for matcher. '\
+        'Did you mean to use with_values instead?'
+
+      expect(&assertion).to raise_error(NotImplementedError, message)
+    end
+  end
+
   describe 'with both attribute name and enum values specified' do
     context 'when the actual enum values are an array' do
       context 'if the attribute is not defined as an enum' do