add test for KMP project custom shared WasmJS/WasmWASI source set

This recreates the issue reported in #4116

Author: adam-enko

dokka-runners/dokka-gradle-plugin/src/testFixtures/kotlin/kotestFiles.kt

@@ -6,6 +6,12 @@ package org.jetbrains.dokka.gradle.utils
 import com.github.difflib.DiffUtils
 import com.github.difflib.UnifiedDiffUtils
 import io.kotest.assertions.fail
+import io.kotest.matchers.MatcherResult
+import io.kotest.matchers.neverNullMatcher
+import io.kotest.matchers.paths.shouldBeAFile
+import io.kotest.matchers.paths.shouldExist
+import io.kotest.matchers.should
+import io.kotest.matchers.shouldNot
 import java.io.IOException
 import java.io.OutputStream
 import java.nio.file.Path
@@ -178,3 +184,44 @@ class NullOutputStream : OutputStream() {
         // do nothing
     }
 }
+
+
+/**
+ * Assert the given [Path] does not contain the given [text].
+ */
+fun Path.shouldContainText(
+    text: String,
+    ignoreCase: Boolean = false,
+) {
+    this.shouldExist()
+    this.shouldBeAFile()
+    this should containText(text, ignoreCase)
+}
+
+/**
+ * Assert the given [Path] does not contain the given [text].
+ */
+fun Path.shouldNotContainText(
+    text: String,
+    ignoreCase: Boolean = false,
+) {
+    this.shouldExist()
+    this.shouldBeAFile()
+    this shouldNot containText(text, ignoreCase)
+}
+
+private fun containText(
+    text: String,
+    ignoreCase: Boolean = false,
+) =
+    neverNullMatcher<Path> { value ->
+        MatcherResult(
+            value.useLines { lines ->
+                lines.any { line ->
+                    line.contains(text, ignoreCase = ignoreCase)
+                }
+            },
+            { "$value should include '$text'" + if (ignoreCase) " (ignoring case)" else "" },
+            { "$value should not include '$text'" + if (ignoreCase) " (ignoring case)" else "" },
+        )
+    }

dokka-runners/dokka-gradle-plugin/src/testFunctional/kotlin/KmpSharedWasmTest.kt

@@ -3,19 +3,20 @@
  */
 package org.jetbrains.dokka.gradle
 
-import io.kotest.assertions.withClue
 import io.kotest.core.spec.style.FunSpec
 import io.kotest.inspectors.shouldForAll
 import io.kotest.inspectors.shouldForNone
 import io.kotest.matchers.paths.shouldBeAFile
 import io.kotest.matchers.sequences.shouldNotBeEmpty
 import io.kotest.matchers.string.shouldContain
-import io.kotest.matchers.string.shouldNotContainIgnoringCase
 import org.jetbrains.dokka.gradle.internal.DokkaConstants
 import org.jetbrains.dokka.gradle.utils.*
-import kotlin.io.path.name
-import kotlin.io.path.useLines
+import kotlin.io.path.*
 
+/**
+ * Small reproducer for issue reported by kotlinx-io
+ * https://github.com/Kotlin/dokka/issues/4116
+ */
 class KmpSharedWasmTest : FunSpec({
     context("given a KMP project with a custom shared Wasm source set") {
         val project = initKmpSharedWasmProject()
@@ -33,22 +34,17 @@ class KmpSharedWasmTest : FunSpec({
                 }
 
                 test("expect no 'unknown class' message in HTML files") {
-                    val htmlFiles = project.projectDir.toFile()
+                    val htmlFiles = project.projectDir
                         .resolve("build/dokka/html")
                         .walk()
-                        .filter { it.isFile && it.extension == "html" }
+                        .filter { it.isRegularFile() && it.extension == "html" }
 
                     htmlFiles.shouldNotBeEmpty()
 
                     htmlFiles.forEach { htmlFile ->
-                        val relativePath = htmlFile.relativeTo(project.projectDir.toFile())
-                        htmlFile.useLines { lines ->
-                            withClue("$relativePath should not contain Error class: unknown class") {
-                                lines.shouldForAll { line -> line.shouldNotContainIgnoringCase("Error class: unknown class") }
-                            }
-                            withClue("$relativePath should not contain ERROR CLASS: Symbol not found") {
-                                lines.shouldForAll { line -> line.shouldNotContainIgnoringCase("ERROR CLASS: Symbol not found") }
-                            }
+                        htmlFile.relativeTo(project.projectDir).apply {
+                            shouldNotContainText("Error class: unknown class")
+                            shouldNotContainText("ERROR CLASS: Symbol not found")
                         }
                     }
                 }
@@ -79,19 +75,17 @@ private fun initKmpSharedWasmProject(
             """.trimMargin()
 
         buildGradleKts = """
-            |import org.jetbrains.kotlin.gradle.*
-            |
             |plugins {
             |  kotlin("multiplatform") version embeddedKotlinVersion
             |  id("org.jetbrains.dokka") version "${DokkaConstants.DOKKA_VERSION}"
             |}
             |
-            |@OptIn(ExperimentalWasmDsl::class)
+            |@OptIn(org.jetbrains.kotlin.gradle.ExperimentalWasmDsl::class)
             |kotlin {
             |  wasmJs { browser() }
             |  wasmWasi { nodejs() }
             |
-            |  @OptIn(ExperimentalKotlinGradlePluginApi::class)
+            |  @OptIn(org.jetbrains.kotlin.gradle.ExperimentalKotlinGradlePluginApi::class)
             |  applyDefaultHierarchyTemplate {
             |    common {
             |      group("wasm") {