grapheme: rename countGrapheme() to countGraphemes()

Author: cometkim

.changeset/early-cats-exercise.md

@@ -0,0 +1,5 @@
+---
+"unicode-segmenter": patch
+---
+
+grapheme: rename `countGrapheme()` to `countGraphemes()`. existing name is deprecated alias.

README.md

@@ -74,21 +74,21 @@ import { splitGraphemes } from 'unicode-segmenter/grapheme';
 #### Example: Count graphemes
 
 ```js
-import { countGrapheme } from 'unicode-segmenter/grapheme';
+import { countGraphemes } from 'unicode-segmenter/grapheme';
 
 '👋 안녕!'.length;
 // => 6
-countGrapheme('👋 안녕!');
+countGraphemes('👋 안녕!');
 // => 5
 
 'a̐éö̲'.length;
 // => 7
-countGrapheme('a̐éö̲');
+countGraphemes('a̐éö̲');
 // => 3
 ```
 
 > [!NOTE]
-> `countGrapheme()` is a small wrapper around `graphemeSegments()`.
+> `countGraphemes()` is a small wrapper around `graphemeSegments()`.
 > 
 > If you need it more than once at a time, consider memoization or use `graphemeSegments()` or `splitSegments()` once instead.
 

src/grapheme.js

@@ -189,12 +189,19 @@ export function* graphemeSegments(input) {
  * @param {string} str
  * @return number count of graphemes
  */
-export function countGrapheme(str) {
+export function countGraphemes(str) {
   let count = 0;
   for (let _ of graphemeSegments(str)) count += 1;
   return count;
 }
 
+export {
+  /**
+   * @deprecated use {@link countGraphemes}
+   */
+  countGraphemes as countGrapheme,
+};
+
 /**
  * @param {string} str
  * @return {IterableIterator<string>}

test/grapheme.js

@@ -7,7 +7,7 @@ import fc from 'fast-check';
 import {
   GraphemeCategory,
   graphemeSegments,
-  countGrapheme,
+  countGraphemes,
   splitGraphemes,
 } from 'unicode-segmenter/grapheme';
 import { assertObjectContaining } from './_helper.js';
@@ -74,34 +74,34 @@ test('graphemeSegments', async t => {
   });
 });
 
-test('countGrapheme', async t => {
+test('countGraphemes', async t => {
   await t.test('latin', () => {
-    assert.equal(countGrapheme('abcd'), 4);
+    assert.equal(countGraphemes('abcd'), 4);
   });
 
   await t.test('flags', () => {
-    assert.equal(countGrapheme('🇷🇸🇮🇴'), 2);
+    assert.equal(countGraphemes('🇷🇸🇮🇴'), 2);
   });
 
   await t.test('emoji', () => {
-    assert.equal(countGrapheme('👻👩‍👩‍👦‍👦'), 2);
-    assert.equal(countGrapheme('🌷🎁💩😜👍🏳️‍🌈'), 6);
+    assert.equal(countGraphemes('👻👩‍👩‍👦‍👦'), 2);
+    assert.equal(countGraphemes('🌷🎁💩😜👍🏳️‍🌈'), 6);
   });
 
   await t.test('diacritics as combining marks', () => {
-    assert.equal(countGrapheme('Ĺo͂řȩm̅'), 5);
+    assert.equal(countGraphemes('Ĺo͂řȩm̅'), 5);
   });
 
   await t.test('Jamo', () => {
-    assert.equal(countGrapheme('뎌쉐'), 2);
+    assert.equal(countGraphemes('뎌쉐'), 2);
   });
 
   await t.test('Hindi', () => {
-    assert.equal(countGrapheme('अनुच्छेद'), 4);
+    assert.equal(countGraphemes('अनुच्छेद'), 4);
   });
 
   await t.test('demonic', () => {
-    assert.equal(countGrapheme('Z͑ͫ̓ͪ̂ͫ̽͏̴̙̤̞͉͚̯̞̠͍A̴̵̜̰͔ͫ͗͢L̠ͨͧͩ͘G̴̻͈͍͔̹̑͗̎̅͛́Ǫ̵̹̻̝̳͂̌̌͘!͖̬̰̙̗̿̋ͥͥ̂ͣ̐́́͜͞'), 6);
+    assert.equal(countGraphemes('Z͑ͫ̓ͪ̂ͫ̽͏̴̙̤̞͉͚̯̞̠͍A̴̵̜̰͔ͫ͗͢L̠ͨͧͩ͘G̴̻͈͍͔̹̑͗̎̅͛́Ǫ̵̹̻̝̳͂̌̌͘!͖̬̰̙̗̿̋ͥͥ̂ͣ̐́́͜͞'), 6);
   });
 });