Introduce binary compatibility plugin (#1774)

* Introduce binary compatibility plugin

* Update diffs

1 files changed, 218 insertions, 0 deletions

diff --git a/core/test-api/api/test-api.api b/core/test-api/api/test-api.api
new file mode 100644
index 00000000..f5f3a7ea
--- /dev/null
+++ b/core/test-api/api/test-api.api
@@ -0,0 +1,218 @@
+public final class org/jetbrains/dokka/testApi/context/MockContext : org/jetbrains/dokka/plugability/DokkaContext {
+	public fun <init> ([Lkotlin/Pair;Lorg/jetbrains/dokka/DokkaConfiguration;Ljava/util/List;)V
+	public synthetic fun <init> ([Lkotlin/Pair;Lorg/jetbrains/dokka/DokkaConfiguration;Ljava/util/List;ILkotlin/jvm/internal/DefaultConstructorMarker;)V
+	public fun get (Lorg/jetbrains/dokka/plugability/ExtensionPoint;)Ljava/util/List;
+	public fun getConfiguration ()Lorg/jetbrains/dokka/DokkaConfiguration;
+	public fun getLogger ()Lorg/jetbrains/dokka/utilities/DokkaConsoleLogger;
+	public synthetic fun getLogger ()Lorg/jetbrains/dokka/utilities/DokkaLogger;
+	public fun getUnusedPoints ()Ljava/util/Collection;
+	public fun plugin (Lkotlin/reflect/KClass;)Lorg/jetbrains/dokka/plugability/DokkaPlugin;
+	public fun single (Lorg/jetbrains/dokka/plugability/ExtensionPoint;)Ljava/lang/Object;
+}
+
+public final class org/jetbrains/dokka/testApi/logger/FilteringLogger : org/jetbrains/dokka/utilities/DokkaLogger {
+	public fun <init> (Lorg/jetbrains/dokka/testApi/logger/FilteringLogger$Level;Lorg/jetbrains/dokka/utilities/DokkaLogger;)V
+	public fun debug (Ljava/lang/String;)V
+	public fun error (Ljava/lang/String;)V
+	public fun getErrorsCount ()I
+	public fun getWarningsCount ()I
+	public fun info (Ljava/lang/String;)V
+	public fun progress (Ljava/lang/String;)V
+	public fun setErrorsCount (I)V
+	public fun setWarningsCount (I)V
+	public fun warn (Ljava/lang/String;)V
+}
+
+public final class org/jetbrains/dokka/testApi/logger/FilteringLogger$Level : java/lang/Enum {
+	public static final field Debug Lorg/jetbrains/dokka/testApi/logger/FilteringLogger$Level;
+	public static final field Error Lorg/jetbrains/dokka/testApi/logger/FilteringLogger$Level;
+	public static final field Info Lorg/jetbrains/dokka/testApi/logger/FilteringLogger$Level;
+	public static final field Progress Lorg/jetbrains/dokka/testApi/logger/FilteringLogger$Level;
+	public static final field Warn Lorg/jetbrains/dokka/testApi/logger/FilteringLogger$Level;
+	public static fun valueOf (Ljava/lang/String;)Lorg/jetbrains/dokka/testApi/logger/FilteringLogger$Level;
+	public static fun values ()[Lorg/jetbrains/dokka/testApi/logger/FilteringLogger$Level;
+}
+
+public final class org/jetbrains/dokka/testApi/logger/TestLogger : org/jetbrains/dokka/utilities/DokkaLogger {
+	public fun <init> (Lorg/jetbrains/dokka/utilities/DokkaLogger;)V
+	public fun debug (Ljava/lang/String;)V
+	public fun error (Ljava/lang/String;)V
+	public final fun getDebugMessages ()Ljava/util/List;
+	public final fun getErrorMessages ()Ljava/util/List;
+	public fun getErrorsCount ()I
+	public final fun getInfoMessages ()Ljava/util/List;
+	public final fun getProgressMessages ()Ljava/util/List;
+	public final fun getWarnMessages ()Ljava/util/List;
+	public fun getWarningsCount ()I
+	public fun info (Ljava/lang/String;)V
+	public fun progress (Ljava/lang/String;)V
+	public fun setErrorsCount (I)V
+	public fun setWarningsCount (I)V
+	public fun warn (Ljava/lang/String;)V
+}
+
+public abstract class org/jetbrains/dokka/testApi/testRunner/AbstractTest {
+	public static final field Companion Lorg/jetbrains/dokka/testApi/testRunner/AbstractTest$Companion;
+	public fun <init> (Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function4;Lorg/jetbrains/dokka/testApi/logger/TestLogger;)V
+	protected final fun dokkaConfiguration (Lkotlin/jvm/functions/Function1;)Lorg/jetbrains/dokka/DokkaConfigurationImpl;
+	protected final fun getCommonStdlibPath ()Ljava/lang/String;
+	protected final fun getDokkaTestGenerator ()Lkotlin/jvm/functions/Function4;
+	protected final fun getJsStdlibPath ()Ljava/lang/String;
+	protected final fun getJvmStdlibPath ()Ljava/lang/String;
+	protected final fun getLogger ()Lorg/jetbrains/dokka/testApi/logger/TestLogger;
+	protected final fun getStdlibExternalDocumentationLink ()Lorg/jetbrains/dokka/ExternalDocumentationLinkImpl;
+	protected final fun getTestBuilder ()Lkotlin/jvm/functions/Function0;
+	protected final fun getTestDataDir (Ljava/lang/String;)Ljava/nio/file/Path;
+	protected final fun testFromData (Lorg/jetbrains/dokka/DokkaConfigurationImpl;ZZLjava/util/List;Lkotlin/jvm/functions/Function1;)V
+	public static synthetic fun testFromData$default (Lorg/jetbrains/dokka/testApi/testRunner/AbstractTest;Lorg/jetbrains/dokka/DokkaConfigurationImpl;ZZLjava/util/List;Lkotlin/jvm/functions/Function1;ILjava/lang/Object;)V
+	protected final fun testInline (Ljava/lang/String;Lorg/jetbrains/dokka/DokkaConfigurationImpl;ZLjava/util/List;Lorg/jetbrains/dokka/utilities/DokkaLogger;Lkotlin/jvm/functions/Function1;)V
+	public static synthetic fun testInline$default (Lorg/jetbrains/dokka/testApi/testRunner/AbstractTest;Ljava/lang/String;Lorg/jetbrains/dokka/DokkaConfigurationImpl;ZLjava/util/List;Lorg/jetbrains/dokka/utilities/DokkaLogger;Lkotlin/jvm/functions/Function1;ILjava/lang/Object;)V
+}
+
+public final class org/jetbrains/dokka/testApi/testRunner/AbstractTest$Companion {
+}
+
+public class org/jetbrains/dokka/testApi/testRunner/CoreTestMethods : org/jetbrains/dokka/testApi/testRunner/TestMethods {
+	public fun <init> (Lkotlin/jvm/functions/Function1;Lkotlin/jvm/functions/Function1;Lkotlin/jvm/functions/Function1;Lkotlin/jvm/functions/Function1;Lkotlin/jvm/functions/Function1;Lkotlin/jvm/functions/Function1;Lkotlin/jvm/functions/Function1;Lkotlin/jvm/functions/Function2;)V
+	public fun getDocumentablesCreationStage ()Lkotlin/jvm/functions/Function1;
+	public fun getDocumentablesMergingStage ()Lkotlin/jvm/functions/Function1;
+	public fun getDocumentablesTransformationStage ()Lkotlin/jvm/functions/Function1;
+	public fun getPagesGenerationStage ()Lkotlin/jvm/functions/Function1;
+	public fun getPagesTransformationStage ()Lkotlin/jvm/functions/Function1;
+	public fun getPluginsSetupStage ()Lkotlin/jvm/functions/Function1;
+	public fun getRenderingStage ()Lkotlin/jvm/functions/Function2;
+	public fun getVerificationStage ()Lkotlin/jvm/functions/Function1;
+}
+
+public abstract class org/jetbrains/dokka/testApi/testRunner/DokkaTestGenerator {
+	public fun <init> (Lorg/jetbrains/dokka/DokkaConfiguration;Lorg/jetbrains/dokka/utilities/DokkaLogger;Lorg/jetbrains/dokka/testApi/testRunner/TestMethods;Ljava/util/List;)V
+	public synthetic fun <init> (Lorg/jetbrains/dokka/DokkaConfiguration;Lorg/jetbrains/dokka/utilities/DokkaLogger;Lorg/jetbrains/dokka/testApi/testRunner/TestMethods;Ljava/util/List;ILkotlin/jvm/internal/DefaultConstructorMarker;)V
+	public abstract fun generate ()V
+	protected final fun getAdditionalPlugins ()Ljava/util/List;
+	protected final fun getConfiguration ()Lorg/jetbrains/dokka/DokkaConfiguration;
+	protected final fun getLogger ()Lorg/jetbrains/dokka/utilities/DokkaLogger;
+	protected final fun getTestMethods ()Lorg/jetbrains/dokka/testApi/testRunner/TestMethods;
+}
+
+public abstract class org/jetbrains/dokka/testApi/testRunner/TestBuilder {
+	public fun <init> ()V
+	public abstract fun build ()Lorg/jetbrains/dokka/testApi/testRunner/TestMethods;
+}
+
+public abstract interface class org/jetbrains/dokka/testApi/testRunner/TestMethods {
+}
+
+public abstract interface annotation class testApi/testRunner/DokkaConfigurationDsl : java/lang/annotation/Annotation {
+}
+
+public final class testApi/testRunner/DokkaSourceSetBuilder {
+	public fun <init> (Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/util/List;Ljava/util/List;Ljava/util/Set;Ljava/util/List;Ljava/util/List;ZZZZILjava/lang/String;Ljava/lang/String;ZZLjava/util/List;Ljava/lang/String;Ljava/util/List;Ljava/util/List;Ljava/util/List;)V
+	public synthetic fun <init> (Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/util/List;Ljava/util/List;Ljava/util/Set;Ljava/util/List;Ljava/util/List;ZZZZILjava/lang/String;Ljava/lang/String;ZZLjava/util/List;Ljava/lang/String;Ljava/util/List;Ljava/util/List;Ljava/util/List;ILkotlin/jvm/internal/DefaultConstructorMarker;)V
+	public final fun build ()Lorg/jetbrains/dokka/DokkaSourceSetImpl;
+	public final fun getAnalysisPlatform ()Ljava/lang/String;
+	public final fun getApiVersion ()Ljava/lang/String;
+	public final fun getClasspath ()Ljava/util/List;
+	public final fun getDependentSourceSets ()Ljava/util/Set;
+	public final fun getDisplayName ()Ljava/lang/String;
+	public final fun getExternalDocumentationLinks ()Ljava/util/List;
+	public final fun getIncludeNonPublic ()Z
+	public final fun getIncludes ()Ljava/util/List;
+	public final fun getJdkVersion ()I
+	public final fun getLanguageVersion ()Ljava/lang/String;
+	public final fun getName ()Ljava/lang/String;
+	public final fun getNoJdkLink ()Z
+	public final fun getNoStdlibLink ()Z
+	public final fun getPerPackageOptions ()Ljava/util/List;
+	public final fun getReportUndocumented ()Z
+	public final fun getSamples ()Ljava/util/List;
+	public final fun getSkipDeprecated ()Z
+	public final fun getSkipEmptyPackages ()Z
+	public final fun getSourceLinks ()Ljava/util/List;
+	public final fun getSourceRoots ()Ljava/util/List;
+	public final fun getSuppressedFiles ()Ljava/util/List;
+	public final fun setAnalysisPlatform (Ljava/lang/String;)V
+	public final fun setApiVersion (Ljava/lang/String;)V
+	public final fun setClasspath (Ljava/util/List;)V
+	public final fun setDependentSourceSets (Ljava/util/Set;)V
+	public final fun setDisplayName (Ljava/lang/String;)V
+	public final fun setExternalDocumentationLinks (Ljava/util/List;)V
+	public final fun setIncludeNonPublic (Z)V
+	public final fun setIncludes (Ljava/util/List;)V
+	public final fun setJdkVersion (I)V
+	public final fun setLanguageVersion (Ljava/lang/String;)V
+	public final fun setName (Ljava/lang/String;)V
+	public final fun setNoJdkLink (Z)V
+	public final fun setNoStdlibLink (Z)V
+	public final fun setPerPackageOptions (Ljava/util/List;)V
+	public final fun setReportUndocumented (Z)V
+	public final fun setSamples (Ljava/util/List;)V
+	public final fun setSkipDeprecated (Z)V
+	public final fun setSkipEmptyPackages (Z)V
+	public final fun setSourceLinks (Ljava/util/List;)V
+	public final fun setSourceRoots (Ljava/util/List;)V
+	public final fun setSuppressedFiles (Ljava/util/List;)V
+}
+
+public final class testApi/testRunner/SourceSetsBuilder : java/util/ArrayList {
+	public fun <init> (Ljava/lang/String;)V
+	public final fun contains (Ljava/lang/Object;)Z
+	public fun contains (Lkotlin/Lazy;)Z
+	public final fun getModuleName ()Ljava/lang/String;
+	public fun getSize ()I
+	public final fun indexOf (Ljava/lang/Object;)I
+	public fun indexOf (Lkotlin/Lazy;)I
+	public final fun lastIndexOf (Ljava/lang/Object;)I
+	public fun lastIndexOf (Lkotlin/Lazy;)I
+	public final fun remove (I)Lkotlin/Lazy;
+	public final fun remove (Ljava/lang/Object;)Z
+	public fun remove (Lkotlin/Lazy;)Z
+	public fun removeAt (I)Lkotlin/Lazy;
+	public final fun size ()I
+	public final fun sourceSet (Lkotlin/jvm/functions/Function1;)Lkotlin/Lazy;
+}
+
+public final class testApi/testRunner/TestDokkaConfigurationBuilder {
+	public fun <init> ()V
+	public final fun build ()Lorg/jetbrains/dokka/DokkaConfigurationImpl;
+	public final fun getCacheRoot ()Ljava/lang/String;
+	public final fun getFailOnWarning ()Z
+	public final fun getFormat ()Ljava/lang/String;
+	public final fun getIncludes ()Ljava/util/List;
+	public final fun getModuleName ()Ljava/lang/String;
+	public final fun getModuleVersion ()Ljava/lang/String;
+	public final fun getModules ()Ljava/util/List;
+	public final fun getOfflineMode ()Z
+	public final fun getOutputDir ()Ljava/io/File;
+	public final fun getPluginsClasspath ()Ljava/util/List;
+	public final fun getPluginsConfigurations ()Ljava/util/List;
+	public final fun getSuppressInheritedMembers ()Z
+	public final fun getSuppressObviousFunctions ()Z
+	public final fun setCacheRoot (Ljava/lang/String;)V
+	public final fun setFailOnWarning (Z)V
+	public final fun setFormat (Ljava/lang/String;)V
+	public final fun setIncludes (Ljava/util/List;)V
+	public final fun setModuleName (Ljava/lang/String;)V
+	public final fun setModuleVersion (Ljava/lang/String;)V
+	public final fun setModules (Ljava/util/List;)V
+	public final fun setOfflineMode (Z)V
+	public final fun setOutputDir (Ljava/io/File;)V
+	public final fun setPluginsClasspath (Ljava/util/List;)V
+	public final fun setPluginsConfigurations (Ljava/util/List;)V
+	public final fun setSuppressInheritedMembers (Z)V
+	public final fun setSuppressObviousFunctions (Z)V
+	public final fun sourceSet (Lkotlin/jvm/functions/Function1;)Lkotlin/Lazy;
+	public final fun sourceSets (Lkotlin/jvm/functions/Function1;)V
+	public final fun unattachedSourceSet (Lkotlin/jvm/functions/Function1;)Lorg/jetbrains/dokka/DokkaSourceSetImpl;
+}
+
+public final class testApi/testRunner/TestDokkaConfigurationBuilderKt {
+	public static final fun dModule (Ljava/lang/String;Ljava/util/List;Ljava/util/Map;Lorg/jetbrains/dokka/DokkaConfiguration$DokkaSourceSet;Ljava/util/Set;Lorg/jetbrains/dokka/model/properties/PropertyContainer;)Lorg/jetbrains/dokka/model/DModule;
+	public static synthetic fun dModule$default (Ljava/lang/String;Ljava/util/List;Ljava/util/Map;Lorg/jetbrains/dokka/DokkaConfiguration$DokkaSourceSet;Ljava/util/Set;Lorg/jetbrains/dokka/model/properties/PropertyContainer;ILjava/lang/Object;)Lorg/jetbrains/dokka/model/DModule;
+	public static final fun dPackage (Lorg/jetbrains/dokka/links/DRI;Ljava/util/List;Ljava/util/List;Ljava/util/List;Ljava/util/List;Ljava/util/Map;Lorg/jetbrains/dokka/DokkaConfiguration$DokkaSourceSet;Ljava/util/Set;Lorg/jetbrains/dokka/model/properties/PropertyContainer;)Lorg/jetbrains/dokka/model/DPackage;
+	public static synthetic fun dPackage$default (Lorg/jetbrains/dokka/links/DRI;Ljava/util/List;Ljava/util/List;Ljava/util/List;Ljava/util/List;Ljava/util/Map;Lorg/jetbrains/dokka/DokkaConfiguration$DokkaSourceSet;Ljava/util/Set;Lorg/jetbrains/dokka/model/properties/PropertyContainer;ILjava/lang/Object;)Lorg/jetbrains/dokka/model/DPackage;
+	public static final fun documentationNode ([Ljava/lang/String;)Lorg/jetbrains/dokka/model/doc/DocumentationNode;
+	public static final fun dokkaConfiguration (Lkotlin/jvm/functions/Function1;)Lorg/jetbrains/dokka/DokkaConfigurationImpl;
+	public static final fun getDefaultSourceSet ()Lorg/jetbrains/dokka/DokkaSourceSetImpl;
+	public static final fun sourceSet (Ljava/lang/String;)Lorg/jetbrains/dokka/DokkaConfiguration$DokkaSourceSet;
+}
+