Introduce optimal provider which if preferred way to have single dependency

Author: whyoleg

cryptography-providers/optimal/api/cryptography-provider-optimal.api

@@ -0,0 +1,8 @@
+// Klib ABI Dump
+// Targets: [androidNativeArm32, androidNativeArm64, androidNativeX64, androidNativeX86, iosArm64, iosSimulatorArm64, iosX64, js, linuxArm64, linuxX64, macosArm64, macosX64, mingwX64, tvosArm64, tvosSimulatorArm64, tvosX64, wasmJs, watchosArm32, watchosArm64, watchosDeviceArm64, watchosSimulatorArm64, watchosX64]
+// Rendering settings:
+// - Signature version: 2
+// - Show manifest properties: true
+// - Show declarations: true
+
+// Library unique name: <dev.whyoleg.cryptography:cryptography-provider-optimal>

cryptography-providers/optimal/api/cryptography-provider-optimal.klib.api

@@ -0,0 +1,67 @@
+/*
+ * Copyright (c) 2023-2025 Oleg Yukhnevich. Use of this source code is governed by the Apache 2.0 license.
+ */
+
+import ckbuild.*
+import org.jetbrains.kotlin.gradle.*
+import org.jetbrains.kotlin.gradle.plugin.mpp.*
+import org.jetbrains.kotlin.konan.target.*
+
+plugins {
+    id("ckbuild.multiplatform-library")
+}
+
+description = "cryptography-kotlin optimal provider"
+
+@OptIn(ExperimentalKotlinGradlePluginApi::class)
+kotlin {
+    jvmTarget()
+    jsTarget()
+    wasmJsTarget()
+    nativeTargets()
+
+    applyDefaultHierarchyTemplate {
+        common {
+            group("web") {
+                withWasmJs()
+                withJs()
+            }
+            group("native") {
+                group("nonApple") {
+                    group("mingw")
+                    group("linux")
+                    group("androidNative")
+                }
+                group("apple") {
+                    group("cryptokitSupported") {
+                        withApple()
+                        excludeCompilations {
+                            (it.target as? KotlinNativeTarget)?.konanTarget == KonanTarget.WATCHOS_ARM32
+                        }
+                    }
+                }
+            }
+        }
+    }
+
+    sourceSets {
+        commonMain.dependencies {
+            api(projects.cryptographyCore)
+        }
+        jvmMain.dependencies {
+            implementation(projects.cryptographyProviderJdk)
+        }
+        named("webMain").dependencies {
+            implementation(projects.cryptographyProviderWebcrypto)
+        }
+        appleMain.dependencies {
+            implementation(projects.cryptographyProviderApple)
+        }
+        named("cryptokitSupportedMain").dependencies {
+            implementation(projects.cryptographyProviderCryptokit)
+        }
+        named("nonAppleMain").dependencies {
+            implementation(projects.cryptographyProviderOpenssl3Prebuilt)
+        }
+    }
+}

cryptography-providers/optimal/build.gradle.kts

@@ -0,0 +1,7 @@
+/*
+ * Copyright (c) 2023-2025 Oleg Yukhnevich. Use of this source code is governed by the Apache 2.0 license.
+ */
+
+package dev.whyoleg.cryptography.providers.optimal
+
+private fun stub(): Unit = Unit

cryptography-providers/optimal/src/commonMain/kotlin/stub.kt

@@ -0,0 +1,17 @@
+/*
+ * Copyright (c) 2023-2025 Oleg Yukhnevich. Use of this source code is governed by the Apache 2.0 license.
+ */
+
+package dev.whyoleg.cryptography.providers.optimal
+
+import dev.whyoleg.cryptography.*
+import kotlin.test.*
+
+class RegisteredProvidersTest {
+    @Test
+    fun test() {
+        assertTrue(CryptographySystem.getRegisteredProviders().also {
+            println(it)
+        }.isNotEmpty())
+    }
+}

cryptography-providers/optimal/src/commonTest/kotlin/RegisteredProvidersTest.kt

@@ -62,6 +62,7 @@ projects("cryptography-kotlin") {
             module("test")
         }
         module("cryptokit")
+        module("optimal") // composite provider
     }
 
     // providers tests