feat: add utf8 to the preferred manifest (#251)

* feat: add `utf8`

* docs: update to new format

---------

Co-authored-by: James Garbutt <43081j@users.noreply.github.com>

Author: outslept

docs/modules/README.md

@@ -21,7 +21,7 @@ ESLint plugin.
 - [`buffer-equals`](./buffer-equals.md)
 - [`builtin-modules`](./builtin-modules.md)
 - [`chalk`](./chalk.md)
-| [`core-util-is`](./core-util-is.md)
+- [`core-util-is`](./core-util-is.md)
 - [`cpx`](./cpx.md)
 - [`crypto-js`](./crypto-js.md)
 - [`deep-equal`](./deep-equal.md)
@@ -77,4 +77,5 @@ ESLint plugin.
 - [`tempy`](./tempy.md)
 - [`traverse`](./traverse.md)
 - [`uri-js`](./uri-js.md)
-- [`xmldom`](./xmldom.md)
+- [`utf8`](./utf8.md)
+- [`xmldom`](./xmldom.md)

docs/modules/utf8.md

@@ -0,0 +1,31 @@
+---
+description: Modern alternatives to the utf8 package for UTF-8 encoding and decoding
+---
+
+# Replacements for `utf8`
+
+Modern Node and browsers provide native UTF-8 APIs, so this dependency is rarely needed.
+
+## TextEncoder/TextDecoder (built-in)
+
+The built-in [`TextEncoder`](https://developer.mozilla.org/en-US/docs/Web/API/TextEncoder) and [`TextDecoder`](https://developer.mozilla.org/en-US/docs/Web/API/TextDecoder) APIs provide a native way to handle UTF-8 encoding and decoding.
+
+```ts
+const text = "€";
+const encoder = new TextEncoder();
+const utf8Bytes = encoder.encode(text); // Uint8Array of UTF-8 bytes
+
+// and to decode:
+
+const decoder = new TextDecoder('utf-8', { fatal: true });
+const decodedText = decoder.decode(utf8Bytes); // "€"
+```
+
+## Buffer (Node.js)
+
+Node's built-in [`Buffer`](https://nodejs.org/api/buffer.html) provides both `Buffer.from(str, 'utf8')` and `buf.toString('utf8')` methods for UTF-8 encoding and decoding.
+
+```ts
+const text = "€";
+const utf8Buffer = Buffer.from(text, 'utf8'); // Buffer of UTF-8 bytes
+```

manifests/preferred.json

@@ -2376,6 +2376,12 @@
       "docPath": "uri-js",
       "category": "preferred"
     },
+    {
+      "type": "documented",
+      "moduleName": "utf8",
+      "docPath": "utf8",
+      "category": "preferred"
+    },
     {
       "type": "documented",
       "moduleName": "xmldom",