Allow optional passing of options to calculators

[mamhoff]

Summary

For the upcoming "strikethrough prices"/"promotion previews" feature, we need to allow passing options to calculator's compute methods.

For strikethrough prices, we will need the current order and the desired quantity to be passed into the calculator, and this commit allows passing any desired options.

Since calculators are polymorphic in all directions and can be used in all kinds of context, we don't specify which options are possible.

This also does the groundwork for allowing the
SolidusPromotions::Benefit to take options and pass them on to its calculator.

Because these methods are used a lot in Solidus, adds YARD-style documentation to the modified methods.

Extracted from #6287

Checklist

Check out our PR guidelines for more details.

The following are mandatory for all PRs:

• I agree that my PR will be published under the same license as Solidus.
• I have written a thorough PR description.
• I have kept my commits small and atomic.
• I have localized any and all user-facing strings that I added to the source code.
• I have used clear, explanatory commit messages.

The following are not always needed:

• 📖 I have updated the README to account for my changes.
• 📑 I have documented new code with YARD.
• 🛣️ I have opened a PR to update the guides.
• ✅ I have added automated tests to cover my changes.
• 📸 I have attached screenshots to demo visual changes.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 89.34%. Comparing base (2d1fcff) to head (5a885dc).
⚠️ Report is 8 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #6346   +/-   ##
=======================================
  Coverage   89.34%   89.34%           
=======================================
  Files         961      961           
  Lines       20165    20165           
=======================================
  Hits        18016    18016           
  Misses       2149     2149           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.