Finish converting most of the undeprecated api to jspecify

patches/api/Add-Lifecycle-Event-system.patch

@@ -17,13 +17,11 @@ index 0000000000000000000000000000000000000000..00000000000000000000000000000000
 +import io.papermc.paper.plugin.lifecycle.event.LifecycleEventManager;
 +import io.papermc.paper.plugin.lifecycle.event.LifecycleEventOwner;
  import org.jetbrains.annotations.ApiStatus;
-+import org.jetbrains.annotations.NotNull;
+ import org.jspecify.annotations.NullMarked;
  
- /**
-  * Represents the context provided to a {@link PluginBootstrap} during both the bootstrapping and plugin
-@@ -0,0 +0,0 @@ import org.jetbrains.annotations.ApiStatus;
-  */
+@@ -0,0 +0,0 @@ import org.jspecify.annotations.NullMarked;
  @ApiStatus.Experimental
+ @NullMarked
  @ApiStatus.NonExtendable
 -public interface BootstrapContext extends PluginProviderContext {
 +public interface BootstrapContext extends PluginProviderContext, LifecycleEventOwner {
@@ -34,7 +32,7 @@ index 0000000000000000000000000000000000000000..00000000000000000000000000000000
 +     *
 +     * @return the lifecycle event manager
 +     */
-+    @NotNull LifecycleEventManager<BootstrapContext> getLifecycleManager();
++    LifecycleEventManager<BootstrapContext> getLifecycleManager();
  }
 diff --git a/src/main/java/io/papermc/paper/plugin/lifecycle/event/LifecycleEvent.java b/src/main/java/io/papermc/paper/plugin/lifecycle/event/LifecycleEvent.java
 new file mode 100644
@@ -71,7 +69,7 @@ index 0000000000000000000000000000000000000000..00000000000000000000000000000000
 +import io.papermc.paper.plugin.lifecycle.event.handler.configuration.LifecycleEventHandlerConfiguration;
 +import io.papermc.paper.plugin.lifecycle.event.types.LifecycleEventType;
 +import org.jetbrains.annotations.ApiStatus;
-+import org.jetbrains.annotations.NotNull;
++import org.jspecify.annotations.NullMarked;
 +
 +/**
 + * Manages a plugin's lifecycle events. Can be obtained
@@ -80,6 +78,7 @@ index 0000000000000000000000000000000000000000..00000000000000000000000000000000
 + * @param <O> the owning type, {@link org.bukkit.plugin.Plugin} or {@link io.papermc.paper.plugin.bootstrap.BootstrapContext}
 + */
 +@ApiStatus.Experimental
++@NullMarked
 +@ApiStatus.NonExtendable
 +public interface LifecycleEventManager<O extends LifecycleEventOwner> {
 +
@@ -102,7 +101,7 @@ index 0000000000000000000000000000000000000000..00000000000000000000000000000000
 +     * @param eventHandler the handler for that event
 +     * @param <E> the type of the event object
 +     */
-+    default <E extends LifecycleEvent> void registerEventHandler(final @NotNull LifecycleEventType<? super O, ? extends E, ?> eventType, final @NotNull LifecycleEventHandler<? super E> eventHandler) {
++    default <E extends LifecycleEvent> void registerEventHandler(final LifecycleEventType<? super O, ? extends E, ?> eventType, final LifecycleEventHandler<? super E> eventHandler) {
 +        this.registerEventHandler(eventType.newHandler(eventHandler));
 +    }
 +
@@ -115,7 +114,7 @@ index 0000000000000000000000000000000000000000..00000000000000000000000000000000
 +     *
 +     * @param handlerConfiguration the handler configuration to register
 +     */
-+    void registerEventHandler(@NotNull LifecycleEventHandlerConfiguration<? super O> handlerConfiguration);
++    void registerEventHandler(LifecycleEventHandlerConfiguration<? super O> handlerConfiguration);
 +}
 diff --git a/src/main/java/io/papermc/paper/plugin/lifecycle/event/LifecycleEventOwner.java b/src/main/java/io/papermc/paper/plugin/lifecycle/event/LifecycleEventOwner.java
 new file mode 100644
@@ -127,7 +126,7 @@ index 0000000000000000000000000000000000000000..00000000000000000000000000000000
 +
 +import io.papermc.paper.plugin.configuration.PluginMeta;
 +import org.jetbrains.annotations.ApiStatus;
-+import org.jetbrains.annotations.NotNull;
++import org.jspecify.annotations.NullMarked;
 +
 +/**
 + * Implemented by types that are considered owners
@@ -137,6 +136,7 @@ index 0000000000000000000000000000000000000000..00000000000000000000000000000000
 + * event handlers.
 + */
 +@ApiStatus.Experimental
++@NullMarked
 +@ApiStatus.NonExtendable
 +public interface LifecycleEventOwner {
 +
@@ -145,7 +145,7 @@ index 0000000000000000000000000000000000000000..00000000000000000000000000000000
 +     *
 +     * @return the plugin meta
 +     */
-+    @NotNull PluginMeta getPluginMeta();
++    PluginMeta getPluginMeta();
 +}
 diff --git a/src/main/java/io/papermc/paper/plugin/lifecycle/event/handler/LifecycleEventHandler.java b/src/main/java/io/papermc/paper/plugin/lifecycle/event/handler/LifecycleEventHandler.java
 new file mode 100644
@@ -157,7 +157,7 @@ index 0000000000000000000000000000000000000000..00000000000000000000000000000000
 +
 +import io.papermc.paper.plugin.lifecycle.event.LifecycleEvent;
 +import org.jetbrains.annotations.ApiStatus;
-+import org.jetbrains.annotations.NotNull;
++import org.jspecify.annotations.NullMarked;
 +
 +/**
 + * A handler for a specific event. Can be implemented
@@ -166,10 +166,11 @@ index 0000000000000000000000000000000000000000..00000000000000000000000000000000
 + * @param <E> the event
 + */
 +@ApiStatus.Experimental
++@NullMarked
 +@FunctionalInterface
 +public interface LifecycleEventHandler<E extends LifecycleEvent> {
 +
-+    void run(@NotNull E event);
++    void run(E event);
 +}
 diff --git a/src/main/java/io/papermc/paper/plugin/lifecycle/event/handler/configuration/LifecycleEventHandlerConfiguration.java b/src/main/java/io/papermc/paper/plugin/lifecycle/event/handler/configuration/LifecycleEventHandlerConfiguration.java
 new file mode 100644
@@ -182,6 +183,7 @@ index 0000000000000000000000000000000000000000..00000000000000000000000000000000
 +import io.papermc.paper.plugin.lifecycle.event.LifecycleEventOwner;
 +import io.papermc.paper.plugin.lifecycle.event.handler.LifecycleEventHandler;
 +import org.jetbrains.annotations.ApiStatus;
++import org.jspecify.annotations.NullMarked;
 +
 +/**
 + * Base type for constructing configured event handlers for
@@ -192,6 +194,7 @@ index 0000000000000000000000000000000000000000..00000000000000000000000000000000
 + */
 +@SuppressWarnings("unused")
 +@ApiStatus.Experimental
++@NullMarked
 +@ApiStatus.NonExtendable
 +public interface LifecycleEventHandlerConfiguration<O extends LifecycleEventOwner> {
 +}
@@ -206,6 +209,7 @@ index 0000000000000000000000000000000000000000..00000000000000000000000000000000
 +import io.papermc.paper.plugin.lifecycle.event.LifecycleEventOwner;
 +import org.jetbrains.annotations.ApiStatus;
 +import org.jetbrains.annotations.Contract;
++import org.jspecify.annotations.NullMarked;
 +
 +/**
 + * Handler configuration for event types that allow "monitor" handlers.
@@ -213,6 +217,7 @@ index 0000000000000000000000000000000000000000..00000000000000000000000000000000
 + * @param <O> the required owner type
 + */
 +@ApiStatus.Experimental
++@NullMarked
 +@ApiStatus.NonExtendable
 +public interface MonitorLifecycleEventHandlerConfiguration<O extends LifecycleEventOwner> extends LifecycleEventHandlerConfiguration<O> {
 +
@@ -237,6 +242,7 @@ index 0000000000000000000000000000000000000000..00000000000000000000000000000000
 +import io.papermc.paper.plugin.lifecycle.event.LifecycleEventOwner;
 +import org.jetbrains.annotations.ApiStatus;
 +import org.jetbrains.annotations.Contract;
++import org.jspecify.annotations.NullMarked;
 +
 +/**
 + * Handler configuration that allows both "monitor" and prioritized handlers.
@@ -245,6 +251,7 @@ index 0000000000000000000000000000000000000000..00000000000000000000000000000000
 + * @param <O> the required owner type
 + */
 +@ApiStatus.Experimental
++@NullMarked
 +@ApiStatus.NonExtendable
 +public interface PrioritizedLifecycleEventHandlerConfiguration<O extends LifecycleEventOwner> extends LifecycleEventHandlerConfiguration<O> {
 +
@@ -300,7 +307,7 @@ index 0000000000000000000000000000000000000000..00000000000000000000000000000000
 +import io.papermc.paper.plugin.lifecycle.event.LifecycleEvent;
 +import org.jetbrains.annotations.ApiStatus;
 +import org.jetbrains.annotations.Contract;
-+import org.jetbrains.annotations.NotNull;
++import org.jspecify.annotations.NullMarked;
 +
 +/**
 + * A lifecycle event that exposes a {@link Registrar} of some kind
@@ -311,6 +318,7 @@ index 0000000000000000000000000000000000000000..00000000000000000000000000000000
 + * @see ReloadableRegistrarEvent
 + */
 +@ApiStatus.Experimental
++@NullMarked
 +@ApiStatus.NonExtendable
 +public interface RegistrarEvent<R extends Registrar> extends LifecycleEvent {
 +
@@ -320,7 +328,7 @@ index 0000000000000000000000000000000000000000..00000000000000000000000000000000
 +     * @return the registrar
 +     */
 +    @Contract(pure = true)
-+    @NotNull R registrar();
++    R registrar();
 +}
 diff --git a/src/main/java/io/papermc/paper/plugin/lifecycle/event/registrar/ReloadableRegistrarEvent.java b/src/main/java/io/papermc/paper/plugin/lifecycle/event/registrar/ReloadableRegistrarEvent.java
 new file mode 100644
@@ -332,7 +340,7 @@ index 0000000000000000000000000000000000000000..00000000000000000000000000000000
 +
 +import org.jetbrains.annotations.ApiStatus;
 +import org.jetbrains.annotations.Contract;
-+import org.jetbrains.annotations.NotNull;
++import org.jspecify.annotations.NullMarked;
 +
 +/**
 + * A lifecycle event that exposes a {@link Registrar} that is
@@ -342,6 +350,7 @@ index 0000000000000000000000000000000000000000..00000000000000000000000000000000
 + * @see RegistrarEvent
 + */
 +@ApiStatus.Experimental
++@NullMarked
 +@ApiStatus.NonExtendable
 +public interface ReloadableRegistrarEvent<R extends Registrar> extends RegistrarEvent<R> {
 +
@@ -351,7 +360,7 @@ index 0000000000000000000000000000000000000000..00000000000000000000000000000000
 +     * @return the cause
 +     */
 +    @Contract(pure = true)
-+    @NotNull Cause cause();
++    Cause cause();
 +
 +    @ApiStatus.Experimental
 +    enum Cause {
@@ -383,7 +392,7 @@ index 0000000000000000000000000000000000000000..00000000000000000000000000000000
 +import io.papermc.paper.plugin.lifecycle.event.handler.configuration.PrioritizedLifecycleEventHandlerConfiguration;
 +import org.jetbrains.annotations.ApiStatus;
 +import org.jetbrains.annotations.Contract;
-+import org.jetbrains.annotations.NotNull;
++import org.jspecify.annotations.NullMarked;
 +
 +/**
 + * Base type for all types of lifecycle events. Differs from
@@ -397,6 +406,7 @@ index 0000000000000000000000000000000000000000..00000000000000000000000000000000
 + * @param <C> the configuration type
 + */
 +@ApiStatus.Experimental
++@NullMarked
 +@ApiStatus.NonExtendable
 +public interface LifecycleEventType<O extends LifecycleEventOwner, E extends LifecycleEvent, C extends LifecycleEventHandlerConfiguration<O>> {
 +
@@ -406,7 +416,7 @@ index 0000000000000000000000000000000000000000..00000000000000000000000000000000
 +     * @return the name
 +     */
 +    @Contract(pure = true)
-+    @NotNull String name();
++    String name();
 +
 +    /**
 +     * Create a configuration for this event with the specified
@@ -417,7 +427,7 @@ index 0000000000000000000000000000000000000000..00000000000000000000000000000000
 +     * @see LifecycleEventManager#registerEventHandler(LifecycleEventHandlerConfiguration)
 +     */
 +    @Contract("_ -> new")
-+    @NotNull C newHandler(@NotNull LifecycleEventHandler<? super E> handler);
++    C newHandler(LifecycleEventHandler<? super E> handler);
 +
 +    /**
 +     * Lifecycle event type that supports separate registration
@@ -458,8 +468,10 @@ index 0000000000000000000000000000000000000000..00000000000000000000000000000000
 +import java.util.Optional;
 +import java.util.ServiceLoader;
 +import org.jetbrains.annotations.ApiStatus;
++import org.jspecify.annotations.NullMarked;
 +
 +@ApiStatus.Internal
++@NullMarked
 +interface LifecycleEventTypeProvider {
 +
 +    Optional<LifecycleEventTypeProvider> INSTANCE = ServiceLoader.load(LifecycleEventTypeProvider.class)
@@ -487,6 +499,7 @@ index 0000000000000000000000000000000000000000..00000000000000000000000000000000
 +import io.papermc.paper.plugin.lifecycle.event.LifecycleEventOwner;
 +import org.bukkit.plugin.Plugin;
 +import org.jetbrains.annotations.ApiStatus;
++import org.jspecify.annotations.NullMarked;
 +
 +/**
 + * Holds various types of lifecycle events for
@@ -494,6 +507,7 @@ index 0000000000000000000000000000000000000000..00000000000000000000000000000000
 + * in {@link LifecycleEventManager}.
 + */
 +@ApiStatus.Experimental
++@NullMarked
 +public final class LifecycleEvents {
 +
 +    //<editor-fold desc="helper methods" defaultstate="collapsed">