clean-quotes 1.0.0

package/.github/workflows/npmpublish.yml

@@ -0,0 +1,48 @@
+# This workflow will run tests using node and then publish a package to npm using Trusted Publishing (OIDC)
+# For more information see: https://docs.npmjs.com/using-private-packages-in-a-ci-cd-workflow
+
+name: clean-quotes NPM Package
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    # Skip Dependabot PRs for CI/CD
+    if: ${{ github.actor != 'dependabot[bot]' }}
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: lts/krypton
+
+      - run: npm install
+      - run: npm test
+
+  publish-npm:
+    needs: build
+    runs-on: ubuntu-latest
+
+    # Skip Dependabot PRs
+    if: ${{ github.actor != 'dependabot[bot]' }}
+
+    # Required for OIDC Trusted Publishing
+    permissions:
+      contents: read
+      id-token: write # 👈 REQUIRED for Trusted Publishing
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: lts/krypton
+          registry-url: https://registry.npmjs.org/
+
+      - run: npm install
+      - run: npm publish

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alex
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,55 @@
+# clean-quotes
+
+<p align="center"><a href="https://nodei.co/npm/clean-quotes/"><img src="https://nodei.co/npm/clean-quotes.png"></a></a></p>
+<p align="center">
+  <img src="https://img.shields.io/badge/License-MIT-yellow.svg">
+</p>
+
+* ✍️ Normalize quotes, dashes, and ellipsis in strings.
+* ♻️ Works seamlessly with `CommonJS`, `ESM` and `TypeScript`
+
+# 📦 Install via [NPM](https://www.npmjs.com/package/clean-quotes)
+
+```bash
+$ npm i clean-quotes
+```
+
+# 💻 Usage
+
+- See examples below
+
+## CommonJS
+```javascript
+const cleanQuotes = require('clean-quotes');
+
+const input = `“Hello” — said the cat… ‘Are you okay?’ «Bonjour» ― こんにちは…`;
+const cleanedString = cleanQuotes(input);
+
+console.log(cleanedString);
+
+// --| Expected output: "Hello" - said the cat... 'Are you okay?' "Bonjour" - こんにちは...
+```
+
+## ESM
+```javascript
+import cleanQuotes from 'clean-quotes';
+
+const input = `“Hello” — said the cat… ‘Are you okay?’ «Bonjour» ― こんにちは…`;
+
+const cleanedString = cleanQuotes(input);
+console.log(cleanedString);
+
+// --| Expected output: "Hello" - said the cat... 'Are you okay?' "Bonjour" - こんにちは...
+```
+
+## TypeScript
+```javascript
+import cleanQuotes from 'clean-quotes';
+
+const input: string = `“Hello” — said the cat… ‘Are you okay?’ «Bonjour» ― こんにちは…`;
+const cleanedString: string = cleanQuotes(input);
+
+console.log(cleanedString);
+
+// --| Expected output: "Hello" - said the cat... 'Are you okay?' "Bonjour" - こんにちは...
+```

package/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Normalize a string by standardizing quotes, dashes, ellipsis, and whitespace.
+ *
+ * - Converts all double quotes variants to standard `"`
+ * - Converts all single quotes/apostrophes variants to `'`
+ * - Converts all dash/hyphen variants to `-`
+ * - Converts all ellipsis variants to `...`
+ * - Collapses multiple spaces into a single space and trims the string
+ *
+ * Supports multi-language punctuation.
+ *
+ * @param {string | null | undefined} str - The input string to normalize
+ * @returns {string} The normalized string
+ */
+declare function cleanQuotes(str: string | null | undefined): string;
+
+export = cleanQuotes;

package/index.js

