diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
index 0d2d0bc..1bba01b 100644
--- a/.github/ISSUE_TEMPLATE/bug_report.md
+++ b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -26,9 +26,9 @@ assignees: ''
 
 يرجى توضيح البيئة التي كنت تستخدمها عند حدوث المشكلة. يمكن ذلك أن يشمل:
 
--   نسخة لغة البرمجة (مثل Python 3.8)
--   نظام التشغيل (مثل Windows 10 أو Ubuntu 20.04)
--   المكتبات البرمجية المعنية وإصداراتها
+-   بيئة التشغيل (مثل Node.js 22.x، أو المتصفح Chrome، أو Next.js / Vite)
+-   إصدار الحزمة arabic-services (مثل 1.1.0)
+-   نظام التشغيل (مثل Windows أو Linux أو macOS)
 
 ## السلوك المتوقع (Expected Behavior)
 
diff --git a/.github/workflows/test.yml b/.github/workflows/ci.yml
similarity index 82%
rename from .github/workflows/test.yml
rename to .github/workflows/ci.yml
index 2955b3e..f71cd5a 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/ci.yml
@@ -1,4 +1,4 @@
-name: Test
+name: CI
 
 on:
     push:
@@ -10,7 +10,7 @@ jobs:
 
         strategy:
             matrix:
-                node-version: [22.x]
+                node-version: [22.x, 24.x]
 
         steps:
             - name: Checkout repository
@@ -32,5 +32,5 @@ jobs:
             - name: Install dependencies
               run: npm ci
 
-            - name: Run build and tests
-              run: npm run build && npm test
+            - name: Run lint, build, and tests
+              run: npm run lint && npm run build && npm test
diff --git a/.github/workflows/npm-publish.yml b/.github/workflows/npm-publish.yml
index 3588c22..2629d23 100644
--- a/.github/workflows/npm-publish.yml
+++ b/.github/workflows/npm-publish.yml
@@ -31,6 +31,7 @@ jobs:
 
             # Step 4: Build package and bundles
             - name: Build package and bundles
+              id: build
               run: npm run build
 
             # Step 5: Publish the package to npm using Trusted Publishing (OIDC)
@@ -39,6 +40,7 @@ jobs:
 
             # Step 6: Upload bundle assets to release
             - name: Upload bundle assets to release
+              if: always() && steps.build.outcome == 'success'
               uses: softprops/action-gh-release@v2
               with:
                   files: |
diff --git a/AGENT.md b/AGENT.md
index ed3ca6e..3f5597b 100644
--- a/AGENT.md
+++ b/AGENT.md
@@ -34,8 +34,11 @@ This repository contains `arabic-services`: a zero-runtime-dependency TypeScript
 - `src/utils/`:
   - `string.util.ts`: Internal string manipulation and regex utility functions.
 - `tests/`:
-  - `scripts.test.ts`: Jest unit tests covering all text operations.
+  - `scripts.test.ts`: Vitest unit tests covering all text operations.
   - `constants.test.ts`: Sanity checks for character mappings and constants.
+  - `artifacts.test.ts`: Module integrity tests for CJS, ESM, and browser UMD bundles.
+  - `edge-cases.test.ts`: Boundary values, orthography variations, and ReDoS resilience tests.
+  - `tree-shaking.test.ts`: Verification of named exports and dead code elimination.
 - `webpack.config.cjs`: Bundler configuration generating UMD (`dist/umd/`) and ESM (`dist/esm/`) bundles for browser distribution.
 - `tsconfig.json`: TypeScript compiler configuration targeting ES5 / CommonJS for the main npm distribution.
 
@@ -54,7 +57,7 @@ This repository contains `arabic-services`: a zero-runtime-dependency TypeScript
 ## Build, Test, and Development Commands
 
 - `npm run build`: Compile TypeScript into `dist/` (generates `.js` and `.d.ts`).
-- `npm test`: Run Jest unit tests and generate coverage report. **Note**: Run `npm run build` before `npm test`, as tests import from the compiled `./dist` directory.
+- `npm test`: Run Vitest test suite and generate coverage report. **Note**: Run `npm run build` before `npm test`, as tests import from the compiled `./dist` directory.
 - `npm test -- -t "test name"`: Run a specific test case by name.
 - `npm run dev`: Quick execution runner using `ts-node src/index.ts`.
 - `npm run bundle`: Run Webpack to bundle production UMD (`arabic-services.umd.js`) and ESM (`arabic-services.esm.js`) files for browser/CDN distribution.
