chore(ci/api):

 - add compose core api
 - refactoring for .teamcity packages

Author: zoobestik

.teamcity/.gitignore

@@ -0,0 +1 @@
+/target

.teamcity/BuildParams.kt

@@ -1,3 +1,5 @@
+import references.builds.compose.ComposeMultiplatformCore
+
 object BuildParams {
   const val DOKKA_TEMPLATES_VERSION = "2.0.0"
 
@@ -36,6 +38,10 @@ object BuildParams {
   const val KOTLINX_METADATA_RELEASE_TAG = KOTLIN_RELEASE_TAG
   const val KOTLINX_METADATA_TITLE = KOTLINX_METADATA_ID
 
+  val API_COMPOSE = ComposeMultiplatformCore {
+    addVersion("1.8.0", "api-reference/1.8")
+  }
+
   const val SEARCH_APP_ID = "7961PKYRXV"
   const val SEARCH_INDEX_NAME = "prod_KOTLINLANG_WEBHELP"
 
@@ -47,5 +53,6 @@ object BuildParams {
     "api/$KOTLINX_IO_ID",
     "api/$KGP_ID",
     "api/$KOTLINX_METADATA_ID",
+    "api/${API_COMPOSE.urlPart}",
   )
 }

.teamcity/builds/apiReferences/BuildApiReferencesProject.kt

@@ -0,0 +1,106 @@
+package common
+
+import common.extensions.scriptGenerateSitemap
+import common.extensions.scriptNoRobots
+import jetbrains.buildServer.configs.kotlin.BuildType
+import jetbrains.buildServer.configs.kotlin.Project
+import jetbrains.buildServer.configs.kotlin.RelativeId
+import templates.SCRIPT_PATH
+import vcsRoots.KotlinLangOrg
+
+private fun String.camelCase(delim: String = "-", join: String = "") =
+    this.split(delim).joinToString(join) { it.replaceFirstChar { char -> char.uppercase() } }
+
+typealias ProjectReferenceBuilder = () -> BuildType
+
+open class ReferenceProject(val urlPart: String, val projectTitle: String = urlPart) {
+    init {
+        if (urlPart.isBlank()) throw IllegalArgumentException("urlPart cannot be blank")
+    }
+
+    val projectName = projectTitle.camelCase(join = " ")
+
+    val projectPrefix = urlPart.camelCase()
+    val project = Project {
+        id = RelativeId(projectPrefix)
+        name = projectName
+        description = "Project for https://kotlinlang.org/api/$urlPart/"
+
+        params {
+            param("env.ALGOLIA_INDEX_NAME", urlPart)
+            param("env.API_REFERENCE_NAME", projectTitle)
+        }
+    }
+
+    protected val versions = mutableListOf<Pair<BuildType, String>>()
+
+    fun getCurrentVersion(): Pair<BuildType, String>? = this.versions.lastOrNull()
+
+    fun addReference(version: String, buildReference: ProjectReferenceBuilder) {
+        versions.add(buildReference() to version)
+    }
+
+    fun build() {
+        val (currentVersion) = getCurrentVersion()
+            ?: throw IllegalStateException("Current version is not set for $projectName")
+
+        val workingDir = "dist/api/$urlPart"
+
+        val pages = BuildType {
+            id = RelativeId("${projectPrefix}_Latest")
+            name = "API Pages"
+            description = "The latest stable version for $projectName"
+
+            artifactRules = "$workingDir/** => pages.zip"
+
+            vcs {
+                root(KotlinLangOrg, "${SCRIPT_PATH}/")
+            }
+
+            steps {
+                scriptNoRobots(workingDir)
+                scriptGenerateSitemap(workingDir)
+            }
+
+            dependencies {
+                dependency(currentVersion) {
+                    snapshot {}
+                    artifacts {
+                        artifactRules = "pages.zip!** => $workingDir"
+                        cleanDestination = true
+                    }
+                }
+            }
+        }
+
+        project.apply {
+            buildType(pages)
+            buildType {
+                id = RelativeId("${projectPrefix}_Search")
+                name = "API Search Index"
+                description = "Build search index for $projectName"
+
+                dependencies {
+                    dependency(pages) {
+                        snapshot {}
+                        artifacts {
+                            artifactRules = "pages.zip!** => $workingDir"
+                            cleanDestination = true
+                        }
+                    }
+                }
+            }
+        }
+
+        currentVersion.dependencies {
+            for ((previousVersion, version) in versions) {
+                if (previousVersion == currentVersion) continue
+                artifacts(previousVersion) {
+                    buildRule = tag("release")
+                    artifactRules = "pages.zip!** => %OLD_VERSIONS_DIR%/$version/"
+                    cleanDestination = true
+                }
+            }
+        }
+    }
+}

.teamcity/builds/kotlinlang/SiteProject.kt

@@ -0,0 +1,6 @@
+package common.extensions
+
+object VCS {
+    fun tag(name: String) = "refs/tags/$name"
+    fun branch(name: String) = "refs/heads/$name"
+}