feature(api): Remove BossBarViewer

api/src/main/java/net/kyori/adventure/audience/Audience.java

@@ -33,7 +33,6 @@
 import java.util.function.Predicate;
 import java.util.stream.Collector;
 import net.kyori.adventure.bossbar.BossBar;
-import net.kyori.adventure.bossbar.BossBarViewer;
 import net.kyori.adventure.chat.ChatType;
 import net.kyori.adventure.chat.SignedMessage;
 import net.kyori.adventure.dialog.DialogLike;
@@ -50,6 +49,7 @@
 import net.kyori.adventure.text.ComponentLike;
 import net.kyori.adventure.title.Title;
 import net.kyori.adventure.title.TitlePart;
+import org.jetbrains.annotations.UnmodifiableView;
 
 /**
  * A receiver of Minecraft media.
@@ -95,7 +95,6 @@
  * and any new methods will be stubbed by default.</p>
  *
  * @see ForwardingAudience
- * @see BossBarViewer
  * @since 4.0.0
  */
 public interface Audience extends Pointered {
@@ -441,6 +440,17 @@ default void showBossBar(final BossBar bar) {
   default void hideBossBar(final BossBar bar) {
   }
 
+  /**
+   * Gets an unmodifiable view of all known currently active bossbars.
+   *
+   * @return an unmodifiable view of all known currently active bossbars
+   * @since 4.14.0
+   */
+  @UnmodifiableView
+  default Iterable<? extends BossBar> activeBossBars() {
+    return List.of();
+  }
+
   /**
    * Plays a sound at the location of the recipient of the sound.
    *

api/src/main/java/net/kyori/adventure/audience/ForwardingAudience.java

@@ -25,8 +25,10 @@
 
 import java.util.ArrayList;
 import java.util.Collections;
+import java.util.HashSet;
 import java.util.List;
 import java.util.Optional;
+import java.util.Set;
 import java.util.UUID;
 import java.util.function.Consumer;
 import java.util.function.Predicate;
@@ -46,6 +48,7 @@
 import org.jetbrains.annotations.ApiStatus;
 import org.jetbrains.annotations.Contract;
 import org.jetbrains.annotations.UnknownNullability;
+import org.jetbrains.annotations.UnmodifiableView;
 import org.jspecify.annotations.Nullable;
 
 /**
@@ -162,6 +165,16 @@ default void hideBossBar(final BossBar bar) {
     for (final Audience audience : this.audiences()) audience.hideBossBar(bar);
   }
 
+  @Override
+  default @UnmodifiableView Iterable<? extends BossBar> activeBossBars() {
+    final Set<BossBar> bossBars = new HashSet<>();
+    for (final Audience audience : this.audiences()) {
+      for (final BossBar bb : audience.activeBossBars()) bossBars.add(bb);
+    }
+
+    return bossBars;
+  }
+
   @Override
   default void playSound(final Sound sound) {
     for (final Audience audience : this.audiences()) audience.playSound(sound);
@@ -343,6 +356,11 @@ default void hideBossBar(final BossBar bar) {
       this.audience().hideBossBar(bar);
     }
 
+    @Override
+    default @UnmodifiableView Iterable<? extends BossBar> activeBossBars() {
+      return this.audience().activeBossBars();
+    }
+
     @Override
     default void playSound(final Sound sound) {
       this.audience().playSound(sound);

api/src/main/java/net/kyori/adventure/bossbar/BossBar.java

@@ -335,7 +335,7 @@ default BossBar name(final ComponentLike name) {
    * @since 4.14.0
    */
   @UnmodifiableView
-  Iterable<? extends BossBarViewer> viewers();
+  Iterable<? extends Audience> viewers();
 
   /**
    * Show this bossbar to {@code viewer}.

api/src/main/java/net/kyori/adventure/bossbar/BossBarImpl.java

@@ -32,6 +32,7 @@
 import java.util.function.BiConsumer;
 import java.util.function.BiPredicate;
 import java.util.function.Consumer;
+import net.kyori.adventure.audience.Audience;
 import net.kyori.adventure.text.Component;
 import net.kyori.adventure.util.Services;
 import org.jspecify.annotations.Nullable;
@@ -261,7 +262,7 @@ public BossBar removeListener(final Listener listener) {
   }
 
   @Override
-  public Iterable<? extends BossBarViewer> viewers() {
+  public Iterable<? extends Audience> viewers() {
     if (this.implementation != null) {
       return this.implementation.viewers();
     }

api/src/main/java/net/kyori/adventure/bossbar/BossBarImplementation.java

@@ -24,6 +24,7 @@
 package net.kyori.adventure.bossbar;
 
 import java.util.List;
+import net.kyori.adventure.audience.Audience;
 import org.jetbrains.annotations.ApiStatus;
 
 /**
@@ -54,7 +55,7 @@ static <I extends BossBarImplementation> I get(final BossBar bar, final Class<I>
    * @since 4.14.0
    */
   @ApiStatus.Internal
-  default Iterable<? extends BossBarViewer> viewers() {
+  default Iterable<? extends Audience> viewers() {
     return List.of();
   }