Improve copying base-frontend files between subprojects (#2970)

1 files changed, 31 insertions, 0 deletions

diff --git a/build-logic/src/main/kotlin/org/jetbrains/conventions/dokka-html-frontend-files.gradle.kts b/build-logic/src/main/kotlin/org/jetbrains/conventions/dokka-html-frontend-files.gradle.kts
new file mode 100644
index 00000000..4ccbef26
--- /dev/null
+++ b/build-logic/src/main/kotlin/org/jetbrains/conventions/dokka-html-frontend-files.gradle.kts
@@ -0,0 +1,31 @@
+package org.jetbrains.conventions
+
+import org.gradle.api.attributes.Usage.USAGE_ATTRIBUTE
+
+/**
+ * Utility for sharing the Dokka HTML frontend files between subprojects in a safe, cacheable way.
+ */
+
+plugins {
+    id("org.jetbrains.conventions.base")
+}
+
+/** Apply a distinct attribute to the incoming/outgoing configuration */
+fun AttributeContainer.dokkaHtmlFrontendFilesAttribute() =
+    attribute(USAGE_ATTRIBUTE, objects.named("org.jetbrains.dokka.html-frontend-files"))
+
+// incoming configuration
+val dokkaHtmlFrontendFiles by configurations.registering {
+    description = "Retrieve Dokka HTML frontend files from other subprojects"
+    isCanBeConsumed = false
+    isCanBeResolved = true
+    attributes { dokkaHtmlFrontendFilesAttribute() }
+}
+
+// outgoing configuration
+val dokkaHtmlFrontendFilesElements by configurations.registering {
+    description = "Provide Dokka HTML frontend files to other subprojects"
+    isCanBeConsumed = true
+    isCanBeResolved = false
+    attributes { dokkaHtmlFrontendFilesAttribute() }
+}