refactor: Add TextUtil.pluralize (#2539)

We have 2 copies of `pluralize` in Enterprise and plugins. Adding it to
`TextUtil` so it can be reused.

Author: vbabich

packages/utils/src/TextUtils.test.ts

@@ -85,3 +85,15 @@ describe('sort text', () => {
     expect(TextUtils.sort('A', 'A', false)).toBe(0);
   });
 });
+
+describe('pluralize', () => {
+  it('handles singular', () => {
+    expect(TextUtils.pluralize(1, 'item')).toBe('item');
+    expect(TextUtils.pluralize(1, 'item', 'pluralized')).toBe('item');
+  });
+
+  it('handles plural', () => {
+    expect(TextUtils.pluralize(2, 'item')).toBe('items');
+    expect(TextUtils.pluralize(2, 'item', 'pluralized')).toBe('pluralized');
+  });
+});

packages/utils/src/TextUtils.ts

@@ -60,6 +60,24 @@ export class TextUtils {
     }
     return 0;
   }
+
+  /**
+   * Pluralize a string based on a value
+   * @param value The value to use for pluralization
+   * @param singular The singular form of the string
+   * @param pluralized The pluralized form of the string. If not provided, will append 's' to the singular form.
+   * @returns The pluralized string
+   */
+  static pluralize(
+    value: number,
+    singular: string,
+    pluralized?: string
+  ): string {
+    if (value === 1) {
+      return singular;
+    }
+    return pluralized ?? `${singular}s`;
+  }
 }
 
 export default TextUtils;