Component::applyFallbackStyle helper method

[rymiel]

Implements and resolves #486.

EDIT: Method was extensively renamed, see discussion below

Of note: I'm not good with javadocs and the explanation is moot at best, please suggest a better wording to describe this "wrapping" feature.

Also, could there possibly be a default instance method, to allow for mm.wrap(ITALIC.as(false)), or would that be too unclear in its operation?

[kezz]

Final nitpicks :p

[zml2008]

I'm not sure if this is the best solution for this sort of operation. What can this wrap operator do that an appropriate style merge can't do with fewer levels of nesting?

With an alternative API of something like:

interface Component {
  default @NotNull Component applyUnsetStyleFrom(final @NotNull Style /* or StyleBuilderApplicable... */ other) {
    return this.style(this.style().merge(other, Merge.Strategy.IF_ABSENT_ON_TARGET));
  }
}

would there be any limitations compared to this PR? (well, aside from the name)

[kezz]

Yes, this component wrapping isn't the ideal solution to the problem it solves. However, it is way more intuitive than other solutions. If we can think of a solid name for this apply unset method, I'd be happy to see a PR with that come through too. However, as it stands I think this PR is solid, and introduces a short-hand for a relatively common pattern.

[rymiel]

Should this PR still be considered for 4.10.0?

[kezz]

I've changed my mind - I think calling this method wrap is good and clear, but it should be performing a style merge.

Think of the case where someone heads onto webui and makes a non-italic lore item. If a developer wants to make that the default, it would be nice to have this method as a no-op in the case where the user has already made the change, for example.

[rymiel]

I've made the method perform a style merge as outlined in #488 (review), but now it theoretically no longer contains any "wrapper"s per se, so i'm confused on how to document this, although it accomplishes the same thing

[zml2008]

Component.applyFallbackStyle() maybe?

[kezz]

Component.applyFallbackStyle() maybe?

Yeah I kiinda like this.

Would this be worth having in StyleSetter instead of Component?

suggestions applied