diff --git a/README.md b/README.md
index ba4162b..8ba9230 100644
--- a/README.md
+++ b/README.md
@@ -29,22 +29,22 @@ Can be used in Node.js and the browser.
 <a href="https://github.com/Seen-Arabic/Arabic-Services-JavaScript/blob/master/LICENSE">
 <img src="https://img.shields.io/github/license/Seen-Arabic/Arabic-Services-JavaScript"/>
 </a>
-<a href="https://github.com/Seen-Arabic/Arabic-Services-JavaScript/actions/workflows/test.yml">
-<img src="https://github.com/Seen-Arabic/Arabic-Services-JavaScript/actions/workflows/test.yml/badge.svg" alt="workflows">
+<a href="https://github.com/Seen-Arabic/Arabic-Services-JavaScript/actions/workflows/ci.yml">
+<img src="https://github.com/Seen-Arabic/Arabic-Services-JavaScript/actions/workflows/ci.yml/badge.svg" alt="workflows">
 </a>
 </div>
 
 ## 📋 Features
 
--   **Tashkeel Removal**: Easily remove Tashkeel from Arabic text.
--   **Tatweel Removal**: Remove Tatweel character from Arabic phrases.
--   **Convert To Old Arabic**: Transform Arabic text into old script.
--   **Convert To Old Arabic And Tashfeer Banned Words**: Transform Arabic text into old script and replace Banned Arabic text with visually similar characters for encoding purposes. (Banned words are words that considered as hate speech in social media)
--   **Tashfeer**: Replaces Arabic text with visually similar characters for encoding purposes.
--   **Tashfeer Banned Words**: Replaces Banned Arabic text with visually similar characters for encoding purposes. (Banned words are words that considered as hate speech in social media)
--   **Remove Arabic Affixes**: Removes predefined affixes (prefixes and suffixes) from an Arabic word if it starts or ends with those affixes.
--   **Word To Letters**: Convert Arabic word to its pronounced letters.
--   ... and more!
+- **Tashkeel Removal**: Easily remove Tashkeel from Arabic text.
+- **Tatweel Removal**: Remove Tatweel character from Arabic phrases.
+- **Convert To Old Arabic**: Transform Arabic text into old script.
+- **Convert To Old Arabic And Tashfeer Banned Words**: Transform Arabic text into old script and replace Banned Arabic text with visually similar characters for encoding purposes. (Banned words are words that considered as hate speech in social media)
+- **Tashfeer**: Replaces Arabic text with visually similar characters for encoding purposes.
+- **Tashfeer Banned Words**: Replaces Banned Arabic text with visually similar characters for encoding purposes. (Banned words are words that considered as hate speech in social media)
+- **Remove Arabic Affixes**: Removes predefined affixes (prefixes and suffixes) from an Arabic word if it starts or ends with those affixes.
+- **Word To Letters**: Convert Arabic word to its pronounced letters.
+- ... and more!
 
 <h3 align=center><a href="https://github.com/Seen-Arabic/Arabic-Services-JavaScript/wiki/Features-Documentation">➡️ Check out the usage and detailed documentation on each feature ⬅️</a></h3>
 
@@ -54,38 +54,51 @@ Arabic-Services was designed to work in both the browser and NodeJS applications
 
 ### Browser
 
