Add wrappers for yaml

README.md

@@ -62,6 +62,7 @@ To learn more please refer to the [API Reference](https://jetbrains.github.io/ko
 | `kotlin-vercel-ncc`                          | [API](https://jetbrains.github.io/kotlin-wrappers/kotlin-vercel-ncc)                    | [README](kotlin-vercel-ncc/README.md)                    |                                  | [![Maven Central](https://img.shields.io/maven-central/v/org.jetbrains.kotlin-wrappers/kotlin-vercel-ncc)](https://mvnrepository.com/artifact/org.jetbrains.kotlin-wrappers/kotlin-vercel-ncc/)                                       |
 | `kotlin-web`                                 | [API](https://jetbrains.github.io/kotlin-wrappers/kotlin-web)                           | [README](kotlin-web/README.md)                           |                                  | [![Maven Central](https://img.shields.io/maven-central/v/org.jetbrains.kotlin-wrappers/kotlin-web)](https://mvnrepository.com/artifact/org.jetbrains.kotlin-wrappers/kotlin-web/)                                                     |
 | `kotlin-wrappers-bom`                        | [API](https://jetbrains.github.io/kotlin-wrappers/kotlin-wrappers-bom)                  | [README](kotlin-wrappers-bom/README.md)                  |                                  | [![Maven Central](https://img.shields.io/maven-central/v/org.jetbrains.kotlin-wrappers/kotlin-wrappers-bom)](https://mvnrepository.com/artifact/org.jetbrains.kotlin-wrappers/kotlin-wrappers-bom/)                                   |
+| `kotlin-yaml`                                | [API](https://jetbrains.github.io/kotlin-wrappers/kotlin-yaml)                          | [README](kotlin-yaml/README.md)                          |                                  | [![Maven Central](https://img.shields.io/maven-central/v/org.jetbrains.kotlin-wrappers/kotlin-yaml)](https://mvnrepository.com/artifact/org.jetbrains.kotlin-wrappers/kotlin-yaml/)                                                   |
 
 Artifacts are published to Maven Central, see the corresponding README files for package coordinates.
 

gradle.properties

@@ -173,3 +173,6 @@ inline-style-prefixer.npm.version=^7.0.1
 
 # https://www.npmjs.com/package/puppeteer
 puppeteer.npm.version=^24.1.0
+
+# https://www.npmjs.com/package/yaml
+yaml.npm.version=^2.7.0

kotlin-yaml/README.md

@@ -0,0 +1,5 @@
+[![Maven Central](https://img.shields.io/maven-central/v/org.jetbrains.kotlin-wrappers/kotlin-yaml)](https://mvnrepository.com/artifact/org.jetbrains.kotlin-wrappers/kotlin-yaml)
+
+# Module kotlin-yaml
+
+Kotlin wrapper for the [YAML](https://eemeli.org/yaml/) library.

kotlin-yaml/build.gradle.kts

@@ -0,0 +1,7 @@
+plugins {
+    `kotlin-library-conventions`
+}
+
+dependencies {
+    jsMainApi(npm(libs.npm.yaml))
+}

kotlin-yaml/gradle.properties

@@ -0,0 +1,2 @@
+description=Kotlin wrapper for YAML
+js.platform=web

kotlin-yaml/src/jsMain/kotlin/yaml/parse.kt

@@ -0,0 +1,19 @@
+package yaml
+
+@JsModule("yaml")
+external object YAML {
+    /**
+     * Parse an input string into JavaScript.
+     *
+     * Only supports input consisting of a single YAML document; for multi-document
+     * support you should use `YAML.parseAllDocuments`. May throw on error, and may
+     * log warnings using `console.warn`.
+     *
+     * @param str - A string with YAML formatting.
+     * @param reviver - A reviver function, as in `JSON.parse()`
+     * @returns The value will match the type of the root value of the parsed YAML
+     *   document, so Maps become objects, Sequences arrays, and scalars result in
+     *   nulls, booleans, numbers and strings.
+     */
+    fun <T> parse(src: String): T
+}

settings.gradle.kts

@@ -203,3 +203,6 @@ include("kotlin-web")
 include("kotlin-wrappers-bom")
 
 include("kotlin-wrappers-catalog")
+
+// Kotlin/JS: yaml wrappers
+include("kotlin-yaml")