generate docs for a lot of API (test try)

crypto/src/commonMain/kotlin/dev/inmo/micro_utils/crypto/Base64.kt

@@ -12,12 +12,35 @@ private val BASE64_INVERSE_ALPHABET = IntArray(256) {
 internal fun Int.toBase64(): Char = BASE64_ALPHABET[this]
 internal fun Byte.fromBase64(): Byte = BASE64_INVERSE_ALPHABET[toInt() and 0xff].toByte() and BASE64_MASK
 
+/**
+ * Type alias representing a Base64-encoded string.
+ */
 typealias EncodedBase64String = String
+
+/**
+ * Type alias representing a Base64-encoded byte array.
+ */
 typealias EncodedByteArray = ByteArray
 
+/**
+ * Encodes this string to Base64 format, returning the result as a string.
+ *
+ * @return A Base64-encoded string
+ */
 fun SourceString.encodeBase64String(): EncodedBase64String = encodeToByteArray().encodeBase64String()
+
+/**
+ * Encodes this string to Base64 format, returning the result as a byte array.
+ *
+ * @return A Base64-encoded byte array
+ */
 fun SourceString.encodeBase64(): EncodedByteArray = encodeToByteArray().encodeBase64()
 
+/**
+ * Encodes this byte array to Base64 format, returning the result as a string.
+ *
+ * @return A Base64-encoded string with padding ('=') characters
+ */
 fun SourceBytes.encodeBase64String(): EncodedBase64String = buildString {
     var i = 0
     while (this@encodeBase64String.size > i) {
@@ -45,11 +68,33 @@ fun SourceBytes.encodeBase64String(): EncodedBase64String = buildString {
         i += read
     }
 }
+
+/**
+ * Encodes this byte array to Base64 format, returning the result as a byte array.
+ *
+ * @return A Base64-encoded byte array
+ */
 fun SourceBytes.encodeBase64(): EncodedByteArray = encodeBase64String().encodeToByteArray()
 
+/**
+ * Decodes this Base64-encoded string back to the original byte array.
+ *
+ * @return The decoded byte array
+ */
 fun EncodedBase64String.decodeBase64(): SourceBytes = dropLastWhile { it == BASE64_PAD }.encodeToByteArray().decodeBase64()
+
+/**
+ * Decodes this Base64-encoded string back to the original string.
+ *
+ * @return The decoded string
+ */
 fun EncodedBase64String.decodeBase64String(): SourceString = decodeBase64().decodeToString()
 
+/**
+ * Decodes this Base64-encoded byte array back to the original byte array.
+ *
+ * @return The decoded byte array
+ */
 fun EncodedByteArray.decodeBase64(): SourceBytes {
     val result = mutableListOf<Byte>()
     val data = ByteArray(4)
@@ -74,4 +119,10 @@ fun EncodedByteArray.decodeBase64(): SourceBytes {
 
     return result.toByteArray()
 }
+
+/**
+ * Decodes this Base64-encoded byte array back to the original string.
+ *
+ * @return The decoded string
+ */
 fun EncodedByteArray.decodeBase64String(): SourceString = decodeBase64().decodeToString()

crypto/src/commonMain/kotlin/dev/inmo/micro_utils/crypto/Hex.kt

@@ -1,7 +1,16 @@
 package dev.inmo.micro_utils.crypto
 
+/**
+ * Character array used for hexadecimal encoding (lowercase).
+ */
 val HEX_ARRAY = "0123456789abcdef".toCharArray()
 
+/**
+ * Converts this byte array to a hexadecimal string representation (lowercase).
+ * Each byte is represented as two hex characters.
+ *
+ * @return A lowercase hex string (e.g., "48656c6c6f" for "Hello")
+ */
 fun SourceBytes.hex(): String {
     val hexChars = CharArray(size * 2)
     for (j in indices) {
@@ -12,4 +21,9 @@ fun SourceBytes.hex(): String {
     return hexChars.concatToString()
 }
 
+/**
+ * Converts this string to a hexadecimal representation by first encoding it as UTF-8 bytes.
+ *
+ * @return A lowercase hex string representation of the UTF-8 encoded bytes
+ */
 fun SourceString.hex(): String = encodeToByteArray().hex()

crypto/src/commonMain/kotlin/dev/inmo/micro_utils/crypto/MD5.kt

@@ -2,7 +2,21 @@ package dev.inmo.micro_utils.crypto
 
 import korlibs.crypto.md5
 
+/**
+ * Type alias representing an MD5 hash as a hex-encoded string (32 characters).
+ */
 typealias MD5 = String
 
+/**
+ * Computes the MD5 hash of this byte array and returns it as a lowercase hex string.
+ *
+ * @return The MD5 hash as a 32-character lowercase hex string
+ */
 fun SourceBytes.md5(): MD5 = md5().hexLower
+
+/**
+ * Computes the MD5 hash of this string (encoded as UTF-8 bytes) and returns it as a lowercase hex string.
+ *
+ * @return The MD5 hash as a 32-character lowercase hex string
+ */
 fun SourceString.md5(): MD5 = encodeToByteArray().md5().hexLower