-We provide both ESM and UMD bundles for use in the browser.
-You can find it with the latest release files.
+You can use the library directly in the browser via CDN using **jsdelivr** or **unpkg**, or download standalone bundle files from the latest [GitHub Releases](https://github.com/Seen-Arabic/Arabic-Services-JavaScript/releases):
 
 ```html
-<script src="arabic-services.umd.js"></script>
+<!-- Via jsdelivr (Recommended) -->
+<script src="https://cdn.jsdelivr.net/npm/arabic-services@1/dist/umd/arabic-services.umd.js"></script>
+
+<!-- Or via unpkg -->
+<script src="https://unpkg.com/arabic-services@1/dist/umd/arabic-services.umd.js"></script>
+
 <script>
 	console.log(ArabicServices.removeTashkeel('الخَيْلُ وَاللّيْلُ وَالبَيْداءُ تَعرِفُني'));
 	// Output: 'الخيل والليل والبيداء تعرفني'
 </script>
 ```
 
-### NodeJS
+### NodeJS & Modern Bundlers
 
-Both CommonJS and ES Module libraries are provided.
+Install the package via npm:
 
 ```bash
 npm install arabic-services
 ```
 
-**CommonJS:**
+#### ES Module & Tree Shaking (Recommended):
+
+Import only the functions you need for maximum bundle size reduction:
 
 ```javascript
-const { ArabicServices } = require('arabic-services');
-console.log(ArabicServices.removeTashkeel('الخَيْلُ وَاللّيْلُ وَالبَيْداءُ تَعرِفُني'));
+import { removeTashkeel, removeTatweel, toOldArabic } from 'arabic-services';
+
+console.log(removeTashkeel('الخَيْلُ وَاللّيْلُ وَالبَيْداءُ تَعرِفُني'));
 // Output: 'الخيل والليل والبيداء تعرفني'
 ```
 
-**ES Module:**
+Or import the full object:
 
 ```javascript
 import { ArabicServices } from 'arabic-services';
-console.log(ArabicServices.removeTashkeel('الخَيْلُ وَاللّيْلُ وَالبَيْداءُ تَعرِفُني'));
+```
+
+#### CommonJS:
+
+```javascript
+const { removeTashkeel, ArabicServices } = require('arabic-services');
+console.log(removeTashkeel('الخَيْلُ وَاللّيْلُ وَالبَيْداءُ تَعرِفُني'));
 // Output: 'الخيل والليل والبيداء تعرفني'
 ```
 
@@ -93,8 +106,8 @@ console.log(ArabicServices.removeTashkeel('الخَيْلُ وَاللّيْلُ
 
 Arabic Services is made publicly available to provide a well tested and well documented library for processing and transforming Arabic text to all developers. We accept feature contributions provided that they are properly documented and include the appropriate unit tests.
 
--   🚀 If you want to contribute to this project and make it better with new ideas, your pull request is very welcomed.
--   📝 If you find any issue just put it in the repository issue section, thank you.
+- 🚀 If you want to contribute to this project and make it better with new ideas, your pull request is very welcomed.
+- 📝 If you find any issue just put it in the repository issue section, thank you.
 
 ## 🌟 Star this repository
 
@@ -106,5 +119,5 @@ This project is licensed under the GPL-3.0 License. See the [LICENSE](./LICENSE)
 
 ## 💬 Contact
 
--   📩 Email: [SeenDevelopment@gmail.com](mailto:SeenDevelopment@gmail.com)
--   🌎 [Website](https://seen-arabic.github.io/)
+- 📩 Email: [SeenDevelopment@gmail.com](mailto:SeenDevelopment@gmail.com)
+- 🌎 [Website](https://seen-arabic.github.io/)
diff --git a/README_AR.md b/README_AR.md
index b8f3f44..c9bca3a 100644
--- a/README_AR.md
+++ b/README_AR.md
@@ -26,22 +26,22 @@
 <a href="https://github.com/Seen-Arabic/Arabic-Services-JavaScript/blob/master/LICENSE">
 <img src="https://img.shields.io/github/license/Seen-Arabic/Arabic-Services-JavaScript"/>
 </a>
-<a href="https://github.com/Seen-Arabic/Arabic-Services-JavaScript/actions/workflows/test.yml">
-<img src="https://github.com/Seen-Arabic/Arabic-Services-JavaScript/actions/workflows/test.yml/badge.svg" alt="workflows">
+<a href="https://github.com/Seen-Arabic/Arabic-Services-JavaScript/actions/workflows/ci.yml">
+<img src="https://github.com/Seen-Arabic/Arabic-Services-JavaScript/actions/workflows/ci.yml/badge.svg" alt="workflows">
 </a>
 </div>
 
 ## 📋 الميزات
 
--   **إزالة التشكيل:** إزالة التشكيل من النص العربي.
--   **إزالة التطويل:** إزالة أحرف التطويل غير الضرورية من العبارات العربية.
--   **التحويل إلى العربية القديمة:** تحويل النص العربي إلى الخط العربي القديم.
--   **التحويل إلى العربية القديمة وتشفير الكلمات المحظورة:** تحويل النص العربي إلى الخط العربي القديم واستبدال النصوص العربية المحظورة بأحرف مشابهة بصريًا لأغراض الترميز. (الكلمات المحظورة هي الكلمات التي تعتبر كلمات مسيئة في وسائل التواصل الاجتماعي)
--   **التشفير:** استبدال النص العربي بأحرف مشابهة بصريًا لأغراض الترميز.
--   **تشفير الكلمات المحظورة:** استبدال النصوص العربية المحظورة بأحرف مشابهة بصريًا لأغراض الترميز. (الكلمات المحظورة هي الكلمات التي تعتبر كلمات مسيئة في وسائل التواصل الاجتماعي)
--   **إزالة اللواحق العربية:** إزالة اللواحق المحددة (البادئات واللاحقات) من كلمة عربية إذا بدأت أو انتهت بهذه اللواحق.
--   **الكلمة إلى حروفها:** تحويل الكلمة العربية إلى حروفها المنطوقة.
--   ...والمزيد!
+- **إزالة التشكيل:** إزالة التشكيل من النص العربي.
+- **إزالة التطويل:** إزالة أحرف التطويل غير الضرورية من العبارات العربية.
+- **التحويل إلى العربية القديمة:** تحويل النص العربي إلى الخط العربي القديم.
+- **التحويل إلى العربية القديمة وتشفير الكلمات المحظورة:** تحويل النص العربي إلى الخط العربي القديم واستبدال النصوص العربية المحظورة بأحرف مشابهة بصريًا لأغراض الترميز. (الكلمات المحظورة هي الكلمات التي تعتبر كلمات مسيئة في وسائل التواصل الاجتماعي)
+- **التشفير:** استبدال النص العربي بأحرف مشابهة بصريًا لأغراض الترميز.
+- **تشفير الكلمات المحظورة:** استبدال النصوص العربية المحظورة بأحرف مشابهة بصريًا لأغراض الترميز. (الكلمات المحظورة هي الكلمات التي تعتبر كلمات مسيئة في وسائل التواصل الاجتماعي)
+- **إزالة اللواحق العربية:** إزالة اللواحق المحددة (البادئات واللاحقات) من كلمة عربية إذا بدأت أو انتهت بهذه اللواحق.
+- **الكلمة إلى حروفها:** تحويل الكلمة العربية إلى حروفها المنطوقة.
+- ...والمزيد!
 
 <h3 align=center><a href="https://github.com/Seen-Arabic/Arabic-Services-JavaScript/wiki/Features%E2%80%90Documentation%E2%80%90AR">➡️ شاهد استخدام كل ميزة من المكتبة وطريقة استخدامها في الكود ⬅️</a></h3>
 
@@ -49,39 +49,53 @@
 
 تم تصميم خدمات العربية لتعمل في كل من المتصفح وتطبيقات NodeJS.
 
-### المتصفح
+### المتصفح (Browser)
 
-نوفر حزم ESM و UMD للاستخدام في المتصفح. يمكن العثور عليها مع ملفات الإصدار الأخير.
+يمكنك استخدام المكتبة مباشرة في المتصفح عبر شبكات الـ CDN العالمية (**jsdelivr** أو **unpkg**)، أو تنزيل ملفات الـ Bundles الجاهزة من صفحة [GitHub Releases](https://github.com/Seen-Arabic/Arabic-Services-JavaScript/releases):
 
 ```html
-<script src="arabic-services.umd.js"></script>
+<!-- عبر jsdelivr (موصى به) -->
+<script src="https://cdn.jsdelivr.net/npm/arabic-services@1/dist/umd/arabic-services.umd.js"></script>
+
+<!-- أو عبر unpkg -->
+<script src="https://unpkg.com/arabic-services@1/dist/umd/arabic-services.umd.js"></script>
+
 <script>
 	console.log(ArabicServices.removeTashkeel('الخَيْلُ وَاللّيْلُ وَالبَيْداءُ تَعرِفُني'));
 	// Output: 'الخيل والليل والبيداء تعرفني'
 </script>
 ```
 
-### NodeJS
+### NodeJS وحزم العمل الحديثة (Modern Bundlers)
 
-تم توفير مكتبات CommonJS و ES Module.
+تثبيت الحزمة عبر npm:
 
 ```bash
 npm install arabic-services
 ```
 
-**CommonJS:**
+#### نظام ES Module ودعم Tree Shaking (موصى به):
+
+استيراد الدوال التي تحتاجها فقط لتقليل حجم الحزمة إلى أدنى حد (أقل من 400 بايت للدالة):
 
 ```javascript
-const { ArabicServices } = require('arabic-services');
-console.log(ArabicServices.removeTashkeel('الخَيْلُ وَاللّيْلُ وَالبَيْداءُ تَعرِفُني'));
+import { removeTashkeel, removeTatweel, toOldArabic } from 'arabic-services';
+
+console.log(removeTashkeel('الخَيْلُ وَاللّيْلُ وَالبَيْداءُ تَعرِفُني'));
 // Output: 'الخيل والليل والبيداء تعرفني'
 ```
 
-**ES Module:**
+أو استيراد الكائن كاملاً:
 
 ```javascript
 import { ArabicServices } from 'arabic-services';
-console.log(ArabicServices.removeTashkeel('الخَيْلُ وَاللّيْلُ وَالبَيْداءُ تَعرِفُني'));
+```
+
+#### نظام CommonJS:
+
+```javascript
+const { removeTashkeel, ArabicServices } = require('arabic-services');
+console.log(removeTashkeel('الخَيْلُ وَاللّيْلُ وَالبَيْداءُ تَعرِفُني'));
 // Output: 'الخيل والليل والبيداء تعرفني'
 ```
 
@@ -89,8 +103,8 @@ console.log(ArabicServices.removeTashkeel('الخَيْلُ وَاللّيْلُ
 
 تم إتاحة خدمات اللغة العربية للجمهور لتوفير مكتبة مُجربة جيدًا وموثقة بشكل جيد لمعالجة وتحويل النصوص العربية لجميع المطورين. نحن نقبل مساهمات الميزات بشرط أن تكون موثقة بشكل صحيح وتشمل الاختبارات المناسبة.
 
--   🚀 إذا كنت ترغب في المساهمة في هذا المشروع وتحسينه بأفكار جديدة، فبإمكانك عمل pull request وطلبك مرحب به للغاية.
--   📝 إذا وجدت أي مشكلة، فقط ضعها في قسم الـIssues في المستودع، شكرًا لك.
+- 🚀 إذا كنت ترغب في المساهمة في هذا المشروع وتحسينه بأفكار جديدة، فبإمكانك عمل pull request وطلبك مرحب به للغاية.
+- 📝 إذا وجدت أي مشكلة، فقط ضعها في قسم الـIssues في المستودع، شكرًا لك.
 
 <div align=center>
 <h2>🌟 ضع نجمة على هذا المستودع 🌟</h2>
@@ -107,5 +121,5 @@ console.log(ArabicServices.removeTashkeel('الخَيْلُ وَاللّيْلُ
 
 ## 💬 الاتصال
 
--   📩 البريد الإلكتروني: [SeenDevelopment@gmail.com](mailto:SeenDevelopment@gmail.com)
--   🌎 [الموقع الإلكتروني](https://seen-arabic.github.io/)
+- 📩 البريد الإلكتروني: [SeenDevelopment@gmail.com](mailto:SeenDevelopment@gmail.com)
+- 🌎 [الموقع الإلكتروني](https://seen-arabic.github.io/)
diff --git a/example.html b/examples/browser/index.html
similarity index 97%
rename from example.html
rename to examples/browser/index.html
index 2941132..fa671ae 100644
--- a/example.html
+++ b/examples/browser/index.html
@@ -12,7 +12,7 @@
 	</head>
 	<body>
 		<!-- run npm run bundle to get arabic-services.umd.js file -->
-		<script src="./dist/umd/arabic-services.umd.js"></script>
+		<script src="../../dist/umd/arabic-services.umd.js"></script>
 		<script>
 			console.log('ArabicServices:', ArabicServices);
 			console.log('-------- Functions --------');
diff --git a/package.json b/package.json
index 56e8075..88c554f 100644
--- a/package.json
+++ b/package.json
@@ -37,8 +37,8 @@
 		"test:watch": "vitest",
 		"prepublishOnly": "npm run build",
 		"format": "npx prettier --write . --ignore-path .gitignore",
-		"lint": "eslint src --quiet",
-		"lint:fix": "eslint src --fix",
+		"lint": "eslint . --quiet",
+		"lint:fix": "eslint . --fix",
 		"bundle": "webpack"
 	},
 	"repository": {
diff --git a/tests/artifacts.test.ts b/tests/artifacts.test.ts
new file mode 100644
index 0000000..80980d5
--- /dev/null
+++ b/tests/artifacts.test.ts
@@ -0,0 +1,128 @@
+import { execSync } from 'node:child_process';
+import * as fs from 'node:fs';
+import { createRequire } from 'node:module';
+import * as path from 'node:path';
+import * as vm from 'node:vm';
+import { describe, expect, it } from 'vitest';
+
+describe('Package Artifacts & Module Integrity', () => {
+	const rootDir = path.resolve(__dirname, '..');
+	const packageJsonPath = path.join(rootDir, 'package.json');
+	const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+
+	it('should have all entry point files existing on disk and non-empty', () => {
+		const entryPoints = [
+			{ field: 'main', path: packageJson.main },
+			{ field: 'module', path: packageJson.module },
+			{ field: 'types', path: packageJson.types },
+			{ field: 'unpkg', path: packageJson.unpkg },
+			{ field: 'jsdelivr', path: packageJson.jsdelivr },
+			{ field: 'exports.import.default', path: packageJson.exports['.'].import.default },
+			{ field: 'exports.import.types', path: packageJson.exports['.'].import.types },
+			{ field: 'exports.require.default', path: packageJson.exports['.'].require.default },
+			{ field: 'exports.require.types', path: packageJson.exports['.'].require.types },
+		];
+
+		for (const entry of entryPoints) {
+			const absolutePath = path.resolve(rootDir, entry.path);
+			expect(fs.existsSync(absolutePath), `File specified in ${entry.field} (${entry.path}) must exist`).toBe(
+				true,
+			);
+			const stats = fs.statSync(absolutePath);
+			expect(stats.size, `File specified in ${entry.field} (${entry.path}) must not be empty`).toBeGreaterThan(0);
+		}
+	});
+
+	it('should have dist/esm/package.json declaring type: module and sideEffects: false', () => {
+		const esmPkgPath = path.join(rootDir, 'dist/esm/package.json');
+		expect(fs.existsSync(esmPkgPath)).toBe(true);
+		const esmPkg = JSON.parse(fs.readFileSync(esmPkgPath, 'utf8'));
+		expect(esmPkg.type).toBe('module');
+		expect(esmPkg.sideEffects).toBe(false);
+	});
+
+	it('should support standalone CommonJS require() in isolated Node.js process', () => {
+		const script = `
+			const { removeTashkeel, toOldArabic, ArabicServices } = require('./dist');
+			const res1 = removeTashkeel('مَرْحَبًا');
+			const res2 = ArabicServices.removeTatweel('رائـــــع');
+			console.log(JSON.stringify({ res1, res2, hasToOldArabic: typeof toOldArabic === 'function' }));
+		`;
+		const stdout = execSync(`node -e "${script.replace(/\n/g, ' ')}"`, {
+			cwd: rootDir,
+			encoding: 'utf8',
+		});
+		const result = JSON.parse(stdout.trim());
+		expect(result.res1).toBe('مرحبا');
+		expect(result.res2).toBe('رائع');
+		expect(result.hasToOldArabic).toBe(true);
+	});
+
+	it('should support standalone ES Module import in isolated Node.js process', () => {
+		const script = `
+			import { removeTashkeel, toOldArabic, ArabicServices } from './dist/esm/index.js';
+			const res1 = removeTashkeel('مَرْحَبًا');
+			const res2 = ArabicServices.removeTatweel('رائـــــع');
+			console.log(JSON.stringify({ res1, res2, hasToOldArabic: typeof toOldArabic === 'function' }));
+		`;
+		const stdout = execSync(`node --input-type=module -e "${script.replace(/\n/g, ' ')}"`, {
+			cwd: rootDir,
+			encoding: 'utf8',
+		});
+		const result = JSON.parse(stdout.trim());
+		expect(result.res1).toBe('مرحبا');
+		expect(result.res2).toBe('رائع');
+		expect(result.hasToOldArabic).toBe(true);
+	});
+
+	it('should execute browser UMD bundle inside a simulated browser window context', () => {
+		const umdPath = path.join(rootDir, packageJson.unpkg);
+		const umdCode = fs.readFileSync(umdPath, 'utf8');
+
+		const sandbox: { window: Record<string, unknown>; ArabicServices?: Record<string, unknown> } = {
+			window: {},
+		};
+		// Establish circular reference standard in browser environments (window.window === window)
+		sandbox.window.window = sandbox.window;
+
+		const context = vm.createContext(sandbox);
+		vm.runInContext(umdCode, context);
+
+		const arabicServices = (sandbox.window.ArabicServices || sandbox.ArabicServices) as Record<
+			string,
+			(...args: unknown[]) => unknown
+		>;
+
+		expect(arabicServices).toBeDefined();
+		expect(typeof arabicServices.removeTashkeel).toBe('function');
+		expect(typeof arabicServices.toOldArabic).toBe('function');
+		expect(typeof arabicServices.removeTatweel).toBe('function');
+		expect(typeof arabicServices.tashfeer).toBe('function');
+
+		expect(arabicServices.removeTashkeel('الخَيْلُ وَاللّيْلُ')).toBe('الخيل والليل');
+		expect(arabicServices.removeTatweel('كتــــاب')).toBe('كتاب');
+	});
+
+	it('should support in-process CommonJS loading via Node.js createRequire()', () => {
+		const nodeRequire = createRequire(import.meta.url);
+		const cjsDist = nodeRequire('../dist');
+
+		expect(cjsDist).toBeDefined();
+		expect(typeof cjsDist.removeTashkeel).toBe('function');
+		expect(typeof cjsDist.toOldArabic).toBe('function');
+		expect(typeof cjsDist.ArabicServices).toBe('object');
+		expect(cjsDist.removeTashkeel('مَرْحَبًا')).toBe('مرحبا');
+		expect(cjsDist.ArabicServices.removeTatweel('رائـــــع')).toBe('رائع');
+	});
+
+	it('should execute purely as Isomorphic/Universal functions without DOM dependencies', async () => {
+		// Import all scripts in current process (where window and document are undefined)
+		expect(typeof window).toBe('undefined');
+		expect(typeof document).toBe('undefined');
+
+		const dist = await import('../dist');
+		expect(dist.removeTashkeel('فَحَصَ')).toBe('فحص');
+		expect(dist.removeTatweel('مـلـف')).toBe('ملف');
+		expect(dist.toOldArabic('بَيْت')).toBe('ٮىٮ');
+	});
+});
diff --git a/tests/edge-cases.test.ts b/tests/edge-cases.test.ts
new file mode 100644
index 0000000..a8f74f3
--- /dev/null
+++ b/tests/edge-cases.test.ts
@@ -0,0 +1,154 @@
+import { describe, it, expect } from 'vitest';
+import {
+	removeTashkeel,
+	removeTatweel,
+	toOldArabic,
+	toOldArabicAndTashfeerBannedWords,
+	tashfeer,
+	tashfeerBannedWords,
+	wordToLetters,
+	removeArabicAffixes,
+} from '../src';
+
+describe('Arabic NLP Edge Cases & Robustness', () => {
+	describe('Empty, Whitespace & Boundary Inputs', () => {
+		it('should gracefully handle empty strings across all functions', () => {
+			expect(removeTashkeel('')).toBe('');
+			expect(removeTatweel('')).toBe('');
+			expect(toOldArabic('')).toBe('');
+			expect(toOldArabicAndTashfeerBannedWords('')).toBe('');
+			expect(tashfeer('')).toBe('');
+			expect(tashfeerBannedWords('')).toBe('');
+			expect(wordToLetters('')).toBe('');
+			expect(removeArabicAffixes('')).toBe('');
+		});
+
+		it('should trim surrounding whitespace properly', () => {
+			expect(removeTashkeel('   مَرْحَبًا   ')).toBe('مرحبا');
+			expect(removeTatweel('   رائــــع   ')).toBe('رائع');
+			expect(toOldArabic('   كِتَابٌ   ')).toBe('کٮاٮ');
+			expect(wordToLetters('   حب   ')).toBe('حاء باء');
+		});
+
+		it('should handle words that are shorter than standard affix length', () => {
+			// 'و' is not in ARABIC_PREFIXES so it stays unchanged
+			expect(removeArabicAffixes('و')).toBe('و');
+			// 'ال' is an exact 2-letter prefix and is removed completely
+			expect(removeArabicAffixes('ال')).toBe('');
+			// single letter prefix 'ي'
+			expect(removeArabicAffixes('يقرأ')).toBe('قرأ');
+		});
+
+		it('should handle sentences with irregular spacing', () => {
+			const sentence = 'ذهب    الموظفون    إلى   العمل';
+			const res = removeArabicAffixes(sentence);
+			expect(res).toContain('موظف');
+			expect(res).toContain('عمل');
+		});
+	});
+
+	describe('Mixed Scripts & Special Characters Preservation', () => {
+		it('should preserve Latin characters, numbers, and emojis while stripping Tashkeel', () => {
+			const text = '🎉 Hello 123! الخَيْلُ وَاللّيْلُ (Test 456) ✨';
+			const result = removeTashkeel(text);
+			expect(result).toBe('🎉 Hello 123! الخيل والليل (Test 456) ✨');
+		});
+
+		it('should preserve non-Arabic characters in toOldArabic', () => {
+			const text = 'User123: كَتَبَ email@example.com!';
+			const result = toOldArabic(text);
+			expect(result).toBe('User123: کٮٮ email@example.com!');
+		});
+
+		it('should preserve non-Arabic characters in tashfeer without corruption', () => {
+			const text = 'Code 99: سلاح';
+			const result = tashfeer(text);
+			expect(result.startsWith('Code 99:')).toBe(true);
+			expect(result.length).toBeGreaterThanOrEqual(text.length);
+		});
+	});
+
+	describe('Complex Diacritics & Orthography', () => {
+		it('should normalize Wasla Alef (ٱ) to standard Alef', () => {
+			expect(removeTashkeel('ٱسْمُ')).toBe('اسم');
+		});
+
+		it('should remove stacked diacritics (Shaddah with Fatha/Kasra/Damma/Tanween)', () => {
+			const stacked = 'مُحَمَّدٌ وَعَلِيٌّ';
+			expect(removeTashkeel(stacked)).toBe('محمد وعلي');
+		});
+
+		it('should handle consecutive Tatweel characters cleanly', () => {
+			const excessiveTatweel = 'قـــــــــــــــــال';
+			expect(removeTatweel(excessiveTatweel)).toBe('قال');
+		});
+
+		it('should handle Tatweel combined with Tashkeel', () => {
+			const tatweelWithTashkeel = 'رَائـِـــــعٌ';
+			const noTashkeel = removeTashkeel(tatweelWithTashkeel);
+			const clean = removeTatweel(noTashkeel);
+			expect(clean).toBe('رائع');
+		});
+	});
+
+	describe('Tashfeer Variants and Word Length Boundaries', () => {
+		it('should handle Tashfeer on words with length >= 8 characters', () => {
+			const longWord = 'المسؤوليات';
+			const result = tashfeer(longWord, 1);
+			expect(result).toBeDefined();
+			expect(typeof result).toBe('string');
+			expect(result.length).toBeGreaterThan(0);
+		});
+
+		it('should handle Tashfeer with Alef, Waw, and Yaa variants', () => {
+			const sentence = 'أحمد يؤمن بالرئيس';
+			const result = tashfeer(sentence, 2);
+			expect(result).toBeDefined();
+			expect(result.length).toBeGreaterThan(0);
+		});
+
+		it('should obfuscate banned words using tashfeerBannedWords', () => {
+			const text = 'هذا السلاح ممنوع';
+			const result = tashfeerBannedWords(text);
+			expect(result).not.toBe(text);
+			expect(result).toContain('هذا');
+			expect(result).toContain('ممنوع');
+		});
+
+		it('should handle toOldArabicAndTashfeerBannedWords on mixed sentences', () => {
+			const input = 'جيش العدو يقتل الأطفال';
+			const result = toOldArabicAndTashfeerBannedWords(input, 1);
+			expect(result).toBeDefined();
+			expect(result.split(' ').length).toBeGreaterThanOrEqual(4);
+		});
+	});
+
+	describe('Performance & ReDoS Resilience', () => {
+		it('should process large texts (50,000+ chars) in under 150ms without catastrophic backtracking', () => {
+			const sampleUnit =
+				'الخَيْلُ وَاللّيْلُ وَالبَيْداءُ تَعرِفُني، وَالسّيفُ وَالرّمحُ والقرْطاسُ وَالقَلَـمُ! ';
+			const largeText = sampleUnit.repeat(600); // ~54,000 characters
+			expect(largeText.length).toBeGreaterThan(50000);
+
+			const startTashkeel = performance.now();
+			const noTashkeel = removeTashkeel(largeText);
+			const tashkeelDuration = performance.now() - startTashkeel;
+
+			const startTatweel = performance.now();
+			const noTatweel = removeTatweel(largeText);
+			const tatweelDuration = performance.now() - startTatweel;
+
+			const startOldArabic = performance.now();
+			const oldArabic = toOldArabic(largeText);
+			const oldArabicDuration = performance.now() - startOldArabic;
+
+			expect(noTashkeel.length).toBeLessThan(largeText.length);
+			expect(noTatweel.length).toBeLessThan(largeText.length);
+			expect(oldArabic.length).toBeGreaterThan(0);
+
+			expect(tashkeelDuration, 'removeTashkeel should process large text within 150ms').toBeLessThan(150);
+			expect(tatweelDuration, 'removeTatweel should process large text within 150ms').toBeLessThan(150);
+			expect(oldArabicDuration, 'toOldArabic should process large text within 150ms').toBeLessThan(150);
+		});
+	});
+});
diff --git a/tests/tree-shaking.test.ts b/tests/tree-shaking.test.ts
index c1c13d2..222ffc7 100644
--- a/tests/tree-shaking.test.ts
+++ b/tests/tree-shaking.test.ts
@@ -1,3 +1,4 @@
+import { execSync } from 'node:child_process';
 import ArabicServicesDefault, {
 	ArabicServices,
 	removeTashkeel,
@@ -34,10 +35,9 @@ describe('Tree Shaking & Named Exports', () => {
 	});
 
 	it('should support native Node.js ESM import with named exports', () => {
-		const { execSync } = require('child_process');
 		const stdout = execSync(
-			'node --input-type=module -e "import(\'./dist/esm/index.js\').then(m => console.log(JSON.stringify({ hasRemoveTashkeel: typeof m.removeTashkeel, hasArabicServices: typeof m.ArabicServices, sampleResult: m.removeTashkeel(\'مَرْحَبًا\') })))"',
-			{ encoding: 'utf8' }
+			"node --input-type=module -e \"import('./dist/esm/index.js').then(m => console.log(JSON.stringify({ hasRemoveTashkeel: typeof m.removeTashkeel, hasArabicServices: typeof m.ArabicServices, sampleResult: m.removeTashkeel('مَرْحَبًا') })))\"",
+			{ encoding: 'utf8' },
 		);
 		const result = JSON.parse(stdout);
 		expect(result.hasRemoveTashkeel).toBe('function');