feat: add grapheme-splitter and grapheme alternatives (#178)

docs/modules/README.md

@@ -33,6 +33,7 @@ ESLint plugin.
 - [`fs-extra`](./fs-extra.md)
 - [`glob`](./glob.md)
 - [`globby`](./glob.md)
+- [`grapheme`](./grapheme.md)
 - [`ìnvariant`](./invariant.md)
 - [`is-builtin-module`](./is-builtin-module.md)
 - [`jQuery`](./jquery.md)

docs/modules/grapheme.md

@@ -0,0 +1,40 @@
+# Grapheme cluster splitting
+
+[`grapheme-splitter`](https://github.com/orling/grapheme-splitter) and [`graphemer`](https://github.com/flmnt/graphemer) are no longer maintained, and can often be replaced with platform-provided APIs.
+
+Or you can find much lighter, actively maintained alternative.
+
+## Alternatives
+
+### Intl API
+
+[`Intl.Segmenter`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/Segmenter) is provided by following modern JavaScript runtimes
+
+- Node.js v16 / Bun / Deno
+- Chrome v87
+- Safari v14.1
+- Firefox v132
+
+```js
+const segmenter = new Intl.Segmenter();
+
+const segments = [...segmenter.segment(text)];
+```
+
+### unicode-segmenter
+
+[`unicode-segmenter`](https://github.com/cometkim/unicode-segmenter) is a lighter and faster alternative that implement Unicode text segmentation standard with zero dependencies.
+
+```js
+import { graphemeSegments } from 'unicode-segmenter/grapheme';
+
+const segments = [...graphemeSegments(text)];
+```
+
+The API is almost same with the `Intl.Segmenter`, so you can also use it as polyfill.
+
+```js
+import { Segmenter } from 'unicode-segmenter/intl-adapter';
+// or
+import 'unicode-segmenter/intl-polyfill';
+```

manifests/preferred.json

@@ -138,6 +138,18 @@
       "docPath": "glob",
       "category": "preferred"
     },
+    {
+      "type": "documented",
+      "moduleName": "grapheme-splitter",
+      "docPath": "grapheme",
+      "category": "preferred"
+    },
+    {
+      "type": "documented",
+      "moduleName": "graphemer",
+      "docPath": "grapheme",
+      "category": "preferred"
+    },
     {
       "type": "documented",
       "moduleName": "invariant",