Add XofAlgorithm interface (#29)

Author: 05nelsonm

library/xof/api/xof.api

@@ -22,17 +22,20 @@ public abstract class org/kotlincrypto/core/Xof$Reader {
 	public final fun use (Lkotlin/jvm/functions/Function1;)Ljava/lang/Object;
 }
 
+public abstract interface class org/kotlincrypto/core/XofAlgorithm : org/kotlincrypto/core/Algorithm {
+}
+
 public abstract class org/kotlincrypto/core/XofFactory {
 }
 
 protected abstract class org/kotlincrypto/core/XofFactory$XofDelegate : org/kotlincrypto/core/Xof, org/kotlincrypto/core/Algorithm, org/kotlincrypto/core/Resettable, org/kotlincrypto/core/Updatable {
-	protected fun <init> (Lorg/kotlincrypto/core/XofFactory;Lorg/kotlincrypto/core/Algorithm;)V
+	protected fun <init> (Lorg/kotlincrypto/core/XofFactory;Lorg/kotlincrypto/core/XofAlgorithm;)V
 	public fun algorithm ()Ljava/lang/String;
 	public final fun equals (Ljava/lang/Object;)Z
-	protected final fun getDelegate ()Lorg/kotlincrypto/core/Algorithm;
+	protected final fun getDelegate ()Lorg/kotlincrypto/core/XofAlgorithm;
 	public final fun hashCode ()I
 	protected final fun newReader ()Lorg/kotlincrypto/core/Xof$Reader;
-	protected abstract fun newReader (Lorg/kotlincrypto/core/Algorithm;)Lorg/kotlincrypto/core/Xof$Reader;
+	protected abstract fun newReader (Lorg/kotlincrypto/core/XofAlgorithm;)Lorg/kotlincrypto/core/Xof$Reader;
 	public fun reset ()V
 	public fun update (B)V
 	public fun update ([B)V

library/xof/src/commonMain/kotlin/org/kotlincrypto/core/Xof.kt

@@ -50,7 +50,7 @@ import kotlin.jvm.JvmStatic
  * @see [reader]
  * @see [Reader]
  * */
-public sealed class Xof<A: Algorithm>: Algorithm, Copyable<Xof<A>>, Resettable, Updatable {
+public sealed class Xof<A: XofAlgorithm>: Algorithm, Copyable<Xof<A>>, Resettable, Updatable {
 
     /**
      * Takes a snapshot of the current [Xof]'s state and produces

library/xof/src/commonMain/kotlin/org/kotlincrypto/core/XofAlgorithm.kt

@@ -0,0 +1,22 @@
+/*
+ * Copyright (c) 2023 Matthew Nelson
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ **/
+package org.kotlincrypto.core
+
+/**
+ * Denotes a class as a user of a specified cryptographic [algorithm]
+ * which supports Extendable-Output Functions (XOFs).
+ * */
+public interface XofAlgorithm: Algorithm

library/xof/src/commonMain/kotlin/org/kotlincrypto/core/XofFactory.kt

@@ -38,7 +38,7 @@ package org.kotlincrypto.core
  *
  * @see [XofDelegate]
  * */
-public abstract class XofFactory<A: Algorithm>
+public abstract class XofFactory<A: XofAlgorithm>
 @InternalKotlinCryptoApi
 public constructor()
 {