Add javadoc and publication

buildSrc/src/main/kotlin/publish-conventions.gradle.kts

@@ -1,3 +1,5 @@
+import org.gradle.jvm.tasks.Jar
+
 plugins {
     `maven-publish`
     signing
@@ -12,6 +14,12 @@ if (!release) {
 
 publishing {
     publications.withType<MavenPublication> {
+
+        // Empty javadoc
+        artifact(tasks.findByName("javadocJar") ?: task<Jar>("javadocJar") {
+            archiveClassifier.set("javadoc")
+        })
+
         pom {
             name.set("${project.group}:${project.name}")
             description.set("Compile-time dependency injection for Kotlin Multiplatform")

kinzhal-annotations/src/commonMain/kotlin/com/daugeldauge/kinzhal/annotations/Annotations.kt

@@ -1,15 +1,38 @@
+@file:Suppress("KDocUnresolvedReference")
+
 package com.daugeldauge.kinzhal.annotations
 
 import kotlin.reflect.KClass
 
+/**
+ * Annotates an interface for which dependency-injected implementation
+ * is to be generated from a set of [modules]. The generated class will
+ * have the name of the type annotated with [Component] prepended with
+ * Kinzhal. For example, `@Component interface AppComponent` will
+ * produce an implementation named KinzhalAppComponent. All [dependencies]
+ * will be primary constructor parameters of generated class.
+ */
 @Retention(AnnotationRetention.SOURCE)
+@Target(AnnotationTarget.CLASS)
 annotation class Component(val modules: Array<KClass<*>> = [], val dependencies: Array<KClass<*>> = [])
 
+/**
+ * Equivalent of [javax.inject.Inject]. Only a constructor injection is supported for now
+ */
 @Retention(AnnotationRetention.SOURCE)
+@Target(AnnotationTarget.CONSTRUCTOR)
 annotation class Inject
 
+/**
+ * Equivalent of [javax.inject.Scope]
+ */
 @Retention(AnnotationRetention.SOURCE)
+@Target(AnnotationTarget.ANNOTATION_CLASS)
 annotation class Scope
 
+/**
+ * Equivalent of [javax.inject.Qualifier]
+ */
 @Retention(AnnotationRetention.SOURCE)
+@Target(AnnotationTarget.ANNOTATION_CLASS)
 annotation class Qualifier

kinzhal-processor/src/jvmMain/kotlin/com/daugeldauge/kinzhal/processor/KinzhalSymbolProcessor.kt

@@ -19,7 +19,7 @@ import java.lang.IllegalStateException
 // TODO scope validation
 // TODO fix possible conflicts in component provider names
 
-class KinzhalSymbolProcessor(private val codeGenerator: CodeGenerator, private val logger: KSPLogger) : SymbolProcessor {
+internal class KinzhalSymbolProcessor(private val codeGenerator: CodeGenerator, private val logger: KSPLogger) : SymbolProcessor {
 
     override fun process(resolver: Resolver): List<KSAnnotated> {
 
@@ -177,6 +177,9 @@ class KinzhalSymbolProcessor(private val codeGenerator: CodeGenerator, private v
     }
 }
 
+/**
+ * Main entry point to Kinzhal processor
+ */
 class KinzhalSymbolProcessorProvider : SymbolProcessorProvider {
     override fun create(environment: SymbolProcessorEnvironment): SymbolProcessor {
         return KinzhalSymbolProcessor(environment.codeGenerator, environment.logger)