feat: add mergeWhenStateIn and mergeUnlessStateIn methods

Author: julian-farbcode

src/Concerns/StatefullyLoadsAttributes.php

@@ -130,6 +130,48 @@ protected function mergeUnlessState($state, $value, $default = null)
         return $this->mergeUnless($this->getState() === $state, $value);
     }
 
+    /**
+     * Merge a value if the current state is one of the given states.
+     *
+     * @param  array<string|ResourceState>  $states
+     * @param  mixed  $value
+     * @param  mixed  $default
+     * @return \Illuminate\Http\Resources\MergeValue|mixed
+     */
+    protected function mergeWhenStateIn(array $states, $value, $default = null)
+    {
+        $states = array_map(fn ($state) => $this->resolveState($state), $states);
+
+        $condition = in_array($this->getState(), $states, true);
+
+        if (func_num_args() === 3) {
+            return $this->mergeWhen($condition, $value, $default);
+        }
+
+        return $this->mergeWhen($condition, $value);
+    }
+
+    /**
+     * Merge a value unless the current state is one of the given states.
+     *
+     * @param  array<string|ResourceState>  $states
+     * @param  mixed  $value
+     * @param  mixed  $default
+     * @return \Illuminate\Http\Resources\MergeValue|mixed
+     */
+    protected function mergeUnlessStateIn(array $states, $value, $default = null)
+    {
+        $states = array_map(fn ($state) => $this->resolveState($state), $states);
+
+        $condition = in_array($this->getState(), $states, true);
+
+        if (func_num_args() === 3) {
+            return $this->mergeUnless($condition, $value, $default);
+        }
+
+        return $this->mergeUnless($condition, $value);
+    }
+
     /**
      * Get the current state of the resource.
      * This method should be implemented by the class using this trait.