stringzy 2.1.0 → 2.2.0

package/README.md

@@ -1,4 +1,9 @@
-# stringzy
+
+<div align="center">
+  
+  
+  ![Stringzy banner](./assets/stringzy-banner2.jpg)
+
 
 ![NPM Version](https://img.shields.io/npm/v/stringzy)
 ![Downloads](https://img.shields.io/npm/dt/stringzy)
@@ -11,6 +16,10 @@
 
 [Checkout our Contributors!](#contri)
 
+
+</div>
+
+
 ## ✨ Features
 
 - 💪 **Powerful** - Transform, validate, analyze, and format strings with minimal code
@@ -59,6 +68,8 @@ const count = stringzy.analyze.wordCount('Hello world'); // 2
 - [capitalizeWords](#capitalizewords) - Capitalizes the first letter of each word
 - [removeSpecialChars](#removespecialchars) - Removes special characters from a string
 - [removeWords](#removewords) - Removes specified words from a string
+- [removeDuplicates](#removeduplicates) - Removes specified words from a string
+- [initials](#initials) - Extracts initials from a text string
 - [camelCase](#camelcase) - Converts the given string to Camel Case
 - [pascaslCase](#pascalcase) - Converts the given string to Pascal Case
 - [snakeCase](#snakecase) - Converts the given string to Snake Case   
@@ -197,6 +208,55 @@ removeWords('JavaScript is awesome and JavaScript rocks', ['JavaScript']);
 | text | string | required | The input string to process |
 | wordsToRemove | string[] | required | Array of words to remove from the string |
 
+#### <a id="removeduplicates"></a>`removeDuplicates(text)`
+
+Removes duplicate case-sensitive words from a given text. 
+
+```javascript
+import { removeDuplicates } from 'stringzy';
+
+removeDuplicates('Hello world this is a is a test');
+// Returns: 'Hello world this is a test'
+
+removeDuplicates('Remove me me me me or Me');
+// Returns: 'Remove me or Me'' 
+
+removeDuplicates('JavaScript is not bad and not awesome');
+// Returns: 'JavaScript is not bad and awesome'
+```
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| text | string | required | The input string to process |
+
+#### <a id="initials"></a>`initials(text, limit)`
+
+Extracts initials from a text string.
+
+```javascript
+import { initials } from 'stringzy';
+
+initials('John Doe');
+// Returns: 'JD'
+
+initials('Alice Bob Charlie', 2);
+// Returns: 'AB'
+
+initials('Hello World Test Case');
+// Returns: 'HWTC'
+
+initials('single');
+// Returns: 's'
+
+initials('  Multiple   Spaces   Between  ');
+// Returns: 'MSB'
+```
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| text | string | required | The input string to extract initials from |
+| limit | number | undefined | Maximum number of initials to return (optional) |
+
 #### <a id="camelcase"></a>`camelCase(text)`
 
 Converts the given string to Camel Case.
@@ -622,6 +682,26 @@ Contributions are welcome! Please feel free to submit a Pull Request.
                     </sub>
                 </a>
             </td>
+          <td align="center">
+                <a href="https://github.com/ahmedsemih">
+                    <img src="https://avatars.githubusercontent.com/ahmedsemih" width="100px;"
+                        alt="Ahmed Semih Erkan" />
+                    <br />
+                    <sub>
+                        <b>Ahmed Semih Erkan</b>
+                    </sub>
+                </a>
+            </td>
+            <td align="center">
+                <a href="https://github.com/michaelvbend">
+                    <img src="https://avatars.githubusercontent.com/michaelvbend" width="100px;"
+                        alt="Michael van der Bend" />
+                    <br />
+                    <sub>
+                        <b>Michael van der Bend</b>
+                    </sub>
+                </a>
+            </td>
         </tr>
     </tbody>
 </table>
@@ -640,4 +720,4 @@ If you have contributed to this project and your image is not here, please let u
 
 ---
 
-Made with ❤️ by Samarth Ruia
+Made with ❤️ by Samarth Ruia

package/changelog.txt

@@ -1,6 +1,16 @@
 CHANGELOG
 
 All notable changes to the `stringzy` package will be documented in this file.
+
+=============================================================================
+Version 2.1.0 - 2025-05-31
+-----------------------------------------------------------------------------
+
+ADDED:
+- Added new utility functions:
+  - `removeDuplicates`: Removes duplicate words from a string
+- Added the stringzy banner to the README
+
 =============================================================================
 Version 2.1.0 - 2025-05-31
 -----------------------------------------------------------------------------

package/index.js

@@ -7,7 +7,7 @@
  * 
  * @module stringzy
  * @author Samarth Ruia
- * @version 2.1.0
+ * @version 2.2.0
  */
 
 import * as transformations from './transformations.js';
@@ -28,6 +28,8 @@ export const {
   titleCase,
   constantCase,
   removeWords,
+  initials,
+  removeDuplicates
 } = transformations;
 
 export const {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stringzy",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "main": "index.js",
   "type": "module",
   "scripts": {

package/transformations.js

@@ -147,3 +147,44 @@ export function removeWords(str, wordsToRemove) {
   const regex = new RegExp(`\\b(${wordsArray.join('|')})\\b`, 'gi');
   return str.replace(regex, '').replace(/\s+/g, ' ').trim();
 }
+
+export function initials(text, limit) {
+  if (typeof text !== "string") {
+    throw new Error("Input must be a string");
+  }
+
+  if (limit !== undefined && (typeof limit !== "number" || isNaN(limit))) {
+    throw new Error("Limit must be a valid number");
+  }
+
+  if (limit < 0) {
+    throw new Error("Limit must be a non-negative number");
+  }
+
+  const words = text
+    .trim()
+    .split(/\s+/)
+    .filter((word) => word.length > 0);
+
+  if (words.length === 0) return "";
+
+  const initialsArray = words
+    .map((word) => word.charAt(0))
+    .slice(0, limit ?? words.length);
+
+  return initialsArray.join("");
+}
+
+export function removeDuplicates(text) {
+  if (typeof text !== "string") {
+    throw new Error("Input must be a string");
+  }
+
+  const wordSet = new Set();
+
+  text.split(" ").forEach((word) => {
+    wordSet.add(word);
+  });
+
+  return Array.from(wordSet).join(" ");
+}