improve(syncmap): remove experimental api status and give the int, short and float maps the FASTEST_MIX by default

Author: vectrixdevelops

collections-fastutil/src/main/java-templates/space/vectrix/sync/collections/fastutil/{{key}}2ObjectSyncMap.java.peb

@@ -19,7 +19,6 @@ import java.util.Set;
 import java.util.concurrent.atomic.LongAdder;
 import java.util.function.BiFunction;
 import java.util.function.{{ keyJava }}Function;
-import org.jetbrains.annotations.ApiStatus;
 import org.jspecify.annotations.NonNull;
 import org.jspecify.annotations.Nullable;
 
@@ -48,7 +47,6 @@ import static java.util.Objects.requireNonNull;
  * @param <V> the value type
  * @since 1.0.0
  */
-@ApiStatus.Experimental
 public class {{ key }}2ObjectSyncMap<V> extends Abstract{{ key }}2ObjectMap<V> {
 
   @Serial
@@ -274,13 +272,13 @@ public class {{ key }}2ObjectSyncMap<V> extends Abstract{{ key }}2ObjectMap<V> {
   /* ------------------------- < Public Operations > ------------------------- */
 
   /**
-   * Initializes a new {@link {{ key }}2ObjectSyncMap} with {@link Hashing#FAST_MIX},
+   * Initializes a new {@link {{ key }}2ObjectSyncMap} with {@link Hashing#{{ mix }}},
    * {@link {{ key }}2ObjectSyncMap#DEFAULT_CAPACITY} and {@link {{ key }}2ObjectSyncMap#DEFAULT_LOAD_FACTOR}.
    *
    * @since 1.0.0
    */
   public {{ key }}2ObjectSyncMap() {
-    this(Hashing.FAST_MIX);
+    this(Hashing.{{ mix }});
   }
 
   /**
@@ -295,14 +293,14 @@ public class {{ key }}2ObjectSyncMap<V> extends Abstract{{ key }}2ObjectMap<V> {
   }
 
   /**
-   * Initializes a new {@link {{ key }}2ObjectSyncMap} with {@link Hashing#FAST_MIX}, the
+   * Initializes a new {@link {{ key }}2ObjectSyncMap} with {@link Hashing#{{ mix }}}, the
    * given initial capacity and {@link {{ key }}2ObjectSyncMap#DEFAULT_LOAD_FACTOR}.
    *
    * @param initialCapacity the initial capacity
    * @since 1.0.0
    */
   public {{ key }}2ObjectSyncMap(final int initialCapacity) {
-    this(Hashing.FAST_MIX, initialCapacity);
+    this(Hashing.{{ mix }}, initialCapacity);
   }
 
   /**
@@ -318,15 +316,15 @@ public class {{ key }}2ObjectSyncMap<V> extends Abstract{{ key }}2ObjectMap<V> {
   }
 
   /**
-   * Initializes a new {@link {{ key }}2ObjectSyncMap} with {@link Hashing#FAST_MIX}, the
+   * Initializes a new {@link {{ key }}2ObjectSyncMap} with {@link Hashing#{{ mix }}}, the
    * given initial capacity and the given load factor.
    *
    * @param initialCapacity the initial capacity
    * @param loadFactor the load factor
    * @since 1.0.0
    */
   public {{ key }}2ObjectSyncMap(final int initialCapacity, final float loadFactor) {
-    this(Hashing.FAST_MIX, initialCapacity, loadFactor);
+    this(Hashing.{{ mix }}, initialCapacity, loadFactor);
   }
 
   /**

collections-fastutil/src/main/java/space/vectrix/sync/collections/fastutil/Hashing.java

@@ -33,7 +33,7 @@
  * @author Vectrix
  * @since 1.0.0
  */
-@ApiStatus.Internal
+@ApiStatus.NonExtendable
 public interface Hashing {
   /**
    * The bitmask applied to ensure hash values are non-negative and fit within

collections-fastutil/src/templateData/template-variables.yaml

@@ -5,27 +5,32 @@ variants:
     keyPrimitive: double
     keyObject: Double
     keyJava: Double
+    mix: FAST_MIX
   float:
     key: Float
     group: floats
     keyPrimitive: float
     keyObject: Float
     keyJava: Double
+    mix: FASTEST_MIX
   int:
     key: Int
     group: ints
     keyPrimitive: int
     keyObject: Integer
     keyJava: Int
+    mix: FASTEST_MIX
   short:
     key: Short
     group: shorts
     keyPrimitive: short
     keyObject: Short
     keyJava: Int
+    mix: FASTEST_MIX
   long:
     key: Long
     group: longs
     keyPrimitive: long
     keyObject: Long
     keyJava: Long
+    mix: FAST_MIX

collections/src/main/java/space/vectrix/sync/collections/Hashing.java

@@ -33,7 +33,7 @@
  * @author Vectrix
  * @since 1.0.0
  */
-@ApiStatus.Internal
+@ApiStatus.NonExtendable
 public interface Hashing {
   /**
    * The bitmask applied to ensure hash values are non-negative and fit within

collections/src/main/java/space/vectrix/sync/collections/SyncMap.java

@@ -38,7 +38,6 @@
 import java.util.function.BiConsumer;
 import java.util.function.BiFunction;
 import java.util.function.Function;
-import org.jetbrains.annotations.ApiStatus;
 import org.jetbrains.annotations.UnknownNullability;
 import org.jspecify.annotations.NonNull;
 import org.jspecify.annotations.Nullable;
@@ -68,7 +67,6 @@
  * @param <V> the value type
  * @since 1.0.0
  */
-@ApiStatus.Experimental
 public class SyncMap<K, V> extends AbstractMap<K, V> implements ConcurrentMap<K, V> {
 
   /* ---------------------------- < Constants > ---------------------------- */