@@ -0,0 +1,35 @@
+/**
+ *  clean-quotes - ✍️ Normalize quotes, dashes, and ellipsis in strings.
+ *  @version: v1.0.0
+ *  @link: https://github.com/tutyamxx/clean-quotes
+ *  @license: MIT
+ **/
+
+
+/**
+ * Normalize a string by standardizing quotes, dashes, ellipsis, and whitespace.
+ *
+ * - Converts all double quotes variants to standard `"`
+ * - Converts all single quotes/apostrophes variants to `'`
+ * - Converts all dash/hyphen variants to `-`
+ * - Converts all ellipsis variants to `...`
+ * - Collapses multiple spaces into a single space and trims the string
+ *
+ * Supports multi-language punctuation.
+ *
+ * @param {string | null | undefined} str - The input string to normalize
+ * @returns {string} The normalized string
+ */
+const cleanQuotes = (str) => (str ?? '')
+    ?.replace(/[\u201C\u201D\u00AB\u00BB\u201E\u201F\u2033\u301D\u301E\u301F]/g, '"')       // --| Normalize double quotes
+    ?.replace(/[\u2018\u2019\u201A\u201B\u2032\u2035\u02BC\u02BB\u02BD\uFF07]/g, "'")       // --| Normalize single quotes/apostrophes
+    ?.replace(/[\u2026\u22EF\u22F1\uFE45]/g, '...')                                         // --| Normalize dashes/hyphens
+    ?.replace(/[\u2013\u2014\u2212\u2015]/g, '-')                                           // --| Normalize ellipsis
+    ?.replace(/\s+/g, ' ')                                                                  // --| Collapse multiple spaces into one and trim
+    ?.trim();
+
+// --| CommonJS export
+module.exports = cleanQuotes;
+
+// --| ESM default export for `import` statements
+module.exports.default = cleanQuotes;

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "clean-quotes",
+  "version": "1.0.0",
+  "description": "✍️ Normalize quotes, dashes, and ellipsis in strings.",
+  "main": "index.js",
+  "module": "index.js",
+  "types": "index.d.ts",
+  "exports": {
+    "require": "./index.js",
+    "import": "./index.js",
+    "types": "./index.d.ts"
+  },
+  "scripts": {
+    "test": "jest --verbose"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tutyamxx/clean-quotes.git"
+  },
+  "keywords": [],
+  "author": "tuty",
+  "license": "MIT",
+  "type": "commonjs",
+  "bugs": {
+    "url": "https://github.com/tutyamxx/clean-quotes/issues"
+  },
+  "homepage": "https://github.com/tutyamxx/clean-quotes#readme",
+  "devDependencies": {
+    "jest": "^30.3.0"
+  }
+}

package/test/index.test.js

@@ -0,0 +1,64 @@
+const cleanQuotes = require('../index.js');
+
+describe('cleanQuotes', () => {
+    test('Normalizes all types of double quotes', () => {
+        const input = `“Hello” «World» „Test‟ 〝Example〞`;
+        const expected = `"Hello" "World" "Test" "Example"`;
+
+        expect(cleanQuotes(input)).toBe(expected);
+    });
+
+    test('Normalizes all types of single quotes/apostrophes', () => {
+        const input = `‘Hello’ ‚World‛ ʼ’ ʼ’`;
+        const expected = `'Hello' 'World' '' ''`;
+
+        expect(cleanQuotes(input)).toBe(expected);
+    });
+
+    test('Normalizes all types of dashes/hyphens', () => {
+        const input = `– — − ―`;
+        const expected = `- - - -`;
+
+        expect(cleanQuotes(input)).toBe(expected);
+    });
+
+    test('Normalizes ellipsis variants', () => {
+        const input = `… … ﹅ …`;
+        const expected = `... ... ... ...`;
+
+        expect(cleanQuotes(input)).toBe(expected);
+    });
+
+    test('Collapses multiple spaces and trims', () => {
+        const input = `   Hello     world   `;
+        const expected = `Hello world`;
+
+        expect(cleanQuotes(input)).toBe(expected);
+    });
+
+    test('Handles null and undefined', () => {
+        expect(cleanQuotes(null)).toBe('');
+        expect(cleanQuotes(undefined)).toBe('');
+    });
+
+    test('Works with multi-language text', () => {
+        const input = `“Hello” — said the cat… ‘Are you okay?’ «Bonjour» ― こんにちは…`;
+        const expected = `"Hello" - said the cat... 'Are you okay?' "Bonjour" - こんにちは...`;
+
+        expect(cleanQuotes(input)).toBe(expected);
+    });
+
+    test('Preserves emoji and special characters', () => {
+        const input = `“Hello 😺” — こんにちは…`;
+        const expected = `"Hello 😺" - こんにちは...`;
+
+        expect(cleanQuotes(input)).toBe(expected);
+    });
+
+    test('Combines all features in one complex string', () => {
+        const input = `‘Test’ – “Example”… ― «多言語»…  ✅`;
+        const expected = `'Test' - "Example"... - "多言語"... ✅`;
+
+        expect(cleanQuotes(input)).toBe(expected);
+    });
+});