package org.jetbrains.dokka.base.signatures import org.jetbrains.dokka.base.transformers.pages.annotations.SinceKotlinTransformer import org.jetbrains.dokka.base.translators.documentables.PageContentBuilder import org.jetbrains.dokka.links.DRI import org.jetbrains.dokka.links.DriOfAny import org.jetbrains.dokka.links.DriOfUnit import org.jetbrains.dokka.model.* import org.jetbrains.dokka.model.AnnotationTarget import org.jetbrains.dokka.model.properties.WithExtraProperties import org.jetbrains.dokka.pages.ContentKind object KotlinSignatureUtils : JvmSignatureUtils { private const val classExtension = "::class" private val strategy = OnlyOnce private val listBrackets = Pair('[', ']') private val ignoredAnnotations = setOf( /** * Rendered separately, see [SinceKotlinTransformer] */ Annotations.Annotation(DRI("kotlin", "SinceKotlin"), emptyMap()), /** * Rendered separately as its own block, see usage of [ContentKind.Deprecation] */ Annotations.Annotation(DRI("kotlin", "Deprecated"), emptyMap()), Annotations.Annotation(DRI("kotlin", "DeprecatedSinceKotlin"), emptyMap()), Annotations.Annotation(DRI("java.lang", "Deprecated"), emptyMap()), // could be used as well for interop ) override fun PageContentBuilder.DocumentableContentBuilder.annotationsBlock(d: AnnotationTarget) = annotationsBlockWithIgnored(d, ignoredAnnotations, strategy, listBrackets, classExtension) override fun PageContentBuilder.DocumentableContentBuilder.annotationsInline(d: AnnotationTarget) = annotationsInlineWithIgnored(d, ignoredAnnotations, strategy, listBrackets, classExtension) override fun WithExtraProperties.modifiers() = extra[AdditionalModifiers]?.content?.entries?.associate { it.key to it.value.filterIsInstance().toSet() } ?: emptyMap() val PrimitiveJavaType.dri: DRI get() = DRI("kotlin", name.capitalize()) val Bound.driOrNull: DRI? get() { return when (this) { is TypeParameter -> dri is TypeConstructor -> dri is Nullable -> inner.driOrNull is DefinitelyNonNullable -> inner.driOrNull is PrimitiveJavaType -> dri is Void -> DriOfUnit is JavaObject -> DriOfAny is Dynamic -> null is UnresolvedBound -> null is TypeAliased -> typeAlias.driOrNull } } val Projection.drisOfAllNestedBounds: List get() = when (this) { is TypeParameter -> listOf(dri) is TypeConstructor -> listOf(dri) + projections.flatMap { it.drisOfAllNestedBounds } is Nullable -> inner.drisOfAllNestedBounds is DefinitelyNonNullable -> inner.drisOfAllNestedBounds is PrimitiveJavaType -> listOf(dri) is Void -> listOf(DriOfUnit) is JavaObject -> listOf(DriOfAny) is Dynamic -> emptyList() is UnresolvedBound -> emptyList() is Variance<*> -> inner.drisOfAllNestedBounds is Star -> emptyList() is TypeAliased -> listOfNotNull(typeAlias.driOrNull, inner.driOrNull) } }