chore: Scalafmt upgrade

[leviramsey]

Draft for now (the formatting changes that result are omitted).

Some of the previous scalafmt settings have no direct equivalent in modern scalafmt, so the diff will be something to behold. Leaving out the resulting formatting changes to facilitate local playing around with the settings.

+~ 3.3 Test/compile

passes.

References #32186 and #32083.

[leviramsey]

Interaction of breaking long lines in scalafmt with the semicolon inference in at least Scala 3.3.1

[patriknw]

I looked at some (random) formatting changes. Overall looks pretty good.

Noted a few annoying things

/** INTERNAL API */

will be broken up in 3 lines

        props.args.forall(
          arg =>

it was more compact

props.args.forall(arg =>

extra ( ) around function parameter

(ex) => shouldRetry.test(ex),

[patriknw]

if we approve this change we should apply it to release-2.8 branch to make it easier to backport fixes

[leviramsey]

I believe the extra ( ) around function parameters is a Scala 3 requirement (at least I've regularly had to clean up my code with parens around single arguments to get Scala 3 happy)

[patriknw]

Scala 3 requirement

but it compiles fine without

[leviramsey]

Scala 3 requires parens around single arguments with type ascriptions. Perhaps scalafmt also imposes the parens for its Scala 3-compatible modes?

[leviramsey]

As noticed in another repo, docstrings.wrap = yes (the default) will do weird things with @param etc. in scaladoc, so incorporating that here.