From 9304ef09f91a8ebb51bef3cb9684e02b627ff592 Mon Sep 17 00:00:00 2001
From: outslept <135520429+outslept@users.noreply.github.com>
Date: Sat, 30 Aug 2025 13:54:15 +0300
Subject: [PATCH] docs: add Bun YAML API as an alternative to js-yaml

---
 docs/modules/js-yaml.md | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/docs/modules/js-yaml.md b/docs/modules/js-yaml.md
index 96bd7094..db0c9995 100644
--- a/docs/modules/js-yaml.md
+++ b/docs/modules/js-yaml.md
@@ -11,3 +11,18 @@
 [Project Page](https://eemeli.org/yaml/)
 
 [npm](https://www.npmjs.com/package/yaml)
+
+### Bun API
+
+[Since Bun v1.2.21, YAML parsing is built in](https://bun.com/blog/release-notes/bun-v1.2.21#native-yaml-support) via the `YAML` namespace:
+
+```js
+import { YAML } from "bun";
+
+console.log(YAML.parse("123"));        // 123
+console.log(YAML.parse("null"));       // null
+console.log(YAML.parse("false"));      // false
+console.log(YAML.parse("abc"));        // "abc"
+console.log(YAML.parse("- abc"));      // [ "abc" ]
+console.log(YAML.parse("abc: def"));   // { "abc": "def" }
+```