bitaboom 1.1.1 → 1.3.0

package/README.md

@@ -176,6 +176,22 @@ convertUrduSymbolsToArabic('ھذا');
 
 ---
 
+### `ensureSpaceBeforeBrackets`
+
+Ensures there is exactly one space before parentheses that follow non-whitespace characters. Normalizes multiple spaces to a single space.
+
+#### Example:
+
+```javascript
+ensureSpaceBeforeBrackets('text(note)');
+// Output: 'text (note)'
+
+ensureSpaceBeforeBrackets('text   (note)');
+// Output: 'text (note)'
+```
+
+---
+
 ### `extractInitials`
 
 Extracts initials from the input string, typically for names or titles.
@@ -227,6 +243,22 @@ insertLineBreaksAfterPunctuation('Text.');
 
 ---
 
+### `isBalanced`
+
+Checks if both quotes and brackets are balanced in a string. A string is considered balanced when all double quotes have matching pairs (even count) and all brackets (parentheses, square brackets, curly braces) are properly matched and nested.
+
+#### Example:
+
+```javascript
+isBalanced('He said "Hello (world)!"');
+// Output: true
+
+isBalanced('He said "Hello (world!"');
+// Output: false (unbalanced quote)
+```
+
+---
+
 ### `isJsonStructureValid`
 
 Checks if a given string resembles a JSON object with numeric or quoted keys and values that are single or double quoted. Useful for detecting malformed JSON-like structures that can be fixed.
@@ -394,6 +426,22 @@ removeNumbersAndDashes('ABC 123-Xyz');
 
 ---
 
+### `removeRedundantPunctuation`
+
+Removes redundant punctuation marks that follow Arabic question marks or exclamation marks. This function cleans up text by removing periods (.) or Arabic commas (،) that immediately follow Arabic question marks (؟) or exclamation marks (!).
+
+#### Example:
+
+```javascript
+removeRedundantPunctuation('كيف حالك؟.');
+// Output: 'كيف حالك؟'
+
+removeRedundantPunctuation('ممتاز!،');
+// Output: 'ممتاز!'
+```
+
+---
+
 ### `removeSingleDigitReferences`
 
 Removes single digit references like (1), «2», [3] from the text.
@@ -433,15 +481,21 @@ removeSolitaryArabicLetters('ب ا الكلمات ت');
 
 ---
 
-### `removeTatwil`
+### `removeTatwil` (Updated)
 
-Removes tatweel characters from Arabic text while preserving the Hijri years.
+Removes tatweel characters while preserving dates references and numbered list items. Example: "1435/3/29 هـ" remains as "1435/3/29 هـ" but "أبـــتِـــكَةُ" becomes "أبتِكَةُ". Also preserves tatweels in numbered list items like "3 ـ item".
 
 #### Example:
 
 ```javascript
 removeTatwil('أبـــتِـــكَةُ');
 // Output: 'أبتِكَةُ'
+
+removeTatwil('1435/3/29 هـ');
+// Output: '1435/3/29 هـ' (unchanged)
+
+removeTatwil('3 ـ وشريط');
+// Output: '3 ـ وشريط' (unchanged)
 ```
 
 ---
@@ -470,6 +524,22 @@ replaceAlifMaqsurah('رؤيى');
 
 ---
 
+### `replaceDoubleBracketsWithArrows`
+
+Replaces double parentheses with single arrow quotation marks. Converts `((text))` format to `«text»` format, handling optional spaces inside the brackets.
+
+#### Example:
+
+```javascript
+replaceDoubleBracketsWithArrows('((text))');
+// Output: '«text»'
+
+replaceDoubleBracketsWithArrows('(( spaced text ))');
+// Output: '«spaced text»'
+```
+
+---
+
 ### `replaceEnglishPunctuationWithArabic`
 
 Replaces English punctuation marks (e.g., ? and ;) with their Arabic equivalents.
@@ -584,3 +654,57 @@ stripZeroWidthCharacters('يَخْلُوَ ‏.');
 ```
 
 ---
+
+### `truncate`
+
+Truncates a string to a specified length, adding an ellipsis if truncated.
+
+#### Example:
+
+```javascript
+truncate('The quick brown fox jumps over the lazy dog', 20);
+// Output: 'The quick brown fox…'
+
+truncate('Short text', 50);
+// Output: 'Short text'
+```
+
+---
+
+### `truncateMiddle`
+
+Truncates a string from the middle, preserving both the beginning and end portions.
+
+#### Example:
+
+```javascript
+truncateMiddle('The quick brown fox jumps right over the lazy dog', 20);
+// Output: 'The quick bro…zy dog'
+
+truncateMiddle('The quick brown fox jumps right over the lazy dog', 25, 8);
+// Output: 'The quick brown …lazy dog'
+
+truncateMiddle('Short text', 50);
+// Output: 'Short text'
+```
+
+---
+
+### `unescapeSpaces`
+
+Unescapes backslash-escaped spaces and trims whitespace from both ends. Commonly used to clean file paths that have been escaped when pasted into terminals.
+
+#### Example:
+
+```javascript
+unescapeSpaces('My\\ Folder\\ Name');
+// Output: 'My Folder Name'
+
+unescapeSpaces('  /path/to/My\\ Document.txt  ');
+// Output: '/path/to/My Document.txt'
+
+unescapeSpaces('regular text');
+// Output: 'regular text'
+```
+
+---

package/dist/index.d.ts

@@ -57,7 +57,7 @@ export const removeSingularCodes: (text: string) => string;
  */
 export const removeSolitaryArabicLetters: (text: string) => string;
 /**
- * Removes tatweel characters while preserving dates references.
+ * Removes tatweel characters while preserving dates references and numbered list items.
  * Example: "1435/3/29 هـ" remains as "1435/3/29 هـ" but "أبـــتِـــكَةُ" becomes "أبتِكَةُ"
  * @param text The text to format.
  * @returns The modified text with the tatweel characters removed.
@@ -224,6 +224,13 @@ export const condenseUnderscores: (text: string) => string;
  * @returns {string} - The modified text with condensed brackets.
  */
 export const doubleToSingleBrackets: (text: string) => string;
+/**
+ * Replaces double parentheses single a single arrow variation.
+ * Example: '((text))' becomes '«text»'.
+ * @param {string} text - The input text to apply the rule to.
+ * @returns {string} - The modified text with condensed brackets.
+ */
+export const replaceDoubleBracketsWithArrows: (text: string) => string;
 /**
  * Formats a multiline string by joining sentences and maintaining footnotes on their own lines.
  * Footnotes are identified by Arabic and English numerals.
@@ -246,6 +253,30 @@ export const normalizeSlashInReferences: (text: string) => string;
  * @returns {string} - The modified text with reduced spaces.
  */
 export const normalizeSpaces: (text: string) => string;
+/**
+ * Ensures at most 1 space exists before any word before brackets.
+ * Adds a space if there isn't one, or reduces multiple spaces to one.
+ * @param {string} text - The input text to modify
+ * @returns {string} - The modified text with proper spacing before brackets
+ */
+export const ensureSpaceBeforeBrackets: (text: string) => string;
+/**
+ * Removes redundant punctuation marks that follow Arabic question marks or exclamation marks.
+ * This function cleans up text by removing periods (.) or Arabic commas (،) that immediately
+ * follow Arabic question marks (؟) or exclamation marks (!), as they are considered redundant
+ * in proper Arabic punctuation.
+ *
+ * @param text - The Arabic text to clean up
+ * @returns The text with redundant punctuation removed
+ *
+ * @example
+ * ```typescript
+ * removeRedundantPunctuation('كيف حالك؟.') // Returns: 'كيف حالك؟'
+ * removeRedundantPunctuation('ممتاز!،') // Returns: 'ممتاز!'
+ * removeRedundantPunctuation('هذا جيد.') // Returns: 'هذا جيد.' (unchanged)
+ * ```
+ */
+export const removeRedundantPunctuation: (text: string) => string;
 /**
  * Removes spaces inside brackets, parentheses, or square brackets.
  * Example: '( a b )' becomes '(a b)'.
@@ -320,6 +351,27 @@ export const isJsonStructureValid: (str: string) => boolean;
  * console.log(result); // ["This is", "a part of the", "string and"]
  */
 export const splitByQuotes: (query: string) => string[];
+/**
+ * Checks if both quotes and brackets are balanced in a string.
+ * This function combines quote balance checking and bracket balance checking
+ * to ensure the entire string has properly balanced punctuation.
+ *
+ * A string is considered balanced when:
+ * - All double quotes have matching pairs (even count)
+ * - All brackets (parentheses, square brackets, curly braces) are properly matched and nested
+ *
+ * @param str - The string to check for balanced quotes and brackets
+ * @returns True if both quotes and brackets are balanced, false otherwise
+ *
+ * @example
+ * ```typescript
+ * isBalanced('He said "Hello (world)!"') // Returns: true
+ * isBalanced('He said "Hello (world!"') // Returns: false (unbalanced quote)
+ * isBalanced('He said "Hello (world)"') // Returns: false (unbalanced quote)
+ * isBalanced('Hello (world) [test]') // Returns: true
+ * ```
+ */
+export const isBalanced: (str: string) => boolean;
 /**
  * Removes various symbols, part references, and numerical markers from the text.
  * Example: '(1) (2/3)' becomes ''.
@@ -376,6 +428,64 @@ export const removeSingleDigitReferences: (text: string) => string;
  * @returns {string} - The modified text with URLs removed.
  */
 export const removeUrls: (text: string) => string;
+/**
+ * Truncates a string to a specified length, adding an ellipsis if truncated.
+ *
+ * @param val - The string to truncate
+ * @param n - Maximum length of the string (default: 150)
+ * @returns The truncated string with ellipsis if needed, otherwise the original string
+ *
+ * @example
+ * ```javascript
+ * truncate('The quick brown fox jumps over the lazy dog', 20);
+ * // Output: 'The quick brown fox…'
+ *
+ * truncate('Short text', 50);
+ * // Output: 'Short text'
+ * ```
+ */
+export const truncate: (val: string, n?: number) => string;
+/**
+ * Truncates a string from the middle, preserving both the beginning and end portions.
+ *
+ * @param text - The string to truncate
+ * @param maxLength - Maximum length of the resulting string (default: 50)
+ * @param endLength - Number of characters to preserve at the end (default: 1/3 of maxLength, minimum 3)
+ * @returns The truncated string with ellipsis in the middle if needed, otherwise the original string
+ *
+ * @example
+ * ```javascript
+ * truncateMiddle('The quick brown fox jumps right over the lazy dog', 20);
+ * // Output: 'The quick bro…zy dog'
+ *
+ * truncateMiddle('The quick brown fox jumps right over the lazy dog', 25, 8);
+ * // Output: 'The quick brown …lazy dog'
+ *
+ * truncateMiddle('Short text', 50);
+ * // Output: 'Short text'
+ * ```
+ */
+export const truncateMiddle: (text: string, maxLength?: number, endLength?: number) => string;
+/**
+ * Unescapes backslash-escaped spaces and trims whitespace from both ends.
+ * Commonly used to clean file paths that have been escaped when pasted into terminals.
+ *
+ * @param input - The string to unescape and clean
+ * @returns The cleaned string with escaped spaces converted to regular spaces and trimmed
+ *
+ * @example
+ * ```javascript
+ * unescapeSpaces('My\\ Folder\\ Name');
+ * // Output: 'My Folder Name'
+ *
+ * unescapeSpaces('  /path/to/My\\ Document.txt  ');
+ * // Output: '/path/to/My Document.txt'
+ *
+ * unescapeSpaces('regular text');
+ * // Output: 'regular text'
+ * ```
+ */
+export const unescapeSpaces: (input: string) => string;
 /**
  * Replaces common Arabic prefixes (like 'Al-', 'Ar-', 'Ash-', etc.) with 'al-' in the text.
  * Handles different variations of prefixes such as Ash- and Al- but not when the second word

package/dist/main.js

@@ -2,173 +2,182 @@
 function $parcel$export(e, n, v, s) {
   Object.defineProperty(e, n, {get: v, set: s, enumerable: true, configurable: true});
 }
-var $28624456cd7e4cb8$exports = {};
+var $798f85a7713a6ff1$exports = {};
 
-$parcel$export($28624456cd7e4cb8$exports, "cleanExtremeArabicUnderscores", () => $28624456cd7e4cb8$export$60dc7fb96c441688);
-$parcel$export($28624456cd7e4cb8$exports, "convertUrduSymbolsToArabic", () => $28624456cd7e4cb8$export$dcf00cfaf31fd188);
-$parcel$export($28624456cd7e4cb8$exports, "fixTrailingWow", () => $28624456cd7e4cb8$export$6c58e29008d10c1d);
-$parcel$export($28624456cd7e4cb8$exports, "addSpaceBetweenArabicTextAndNumbers", () => $28624456cd7e4cb8$export$cf81487e80b00e26);
-$parcel$export($28624456cd7e4cb8$exports, "stripEnglishCharactersAndSymbols", () => $28624456cd7e4cb8$export$df81ab2e9352ca65);
-$parcel$export($28624456cd7e4cb8$exports, "removeNonIndexSignatures", () => $28624456cd7e4cb8$export$d580a3cb14401529);
-$parcel$export($28624456cd7e4cb8$exports, "removeSingularCodes", () => $28624456cd7e4cb8$export$84d849da647fa2e5);
-$parcel$export($28624456cd7e4cb8$exports, "removeSolitaryArabicLetters", () => $28624456cd7e4cb8$export$7dedbc726019ed0f);
-$parcel$export($28624456cd7e4cb8$exports, "removeTatwil", () => $28624456cd7e4cb8$export$9571c9c2c203652d);
-$parcel$export($28624456cd7e4cb8$exports, "replaceTaMarbutahWithHa", () => $28624456cd7e4cb8$export$f95230335378ec58);
-$parcel$export($28624456cd7e4cb8$exports, "stripDiacritics", () => $28624456cd7e4cb8$export$b5bee4b27048330b);
-$parcel$export($28624456cd7e4cb8$exports, "stripZeroWidthCharacters", () => $28624456cd7e4cb8$export$8696bb09194c5fb5);
-$parcel$export($28624456cd7e4cb8$exports, "replaceAlifMaqsurah", () => $28624456cd7e4cb8$export$b1d6cb321dee12ad);
-$parcel$export($28624456cd7e4cb8$exports, "replaceEnglishPunctuationWithArabic", () => $28624456cd7e4cb8$export$db0c96cd03237332);
-$parcel$export($28624456cd7e4cb8$exports, "normalizeAlifVariants", () => $28624456cd7e4cb8$export$1d28b07894af8a98);
+$parcel$export($798f85a7713a6ff1$exports, "cleanExtremeArabicUnderscores", () => $798f85a7713a6ff1$export$60dc7fb96c441688);
+$parcel$export($798f85a7713a6ff1$exports, "convertUrduSymbolsToArabic", () => $798f85a7713a6ff1$export$dcf00cfaf31fd188);
+$parcel$export($798f85a7713a6ff1$exports, "fixTrailingWow", () => $798f85a7713a6ff1$export$6c58e29008d10c1d);
+$parcel$export($798f85a7713a6ff1$exports, "addSpaceBetweenArabicTextAndNumbers", () => $798f85a7713a6ff1$export$cf81487e80b00e26);
+$parcel$export($798f85a7713a6ff1$exports, "stripEnglishCharactersAndSymbols", () => $798f85a7713a6ff1$export$df81ab2e9352ca65);
+$parcel$export($798f85a7713a6ff1$exports, "removeNonIndexSignatures", () => $798f85a7713a6ff1$export$d580a3cb14401529);
+$parcel$export($798f85a7713a6ff1$exports, "removeSingularCodes", () => $798f85a7713a6ff1$export$84d849da647fa2e5);
+$parcel$export($798f85a7713a6ff1$exports, "removeSolitaryArabicLetters", () => $798f85a7713a6ff1$export$7dedbc726019ed0f);
+$parcel$export($798f85a7713a6ff1$exports, "removeTatwil", () => $798f85a7713a6ff1$export$9571c9c2c203652d);
+$parcel$export($798f85a7713a6ff1$exports, "replaceTaMarbutahWithHa", () => $798f85a7713a6ff1$export$f95230335378ec58);
+$parcel$export($798f85a7713a6ff1$exports, "stripDiacritics", () => $798f85a7713a6ff1$export$b5bee4b27048330b);
+$parcel$export($798f85a7713a6ff1$exports, "stripZeroWidthCharacters", () => $798f85a7713a6ff1$export$8696bb09194c5fb5);
+$parcel$export($798f85a7713a6ff1$exports, "replaceAlifMaqsurah", () => $798f85a7713a6ff1$export$b1d6cb321dee12ad);
+$parcel$export($798f85a7713a6ff1$exports, "replaceEnglishPunctuationWithArabic", () => $798f85a7713a6ff1$export$db0c96cd03237332);
+$parcel$export($798f85a7713a6ff1$exports, "normalizeAlifVariants", () => $798f85a7713a6ff1$export$1d28b07894af8a98);
 /**
  * Removes extreme Arabic underscores (ـ) that appear at the beginning or end of a line or in text.
  * Does not affect Hijri dates (e.g., 1424هـ) or specific Arabic terms.
  * Example: "ـThis is a textـ" will be changed to "This is a text".
  * @param {string} text - The input text to apply the rule to.
  * @returns {string} - The modified text with extreme underscores removed.
- */ const $28624456cd7e4cb8$export$60dc7fb96c441688 = (text)=>{
+ */ const $798f85a7713a6ff1$export$60dc7fb96c441688 = (text)=>{
     return text.replace(/(?<!\d ?ه|اه)ـ(?=\r?$)|^ـ(?!اهـ)/gm, '');
 };
-const $28624456cd7e4cb8$export$dcf00cfaf31fd188 = (text)=>{
+const $798f85a7713a6ff1$export$dcf00cfaf31fd188 = (text)=>{
     return text.replace(/ھ/g, "\u0647").replace(/ی/g, "\u064A");
 };
-const $28624456cd7e4cb8$export$6c58e29008d10c1d = (text)=>{
+const $798f85a7713a6ff1$export$6c58e29008d10c1d = (text)=>{
     return text.replace(/ و /g, " \u0648");
 };
-const $28624456cd7e4cb8$export$cf81487e80b00e26 = (text)=>{
+const $798f85a7713a6ff1$export$cf81487e80b00e26 = (text)=>{
     return text.replace(/([\u0600-\u06FF]+)(\d+)/g, '$1 $2');
 };
-const $28624456cd7e4cb8$export$df81ab2e9352ca65 = (text)=>{
+const $798f85a7713a6ff1$export$df81ab2e9352ca65 = (text)=>{
     return text.replace(/[a-zA-Z]+[0-9]*|[¬§`ﷺ=]|\/{2,}|&/g, ' ');
 };
-const $28624456cd7e4cb8$export$d580a3cb14401529 = (text)=>{
+const $798f85a7713a6ff1$export$d580a3cb14401529 = (text)=>{
     return text.replace(/(?<![0-9] ?)-|(?<=[\u0600-\u06FF])\s?\d\s?(?=[\u0600-\u06FF])/g, ' ').replace(/(?<=[\u0600-\u06FF]\s)(\d+\s)+\d+(?=(\s[\u0600-\u06FF]|$))/g, ' ');
 };
-const $28624456cd7e4cb8$export$84d849da647fa2e5 = (text)=>{
-    return text.replace(/[\[\({][\u0621-\u064A\u0660-\u0669][\]\)}]/g, '');
+const $798f85a7713a6ff1$export$84d849da647fa2e5 = (text)=>{
+    return text.replace(/[[({][\u0621-\u064A\u0660-\u0669][\])}]/g, '');
 };
-const $28624456cd7e4cb8$export$7dedbc726019ed0f = (text)=>{
+const $798f85a7713a6ff1$export$7dedbc726019ed0f = (text)=>{
     return text.replace(/(^| )[\u0621-\u064A]( |$)/g, ' ');
 };
-const $28624456cd7e4cb8$export$9571c9c2c203652d = (text)=>{
-    return text.replace(/(?<![0-9ه])ـ/g, '');
+const $798f85a7713a6ff1$export$9571c9c2c203652d = (text)=>{
+    // Don't remove tatweel if:
+    // 1. Immediately preceded by a number or ه (for dates like "1435هـ")
+    // 2. Preceded by a number with optional spaces (for list items like "3 ـ")
+    return text.replace(/(?<![0-9ه])(?<![0-9]\s*)ـ/g, '');
 };
-const $28624456cd7e4cb8$export$f95230335378ec58 = (text)=>{
+const $798f85a7713a6ff1$export$f95230335378ec58 = (text)=>{
     return text.replace(/[ة]/g, "\u0647");
 };
-const $28624456cd7e4cb8$export$b5bee4b27048330b = (text)=>{
+const $798f85a7713a6ff1$export$b5bee4b27048330b = (text)=>{
     return text.replace(/[\u0610\u0611\u0612\u0613\u0614\u0615\u0616\u0617\u0618\u0619\u061A\u064B\u064C\u064D\u064E\u064F\u0650\u0651\u0652\u0653\u0654\u0655\u0656\u0657\u0658\u065A\u065B\u065C\u065D\u065E\u0640]/g, '');
 };
-const $28624456cd7e4cb8$export$8696bb09194c5fb5 = (text)=>{
+const $798f85a7713a6ff1$export$8696bb09194c5fb5 = (text)=>{
     return text.replace(/[\u200B-\u200F\u202A-\u202E\u2060-\u2064\uFEFF]/g, ' ');
 };
-const $28624456cd7e4cb8$export$b1d6cb321dee12ad = (text)=>{
+const $798f85a7713a6ff1$export$b1d6cb321dee12ad = (text)=>{
     return text.replace(/[ىي]/g, "\u064A");
 };
-const $28624456cd7e4cb8$export$db0c96cd03237332 = (text)=>{
+const $798f85a7713a6ff1$export$db0c96cd03237332 = (text)=>{
     return text.replace(/\?|؟\./g, "\u061F").replace(/(;|؛)\s*(\1\s*)*/g, "\u061B").replace(/,|-،/g, "\u060C");
 };
-const $28624456cd7e4cb8$export$1d28b07894af8a98 = (text)=>{
+const $798f85a7713a6ff1$export$1d28b07894af8a98 = (text)=>{
     return text.replace(/[أإآ]/g, "\u0627");
 };
 
 
-var $f4495ebb65d3b1e0$exports = {};
+var $86c5c45def76a44f$exports = {};
 
-$parcel$export($f4495ebb65d3b1e0$exports, "insertLineBreaksAfterPunctuation", () => $f4495ebb65d3b1e0$export$814bebc253f2e5df);
-$parcel$export($f4495ebb65d3b1e0$exports, "addSpaceBeforeAndAfterPunctuation", () => $f4495ebb65d3b1e0$export$f0306841cd6b95d5);
-$parcel$export($f4495ebb65d3b1e0$exports, "applySmartQuotes", () => $f4495ebb65d3b1e0$export$42f47e081bfe828c);
-$parcel$export($f4495ebb65d3b1e0$exports, "cleanLiteralNewLines", () => $f4495ebb65d3b1e0$export$b4922cc8c111eae2);
-$parcel$export($f4495ebb65d3b1e0$exports, "cleanMultilines", () => $f4495ebb65d3b1e0$export$95680a0d9bdd5dba);
-$parcel$export($f4495ebb65d3b1e0$exports, "hasWordInSingleLine", () => $f4495ebb65d3b1e0$export$20a121a9317a6ed4);
-$parcel$export($f4495ebb65d3b1e0$exports, "isOnlyPunctuation", () => $f4495ebb65d3b1e0$export$d936e191dd6a8e06);
-$parcel$export($f4495ebb65d3b1e0$exports, "cleanJunkFromText", () => $f4495ebb65d3b1e0$export$38e1db3c2502e6cc);
-$parcel$export($f4495ebb65d3b1e0$exports, "cleanSpacesBeforePeriod", () => $f4495ebb65d3b1e0$export$e65ff0050dc4971d);
-$parcel$export($f4495ebb65d3b1e0$exports, "condenseAsterisks", () => $f4495ebb65d3b1e0$export$6e89dcbda2f1dcad);
-$parcel$export($f4495ebb65d3b1e0$exports, "condenseColons", () => $f4495ebb65d3b1e0$export$64ee6721b5d4cefa);
-$parcel$export($f4495ebb65d3b1e0$exports, "condenseDashes", () => $f4495ebb65d3b1e0$export$9f873c000de6f69a);
-$parcel$export($f4495ebb65d3b1e0$exports, "condenseEllipsis", () => $f4495ebb65d3b1e0$export$35abf980a52dfe44);
-$parcel$export($f4495ebb65d3b1e0$exports, "reduceMultilineBreaksToDouble", () => $f4495ebb65d3b1e0$export$660f127778d3db20);
-$parcel$export($f4495ebb65d3b1e0$exports, "reduceMultilineBreaksToSingle", () => $f4495ebb65d3b1e0$export$7b984b558843c423);
-$parcel$export($f4495ebb65d3b1e0$exports, "condensePeriods", () => $f4495ebb65d3b1e0$export$3468167fbf4483d7);
-$parcel$export($f4495ebb65d3b1e0$exports, "condenseUnderscores", () => $f4495ebb65d3b1e0$export$a299139a27d861bb);
-$parcel$export($f4495ebb65d3b1e0$exports, "doubleToSingleBrackets", () => $f4495ebb65d3b1e0$export$55102718dfa8db7e);
-$parcel$export($f4495ebb65d3b1e0$exports, "formatStringBySentence", () => $f4495ebb65d3b1e0$export$748703bb362bd52c);
-$parcel$export($f4495ebb65d3b1e0$exports, "normalizeSlashInReferences", () => $f4495ebb65d3b1e0$export$9027754b4b9f4cf4);
-$parcel$export($f4495ebb65d3b1e0$exports, "normalizeSpaces", () => $f4495ebb65d3b1e0$export$85f748ccc2d3e888);
-$parcel$export($f4495ebb65d3b1e0$exports, "removeSpaceInsideBrackets", () => $f4495ebb65d3b1e0$export$6726e05a22c5d4c9);
-$parcel$export($f4495ebb65d3b1e0$exports, "stripBoldStyling", () => $f4495ebb65d3b1e0$export$6db2c5d62fd5ffe9);
-$parcel$export($f4495ebb65d3b1e0$exports, "stripItalicsStyling", () => $f4495ebb65d3b1e0$export$9340b5fbcad6fe5a);
-$parcel$export($f4495ebb65d3b1e0$exports, "stripStyling", () => $f4495ebb65d3b1e0$export$e166e222302a97bd);
-$parcel$export($f4495ebb65d3b1e0$exports, "trimSpaceInsideQuotes", () => $f4495ebb65d3b1e0$export$eedf7f8c32995e56);
+$parcel$export($86c5c45def76a44f$exports, "insertLineBreaksAfterPunctuation", () => $86c5c45def76a44f$export$814bebc253f2e5df);
+$parcel$export($86c5c45def76a44f$exports, "addSpaceBeforeAndAfterPunctuation", () => $86c5c45def76a44f$export$f0306841cd6b95d5);
+$parcel$export($86c5c45def76a44f$exports, "applySmartQuotes", () => $86c5c45def76a44f$export$42f47e081bfe828c);
+$parcel$export($86c5c45def76a44f$exports, "cleanLiteralNewLines", () => $86c5c45def76a44f$export$b4922cc8c111eae2);
+$parcel$export($86c5c45def76a44f$exports, "cleanMultilines", () => $86c5c45def76a44f$export$95680a0d9bdd5dba);
+$parcel$export($86c5c45def76a44f$exports, "hasWordInSingleLine", () => $86c5c45def76a44f$export$20a121a9317a6ed4);
+$parcel$export($86c5c45def76a44f$exports, "isOnlyPunctuation", () => $86c5c45def76a44f$export$d936e191dd6a8e06);
+$parcel$export($86c5c45def76a44f$exports, "cleanJunkFromText", () => $86c5c45def76a44f$export$38e1db3c2502e6cc);
+$parcel$export($86c5c45def76a44f$exports, "cleanSpacesBeforePeriod", () => $86c5c45def76a44f$export$e65ff0050dc4971d);
+$parcel$export($86c5c45def76a44f$exports, "condenseAsterisks", () => $86c5c45def76a44f$export$6e89dcbda2f1dcad);
+$parcel$export($86c5c45def76a44f$exports, "condenseColons", () => $86c5c45def76a44f$export$64ee6721b5d4cefa);
+$parcel$export($86c5c45def76a44f$exports, "condenseDashes", () => $86c5c45def76a44f$export$9f873c000de6f69a);
+$parcel$export($86c5c45def76a44f$exports, "condenseEllipsis", () => $86c5c45def76a44f$export$35abf980a52dfe44);
+$parcel$export($86c5c45def76a44f$exports, "reduceMultilineBreaksToDouble", () => $86c5c45def76a44f$export$660f127778d3db20);
+$parcel$export($86c5c45def76a44f$exports, "reduceMultilineBreaksToSingle", () => $86c5c45def76a44f$export$7b984b558843c423);
+$parcel$export($86c5c45def76a44f$exports, "condensePeriods", () => $86c5c45def76a44f$export$3468167fbf4483d7);
+$parcel$export($86c5c45def76a44f$exports, "condenseUnderscores", () => $86c5c45def76a44f$export$a299139a27d861bb);
+$parcel$export($86c5c45def76a44f$exports, "doubleToSingleBrackets", () => $86c5c45def76a44f$export$55102718dfa8db7e);
+$parcel$export($86c5c45def76a44f$exports, "replaceDoubleBracketsWithArrows", () => $86c5c45def76a44f$export$803cc4592448c009);
+$parcel$export($86c5c45def76a44f$exports, "formatStringBySentence", () => $86c5c45def76a44f$export$748703bb362bd52c);
+$parcel$export($86c5c45def76a44f$exports, "normalizeSlashInReferences", () => $86c5c45def76a44f$export$9027754b4b9f4cf4);
+$parcel$export($86c5c45def76a44f$exports, "normalizeSpaces", () => $86c5c45def76a44f$export$85f748ccc2d3e888);
+$parcel$export($86c5c45def76a44f$exports, "ensureSpaceBeforeBrackets", () => $86c5c45def76a44f$export$5c77851c03e0da0a);
+$parcel$export($86c5c45def76a44f$exports, "removeRedundantPunctuation", () => $86c5c45def76a44f$export$a97ebab70a927fe1);
+$parcel$export($86c5c45def76a44f$exports, "removeSpaceInsideBrackets", () => $86c5c45def76a44f$export$6726e05a22c5d4c9);
+$parcel$export($86c5c45def76a44f$exports, "stripBoldStyling", () => $86c5c45def76a44f$export$6db2c5d62fd5ffe9);
+$parcel$export($86c5c45def76a44f$exports, "stripItalicsStyling", () => $86c5c45def76a44f$export$9340b5fbcad6fe5a);
+$parcel$export($86c5c45def76a44f$exports, "stripStyling", () => $86c5c45def76a44f$export$e166e222302a97bd);
+$parcel$export($86c5c45def76a44f$exports, "trimSpaceInsideQuotes", () => $86c5c45def76a44f$export$eedf7f8c32995e56);
 /**
  * Adds line breaks after punctuation marks such as periods, exclamation points, and question marks.
  * Example: 'Text.' becomes 'Text.\n'.
  * @param {string} text - The input text containing punctuation.
  * @returns {string} - The modified text with line breaks added after punctuation.
- */ const $f4495ebb65d3b1e0$export$814bebc253f2e5df = (text)=>{
+ */ const $86c5c45def76a44f$export$814bebc253f2e5df = (text)=>{
     // Define the punctuation marks that should trigger a new line
     const punctuation = /([.?!؟])/g;
     // Replace occurrences of punctuation marks followed by a space with the punctuation mark, a newline, and the space
     const formattedText = text.replace(punctuation, '$1\n').replace(/\n\s+/g, '\n').trim();
     return formattedText;
 };
-const $f4495ebb65d3b1e0$export$f0306841cd6b95d5 = (text)=>{
-    return text.replace(/( ?)([.!?,،؟;؛])((?![ '”“\)"\]\n])|(?=\s{2,}))/g, '$1$2 ').replace(/\s([.!?,،؟;؛])\s*([ '”“\)"\]\n])/g, '$1$2').replace(/([^\s\w\d'”“\)"\]]+)\s+([.!?,،؟;؛])|([.!?,،؟;؛])\s+$/g, '$1$2$3').replace(/(?<=\D)( ?: ?)(?!(\d+:)|(:\d+))|(?<=\d) ?: ?(?=\D)|(?<=\D) ?: ?(?=\d)/g, ': ');
+const $86c5c45def76a44f$export$f0306841cd6b95d5 = (text)=>{
+    return text.replace(/( ?)([.!?,،؟;؛])((?![ '”“)"\]\n])|(?=\s{2,}))/g, '$1$2 ').replace(/\s([.!?,،؟;؛])\s*([ '”“)"\]\n])/g, '$1$2').replace(/([^\s\w\d'”“)"\]]+)\s+([.!?,،؟;؛])|([.!?,،؟;؛])\s+$/g, '$1$2$3').replace(/(?<=\D)( ?: ?)(?!(\d+:)|(:\d+))|(?<=\d) ?: ?(?=\D)|(?<=\D) ?: ?(?=\d)/g, ': ');
 };
-const $f4495ebb65d3b1e0$export$42f47e081bfe828c = (text)=>{
+const $86c5c45def76a44f$export$42f47e081bfe828c = (text)=>{
     return text.replace(/[“”]/g, '"').replace(/"([^"]*)"/g, "\u201C$1\u201D").replace(/^”/g, "\u201C");
 };
-const $f4495ebb65d3b1e0$export$b4922cc8c111eae2 = (text)=>{
+const $86c5c45def76a44f$export$b4922cc8c111eae2 = (text)=>{
     return text.replace(/\\n|\r/g, '\n');
 };
-const $f4495ebb65d3b1e0$export$95680a0d9bdd5dba = (text)=>{
+const $86c5c45def76a44f$export$95680a0d9bdd5dba = (text)=>{
     return text.replace(/^ +| +$/gm, '');
 };
-const $f4495ebb65d3b1e0$export$20a121a9317a6ed4 = (text)=>{
+const $86c5c45def76a44f$export$20a121a9317a6ed4 = (text)=>{
     return /^\s*\S+\s*$/gm.test(text);
 };
-const $f4495ebb65d3b1e0$export$d936e191dd6a8e06 = (text)=>{
+const $86c5c45def76a44f$export$d936e191dd6a8e06 = (text)=>{
     const regex = /^[\u0020-\u002f\u003a-\u0040\u005b-\u0060\u007b-\u007e0-9٠-٩]+$/;
     return regex.test(text);
 };
-const $f4495ebb65d3b1e0$export$38e1db3c2502e6cc = (text)=>{
-    const newBody = $f4495ebb65d3b1e0$export$95680a0d9bdd5dba(text);
+const $86c5c45def76a44f$export$38e1db3c2502e6cc = (text)=>{
+    const newBody = $86c5c45def76a44f$export$95680a0d9bdd5dba(text);
     const lines = newBody.split('\n').filter((line)=>{
-        return !line || line.length > 1 && !$f4495ebb65d3b1e0$export$d936e191dd6a8e06(line);
+        return !line || line.length > 1 && !$86c5c45def76a44f$export$d936e191dd6a8e06(line);
     });
     return lines.join('\n').trim();
 };
-const $f4495ebb65d3b1e0$export$e65ff0050dc4971d = (text)=>{
+const $86c5c45def76a44f$export$e65ff0050dc4971d = (text)=>{
     return text.replace(/\s+([.؟!,،؛:?])/g, '$1');
 };
-const $f4495ebb65d3b1e0$export$6e89dcbda2f1dcad = (text)=>{
+const $86c5c45def76a44f$export$6e89dcbda2f1dcad = (text)=>{
     return text.replace(/(\*\s*)+/g, '*');
 };
-const $f4495ebb65d3b1e0$export$64ee6721b5d4cefa = (text)=>{
-    return text.replace(/[\.-]?:[\.-]?/g, ':');
+const $86c5c45def76a44f$export$64ee6721b5d4cefa = (text)=>{
+    return text.replace(/[.-]?:[.-]?/g, ':');
 };
-const $f4495ebb65d3b1e0$export$9f873c000de6f69a = (text)=>{
+const $86c5c45def76a44f$export$9f873c000de6f69a = (text)=>{
     return text.replace(/-{2,}/g, '-');
 };
-const $f4495ebb65d3b1e0$export$35abf980a52dfe44 = (text)=>{
+const $86c5c45def76a44f$export$35abf980a52dfe44 = (text)=>{
     return text.replace(/\.{2,}/g, "\u2026");
 };
-const $f4495ebb65d3b1e0$export$660f127778d3db20 = (text)=>{
+const $86c5c45def76a44f$export$660f127778d3db20 = (text)=>{
     return text.replace(/(\n\s*){3,}/g, '\n\n');
 };
-const $f4495ebb65d3b1e0$export$7b984b558843c423 = (text)=>{
+const $86c5c45def76a44f$export$7b984b558843c423 = (text)=>{
     return text.replace(/(\n\s*){2,}/g, '\n');
 };
-const $f4495ebb65d3b1e0$export$3468167fbf4483d7 = (text)=>{
+const $86c5c45def76a44f$export$3468167fbf4483d7 = (text)=>{
     return text.replace(/\. +\./g, '.');
 };
-const $f4495ebb65d3b1e0$export$a299139a27d861bb = (text)=>{
+const $86c5c45def76a44f$export$a299139a27d861bb = (text)=>{
     return text.replace(/ـ{2,}/g, "\u0640").replace(/_+/g, '_');
 };
-const $f4495ebb65d3b1e0$export$55102718dfa8db7e = (text)=>{
+const $86c5c45def76a44f$export$55102718dfa8db7e = (text)=>{
     return text.replace(/(\(|\)){2,}|(\[|\]){2,}/g, '$1$2');
 };
-const $f4495ebb65d3b1e0$export$748703bb362bd52c = (input)=>{
+const $86c5c45def76a44f$export$803cc4592448c009 = (text)=>{
+    return text.replace(/\(\(\s?/g, "\xab").replace(/\s?\)\)/g, "\xbb");
+};
+const $86c5c45def76a44f$export$748703bb362bd52c = (input)=>{
     const footnoteRegex = /^\((?:\d+|۱|۲|۳|۴|۵|۶|۷|۸|۹)\)\s/;
     const sentences = [];
     const lines = input.split('\n');
@@ -196,37 +205,43 @@ const $f4495ebb65d3b1e0$export$748703bb362bd52c = (input)=>{
     if (currentSentence) sentences.push(currentSentence.trim());
     return sentences.join('\n');
 };
-const $f4495ebb65d3b1e0$export$9027754b4b9f4cf4 = (text)=>{
+const $86c5c45def76a44f$export$9027754b4b9f4cf4 = (text)=>{
     return text.replace(/(\d+)\s?\/\s?(\d+)/g, '$1/$2');
 };
-const $f4495ebb65d3b1e0$export$85f748ccc2d3e888 = (text)=>{
+const $86c5c45def76a44f$export$85f748ccc2d3e888 = (text)=>{
     return text.replace(/[ \t]+/g, ' ');
 };
-const $f4495ebb65d3b1e0$export$6726e05a22c5d4c9 = (text)=>{
-    return text.replace(/([\[\(])\s*(.*?)\s*([\]\)])/g, '$1$2$3');
+const $86c5c45def76a44f$export$5c77851c03e0da0a = (text)=>{
+    return text.replace(/(\S) *(\([^)]*\))/g, '$1 $2');
+};
+const $86c5c45def76a44f$export$a97ebab70a927fe1 = (text)=>{
+    return text.replace(/([؟!])[.،]/g, '$1');
 };
-const $f4495ebb65d3b1e0$export$6db2c5d62fd5ffe9 = (text)=>{
+const $86c5c45def76a44f$export$6726e05a22c5d4c9 = (text)=>{
+    return text.replace(/([[(])\s*(.*?)\s*([\])])/g, '$1$2$3');
+};
+const $86c5c45def76a44f$export$6db2c5d62fd5ffe9 = (text)=>{
     // Normalize the string to NFKD form
     const normalizedString = text.normalize('NFKD');
     // Remove combining marks (diacritics) and stylistic characters from the string
     return normalizedString.replace(/[\u0300-\u036f]/g, '').trim();
 };
-const $f4495ebb65d3b1e0$export$9340b5fbcad6fe5a = (text)=>{
+const $86c5c45def76a44f$export$9340b5fbcad6fe5a = (text)=>{
     const italicMap = {
         '\uD835\uDC4E': 'I',
         '\uD835\uDC68': 'g',
-        '\u{1D63C}': '!',
+        "\uD835\uDE3C": '!',
         '\uD835\uDC4F': 'J',
         '\uD835\uDC69': 'h',
-        '\u{1D63D}': '?',
+        "\uD835\uDE3D": '?',
         '\uD835\uDC50': 'K',
         '\uD835\uDC6A': 'i',
         '\uD835\uDC51': 'L',
         '\uD835\uDC6B': 'j',
-        '\u{1D63F}': ',',
+        "\uD835\uDE3F": ',',
         '\uD835\uDC52': 'M',
         '\uD835\uDC6C': 'k',
-        '\u{1D640}': '.',
+        "\uD835\uDE40": '.',
         '\uD835\uDC53': 'N',
         '\uD835\uDC6D': 'l',
         '\uD835\uDC54': 'O',
@@ -240,7 +255,7 @@ const $f4495ebb65d3b1e0$export$9340b5fbcad6fe5a = (text)=>{
         '\uD835\uDC72': 'q',
         '\uD835\uDC59': 'T',
         '\uD835\uDC73': 'r',
-        '\u{1D647}': '-',
+        "\uD835\uDE47": '-',
         '\uD835\uDC5A': 'U',
         '\uD835\uDC74': 's',
         '\uD835\uDC5B': 'V',
@@ -275,19 +290,20 @@ const $f4495ebb65d3b1e0$export$9340b5fbcad6fe5a = (text)=>{
         return italicMap[match] || match;
     });
 };
-const $f4495ebb65d3b1e0$export$e166e222302a97bd = (text)=>{
-    return $f4495ebb65d3b1e0$export$9340b5fbcad6fe5a($f4495ebb65d3b1e0$export$6db2c5d62fd5ffe9(text));
+const $86c5c45def76a44f$export$e166e222302a97bd = (text)=>{
+    return $86c5c45def76a44f$export$9340b5fbcad6fe5a($86c5c45def76a44f$export$6db2c5d62fd5ffe9(text));
 };
-const $f4495ebb65d3b1e0$export$eedf7f8c32995e56 = (text)=>{
+const $86c5c45def76a44f$export$eedf7f8c32995e56 = (text)=>{
     return text.replace(/([“”"]|«) *(.*?) *([“”"]|»)/g, '$1$2$3');
 };
 
 
-var $0a00bc254018888e$exports = {};
+var $045191e51bf3eda2$exports = {};
 
-$parcel$export($0a00bc254018888e$exports, "normalizeJsonSyntax", () => $0a00bc254018888e$export$62c7e2fbc3880e40);
-$parcel$export($0a00bc254018888e$exports, "isJsonStructureValid", () => $0a00bc254018888e$export$70726570eaa51acb);
-$parcel$export($0a00bc254018888e$exports, "splitByQuotes", () => $0a00bc254018888e$export$ae2dc619900afbaa);
+$parcel$export($045191e51bf3eda2$exports, "normalizeJsonSyntax", () => $045191e51bf3eda2$export$62c7e2fbc3880e40);
+$parcel$export($045191e51bf3eda2$exports, "isJsonStructureValid", () => $045191e51bf3eda2$export$70726570eaa51acb);
+$parcel$export($045191e51bf3eda2$exports, "splitByQuotes", () => $045191e51bf3eda2$export$ae2dc619900afbaa);
+$parcel$export($045191e51bf3eda2$exports, "isBalanced", () => $045191e51bf3eda2$export$1e23eb8d8fab7cc);
 /**
  * Converts a string that resembles JSON but with numeric keys and single-quoted values
  * into valid JSON format. This function replaces numeric keys with quoted numeric keys
@@ -299,96 +315,181 @@ $parcel$export($0a00bc254018888e$exports, "splitByQuotes", () => $0a00bc25401888
  * @example
  * const result = normalizeJsonSyntax("{10: 'abc', 20: 'def'}");
  * console.log(result); // '{"10": "abc", "20": "def"}'
- */ const $0a00bc254018888e$export$62c7e2fbc3880e40 = (str)=>{
+ */ const $045191e51bf3eda2$export$62c7e2fbc3880e40 = (str)=>{
     let input = str.replace(/(\b\d+\b)(?=:)/g, '"$1"');
     input = input.replace(/:\s*'([^']+)'/g, ': "$1"');
     input = input.replace(/:\s*"([^"]+)"/g, ': "$1"');
     return JSON.stringify(JSON.parse(input));
 };
-const $0a00bc254018888e$export$70726570eaa51acb = (str)=>{
+const $045191e51bf3eda2$export$70726570eaa51acb = (str)=>{
     // Checks for a pattern with numeric keys or quoted keys and values in quotes
     const jsonLikePattern = /^{(\s*(\d+|'[^']*'|"[^"]*")\s*:\s*('|")[^'"]*\3\s*,)*(?:\s*(\d+|'[^']*'|"[^"]*")\s*:\s*('|")[^'"]*\5\s*)}$/;
     return jsonLikePattern.test(str.trim());
 };
-const $0a00bc254018888e$export$ae2dc619900afbaa = (query)=>{
+const $045191e51bf3eda2$export$ae2dc619900afbaa = (query)=>{
     const regex = /(?:[^\s"]+|"(.*?)")+/g;
     return (query.match(regex) || []).map((s)=>s.startsWith('"') ? s.slice(1, -1) : s);
 };
+/**
+ * Checks if all double quotes in a string are balanced (even count).
+ * A string has balanced quotes if every opening quote has a corresponding closing quote.
+ *
+ * @param str - The string to check for balanced quotes
+ * @returns True if quotes are balanced (even count), false otherwise
+ *
+ * @example
+ * ```typescript
+ * areQuotesBalanced('Hello "world"') // Returns: true
+ * areQuotesBalanced('Hello "world') // Returns: false
+ * areQuotesBalanced('No quotes') // Returns: true
+ * ```
+ */ const $045191e51bf3eda2$var$areQuotesBalanced = (str)=>{
+    let quoteCount = 0;
+    for (const char of str)if (char === '"') quoteCount++;
+    return quoteCount % 2 === 0;
+};
+const $045191e51bf3eda2$var$brackets = {
+    '(': ')',
+    '[': ']',
+    '{': '}'
+};
+const $045191e51bf3eda2$var$openBrackets = new Set([
+    '(',
+    '[',
+    '{'
+]);
+const $045191e51bf3eda2$var$closeBrackets = new Set([
+    ')',
+    ']',
+    '}'
+]);
+/**
+ * Checks if all brackets in a string are properly balanced and matched.
+ * This function validates that every opening bracket has a corresponding closing bracket
+ * in the correct order and of the matching type.
+ *
+ * Supported bracket types: parentheses (), square brackets [], curly braces {}
+ *
+ * @param str - The string to check for balanced brackets
+ * @returns True if all brackets are properly balanced and matched, false otherwise
+ *
+ * @example
+ * ```typescript
+ * areBracketsBalanced('(hello [world])') // Returns: true
+ * areBracketsBalanced('(hello [world)') // Returns: false (mismatched)
+ * areBracketsBalanced('((hello))') // Returns: true
+ * areBracketsBalanced('(hello') // Returns: false (unclosed)
+ * ```
+ */ const $045191e51bf3eda2$var$areBracketsBalanced = (str)=>{
+    const stack = [];
+    for (const char of str){
+        if ($045191e51bf3eda2$var$openBrackets.has(char)) stack.push(char);
+        else if ($045191e51bf3eda2$var$closeBrackets.has(char)) {
+            const lastOpen = stack.pop();
+            if (!lastOpen || $045191e51bf3eda2$var$brackets[lastOpen] !== char) return false;
+        }
+    }
+    return stack.length === 0;
+};
+const $045191e51bf3eda2$export$1e23eb8d8fab7cc = (str)=>{
+    return $045191e51bf3eda2$var$areQuotesBalanced(str) && $045191e51bf3eda2$var$areBracketsBalanced(str);
+};
 
 
-var $1f25f0941eacce7f$exports = {};
+var $15eb38b546e8440a$exports = {};
 
-$parcel$export($1f25f0941eacce7f$exports, "cleanSymbolsAndPartReferences", () => $1f25f0941eacce7f$export$70476c4e7ef0b147);
-$parcel$export($1f25f0941eacce7f$exports, "cleanTrailingPageNumbers", () => $1f25f0941eacce7f$export$9f81734a6223638b);
-$parcel$export($1f25f0941eacce7f$exports, "replaceLineBreaksWithSpaces", () => $1f25f0941eacce7f$export$631d05f860fc7118);
-$parcel$export($1f25f0941eacce7f$exports, "stripAllDigits", () => $1f25f0941eacce7f$export$edd6c3bb8fa3bc01);
-$parcel$export($1f25f0941eacce7f$exports, "removeDeathYear", () => $1f25f0941eacce7f$export$a537ffbd78859923);
-$parcel$export($1f25f0941eacce7f$exports, "removeNumbersAndDashes", () => $1f25f0941eacce7f$export$c8e7d4d7d9f46256);
-$parcel$export($1f25f0941eacce7f$exports, "removeSingleDigitReferences", () => $1f25f0941eacce7f$export$8e7f001aa315ad82);
-$parcel$export($1f25f0941eacce7f$exports, "removeUrls", () => $1f25f0941eacce7f$export$e4a0bb7881a4591a);
+$parcel$export($15eb38b546e8440a$exports, "cleanSymbolsAndPartReferences", () => $15eb38b546e8440a$export$70476c4e7ef0b147);
+$parcel$export($15eb38b546e8440a$exports, "cleanTrailingPageNumbers", () => $15eb38b546e8440a$export$9f81734a6223638b);
+$parcel$export($15eb38b546e8440a$exports, "replaceLineBreaksWithSpaces", () => $15eb38b546e8440a$export$631d05f860fc7118);
+$parcel$export($15eb38b546e8440a$exports, "stripAllDigits", () => $15eb38b546e8440a$export$edd6c3bb8fa3bc01);
+$parcel$export($15eb38b546e8440a$exports, "removeDeathYear", () => $15eb38b546e8440a$export$a537ffbd78859923);
+$parcel$export($15eb38b546e8440a$exports, "removeNumbersAndDashes", () => $15eb38b546e8440a$export$c8e7d4d7d9f46256);
+$parcel$export($15eb38b546e8440a$exports, "removeSingleDigitReferences", () => $15eb38b546e8440a$export$8e7f001aa315ad82);
+$parcel$export($15eb38b546e8440a$exports, "removeUrls", () => $15eb38b546e8440a$export$e4a0bb7881a4591a);
+$parcel$export($15eb38b546e8440a$exports, "truncate", () => $15eb38b546e8440a$export$6a506b36fdea397d);
+$parcel$export($15eb38b546e8440a$exports, "truncateMiddle", () => $15eb38b546e8440a$export$f3a88d5244308057);
+$parcel$export($15eb38b546e8440a$exports, "unescapeSpaces", () => $15eb38b546e8440a$export$1791d17c7d9c448);
 /**
  * Removes various symbols, part references, and numerical markers from the text.
  * Example: '(1) (2/3)' becomes ''.
  * @param {string} text - The input text to apply the rule to.
  * @returns {string} - The modified text with symbols and part references removed.
- */ const $1f25f0941eacce7f$export$70476c4e7ef0b147 = (text)=>{
-    return text.replace(/ *\(?:\d+(?:\/\d+){0,2}\)? *| *\[\d+(?:\/\d+)?\] *| *«\d+» *|\d+\/\d+(?:\/\d+)?|[،§{}۝؍‎﴿﴾<>;_؟»«:!،؛\[\]…ـ¬\.\\\/\*\(\)"]/g, ' ');
+ */ const $15eb38b546e8440a$export$70476c4e7ef0b147 = (text)=>{
+    return text.replace(/ *\(?:\d+(?:\/\d+){0,2}\)? *| *\[\d+(?:\/\d+)?\] *| *«\d+» *|\d+\/\d+(?:\/\d+)?|[،§{}۝؍‎﴿﴾<>;_؟»«:!،؛[\]…ـ¬.\\/*()"]/g, ' ');
 };
-const $1f25f0941eacce7f$export$9f81734a6223638b = (text)=>{
+const $15eb38b546e8440a$export$9f81734a6223638b = (text)=>{
     return text.replace(/-\[\d+\]-/g, '');
 };
-const $1f25f0941eacce7f$export$631d05f860fc7118 = (text)=>{
+const $15eb38b546e8440a$export$631d05f860fc7118 = (text)=>{
     return text.replace(/\s+/g, ' ');
 };
-const $1f25f0941eacce7f$export$edd6c3bb8fa3bc01 = (text)=>{
+const $15eb38b546e8440a$export$edd6c3bb8fa3bc01 = (text)=>{
     return text.replace(/[0-9]/g, '');
 };
-const $1f25f0941eacce7f$export$a537ffbd78859923 = (text)=>{
+const $15eb38b546e8440a$export$a537ffbd78859923 = (text)=>{
     return text.replace(/\[(d)\.\s*\d{1,4}[hH]\]\s*|\((d)\.\s*\d{1,4}[hH]\)\s*/g, '');
 };
-const $1f25f0941eacce7f$export$c8e7d4d7d9f46256 = (text)=>{
+const $15eb38b546e8440a$export$c8e7d4d7d9f46256 = (text)=>{
     return text.replace(/[\d-]/g, '');
 };
-const $1f25f0941eacce7f$export$8e7f001aa315ad82 = (text)=>{
+const $15eb38b546e8440a$export$8e7f001aa315ad82 = (text)=>{
     return text.replace(/\(\d{1}\)|\[\d{1}\]|«\d»/g, '');
 };
-const $1f25f0941eacce7f$export$e4a0bb7881a4591a = (text)=>{
+const $15eb38b546e8440a$export$e4a0bb7881a4591a = (text)=>{
     return text.replace(/https?:\/\/(www\.)?[-a-zA-Z0-9@:%._+~#=]{1,256}\.[a-zA-Z0-9()]{1,6}\b([-a-zA-Z0-9()@:%_+.~#?&//=]*)/g, '');
 };
+const $15eb38b546e8440a$export$6a506b36fdea397d = (val, n = 150)=>val.length > n ? `${val.substring(0, n - 1)}\u{2026}` : val;
+const $15eb38b546e8440a$export$f3a88d5244308057 = (text, maxLength = 50, endLength)=>{
+    if (text.length <= maxLength) return text;
+    // Default end length is roughly 1/3 of max length, minimum 3 characters
+    const defaultEndLength = Math.max(3, Math.floor(maxLength / 3));
+    const actualEndLength = endLength ?? defaultEndLength;
+    // Reserve space for the ellipsis character (1 char)
+    const availableLength = maxLength - 1;
+    // Calculate start length (remaining space after end portion)
+    const startLength = availableLength - actualEndLength;
+    // Ensure we have at least some characters at the start
+    if (startLength < 1) // If we can't fit both start and end, just truncate normally
+    return `${text.substring(0, maxLength - 1)}\u{2026}`;
+    const startPortion = text.substring(0, startLength);
+    const endPortion = text.substring(text.length - actualEndLength);
+    return `${startPortion}\u{2026}${endPortion}`;
+};
+const $15eb38b546e8440a$export$1791d17c7d9c448 = (input)=>input.replace(/\\ /g, ' ').trim();
 
 
-var $2d6eb7113bd26878$exports = {};
+var $0c91e05aa031e32a$exports = {};
 
-$parcel$export($2d6eb7113bd26878$exports, "normalizeArabicPrefixesToAl", () => $2d6eb7113bd26878$export$2a02c946f8bfe63e);
-$parcel$export($2d6eb7113bd26878$exports, "normalizeDoubleApostrophes", () => $2d6eb7113bd26878$export$bdee7fc4cb327c1a);
-$parcel$export($2d6eb7113bd26878$exports, "replaceSalutationsWithSymbol", () => $2d6eb7113bd26878$export$a0f0be7fbc73baaa);
-$parcel$export($2d6eb7113bd26878$exports, "normalize", () => $2d6eb7113bd26878$export$a3295358bff77e);
-$parcel$export($2d6eb7113bd26878$exports, "normalizeApostrophes", () => $2d6eb7113bd26878$export$a4e89c859f54cbf3);
-$parcel$export($2d6eb7113bd26878$exports, "removeArabicPrefixes", () => $2d6eb7113bd26878$export$dcfbf7d1ecba5f64);
-$parcel$export($2d6eb7113bd26878$exports, "normalizeTransliteratedEnglish", () => $2d6eb7113bd26878$export$17df925670d0176a);
-$parcel$export($2d6eb7113bd26878$exports, "extractInitials", () => $2d6eb7113bd26878$export$d421e6fd95c29a67);
+$parcel$export($0c91e05aa031e32a$exports, "normalizeArabicPrefixesToAl", () => $0c91e05aa031e32a$export$2a02c946f8bfe63e);
+$parcel$export($0c91e05aa031e32a$exports, "normalizeDoubleApostrophes", () => $0c91e05aa031e32a$export$bdee7fc4cb327c1a);
+$parcel$export($0c91e05aa031e32a$exports, "replaceSalutationsWithSymbol", () => $0c91e05aa031e32a$export$a0f0be7fbc73baaa);
+$parcel$export($0c91e05aa031e32a$exports, "normalize", () => $0c91e05aa031e32a$export$a3295358bff77e);
+$parcel$export($0c91e05aa031e32a$exports, "normalizeApostrophes", () => $0c91e05aa031e32a$export$a4e89c859f54cbf3);
+$parcel$export($0c91e05aa031e32a$exports, "removeArabicPrefixes", () => $0c91e05aa031e32a$export$dcfbf7d1ecba5f64);
+$parcel$export($0c91e05aa031e32a$exports, "normalizeTransliteratedEnglish", () => $0c91e05aa031e32a$export$17df925670d0176a);
+$parcel$export($0c91e05aa031e32a$exports, "extractInitials", () => $0c91e05aa031e32a$export$d421e6fd95c29a67);
 
-const $2d6eb7113bd26878$export$2a02c946f8bfe63e = (text)=>{
+const $0c91e05aa031e32a$export$2a02c946f8bfe63e = (text)=>{
     return text.replace(/(\b|\W)(Al |Al-|Ar-|As-|Adh-|Ad-|Ats-|Ath |Ath-|Az |Az-|az-|adh-|as-|ar-)/g, '$1al-').replace(/(\b|\W)(Ash-S|ash-S)/g, '$1al-S').replace(/al- (.+?)\b/g, 'al-$1');
 };
-const $2d6eb7113bd26878$export$bdee7fc4cb327c1a = (text)=>{
+const $0c91e05aa031e32a$export$bdee7fc4cb327c1a = (text)=>{
     return text.replace(/ʿʿ/g, "\u02BF").replace(/ʾʾ/g, "\u02BE");
 };
-const $2d6eb7113bd26878$export$a0f0be7fbc73baaa = (text)=>{
+const $0c91e05aa031e32a$export$a0f0be7fbc73baaa = (text)=>{
     return text.replace(/\(peace be upon him\)|(Messenger of (Allah|Allāh)|Messenger|Prophet|Mu[hḥ]ammad) *\((s[^)]*m|peace[^)]*him|May[^)]*him|may[^)]*him)\)*/gi, "$1 \uFDFA").replace(/,\s*ﷺ\s*,/g, " \uFDFA");
 };
-const $2d6eb7113bd26878$export$a3295358bff77e = (input)=>{
+const $0c91e05aa031e32a$export$a3295358bff77e = (input)=>{
     return input.normalize('NFKD').replace(/[\u0300-\u036f]/g, '').replace(/`|ʾ|ʿ|-/g, '');
 };
-const $2d6eb7113bd26878$export$a4e89c859f54cbf3 = (text)=>{
+const $0c91e05aa031e32a$export$a4e89c859f54cbf3 = (text)=>{
     return text.replace(/‛|’|‘/g, "'");
 };
-const $2d6eb7113bd26878$export$dcfbf7d1ecba5f64 = (text)=>{
-    return (0, $f4495ebb65d3b1e0$export$85f748ccc2d3e888)(text.replace(/(\bal-|\bli-|\bbi-|\bfī|\bwa[-\s]+|\bl-|\bliʿl|\Bʿalá|\Bʿan|\bb\.)/gi, ''));
+const $0c91e05aa031e32a$export$dcfbf7d1ecba5f64 = (text)=>{
+    return (0, $86c5c45def76a44f$export$85f748ccc2d3e888)(text.replace(/(\bal-|\bli-|\bbi-|\bfī|\bwa[-\s]+|\bl-|\bliʿl|\Bʿalá|\Bʿan|\bb\.)/gi, ''));
 };
-const $2d6eb7113bd26878$export$17df925670d0176a = (text)=>$2d6eb7113bd26878$export$a3295358bff77e($2d6eb7113bd26878$export$dcfbf7d1ecba5f64(text));
-const $2d6eb7113bd26878$export$d421e6fd95c29a67 = (fullName)=>{
-    const initials = $2d6eb7113bd26878$export$17df925670d0176a(fullName).trim().split(/[ -]/).slice(0, 2).map((word)=>{
+const $0c91e05aa031e32a$export$17df925670d0176a = (text)=>$0c91e05aa031e32a$export$a3295358bff77e($0c91e05aa031e32a$export$dcfbf7d1ecba5f64(text));
+const $0c91e05aa031e32a$export$d421e6fd95c29a67 = (fullName)=>{
+    const initials = $0c91e05aa031e32a$export$17df925670d0176a(fullName).trim().split(/[ -]/).slice(0, 2).map((word)=>{
         return word.charAt(0).toUpperCase();
     }).join('');
     return initials;
@@ -397,5 +498,5 @@ const $2d6eb7113bd26878$export$d421e6fd95c29a67 = (fullName)=>{
 
 
 
-export {$28624456cd7e4cb8$export$60dc7fb96c441688 as cleanExtremeArabicUnderscores, $28624456cd7e4cb8$export$dcf00cfaf31fd188 as convertUrduSymbolsToArabic, $28624456cd7e4cb8$export$6c58e29008d10c1d as fixTrailingWow, $28624456cd7e4cb8$export$cf81487e80b00e26 as addSpaceBetweenArabicTextAndNumbers, $28624456cd7e4cb8$export$df81ab2e9352ca65 as stripEnglishCharactersAndSymbols, $28624456cd7e4cb8$export$d580a3cb14401529 as removeNonIndexSignatures, $28624456cd7e4cb8$export$84d849da647fa2e5 as removeSingularCodes, $28624456cd7e4cb8$export$7dedbc726019ed0f as removeSolitaryArabicLetters, $28624456cd7e4cb8$export$9571c9c2c203652d as removeTatwil, $28624456cd7e4cb8$export$f95230335378ec58 as replaceTaMarbutahWithHa, $28624456cd7e4cb8$export$b5bee4b27048330b as stripDiacritics, $28624456cd7e4cb8$export$8696bb09194c5fb5 as stripZeroWidthCharacters, $28624456cd7e4cb8$export$b1d6cb321dee12ad as replaceAlifMaqsurah, $28624456cd7e4cb8$export$db0c96cd03237332 as replaceEnglishPunctuationWithArabic, $28624456cd7e4cb8$export$1d28b07894af8a98 as normalizeAlifVariants, $f4495ebb65d3b1e0$export$814bebc253f2e5df as insertLineBreaksAfterPunctuation, $f4495ebb65d3b1e0$export$f0306841cd6b95d5 as addSpaceBeforeAndAfterPunctuation, $f4495ebb65d3b1e0$export$42f47e081bfe828c as applySmartQuotes, $f4495ebb65d3b1e0$export$b4922cc8c111eae2 as cleanLiteralNewLines, $f4495ebb65d3b1e0$export$95680a0d9bdd5dba as cleanMultilines, $f4495ebb65d3b1e0$export$20a121a9317a6ed4 as hasWordInSingleLine, $f4495ebb65d3b1e0$export$d936e191dd6a8e06 as isOnlyPunctuation, $f4495ebb65d3b1e0$export$38e1db3c2502e6cc as cleanJunkFromText, $f4495ebb65d3b1e0$export$e65ff0050dc4971d as cleanSpacesBeforePeriod, $f4495ebb65d3b1e0$export$6e89dcbda2f1dcad as condenseAsterisks, $f4495ebb65d3b1e0$export$64ee6721b5d4cefa as condenseColons, $f4495ebb65d3b1e0$export$9f873c000de6f69a as condenseDashes, $f4495ebb65d3b1e0$export$35abf980a52dfe44 as condenseEllipsis, $f4495ebb65d3b1e0$export$660f127778d3db20 as reduceMultilineBreaksToDouble, $f4495ebb65d3b1e0$export$7b984b558843c423 as reduceMultilineBreaksToSingle, $f4495ebb65d3b1e0$export$3468167fbf4483d7 as condensePeriods, $f4495ebb65d3b1e0$export$a299139a27d861bb as condenseUnderscores, $f4495ebb65d3b1e0$export$55102718dfa8db7e as doubleToSingleBrackets, $f4495ebb65d3b1e0$export$748703bb362bd52c as formatStringBySentence, $f4495ebb65d3b1e0$export$9027754b4b9f4cf4 as normalizeSlashInReferences, $f4495ebb65d3b1e0$export$85f748ccc2d3e888 as normalizeSpaces, $f4495ebb65d3b1e0$export$6726e05a22c5d4c9 as removeSpaceInsideBrackets, $f4495ebb65d3b1e0$export$6db2c5d62fd5ffe9 as stripBoldStyling, $f4495ebb65d3b1e0$export$9340b5fbcad6fe5a as stripItalicsStyling, $f4495ebb65d3b1e0$export$e166e222302a97bd as stripStyling, $f4495ebb65d3b1e0$export$eedf7f8c32995e56 as trimSpaceInsideQuotes, $0a00bc254018888e$export$62c7e2fbc3880e40 as normalizeJsonSyntax, $0a00bc254018888e$export$70726570eaa51acb as isJsonStructureValid, $0a00bc254018888e$export$ae2dc619900afbaa as splitByQuotes, $1f25f0941eacce7f$export$70476c4e7ef0b147 as cleanSymbolsAndPartReferences, $1f25f0941eacce7f$export$9f81734a6223638b as cleanTrailingPageNumbers, $1f25f0941eacce7f$export$631d05f860fc7118 as replaceLineBreaksWithSpaces, $1f25f0941eacce7f$export$edd6c3bb8fa3bc01 as stripAllDigits, $1f25f0941eacce7f$export$a537ffbd78859923 as removeDeathYear, $1f25f0941eacce7f$export$c8e7d4d7d9f46256 as removeNumbersAndDashes, $1f25f0941eacce7f$export$8e7f001aa315ad82 as removeSingleDigitReferences, $1f25f0941eacce7f$export$e4a0bb7881a4591a as removeUrls, $2d6eb7113bd26878$export$2a02c946f8bfe63e as normalizeArabicPrefixesToAl, $2d6eb7113bd26878$export$bdee7fc4cb327c1a as normalizeDoubleApostrophes, $2d6eb7113bd26878$export$a0f0be7fbc73baaa as replaceSalutationsWithSymbol, $2d6eb7113bd26878$export$a3295358bff77e as normalize, $2d6eb7113bd26878$export$a4e89c859f54cbf3 as normalizeApostrophes, $2d6eb7113bd26878$export$dcfbf7d1ecba5f64 as removeArabicPrefixes, $2d6eb7113bd26878$export$17df925670d0176a as normalizeTransliteratedEnglish, $2d6eb7113bd26878$export$d421e6fd95c29a67 as extractInitials};
+export {$798f85a7713a6ff1$export$60dc7fb96c441688 as cleanExtremeArabicUnderscores, $798f85a7713a6ff1$export$dcf00cfaf31fd188 as convertUrduSymbolsToArabic, $798f85a7713a6ff1$export$6c58e29008d10c1d as fixTrailingWow, $798f85a7713a6ff1$export$cf81487e80b00e26 as addSpaceBetweenArabicTextAndNumbers, $798f85a7713a6ff1$export$df81ab2e9352ca65 as stripEnglishCharactersAndSymbols, $798f85a7713a6ff1$export$d580a3cb14401529 as removeNonIndexSignatures, $798f85a7713a6ff1$export$84d849da647fa2e5 as removeSingularCodes, $798f85a7713a6ff1$export$7dedbc726019ed0f as removeSolitaryArabicLetters, $798f85a7713a6ff1$export$9571c9c2c203652d as removeTatwil, $798f85a7713a6ff1$export$f95230335378ec58 as replaceTaMarbutahWithHa, $798f85a7713a6ff1$export$b5bee4b27048330b as stripDiacritics, $798f85a7713a6ff1$export$8696bb09194c5fb5 as stripZeroWidthCharacters, $798f85a7713a6ff1$export$b1d6cb321dee12ad as replaceAlifMaqsurah, $798f85a7713a6ff1$export$db0c96cd03237332 as replaceEnglishPunctuationWithArabic, $798f85a7713a6ff1$export$1d28b07894af8a98 as normalizeAlifVariants, $86c5c45def76a44f$export$814bebc253f2e5df as insertLineBreaksAfterPunctuation, $86c5c45def76a44f$export$f0306841cd6b95d5 as addSpaceBeforeAndAfterPunctuation, $86c5c45def76a44f$export$42f47e081bfe828c as applySmartQuotes, $86c5c45def76a44f$export$b4922cc8c111eae2 as cleanLiteralNewLines, $86c5c45def76a44f$export$95680a0d9bdd5dba as cleanMultilines, $86c5c45def76a44f$export$20a121a9317a6ed4 as hasWordInSingleLine, $86c5c45def76a44f$export$d936e191dd6a8e06 as isOnlyPunctuation, $86c5c45def76a44f$export$38e1db3c2502e6cc as cleanJunkFromText, $86c5c45def76a44f$export$e65ff0050dc4971d as cleanSpacesBeforePeriod, $86c5c45def76a44f$export$6e89dcbda2f1dcad as condenseAsterisks, $86c5c45def76a44f$export$64ee6721b5d4cefa as condenseColons, $86c5c45def76a44f$export$9f873c000de6f69a as condenseDashes, $86c5c45def76a44f$export$35abf980a52dfe44 as condenseEllipsis, $86c5c45def76a44f$export$660f127778d3db20 as reduceMultilineBreaksToDouble, $86c5c45def76a44f$export$7b984b558843c423 as reduceMultilineBreaksToSingle, $86c5c45def76a44f$export$3468167fbf4483d7 as condensePeriods, $86c5c45def76a44f$export$a299139a27d861bb as condenseUnderscores, $86c5c45def76a44f$export$55102718dfa8db7e as doubleToSingleBrackets, $86c5c45def76a44f$export$803cc4592448c009 as replaceDoubleBracketsWithArrows, $86c5c45def76a44f$export$748703bb362bd52c as formatStringBySentence, $86c5c45def76a44f$export$9027754b4b9f4cf4 as normalizeSlashInReferences, $86c5c45def76a44f$export$85f748ccc2d3e888 as normalizeSpaces, $86c5c45def76a44f$export$5c77851c03e0da0a as ensureSpaceBeforeBrackets, $86c5c45def76a44f$export$a97ebab70a927fe1 as removeRedundantPunctuation, $86c5c45def76a44f$export$6726e05a22c5d4c9 as removeSpaceInsideBrackets, $86c5c45def76a44f$export$6db2c5d62fd5ffe9 as stripBoldStyling, $86c5c45def76a44f$export$9340b5fbcad6fe5a as stripItalicsStyling, $86c5c45def76a44f$export$e166e222302a97bd as stripStyling, $86c5c45def76a44f$export$eedf7f8c32995e56 as trimSpaceInsideQuotes, $045191e51bf3eda2$export$62c7e2fbc3880e40 as normalizeJsonSyntax, $045191e51bf3eda2$export$70726570eaa51acb as isJsonStructureValid, $045191e51bf3eda2$export$ae2dc619900afbaa as splitByQuotes, $045191e51bf3eda2$export$1e23eb8d8fab7cc as isBalanced, $15eb38b546e8440a$export$70476c4e7ef0b147 as cleanSymbolsAndPartReferences, $15eb38b546e8440a$export$9f81734a6223638b as cleanTrailingPageNumbers, $15eb38b546e8440a$export$631d05f860fc7118 as replaceLineBreaksWithSpaces, $15eb38b546e8440a$export$edd6c3bb8fa3bc01 as stripAllDigits, $15eb38b546e8440a$export$a537ffbd78859923 as removeDeathYear, $15eb38b546e8440a$export$c8e7d4d7d9f46256 as removeNumbersAndDashes, $15eb38b546e8440a$export$8e7f001aa315ad82 as removeSingleDigitReferences, $15eb38b546e8440a$export$e4a0bb7881a4591a as removeUrls, $15eb38b546e8440a$export$6a506b36fdea397d as truncate, $15eb38b546e8440a$export$f3a88d5244308057 as truncateMiddle, $15eb38b546e8440a$export$1791d17c7d9c448 as unescapeSpaces, $0c91e05aa031e32a$export$2a02c946f8bfe63e as normalizeArabicPrefixesToAl, $0c91e05aa031e32a$export$bdee7fc4cb327c1a as normalizeDoubleApostrophes, $0c91e05aa031e32a$export$a0f0be7fbc73baaa as replaceSalutationsWithSymbol, $0c91e05aa031e32a$export$a3295358bff77e as normalize, $0c91e05aa031e32a$export$a4e89c859f54cbf3 as normalizeApostrophes, $0c91e05aa031e32a$export$dcfbf7d1ecba5f64 as removeArabicPrefixes, $0c91e05aa031e32a$export$17df925670d0176a as normalizeTransliteratedEnglish, $0c91e05aa031e32a$export$d421e6fd95c29a67 as extractInitials};
 //# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -1 +1 @@
-{"mappings":"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","sources":["src/index.ts","src/arabic.ts","src/formatting.ts","src/parsing.ts","src/sanitization.ts","src/transliteration.ts"],"sourcesContent":["export * from './arabic';\nexport * from './formatting';\nexport * from './parsing';\nexport * from './sanitization';\nexport * from './transliteration';\n","/**\n * Removes extreme Arabic underscores (ـ) that appear at the beginning or end of a line or in text.\n * Does not affect Hijri dates (e.g., 1424هـ) or specific Arabic terms.\n * Example: \"ـThis is a textـ\" will be changed to \"This is a text\".\n * @param {string} text - The input text to apply the rule to.\n * @returns {string} - The modified text with extreme underscores removed.\n */\nexport const cleanExtremeArabicUnderscores = (text: string): string => {\n    return text.replace(/(?<!\\d ?ه|اه)ـ(?=\\r?$)|^ـ(?!اهـ)/gm, '');\n};\n\n/**\n * Converts Urdu symbols to their Arabic equivalents.\n * Example: 'ھذا' will be changed to 'هذا', 'ی' to 'ي'.\n * @param {string} text - The input text containing Urdu symbols.\n * @returns {string} - The modified text with Urdu symbols converted to Arabic symbols.\n */\nexport const convertUrduSymbolsToArabic = (text: string): string => {\n    return text.replace(/ھ/g, 'ه').replace(/ی/g, 'ي');\n};\n\n/**\n * Fixes the trailing \"و\" (wow) in phrases such as \"عليكم و رحمة\" to \"عليكم ورحمة\".\n * This function attempts to correct phrases where \"و\" appears unnecessarily, particularly in greetings.\n * Example: 'السلام عليكم و رحمة' will be changed to 'السلام عليكم ورحمة'.\n * @param {string} text - The input text containing the \"و\" character.\n * @returns {string} - The modified text with unnecessary trailing \"و\" characters corrected.\n */\nexport const fixTrailingWow = (text: string): string => {\n    return text.replace(/ و /g, ' و');\n};\n\n/**\n * Inserts a space between Arabic text and numbers.\n * Example: 'الآية37' will be changed to 'الآية 37'.\n * @param {string} text - The input text containing Arabic text followed by numbers.\n * @returns {string} - The modified text with spaces inserted between Arabic text and numbers.\n */\nexport const addSpaceBetweenArabicTextAndNumbers = (text: string): string => {\n    return text.replace(/([\\u0600-\\u06FF]+)(\\d+)/g, '$1 $2');\n};\n\n/**\n * Removes English letters and symbols from the text, including ampersands, slashes, and other symbols.\n * Example: 'أحب & لنفسي' will be changed to 'أحب   لنفسي'.\n * @param {string} text - The input text containing English letters and symbols.\n * @returns {string} - The modified text with English letters and symbols removed.\n */\nexport const stripEnglishCharactersAndSymbols = (text: string): string => {\n    return text.replace(/[a-zA-Z]+[0-9]*|[¬§`ﷺ=]|\\/{2,}|&/g, ' ');\n};\n\n/**\n * Removes single-digit numbers surrounded by Arabic text. Also removes dashes (-) not followed by a number.\n * For example, removes '3' from 'وهب 3 وقال' but does not remove '121' from 'لوحه 121 الجرح'.\n * @param {string} text - The input text to apply the rule to.\n * @returns {string} - The modified text with non-index numbers and dashes removed.\n */\nexport const removeNonIndexSignatures = (text: string): string => {\n    return text\n        .replace(/(?<![0-9] ?)-|(?<=[\\u0600-\\u06FF])\\s?\\d\\s?(?=[\\u0600-\\u06FF])/g, ' ')\n        .replace(/(?<=[\\u0600-\\u06FF]\\s)(\\d+\\s)+\\d+(?=(\\s[\\u0600-\\u06FF]|$))/g, ' ');\n};\n\n/**\n * Removes characters enclosed in square brackets [] or parentheses () if they are Arabic letters or Arabic-Indic numerals.\n * Example: '[س]' or '(س)' will be removed.\n * @param {string} text - The input text to apply the rule to.\n * @returns {string} - The modified text with singular codes removed.\n */\nexport const removeSingularCodes = (text: string): string => {\n    return text.replace(/[\\[\\({][\\u0621-\\u064A\\u0660-\\u0669][\\]\\)}]/g, '');\n};\n\n/**\n * Removes solitary Arabic letters unless they are the 'ha' letter, which is used in Hijri years.\n * Example: \"ب ا الكلمات ت\" will be changed to \"ا الكلمات\".\n * @param {string} text - The input text to apply the rule to.\n * @returns {string} - The modified text with solitary Arabic letters removed.\n */\nexport const removeSolitaryArabicLetters = (text: string): string => {\n    return text.replace(/(^| )[\\u0621-\\u064A]( |$)/g, ' ');\n};\n\n/**\n * Removes tatweel characters while preserving dates references.\n * Example: \"1435/3/29 هـ\" remains as \"1435/3/29 هـ\" but \"أبـــتِـــكَةُ\" becomes \"أبتِكَةُ\"\n * @param text The text to format.\n * @returns The modified text with the tatweel characters removed.\n */\nexport const removeTatwil = (text: string) => {\n    return text.replace(/(?<![0-9ه])ـ/g, '');\n};\n\n/**\n * Replaces the 'tah marbutah' (ة) character with 'ha' (ه).\n * Example: 'مدرسة' will be changed to 'مدرسه'.\n * @param {string} text - The input text to apply the rule to.\n * @returns {string} - The modified text with 'ta marbutah' replaced by 'ha'.\n */\nexport const replaceTaMarbutahWithHa = (text: string): string => {\n    return text.replace(/[ة]/g, 'ه');\n};\n\n/**\n * Removes Arabic diacritics (tashkeel) and the tatweel (elongation) character.\n * Example: 'مُحَمَّدٌ' will be changed to 'محمد'.\n * @param {string} text - The input text to apply the rule to.\n * @returns {string} - The modified text with diacritics and tatweel removed.\n */\nexport const stripDiacritics = (text: string): string => {\n    return text.replace(\n        /[\\u0610\\u0611\\u0612\\u0613\\u0614\\u0615\\u0616\\u0617\\u0618\\u0619\\u061A\\u064B\\u064C\\u064D\\u064E\\u064F\\u0650\\u0651\\u0652\\u0653\\u0654\\u0655\\u0656\\u0657\\u0658\\u065A\\u065B\\u065C\\u065D\\u065E\\u0640]/g,\n        '',\n    );\n};\n\n/**\n * Removes zero-width joiners (ZWJ) and other zero-width characters from the input text.\n * Zero-width characters include U+200B to U+200F, U+202A to U+202E, U+2060 to U+2064, and U+FEFF.\n * @param {string} text - The input text to apply the rule to.\n * @returns {string} - The modified text with zero-width characters removed.\n */\nexport const stripZeroWidthCharacters = (text: string): string => {\n    return text.replace(/[\\u200B-\\u200F\\u202A-\\u202E\\u2060-\\u2064\\uFEFF]/g, ' ');\n};\n\n/**\n * Replaces the 'alif maqsurah' (ى) character with the regular 'ya' (ي).\n * Example: 'رؤيى' will be changed to 'رؤيي'.\n * @param {string} text - The input text to apply the rule to.\n * @returns {string} - The modified text with 'alif maqsurah' replaced by 'ya'.\n */\nexport const replaceAlifMaqsurah = (text: string): string => {\n    return text.replace(/[ىي]/g, 'ي');\n};\n\n/**\n * Replaces English punctuation (question mark and semicolon) with their Arabic equivalents.\n * Example: '?' will be replaced with '؟', and ';' with '؛'.\n * @param {string} text - The input text to apply the rule to.\n * @returns {string} - The modified text with English punctuation replaced by Arabic punctuation.\n */\nexport const replaceEnglishPunctuationWithArabic = (text: string): string => {\n    return text\n        .replace(/\\?|؟\\./g, '؟')\n        .replace(/(;|؛)\\s*(\\1\\s*)*/g, '؛')\n        .replace(/,|-،/g, '،');\n};\n\n/**\n * Simplifies all forms of 'alif' (أ, إ, and آ) to the basic 'ا'.\n * Example: 'أنا إلى الآفاق' will be changed to 'انا الى الافاق'.\n * @param {string} text - The input text to apply the rule to.\n * @returns {string} - The modified text with simplified 'alif' characters.\n */\nexport const normalizeAlifVariants = (text: string): string => {\n    return text.replace(/[أإآ]/g, 'ا');\n};\n","/**\n * Adds line breaks after punctuation marks such as periods, exclamation points, and question marks.\n * Example: 'Text.' becomes 'Text.\\n'.\n * @param {string} text - The input text containing punctuation.\n * @returns {string} - The modified text with line breaks added after punctuation.\n */\nexport const insertLineBreaksAfterPunctuation = (text: string): string => {\n    // Define the punctuation marks that should trigger a new line\n    const punctuation = /([.?!؟])/g;\n\n    // Replace occurrences of punctuation marks followed by a space with the punctuation mark, a newline, and the space\n    const formattedText = text.replace(punctuation, '$1\\n').replace(/\\n\\s+/g, '\\n').trim();\n\n    return formattedText;\n};\n\n/**\n * Adds spaces before and after punctuation, except for certain cases like quoted text or ayah references.\n * Example: 'Text,word' becomes 'Text, word'.\n * @param {string} text - The input text containing punctuation.\n * @returns {string} - The modified text with spaces added before and after punctuation.\n */\nexport const addSpaceBeforeAndAfterPunctuation = (text: string): string => {\n    return text\n        .replace(/( ?)([.!?,،؟;؛])((?![ '”“\\)\"\\]\\n])|(?=\\s{2,}))/g, '$1$2 ')\n        .replace(/\\s([.!?,،؟;؛])\\s*([ '”“\\)\"\\]\\n])/g, '$1$2')\n        .replace(/([^\\s\\w\\d'”“\\)\"\\]]+)\\s+([.!?,،؟;؛])|([.!?,،؟;؛])\\s+$/g, '$1$2$3')\n        .replace(/(?<=\\D)( ?: ?)(?!(\\d+:)|(:\\d+))|(?<=\\d) ?: ?(?=\\D)|(?<=\\D) ?: ?(?=\\d)/g, ': ');\n};\n\n/**\n * Turns regular double quotes surrounding a body of text into smart quotes.\n * Also fixes incorrect starting quotes by ensuring the string starts with an opening quote if needed.\n * Example: 'The \"quick brown\" fox' becomes 'The “quick brown” fox'.\n * @param {string} text - The input text to apply the rule to.\n * @returns {string} - The modified text with smart quotes applied.\n */\nexport const applySmartQuotes = (text: string): string => {\n    return text\n        .replace(/[“”]/g, '\"')\n        .replace(/\"([^\"]*)\"/g, '“$1”')\n        .replace(/^”/g, '“');\n};\n\n/**\n * Replaces literal new line characters (\\n) and carriage returns (\\r) with actual line breaks.\n * Example: 'A\\\\nB' becomes 'A\\nB'.\n * @param {string} text - The input text containing literal new lines.\n * @returns {string} - The modified text with actual line breaks.\n */\nexport const cleanLiteralNewLines = (text: string): string => {\n    return text.replace(/\\\\n|\\r/g, '\\n');\n};\n\n/**\n * Removes trailing spaces from each line in a multiline string.\n * Example: \" This is a line   \\nAnother line   \" becomes \"This is a line\\nAnother line\".\n * @param {string} text - The input text to apply the rule to.\n * @returns {string} - The modified text with trailing spaces removed.\n */\nexport const cleanMultilines = (text: string): string => {\n    return text.replace(/^ +| +$/gm, '');\n};\n\n/**\n * Detects if a word is by itself in a line.\n * @param text The text to check.\n * @returns true if there exists a word in any of the lines in the text that is by itself.\n */\nexport const hasWordInSingleLine = (text: string): boolean => {\n    return /^\\s*\\S+\\s*$/gm.test(text);\n};\n\n/**\n * Checks if the input string consists of only punctuation characters.\n * @param {string} text - The input text to check.\n * @returns {boolean} - Returns true if the string contains only punctuation, false otherwise.\n */\nexport const isOnlyPunctuation = (text: string): boolean => {\n    const regex = /^[\\u0020-\\u002f\\u003a-\\u0040\\u005b-\\u0060\\u007b-\\u007e0-9٠-٩]+$/;\n    return regex.test(text);\n};\n\nexport const cleanJunkFromText = (text: string): string => {\n    const newBody = cleanMultilines(text);\n    const lines = newBody.split('\\n').filter((line) => {\n        return !line || (line.length > 1 && !isOnlyPunctuation(line));\n    });\n\n    return lines.join('\\n').trim();\n};\n\n/**\n * Cleans unnecessary spaces before punctuation marks such as periods, commas, and question marks.\n * Example: 'This is a sentence , with extra space .' becomes 'This is a sentence, with extra space.'.\n * @param {string} text - The input text to apply the rule to.\n * @returns {string} - The modified text with cleaned spaces before punctuation.\n */\nexport const cleanSpacesBeforePeriod = (text: string): string => {\n    return text.replace(/\\s+([.؟!,،؛:?])/g, '$1');\n};\n\n/**\n * Condenses multiple asterisks (*) into a single one.\n * Example: '***' becomes '*'.\n * @param {string} text - The input text to apply the rule to.\n * @returns {string} - The modified text with condensed asterisks.\n */\nexport const condenseAsterisks = (text: string): string => {\n    return text.replace(/(\\*\\s*)+/g, '*');\n};\n\n/**\n * Replaces occurrences of colons surrounded by periods (e.g., '.:.' or ':') with a single colon.\n * Example: 'This.:. is a test' becomes 'This: is a test'.\n * @param {string} text - The input text to apply the rule to.\n * @returns {string} - The modified text with condensed colons.\n */\nexport const condenseColons = (text: string): string => {\n    return text.replace(/[\\.-]?:[\\.-]?/g, ':');\n};\n\n/**\n * Condenses two or more dashes (--) into a single dash (-).\n * Example: 'This is some ---- text' becomes 'This is some - text'.\n * @param {string} text - The input text to apply the rule to.\n * @returns {string} - The modified text with condensed dashes.\n */\nexport const condenseDashes = (text: string): string => {\n    return text.replace(/-{2,}/g, '-');\n};\n\n/**\n * Replaces sequences of two or more periods (e.g., '...') with an ellipsis character (…).\n * Example: 'This is a test...' becomes 'This is a test…'.\n * @param {string} text - The input text to apply the rule to.\n * @returns {string} - The modified text with ellipses condensed.\n */\nexport const condenseEllipsis = (text: string): string => {\n    return text.replace(/\\.{2,}/g, '…');\n};\n\n/**\n * Reduces multiple consecutive line breaks (3 or more) to exactly 2 line breaks.\n * Example: 'This is line 1\\n\\n\\n\\nThis is line 2' becomes 'This is line 1\\n\\nThis is line 2'.\n * @param {string} text - The input text to apply the rule to.\n * @returns {string} - The modified text with condensed line breaks.\n */\nexport const reduceMultilineBreaksToDouble = (text: string): string => {\n    return text.replace(/(\\n\\s*){3,}/g, '\\n\\n');\n};\n\n/**\n * Reduces multiple consecutive line breaks (2 or more) to exactly 1 line break.\n * Example: 'This is line 1\\n\\nThis is line 2' becomes 'This is line 1\\nThis is line 2'.\n * @param {string} text - The input text to apply the rule to.\n * @returns {string} - The modified text with condensed line breaks.\n */\nexport const reduceMultilineBreaksToSingle = (text: string): string => {\n    return text.replace(/(\\n\\s*){2,}/g, '\\n');\n};\n\n/**\n * Condenses multiple periods separated by spaces (e.g., '. . .') into a single period.\n * Example: 'This . . . is a test' becomes 'This. is a test'.\n * @param {string} text - The input text to apply the rule to.\n * @returns {string} - The modified text with condensed periods.\n */\nexport const condensePeriods = (text: string): string => {\n    return text.replace(/\\. +\\./g, '.');\n};\n\n/**\n * Condenses multiple underscores (__) or Arabic Tatweel characters (ـــــ) into a single underscore or Tatweel.\n * Example: 'This is ـــ some text __' becomes 'This is ـ some text _'.\n * @param {string} text - The input text to apply the rule to.\n * @returns {string} - The modified text with condensed underscores.\n */\nexport const condenseUnderscores = (text: string): string => {\n    return text.replace(/ـ{2,}/g, 'ـ').replace(/_+/g, '_');\n};\n\n/**\n * Replaces double parentheses or brackets with single ones.\n * Example: '((text))' becomes '(text)'.\n * @param {string} text - The input text to apply the rule to.\n * @returns {string} - The modified text with condensed brackets.\n */\nexport const doubleToSingleBrackets = (text: string): string => {\n    return text.replace(/(\\(|\\)){2,}|(\\[|\\]){2,}/g, '$1$2');\n};\n\n/**\n * Formats a multiline string by joining sentences and maintaining footnotes on their own lines.\n * Footnotes are identified by Arabic and English numerals.\n * Example: 'Sentence one.\\n(1) A footnote.\\nSentence two.' remains the same, while regular sentences are joined.\n * @param {string} input - The input text containing sentences and footnotes.\n * @returns {string} - The formatted text.\n */\nexport const formatStringBySentence = (input: string): string => {\n    const footnoteRegex = /^\\((?:\\d+|۱|۲|۳|۴|۵|۶|۷|۸|۹)\\)\\s/;\n    const sentences: string[] = [];\n    const lines = input.split('\\n');\n    let currentSentence = '';\n\n    lines.forEach((line) => {\n        const trimmedLine = line.trim();\n        const isFootnote = footnoteRegex.test(trimmedLine);\n        const isNumber = /^\\(\\d+\\/\\d+\\)/.test(trimmedLine);\n\n        if (isFootnote && !isNumber) {\n            if (currentSentence) {\n                sentences.push(currentSentence.trim());\n                currentSentence = '';\n            }\n            sentences.push(trimmedLine);\n        } else {\n            currentSentence += `${trimmedLine} `;\n            const lastChar = currentSentence.trim().slice(-1);\n            if (/[.!؟]/.test(lastChar)) {\n                sentences.push(currentSentence.trim());\n                currentSentence = '';\n            }\n        }\n    });\n\n    // Add any remaining text to the output\n    if (currentSentence) {\n        sentences.push(currentSentence.trim());\n    }\n\n    return sentences.join('\\n');\n};\n\n/**\n * Removes unnecessary spaces around slashes in references.\n * Example: '127 / 11' becomes '127/11'.\n * @param {string} text - The input text containing references.\n * @returns {string} - The modified text with spaces removed around slashes.\n */\nexport const normalizeSlashInReferences = (text: string): string => {\n    return text.replace(/(\\d+)\\s?\\/\\s?(\\d+)/g, '$1/$2');\n};\n\n/**\n * Reduces multiple spaces or tabs to a single space.\n * Example: 'This   is a   text' becomes 'This is a text'.\n * @param {string} text - The input text containing extra spaces.\n * @returns {string} - The modified text with reduced spaces.\n */\nexport const normalizeSpaces = (text: string): string => {\n    return text.replace(/[ \\t]+/g, ' ');\n};\n\n/**\n * Removes spaces inside brackets, parentheses, or square brackets.\n * Example: '( a b )' becomes '(a b)'.\n * @param {string} text - The input text with spaces inside brackets.\n * @returns {string} - The modified text with spaces removed inside brackets.\n */\nexport const removeSpaceInsideBrackets = (text: string): string => {\n    return text.replace(/([\\[\\(])\\s*(.*?)\\s*([\\]\\)])/g, '$1$2$3');\n};\n\n/**\n * Removes bold styling from text by normalizing the string and removing stylistic characters.\n * @param {string} text - The input text containing bold characters.\n * @returns {string} - The modified text with bold styling removed.\n */\nexport const stripBoldStyling = (text: string): string => {\n    // Normalize the string to NFKD form\n    const normalizedString = text.normalize('NFKD');\n\n    // Remove combining marks (diacritics) and stylistic characters from the string\n    return normalizedString.replace(/[\\u0300-\\u036f]/g, '').trim();\n};\n\n/**\n * Removes italicized characters by replacing italic Unicode characters with their normal counterparts.\n * Example: '𝘼𝘽𝘾' becomes 'ABC'.\n * @param {string} text - The input text containing italicized characters.\n * @returns {string} - The modified text with italics removed.\n */\nexport const stripItalicsStyling = (text: string): string => {\n    const italicMap: Record<string, string> = {\n        '\\uD835\\uDC4E': 'I',\n        '\\uD835\\uDC68': 'g',\n        '\\u{1D63C}': '!',\n        '\\uD835\\uDC4F': 'J',\n        '\\uD835\\uDC69': 'h',\n        '\\u{1D63D}': '?',\n        '\\uD835\\uDC50': 'K',\n        '\\uD835\\uDC6A': 'i',\n        '\\uD835\\uDC51': 'L',\n        '\\uD835\\uDC6B': 'j',\n        '\\u{1D63F}': ',',\n        '\\uD835\\uDC52': 'M',\n        '\\uD835\\uDC6C': 'k',\n        '\\u{1D640}': '.',\n        '\\uD835\\uDC53': 'N',\n        '\\uD835\\uDC6D': 'l',\n        '\\uD835\\uDC54': 'O',\n        '\\uD835\\uDC6E': 'm',\n        '\\uD835\\uDC6F': 'n',\n        '\\uD835\\uDC56': 'Q',\n        '\\uD835\\uDC70': 'o',\n        '\\uD835\\uDC57': 'R',\n        '\\uD835\\uDC71': 'p',\n        '\\uD835\\uDC58': 'S',\n        '\\uD835\\uDC72': 'q',\n        '\\uD835\\uDC59': 'T',\n        '\\uD835\\uDC73': 'r',\n        '\\u{1D647}': '-',\n        '\\uD835\\uDC5A': 'U',\n        '\\uD835\\uDC74': 's',\n        '\\uD835\\uDC5B': 'V',\n        '\\uD835\\uDC75': 't',\n        '\\uD835\\uDC5C': 'W',\n        '\\uD835\\uDC76': 'u',\n        '\\uD835\\uDC5D': 'X',\n        '\\uD835\\uDC77': 'v',\n        '\\uD835\\uDC5E': 'Y',\n        '\\uD835\\uDC78': 'w',\n        '\\uD835\\uDC5F': 'Z',\n        '\\uD835\\uDC79': 'x',\n        '\\uD835\\uDC46': 'A',\n        '\\uD835\\uDC7A': 'y',\n        '\\uD835\\uDC47': 'B',\n        '\\uD835\\uDC7B': 'z',\n        '\\uD835\\uDC62': 'a',\n        '\\uD835\\uDC48': 'C',\n        '\\uD835\\uDC63': 'b',\n        '\\uD835\\uDC49': 'D',\n        '\\uD835\\uDC64': 'c',\n        '\\uD835\\uDC4A': 'E',\n        '\\uD835\\uDC65': 'd',\n        '\\uD835\\uDC4B': 'F',\n        '\\uD835\\uDC66': 'e',\n        '\\uD835\\uDC4C': 'G',\n        '\\uD835\\uDC67': 'f',\n        '\\uD835\\uDC4D': 'H',\n        '\\uD835\\uDC55': 'P',\n    };\n\n    return text.replace(/[\\uD835\\uDC62-\\uD835\\uDC7B\\uD835\\uDC46-\\uD835\\uDC5F\\u{1D63C}-\\u{1D647}]/gu, (match) => {\n        return italicMap[match] || match;\n    });\n};\n\n/**\n * Removes all bold and italic styling from the input text.\n * @param {string} text - The input text to remove styling from.\n * @returns {string} - The modified text with all styling removed.\n */\nexport const stripStyling = (text: string): string => {\n    return stripItalicsStyling(stripBoldStyling(text));\n};\n\n/**\n * Removes unnecessary spaces inside quotes.\n * Example: '“ Text ”' becomes '“Text”'.\n * @param {string} text - The input text with spaces inside quotes.\n * @returns {string} - The modified text with spaces removed inside quotes.\n */\nexport const trimSpaceInsideQuotes = (text: string): string => {\n    return text.replace(/([“”\"]|«) *(.*?) *([“”\"]|»)/g, '$1$2$3');\n};\n","/**\n * Converts a string that resembles JSON but with numeric keys and single-quoted values\n * into valid JSON format. This function replaces numeric keys with quoted numeric keys\n * and ensures all values are double-quoted as required by JSON.\n *\n * @param {string} str - The input string that needs to be fixed into valid JSON.\n * @returns {string} - A valid JSON string.\n *\n * @example\n * const result = normalizeJsonSyntax(\"{10: 'abc', 20: 'def'}\");\n * console.log(result); // '{\"10\": \"abc\", \"20\": \"def\"}'\n */\nexport const normalizeJsonSyntax = (str: string): string => {\n    let input = str.replace(/(\\b\\d+\\b)(?=:)/g, '\"$1\"');\n    input = input.replace(/:\\s*'([^']+)'/g, ': \"$1\"');\n    input = input.replace(/:\\s*\"([^\"]+)\"/g, ': \"$1\"');\n\n    return JSON.stringify(JSON.parse(input));\n};\n\n/**\n * Checks if a given string resembles a JSON object with numeric or quoted keys and values\n * that are single or double quoted. This is useful for detecting malformed JSON-like\n * structures that can be fixed by the `normalizeJsonSyntax` function.\n *\n * @param {string} str - The input string to check.\n * @returns {boolean} - Returns true if the string is JSON-like, false otherwise.\n *\n * @example\n * const result = isJsonStructureValid(\"{10: 'abc', 'key': 'value'}\");\n * console.log(result); // true\n */\nexport const isJsonStructureValid = (str: string): boolean => {\n    // Checks for a pattern with numeric keys or quoted keys and values in quotes\n    const jsonLikePattern =\n        /^{(\\s*(\\d+|'[^']*'|\"[^\"]*\")\\s*:\\s*('|\")[^'\"]*\\3\\s*,)*(?:\\s*(\\d+|'[^']*'|\"[^\"]*\")\\s*:\\s*('|\")[^'\"]*\\5\\s*)}$/;\n    return jsonLikePattern.test(str.trim());\n};\n\n/**\n * Splits a string by spaces and quoted substrings.\n *\n * This function takes an input string and splits it into parts where substrings\n * enclosed in double quotes are treated as a single part. Other substrings\n * separated by spaces are split normally.\n *\n * @param {string} query - The input string to be split.\n * @returns {string[]} An array of strings, with quoted substrings kept intact.\n *\n * @example\n * const result = splitByQuotes('\"This is\" \"a part of the\" \"string and\"');\n * console.log(result); // [\"This is\", \"a part of the\", \"string and\"]\n */\nexport const splitByQuotes = (query: string): string[] => {\n    const regex = /(?:[^\\s\"]+|\"(.*?)\")+/g;\n    return (query.match(regex) || []).map((s: string) => (s.startsWith('\"') ? s.slice(1, -1) : s));\n};\n","/**\n * Removes various symbols, part references, and numerical markers from the text.\n * Example: '(1) (2/3)' becomes ''.\n * @param {string} text - The input text to apply the rule to.\n * @returns {string} - The modified text with symbols and part references removed.\n */\nexport const cleanSymbolsAndPartReferences = (text: string): string => {\n    return text.replace(\n        / *\\(?:\\d+(?:\\/\\d+){0,2}\\)? *| *\\[\\d+(?:\\/\\d+)?\\] *| *«\\d+» *|\\d+\\/\\d+(?:\\/\\d+)?|[،§{}۝؍‎﴿﴾<>;_؟»«:!،؛\\[\\]…ـ¬\\.\\\\\\/\\*\\(\\)\"]/g,\n        ' ',\n    );\n};\n\n/**\n * Removes trailing page numbers formatted as '-[46]-' from the text.\n * Example: 'This is some -[46]- text' becomes 'This is some text'.\n * @param {string} text - The input text with trailing page numbers.\n * @returns {string} - The modified text with page numbers removed.\n */\nexport const cleanTrailingPageNumbers = (text: string): string => {\n    return text.replace(/-\\[\\d+\\]-/g, '');\n};\n\n/**\n * Replaces consecutive line breaks and whitespace characters with a single space.\n * Example: 'a\\nb' becomes 'a b'.\n * @param {string} text - The input text containing line breaks or multiple spaces.\n * @returns {string} - The modified text with spaces.\n */\nexport const replaceLineBreaksWithSpaces = (text: string): string => {\n    return text.replace(/\\s+/g, ' ');\n};\n\n/**\n * Removes all numeric digits from the text.\n * Example: 'abc123' becomes 'abc'.\n * @param {string} text - The input text containing digits.\n * @returns {string} - The modified text with digits removed.\n */\nexport const stripAllDigits = (text: string): string => {\n    return text.replace(/[0-9]/g, '');\n};\n\n/**\n * Removes death year references like \"(d. 390H)\" and \"[d. 100h]\" from the text.\n * Example: 'Sufyān ibn ‘Uyaynah (d. 198h)' becomes 'Sufyān ibn ‘Uyaynah'.\n * @param {string} text - The input text containing death year references.\n * @returns {string} - The modified text with death years removed.\n */\nexport const removeDeathYear = (text: string): string => {\n    return text.replace(/\\[(d)\\.\\s*\\d{1,4}[hH]\\]\\s*|\\((d)\\.\\s*\\d{1,4}[hH]\\)\\s*/g, '');\n};\n\n/**\n * Removes numeric digits and dashes from the text.\n * Example: 'ABC 123-Xyz' becomes 'ABC Xyz'.\n * @param {string} text - The input text containing digits and dashes.\n * @returns {string} - The modified text with numbers and dashes removed.\n */\nexport const removeNumbersAndDashes = (text: string): string => {\n    return text.replace(/[\\d-]/g, '');\n};\n\n/**\n * Removes single digit references like (1), «2», [3] from the text.\n * Example: 'Ref (1), Ref «2», Ref [3]' becomes 'Ref , Ref , Ref '.\n * @param {string} text - The input text containing single digit references.\n * @returns {string} - The modified text with single digit references removed.\n */\nexport const removeSingleDigitReferences = (text: string): string => {\n    return text.replace(/\\(\\d{1}\\)|\\[\\d{1}\\]|«\\d»/g, '');\n};\n\n/**\n * Removes URLs from the text.\n * Example: 'Visit https://example.com' becomes 'Visit '.\n * @param {string} text - The input text containing URLs.\n * @returns {string} - The modified text with URLs removed.\n */\nexport const removeUrls = (text: string): string => {\n    return text.replace(\n        /https?:\\/\\/(www\\.)?[-a-zA-Z0-9@:%._+~#=]{1,256}\\.[a-zA-Z0-9()]{1,6}\\b([-a-zA-Z0-9()@:%_+.~#?&//=]*)/g,\n        '',\n    );\n};\n","import { normalizeSpaces } from './formatting';\n\n/**\n * Replaces common Arabic prefixes (like 'Al-', 'Ar-', 'Ash-', etc.) with 'al-' in the text.\n * Handles different variations of prefixes such as Ash- and Al- but not when the second word\n * does not start with 'S'.\n * Example: 'Ash-Shafiee' becomes 'al-Shafiee'.\n *\n * @param {string} text - The input text containing Arabic prefixes.\n * @returns {string} - The modified text with standardized 'al-' prefixes.\n */\nexport const normalizeArabicPrefixesToAl = (text: string): string => {\n    return text\n        .replace(/(\\b|\\W)(Al |Al-|Ar-|As-|Adh-|Ad-|Ats-|Ath |Ath-|Az |Az-|az-|adh-|as-|ar-)/g, '$1al-')\n        .replace(/(\\b|\\W)(Ash-S|ash-S)/g, '$1al-S')\n        .replace(/al- (.+?)\\b/g, 'al-$1');\n};\n\n/**\n * Removes double occurrences of Arabic apostrophes such as ʿʿ or ʾʾ in the text.\n * Example: 'ʿulamāʾʾ' becomes 'ʿulamāʾ'.\n *\n * @param {string} text - The input text containing double apostrophes.\n * @returns {string} - The modified text with condensed apostrophes.\n */\nexport const normalizeDoubleApostrophes = (text: string): string => {\n    return text.replace(/ʿʿ/g, 'ʿ').replace(/ʾʾ/g, 'ʾ');\n};\n\n/**\n * Replaces common salutations such as \"sallahu alayhi wasallam\" with \"ﷺ\" in the text.\n * It also handles variations of the salutation phrase, including 'peace and blessings be upon him'.\n * Example: 'Then Muḥammad (sallahu alayhi wasallam)' becomes 'Then Muḥammad ﷺ'.\n *\n * @param {string} text - The input text containing salutations.\n * @returns {string} - The modified text with salutations replaced.\n */\nexport const replaceSalutationsWithSymbol = (text: string): string => {\n    return text\n        .replace(\n            /\\(peace be upon him\\)|(Messenger of (Allah|Allāh)|Messenger|Prophet|Mu[hḥ]ammad) *\\((s[^)]*m|peace[^)]*him|May[^)]*him|may[^)]*him)\\)*/gi,\n            '$1 ﷺ',\n        )\n        .replace(/,\\s*ﷺ\\s*,/g, ' ﷺ');\n};\n\n/**\n * Normalizes the text by removing diacritics, apostrophes, and dashes.\n * Example: 'Al-Jadwal' becomes 'AlJadwal'.\n *\n * @param {string} input - The input text to normalize.\n * @returns {string} - The normalized text.\n */\nexport const normalize = (input: string) => {\n    return input\n        .normalize('NFKD')\n        .replace(/[\\u0300-\\u036f]/g, '')\n        .replace(/`|ʾ|ʿ|-/g, '');\n};\n\n/**\n * Replaces various apostrophe characters (‛, ’, ‘) with the standard apostrophe (').\n * Example: '‛ulama’ al-su‘' becomes ''ulama' al-su''.\n *\n * @param {string} text - The input text containing different apostrophe characters.\n * @returns {string} - The modified text with normalized apostrophes.\n */\nexport const normalizeApostrophes = (text: string): string => {\n    return text.replace(/‛|’|‘/g, \"'\");\n};\n\n/**\n * Strips common Arabic prefixes like 'al-', 'bi-', 'fī', 'wa-', etc. from the beginning of words.\n * Example: 'al-Bukhari' becomes 'Bukhari'.\n *\n * @param {string} text - The input text containing Arabic prefixes.\n * @returns {string} - The modified text with prefixes stripped.\n */\nexport const removeArabicPrefixes = (text: string): string => {\n    return normalizeSpaces(text.replace(/(\\bal-|\\bli-|\\bbi-|\\bfī|\\bwa[-\\s]+|\\bl-|\\bliʿl|\\Bʿalá|\\Bʿan|\\bb\\.)/gi, ''));\n};\n\n/**\n * Simplifies English transliterations by removing diacritics, apostrophes, and common prefixes.\n * Example: 'Al-Jadwal' becomes 'Jadwal', and 'āḍġḥīṣṭū' becomes 'adghistu'.\n *\n * @param {string} text - The input text to simplify.\n * @returns {string} - The simplified text.\n */\nexport const normalizeTransliteratedEnglish = (text: string): string => normalize(removeArabicPrefixes(text));\n\n/**\n * Extracts the initials from the input string, typically used for names or titles.\n * Example: 'Nayl al-Awtar' becomes 'NA'.\n *\n * @param {string} text - The input text to extract initials from.\n * @returns {string} - The extracted initials.\n */\nexport const extractInitials = (fullName: string) => {\n    const initials = normalizeTransliteratedEnglish(fullName)\n        .trim()\n        .split(/[ -]/)\n        .slice(0, 2)\n        .map((word) => {\n            return word.charAt(0).toUpperCase();\n        })\n        .join('');\n    return initials;\n};\n"],"names":[],"version":3,"file":"main.js.map","sourceRoot":"../"}
+{"mappings":";;;;;;;;;;;;;;;;;;;;;ACAA;;;;;;CAMC,GACM,MAAM,4CAAgC,CAAC;IAC1C,OAAO,KAAK,OAAO,CAAC,sCAAsC;AAC9D;AAQO,MAAM,4CAA6B,CAAC;IACvC,OAAO,KAAK,OAAO,CAAC,MAAM,UAAK,OAAO,CAAC,MAAM;AACjD;AASO,MAAM,4CAAiB,CAAC;IAC3B,OAAO,KAAK,OAAO,CAAC,QAAQ;AAChC;AAQO,MAAM,4CAAsC,CAAC;IAChD,OAAO,KAAK,OAAO,CAAC,4BAA4B;AACpD;AAQO,MAAM,4CAAmC,CAAC;IAC7C,OAAO,KAAK,OAAO,CAAC,yCAAyC;AACjE;AAQO,MAAM,4CAA2B,CAAC;IACrC,OAAO,KACF,OAAO,CAAC,kEAAkE,KAC1E,OAAO,CAAC,+DAA+D;AAChF;AAQO,MAAM,4CAAsB,CAAC;IAChC,OAAO,KAAK,OAAO,CAAC,4CAA4C;AACpE;AAQO,MAAM,4CAA8B,CAAC;IACxC,OAAO,KAAK,OAAO,CAAC,8BAA8B;AACtD;AAQO,MAAM,4CAAe,CAAC;IACzB,2BAA2B;IAC3B,qEAAqE;IACrE,2EAA2E;IAC3E,OAAO,KAAK,OAAO,CAAC,8BAA8B;AACtD;AAQO,MAAM,4CAA0B,CAAC;IACpC,OAAO,KAAK,OAAO,CAAC,QAAQ;AAChC;AAQO,MAAM,4CAAkB,CAAC;IAC5B,OAAO,KAAK,OAAO,CACf,iMACA;AAER;AAQO,MAAM,4CAA2B,CAAC;IACrC,OAAO,KAAK,OAAO,CAAC,oDAAoD;AAC5E;AAQO,MAAM,4CAAsB,CAAC;IAChC,OAAO,KAAK,OAAO,CAAC,SAAS;AACjC;AAQO,MAAM,4CAAsC,CAAC;IAChD,OAAO,KACF,OAAO,CAAC,WAAW,UACnB,OAAO,CAAC,qBAAqB,UAC7B,OAAO,CAAC,SAAS;AAC1B;AAQO,MAAM,4CAAwB,CAAC;IAClC,OAAO,KAAK,OAAO,CAAC,UAAU;AAClC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACjKA;;;;;CAKC,GACM,MAAM,4CAAmC,CAAC;IAC7C,8DAA8D;IAC9D,MAAM,cAAc;IAEpB,mHAAmH;IACnH,MAAM,gBAAgB,KAAK,OAAO,CAAC,aAAa,QAAQ,OAAO,CAAC,UAAU,MAAM,IAAI;IAEpF,OAAO;AACX;AAQO,MAAM,4CAAoC,CAAC;IAC9C,OAAO,KACF,OAAO,CAAC,kDAAkD,SAC1D,OAAO,CAAC,oCAAoC,QAC5C,OAAO,CAAC,wDAAwD,UAChE,OAAO,CAAC,0EAA0E;AAC3F;AASO,MAAM,4CAAmB,CAAC;IAC7B,OAAO,KACF,OAAO,CAAC,SAAS,KACjB,OAAO,CAAC,cAAc,kBACtB,OAAO,CAAC,OAAO;AACxB;AAQO,MAAM,4CAAuB,CAAC;IACjC,OAAO,KAAK,OAAO,CAAC,WAAW;AACnC;AAQO,MAAM,4CAAkB,CAAC;IAC5B,OAAO,KAAK,OAAO,CAAC,aAAa;AACrC;AAOO,MAAM,4CAAsB,CAAC;IAChC,OAAO,gBAAgB,IAAI,CAAC;AAChC;AAOO,MAAM,4CAAoB,CAAC;IAC9B,MAAM,QAAQ;IACd,OAAO,MAAM,IAAI,CAAC;AACtB;AAEO,MAAM,4CAAoB,CAAC;IAC9B,MAAM,UAAU,0CAAgB;IAChC,MAAM,QAAQ,QAAQ,KAAK,CAAC,MAAM,MAAM,CAAC,CAAC;QACtC,OAAO,CAAC,QAAS,KAAK,MAAM,GAAG,KAAK,CAAC,0CAAkB;IAC3D;IAEA,OAAO,MAAM,IAAI,CAAC,MAAM,IAAI;AAChC;AAQO,MAAM,4CAA0B,CAAC;IACpC,OAAO,KAAK,OAAO,CAAC,oBAAoB;AAC5C;AAQO,MAAM,4CAAoB,CAAC;IAC9B,OAAO,KAAK,OAAO,CAAC,aAAa;AACrC;AAQO,MAAM,4CAAiB,CAAC;IAC3B,OAAO,KAAK,OAAO,CAAC,gBAAgB;AACxC;AAQO,MAAM,4CAAiB,CAAC;IAC3B,OAAO,KAAK,OAAO,CAAC,UAAU;AAClC;AAQO,MAAM,4CAAmB,CAAC;IAC7B,OAAO,KAAK,OAAO,CAAC,WAAW;AACnC;AAQO,MAAM,4CAAgC,CAAC;IAC1C,OAAO,KAAK,OAAO,CAAC,gBAAgB;AACxC;AAQO,MAAM,4CAAgC,CAAC;IAC1C,OAAO,KAAK,OAAO,CAAC,gBAAgB;AACxC;AAQO,MAAM,4CAAkB,CAAC;IAC5B,OAAO,KAAK,OAAO,CAAC,WAAW;AACnC;AAQO,MAAM,4CAAsB,CAAC;IAChC,OAAO,KAAK,OAAO,CAAC,UAAU,UAAK,OAAO,CAAC,OAAO;AACtD;AAQO,MAAM,4CAAyB,CAAC;IACnC,OAAO,KAAK,OAAO,CAAC,4BAA4B;AACpD;AAQO,MAAM,4CAAkC,CAAC;IAC5C,OAAO,KAAK,OAAO,CAAC,YAAY,QAAK,OAAO,CAAC,YAAY;AAC7D;AASO,MAAM,4CAAyB,CAAC;IACnC,MAAM,gBAAgB;IACtB,MAAM,YAAsB,EAAE;IAC9B,MAAM,QAAQ,MAAM,KAAK,CAAC;IAC1B,IAAI,kBAAkB;IAEtB,MAAM,OAAO,CAAC,CAAC;QACX,MAAM,cAAc,KAAK,IAAI;QAC7B,MAAM,aAAa,cAAc,IAAI,CAAC;QACtC,MAAM,WAAW,gBAAgB,IAAI,CAAC;QAEtC,IAAI,cAAc,CAAC,UAAU;YACzB,IAAI,iBAAiB;gBACjB,UAAU,IAAI,CAAC,gBAAgB,IAAI;gBACnC,kBAAkB;YACtB;YACA,UAAU,IAAI,CAAC;QACnB,OAAO;YACH,mBAAmB,GAAG,YAAY,CAAC,CAAC;YACpC,MAAM,WAAW,gBAAgB,IAAI,GAAG,KAAK,CAAC;YAC9C,IAAI,QAAQ,IAAI,CAAC,WAAW;gBACxB,UAAU,IAAI,CAAC,gBAAgB,IAAI;gBACnC,kBAAkB;YACtB;QACJ;IACJ;IAEA,uCAAuC;IACvC,IAAI,iBACA,UAAU,IAAI,CAAC,gBAAgB,IAAI;IAGvC,OAAO,UAAU,IAAI,CAAC;AAC1B;AAQO,MAAM,4CAA6B,CAAC;IACvC,OAAO,KAAK,OAAO,CAAC,uBAAuB;AAC/C;AAQO,MAAM,4CAAkB,CAAC;IAC5B,OAAO,KAAK,OAAO,CAAC,WAAW;AACnC;AAQO,MAAM,4CAA4B,CAAC;IACtC,OAAO,KAAK,OAAO,CAAC,sBAAsB;AAC9C;AAkBO,MAAM,4CAA6B,CAAC;IACvC,OAAO,KAAK,OAAO,CAAC,eAAe;AACvC;AAQO,MAAM,4CAA4B,CAAC;IACtC,OAAO,KAAK,OAAO,CAAC,6BAA6B;AACrD;AAOO,MAAM,4CAAmB,CAAC;IAC7B,oCAAoC;IACpC,MAAM,mBAAmB,KAAK,SAAS,CAAC;IAExC,+EAA+E;IAC/E,OAAO,iBAAiB,OAAO,CAAC,oBAAoB,IAAI,IAAI;AAChE;AAQO,MAAM,4CAAsB,CAAC;IAChC,MAAM,YAAoC;QACtC,gBAAgB;QAChB,gBAAgB;QAChB,gBAAa;QACb,gBAAgB;QAChB,gBAAgB;QAChB,gBAAa;QACb,gBAAgB;QAChB,gBAAgB;QAChB,gBAAgB;QAChB,gBAAgB;QAChB,gBAAa;QACb,gBAAgB;QAChB,gBAAgB;QAChB,gBAAa;QACb,gBAAgB;QAChB,gBAAgB;QAChB,gBAAgB;QAChB,gBAAgB;QAChB,gBAAgB;QAChB,gBAAgB;QAChB,gBAAgB;QAChB,gBAAgB;QAChB,gBAAgB;QAChB,gBAAgB;QAChB,gBAAgB;QAChB,gBAAgB;QAChB,gBAAgB;QAChB,gBAAa;QACb,gBAAgB;QAChB,gBAAgB;QAChB,gBAAgB;QAChB,gBAAgB;QAChB,gBAAgB;QAChB,gBAAgB;QAChB,gBAAgB;QAChB,gBAAgB;QAChB,gBAAgB;QAChB,gBAAgB;QAChB,gBAAgB;QAChB,gBAAgB;QAChB,gBAAgB;QAChB,gBAAgB;QAChB,gBAAgB;QAChB,gBAAgB;QAChB,gBAAgB;QAChB,gBAAgB;QAChB,gBAAgB;QAChB,gBAAgB;QAChB,gBAAgB;QAChB,gBAAgB;QAChB,gBAAgB;QAChB,gBAAgB;QAChB,gBAAgB;QAChB,gBAAgB;QAChB,gBAAgB;QAChB,gBAAgB;QAChB,gBAAgB;IACpB;IAEA,OAAO,KAAK,OAAO,CAAC,6EAA6E,CAAC;QAC9F,OAAO,SAAS,CAAC,MAAM,IAAI;IAC/B;AACJ;AAOO,MAAM,4CAAe,CAAC;IACzB,OAAO,0CAAoB,0CAAiB;AAChD;AAQO,MAAM,4CAAwB,CAAC;IAClC,OAAO,KAAK,OAAO,CAAC,gCAAgC;AACxD;;;;;;;;;ACtZA;;;;;;;;;;;CAWC,GACM,MAAM,4CAAsB,CAAC;IAChC,IAAI,QAAQ,IAAI,OAAO,CAAC,mBAAmB;IAC3C,QAAQ,MAAM,OAAO,CAAC,kBAAkB;IACxC,QAAQ,MAAM,OAAO,CAAC,kBAAkB;IAExC,OAAO,KAAK,SAAS,CAAC,KAAK,KAAK,CAAC;AACrC;AAcO,MAAM,4CAAuB,CAAC;IACjC,6EAA6E;IAC7E,MAAM,kBACF;IACJ,OAAO,gBAAgB,IAAI,CAAC,IAAI,IAAI;AACxC;AAgBO,MAAM,4CAAgB,CAAC;IAC1B,MAAM,QAAQ;IACd,OAAO,AAAC,CAAA,MAAM,KAAK,CAAC,UAAU,EAAE,AAAD,EAAG,GAAG,CAAC,CAAC,IAAe,EAAE,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,MAAM;AAC/F;AAEA;;;;;;;;;;;;;CAaC,GACD,MAAM,0CAAoB,CAAC;IACvB,IAAI,aAAa;IACjB,KAAK,MAAM,QAAQ,IACf,IAAI,SAAS,KACT;IAGR,OAAO,aAAa,MAAM;AAC9B;AAEA,MAAM,iCAAW;IAAE,KAAK;IAAK,KAAK;IAAK,KAAK;AAAI;AAChD,MAAM,qCAAe,IAAI,IAAI;IAAC;IAAK;IAAK;CAAI;AAC5C,MAAM,sCAAgB,IAAI,IAAI;IAAC;IAAK;IAAK;CAAI;AAE7C;;;;;;;;;;;;;;;;;CAiBC,GAED,MAAM,4CAAsB,CAAC;IACzB,MAAM,QAAkB,EAAE;IAE1B,KAAK,MAAM,QAAQ,IAAK;QACpB,IAAI,mCAAa,GAAG,CAAC,OACjB,MAAM,IAAI,CAAC;aACR,IAAI,oCAAc,GAAG,CAAC,OAAO;YAChC,MAAM,WAAW,MAAM,GAAG;YAC1B,IAAI,CAAC,YAAY,8BAAQ,CAAC,SAAkC,KAAK,MAC7D,OAAO;QAEf;IACJ;IAEA,OAAO,MAAM,MAAM,KAAK;AAC5B;AAsBO,MAAM,2CAAa,CAAC;IACvB,OAAO,wCAAkB,QAAQ,0CAAoB;AACzD;;;;;;;;;;;;;;;;AChJA;;;;;CAKC,GACM,MAAM,4CAAgC,CAAC;IAC1C,OAAO,KAAK,OAAO,CACf,yHACA;AAER;AAQO,MAAM,4CAA2B,CAAC;IACrC,OAAO,KAAK,OAAO,CAAC,cAAc;AACtC;AAQO,MAAM,4CAA8B,CAAC;IACxC,OAAO,KAAK,OAAO,CAAC,QAAQ;AAChC;AAQO,MAAM,4CAAiB,CAAC;IAC3B,OAAO,KAAK,OAAO,CAAC,UAAU;AAClC;AAQO,MAAM,4CAAkB,CAAC;IAC5B,OAAO,KAAK,OAAO,CAAC,0DAA0D;AAClF;AAQO,MAAM,4CAAyB,CAAC;IACnC,OAAO,KAAK,OAAO,CAAC,UAAU;AAClC;AAQO,MAAM,4CAA8B,CAAC;IACxC,OAAO,KAAK,OAAO,CAAC,6BAA6B;AACrD;AAQO,MAAM,4CAAa,CAAC;IACvB,OAAO,KAAK,OAAO,CACf,wGACA;AAER;AAkBO,MAAM,4CAAW,CAAC,KAAa,IAAI,GAAG,GAAc,IAAI,MAAM,GAAG,IAAI,GAAG,IAAI,SAAS,CAAC,GAAG,IAAI,GAAG,QAAC,CAAC,GAAG;AAsBrG,MAAM,4CAAiB,CAAC,MAAc,YAAoB,EAAE,EAAE;IACjE,IAAI,KAAK,MAAM,IAAI,WACf,OAAO;IAGX,wEAAwE;IACxE,MAAM,mBAAmB,KAAK,GAAG,CAAC,GAAG,KAAK,KAAK,CAAC,YAAY;IAC5D,MAAM,kBAAkB,aAAa;IAErC,oDAAoD;IACpD,MAAM,kBAAkB,YAAY;IAEpC,6DAA6D;IAC7D,MAAM,cAAc,kBAAkB;IAEtC,uDAAuD;IACvD,IAAI,cAAc,GACd,6DAA6D;IAC7D,OAAO,GAAG,KAAK,SAAS,CAAC,GAAG,YAAY,GAAG,QAAC,CAAC;IAGjD,MAAM,eAAe,KAAK,SAAS,CAAC,GAAG;IACvC,MAAM,aAAa,KAAK,SAAS,CAAC,KAAK,MAAM,GAAG;IAEhD,OAAO,GAAG,aAAa,QAAC,EAAE,YAAY;AAC1C;AAqBO,MAAM,2CAAiB,CAAC,QAAkB,MAAM,OAAO,CAAC,QAAQ,KAAK,IAAI;;;;;;;;;;;;;;AC/JzE,MAAM,4CAA8B,CAAC;IACxC,OAAO,KACF,OAAO,CAAC,8EAA8E,SACtF,OAAO,CAAC,yBAAyB,UACjC,OAAO,CAAC,gBAAgB;AACjC;AASO,MAAM,4CAA6B,CAAC;IACvC,OAAO,KAAK,OAAO,CAAC,OAAO,UAAK,OAAO,CAAC,OAAO;AACnD;AAUO,MAAM,4CAA+B,CAAC;IACzC,OAAO,KACF,OAAO,CACJ,4IACA,aAEH,OAAO,CAAC,cAAc;AAC/B;AASO,MAAM,0CAAY,CAAC;IACtB,OAAO,MACF,SAAS,CAAC,QACV,OAAO,CAAC,oBAAoB,IAC5B,OAAO,CAAC,YAAY;AAC7B;AASO,MAAM,4CAAuB,CAAC;IACjC,OAAO,KAAK,OAAO,CAAC,UAAU;AAClC;AASO,MAAM,4CAAuB,CAAC;IACjC,OAAO,CAAA,GAAA,yCAAc,EAAE,KAAK,OAAO,CAAC,wEAAwE;AAChH;AASO,MAAM,4CAAiC,CAAC,OAAiB,wCAAU,0CAAqB;AASxF,MAAM,4CAAkB,CAAC;IAC5B,MAAM,WAAW,0CAA+B,UAC3C,IAAI,GACJ,KAAK,CAAC,QACN,KAAK,CAAC,GAAG,GACT,GAAG,CAAC,CAAC;QACF,OAAO,KAAK,MAAM,CAAC,GAAG,WAAW;IACrC,GACC,IAAI,CAAC;IACV,OAAO;AACX;","sources":["src/index.ts","src/arabic.ts","src/formatting.ts","src/parsing.ts","src/sanitization.ts","src/transliteration.ts"],"sourcesContent":["export * from './arabic';\nexport * from './formatting';\nexport * from './parsing';\nexport * from './sanitization';\nexport * from './transliteration';\n","/**\n * Removes extreme Arabic underscores (ـ) that appear at the beginning or end of a line or in text.\n * Does not affect Hijri dates (e.g., 1424هـ) or specific Arabic terms.\n * Example: \"ـThis is a textـ\" will be changed to \"This is a text\".\n * @param {string} text - The input text to apply the rule to.\n * @returns {string} - The modified text with extreme underscores removed.\n */\nexport const cleanExtremeArabicUnderscores = (text: string) => {\n    return text.replace(/(?<!\\d ?ه|اه)ـ(?=\\r?$)|^ـ(?!اهـ)/gm, '');\n};\n\n/**\n * Converts Urdu symbols to their Arabic equivalents.\n * Example: 'ھذا' will be changed to 'هذا', 'ی' to 'ي'.\n * @param {string} text - The input text containing Urdu symbols.\n * @returns {string} - The modified text with Urdu symbols converted to Arabic symbols.\n */\nexport const convertUrduSymbolsToArabic = (text: string) => {\n    return text.replace(/ھ/g, 'ه').replace(/ی/g, 'ي');\n};\n\n/**\n * Fixes the trailing \"و\" (wow) in phrases such as \"عليكم و رحمة\" to \"عليكم ورحمة\".\n * This function attempts to correct phrases where \"و\" appears unnecessarily, particularly in greetings.\n * Example: 'السلام عليكم و رحمة' will be changed to 'السلام عليكم ورحمة'.\n * @param {string} text - The input text containing the \"و\" character.\n * @returns {string} - The modified text with unnecessary trailing \"و\" characters corrected.\n */\nexport const fixTrailingWow = (text: string) => {\n    return text.replace(/ و /g, ' و');\n};\n\n/**\n * Inserts a space between Arabic text and numbers.\n * Example: 'الآية37' will be changed to 'الآية 37'.\n * @param {string} text - The input text containing Arabic text followed by numbers.\n * @returns {string} - The modified text with spaces inserted between Arabic text and numbers.\n */\nexport const addSpaceBetweenArabicTextAndNumbers = (text: string) => {\n    return text.replace(/([\\u0600-\\u06FF]+)(\\d+)/g, '$1 $2');\n};\n\n/**\n * Removes English letters and symbols from the text, including ampersands, slashes, and other symbols.\n * Example: 'أحب & لنفسي' will be changed to 'أحب   لنفسي'.\n * @param {string} text - The input text containing English letters and symbols.\n * @returns {string} - The modified text with English letters and symbols removed.\n */\nexport const stripEnglishCharactersAndSymbols = (text: string) => {\n    return text.replace(/[a-zA-Z]+[0-9]*|[¬§`ﷺ=]|\\/{2,}|&/g, ' ');\n};\n\n/**\n * Removes single-digit numbers surrounded by Arabic text. Also removes dashes (-) not followed by a number.\n * For example, removes '3' from 'وهب 3 وقال' but does not remove '121' from 'لوحه 121 الجرح'.\n * @param {string} text - The input text to apply the rule to.\n * @returns {string} - The modified text with non-index numbers and dashes removed.\n */\nexport const removeNonIndexSignatures = (text: string) => {\n    return text\n        .replace(/(?<![0-9] ?)-|(?<=[\\u0600-\\u06FF])\\s?\\d\\s?(?=[\\u0600-\\u06FF])/g, ' ')\n        .replace(/(?<=[\\u0600-\\u06FF]\\s)(\\d+\\s)+\\d+(?=(\\s[\\u0600-\\u06FF]|$))/g, ' ');\n};\n\n/**\n * Removes characters enclosed in square brackets [] or parentheses () if they are Arabic letters or Arabic-Indic numerals.\n * Example: '[س]' or '(س)' will be removed.\n * @param {string} text - The input text to apply the rule to.\n * @returns {string} - The modified text with singular codes removed.\n */\nexport const removeSingularCodes = (text: string) => {\n    return text.replace(/[[({][\\u0621-\\u064A\\u0660-\\u0669][\\])}]/g, '');\n};\n\n/**\n * Removes solitary Arabic letters unless they are the 'ha' letter, which is used in Hijri years.\n * Example: \"ب ا الكلمات ت\" will be changed to \"ا الكلمات\".\n * @param {string} text - The input text to apply the rule to.\n * @returns {string} - The modified text with solitary Arabic letters removed.\n */\nexport const removeSolitaryArabicLetters = (text: string) => {\n    return text.replace(/(^| )[\\u0621-\\u064A]( |$)/g, ' ');\n};\n\n/**\n * Removes tatweel characters while preserving dates references and numbered list items.\n * Example: \"1435/3/29 هـ\" remains as \"1435/3/29 هـ\" but \"أبـــتِـــكَةُ\" becomes \"أبتِكَةُ\"\n * @param text The text to format.\n * @returns The modified text with the tatweel characters removed.\n */\nexport const removeTatwil = (text: string) => {\n    // Don't remove tatweel if:\n    // 1. Immediately preceded by a number or ه (for dates like \"1435هـ\")\n    // 2. Preceded by a number with optional spaces (for list items like \"3 ـ\")\n    return text.replace(/(?<![0-9ه])(?<![0-9]\\s*)ـ/g, '');\n};\n\n/**\n * Replaces the 'tah marbutah' (ة) character with 'ha' (ه).\n * Example: 'مدرسة' will be changed to 'مدرسه'.\n * @param {string} text - The input text to apply the rule to.\n * @returns {string} - The modified text with 'ta marbutah' replaced by 'ha'.\n */\nexport const replaceTaMarbutahWithHa = (text: string) => {\n    return text.replace(/[ة]/g, 'ه');\n};\n\n/**\n * Removes Arabic diacritics (tashkeel) and the tatweel (elongation) character.\n * Example: 'مُحَمَّدٌ' will be changed to 'محمد'.\n * @param {string} text - The input text to apply the rule to.\n * @returns {string} - The modified text with diacritics and tatweel removed.\n */\nexport const stripDiacritics = (text: string) => {\n    return text.replace(\n        /[\\u0610\\u0611\\u0612\\u0613\\u0614\\u0615\\u0616\\u0617\\u0618\\u0619\\u061A\\u064B\\u064C\\u064D\\u064E\\u064F\\u0650\\u0651\\u0652\\u0653\\u0654\\u0655\\u0656\\u0657\\u0658\\u065A\\u065B\\u065C\\u065D\\u065E\\u0640]/g,\n        '',\n    );\n};\n\n/**\n * Removes zero-width joiners (ZWJ) and other zero-width characters from the input text.\n * Zero-width characters include U+200B to U+200F, U+202A to U+202E, U+2060 to U+2064, and U+FEFF.\n * @param {string} text - The input text to apply the rule to.\n * @returns {string} - The modified text with zero-width characters removed.\n */\nexport const stripZeroWidthCharacters = (text: string) => {\n    return text.replace(/[\\u200B-\\u200F\\u202A-\\u202E\\u2060-\\u2064\\uFEFF]/g, ' ');\n};\n\n/**\n * Replaces the 'alif maqsurah' (ى) character with the regular 'ya' (ي).\n * Example: 'رؤيى' will be changed to 'رؤيي'.\n * @param {string} text - The input text to apply the rule to.\n * @returns {string} - The modified text with 'alif maqsurah' replaced by 'ya'.\n */\nexport const replaceAlifMaqsurah = (text: string) => {\n    return text.replace(/[ىي]/g, 'ي');\n};\n\n/**\n * Replaces English punctuation (question mark and semicolon) with their Arabic equivalents.\n * Example: '?' will be replaced with '؟', and ';' with '؛'.\n * @param {string} text - The input text to apply the rule to.\n * @returns {string} - The modified text with English punctuation replaced by Arabic punctuation.\n */\nexport const replaceEnglishPunctuationWithArabic = (text: string) => {\n    return text\n        .replace(/\\?|؟\\./g, '؟')\n        .replace(/(;|؛)\\s*(\\1\\s*)*/g, '؛')\n        .replace(/,|-،/g, '،');\n};\n\n/**\n * Simplifies all forms of 'alif' (أ, إ, and آ) to the basic 'ا'.\n * Example: 'أنا إلى الآفاق' will be changed to 'انا الى الافاق'.\n * @param {string} text - The input text to apply the rule to.\n * @returns {string} - The modified text with simplified 'alif' characters.\n */\nexport const normalizeAlifVariants = (text: string) => {\n    return text.replace(/[أإآ]/g, 'ا');\n};\n","/**\n * Adds line breaks after punctuation marks such as periods, exclamation points, and question marks.\n * Example: 'Text.' becomes 'Text.\\n'.\n * @param {string} text - The input text containing punctuation.\n * @returns {string} - The modified text with line breaks added after punctuation.\n */\nexport const insertLineBreaksAfterPunctuation = (text: string) => {\n    // Define the punctuation marks that should trigger a new line\n    const punctuation = /([.?!؟])/g;\n\n    // Replace occurrences of punctuation marks followed by a space with the punctuation mark, a newline, and the space\n    const formattedText = text.replace(punctuation, '$1\\n').replace(/\\n\\s+/g, '\\n').trim();\n\n    return formattedText;\n};\n\n/**\n * Adds spaces before and after punctuation, except for certain cases like quoted text or ayah references.\n * Example: 'Text,word' becomes 'Text, word'.\n * @param {string} text - The input text containing punctuation.\n * @returns {string} - The modified text with spaces added before and after punctuation.\n */\nexport const addSpaceBeforeAndAfterPunctuation = (text: string) => {\n    return text\n        .replace(/( ?)([.!?,،؟;؛])((?![ '”“)\"\\]\\n])|(?=\\s{2,}))/g, '$1$2 ')\n        .replace(/\\s([.!?,،؟;؛])\\s*([ '”“)\"\\]\\n])/g, '$1$2')\n        .replace(/([^\\s\\w\\d'”“)\"\\]]+)\\s+([.!?,،؟;؛])|([.!?,،؟;؛])\\s+$/g, '$1$2$3')\n        .replace(/(?<=\\D)( ?: ?)(?!(\\d+:)|(:\\d+))|(?<=\\d) ?: ?(?=\\D)|(?<=\\D) ?: ?(?=\\d)/g, ': ');\n};\n\n/**\n * Turns regular double quotes surrounding a body of text into smart quotes.\n * Also fixes incorrect starting quotes by ensuring the string starts with an opening quote if needed.\n * Example: 'The \"quick brown\" fox' becomes 'The “quick brown” fox'.\n * @param {string} text - The input text to apply the rule to.\n * @returns {string} - The modified text with smart quotes applied.\n */\nexport const applySmartQuotes = (text: string) => {\n    return text\n        .replace(/[“”]/g, '\"')\n        .replace(/\"([^\"]*)\"/g, '“$1”')\n        .replace(/^”/g, '“');\n};\n\n/**\n * Replaces literal new line characters (\\n) and carriage returns (\\r) with actual line breaks.\n * Example: 'A\\\\nB' becomes 'A\\nB'.\n * @param {string} text - The input text containing literal new lines.\n * @returns {string} - The modified text with actual line breaks.\n */\nexport const cleanLiteralNewLines = (text: string) => {\n    return text.replace(/\\\\n|\\r/g, '\\n');\n};\n\n/**\n * Removes trailing spaces from each line in a multiline string.\n * Example: \" This is a line   \\nAnother line   \" becomes \"This is a line\\nAnother line\".\n * @param {string} text - The input text to apply the rule to.\n * @returns {string} - The modified text with trailing spaces removed.\n */\nexport const cleanMultilines = (text: string) => {\n    return text.replace(/^ +| +$/gm, '');\n};\n\n/**\n * Detects if a word is by itself in a line.\n * @param text The text to check.\n * @returns true if there exists a word in any of the lines in the text that is by itself.\n */\nexport const hasWordInSingleLine = (text: string): boolean => {\n    return /^\\s*\\S+\\s*$/gm.test(text);\n};\n\n/**\n * Checks if the input string consists of only punctuation characters.\n * @param {string} text - The input text to check.\n * @returns {boolean} - Returns true if the string contains only punctuation, false otherwise.\n */\nexport const isOnlyPunctuation = (text: string): boolean => {\n    const regex = /^[\\u0020-\\u002f\\u003a-\\u0040\\u005b-\\u0060\\u007b-\\u007e0-9٠-٩]+$/;\n    return regex.test(text);\n};\n\nexport const cleanJunkFromText = (text: string) => {\n    const newBody = cleanMultilines(text);\n    const lines = newBody.split('\\n').filter((line) => {\n        return !line || (line.length > 1 && !isOnlyPunctuation(line));\n    });\n\n    return lines.join('\\n').trim();\n};\n\n/**\n * Cleans unnecessary spaces before punctuation marks such as periods, commas, and question marks.\n * Example: 'This is a sentence , with extra space .' becomes 'This is a sentence, with extra space.'.\n * @param {string} text - The input text to apply the rule to.\n * @returns {string} - The modified text with cleaned spaces before punctuation.\n */\nexport const cleanSpacesBeforePeriod = (text: string) => {\n    return text.replace(/\\s+([.؟!,،؛:?])/g, '$1');\n};\n\n/**\n * Condenses multiple asterisks (*) into a single one.\n * Example: '***' becomes '*'.\n * @param {string} text - The input text to apply the rule to.\n * @returns {string} - The modified text with condensed asterisks.\n */\nexport const condenseAsterisks = (text: string) => {\n    return text.replace(/(\\*\\s*)+/g, '*');\n};\n\n/**\n * Replaces occurrences of colons surrounded by periods (e.g., '.:.' or ':') with a single colon.\n * Example: 'This.:. is a test' becomes 'This: is a test'.\n * @param {string} text - The input text to apply the rule to.\n * @returns {string} - The modified text with condensed colons.\n */\nexport const condenseColons = (text: string) => {\n    return text.replace(/[.-]?:[.-]?/g, ':');\n};\n\n/**\n * Condenses two or more dashes (--) into a single dash (-).\n * Example: 'This is some ---- text' becomes 'This is some - text'.\n * @param {string} text - The input text to apply the rule to.\n * @returns {string} - The modified text with condensed dashes.\n */\nexport const condenseDashes = (text: string) => {\n    return text.replace(/-{2,}/g, '-');\n};\n\n/**\n * Replaces sequences of two or more periods (e.g., '...') with an ellipsis character (…).\n * Example: 'This is a test...' becomes 'This is a test…'.\n * @param {string} text - The input text to apply the rule to.\n * @returns {string} - The modified text with ellipses condensed.\n */\nexport const condenseEllipsis = (text: string) => {\n    return text.replace(/\\.{2,}/g, '…');\n};\n\n/**\n * Reduces multiple consecutive line breaks (3 or more) to exactly 2 line breaks.\n * Example: 'This is line 1\\n\\n\\n\\nThis is line 2' becomes 'This is line 1\\n\\nThis is line 2'.\n * @param {string} text - The input text to apply the rule to.\n * @returns {string} - The modified text with condensed line breaks.\n */\nexport const reduceMultilineBreaksToDouble = (text: string) => {\n    return text.replace(/(\\n\\s*){3,}/g, '\\n\\n');\n};\n\n/**\n * Reduces multiple consecutive line breaks (2 or more) to exactly 1 line break.\n * Example: 'This is line 1\\n\\nThis is line 2' becomes 'This is line 1\\nThis is line 2'.\n * @param {string} text - The input text to apply the rule to.\n * @returns {string} - The modified text with condensed line breaks.\n */\nexport const reduceMultilineBreaksToSingle = (text: string) => {\n    return text.replace(/(\\n\\s*){2,}/g, '\\n');\n};\n\n/**\n * Condenses multiple periods separated by spaces (e.g., '. . .') into a single period.\n * Example: 'This . . . is a test' becomes 'This. is a test'.\n * @param {string} text - The input text to apply the rule to.\n * @returns {string} - The modified text with condensed periods.\n */\nexport const condensePeriods = (text: string) => {\n    return text.replace(/\\. +\\./g, '.');\n};\n\n/**\n * Condenses multiple underscores (__) or Arabic Tatweel characters (ـــــ) into a single underscore or Tatweel.\n * Example: 'This is ـــ some text __' becomes 'This is ـ some text _'.\n * @param {string} text - The input text to apply the rule to.\n * @returns {string} - The modified text with condensed underscores.\n */\nexport const condenseUnderscores = (text: string) => {\n    return text.replace(/ـ{2,}/g, 'ـ').replace(/_+/g, '_');\n};\n\n/**\n * Replaces double parentheses or brackets with single ones.\n * Example: '((text))' becomes '(text)'.\n * @param {string} text - The input text to apply the rule to.\n * @returns {string} - The modified text with condensed brackets.\n */\nexport const doubleToSingleBrackets = (text: string) => {\n    return text.replace(/(\\(|\\)){2,}|(\\[|\\]){2,}/g, '$1$2');\n};\n\n/**\n * Replaces double parentheses single a single arrow variation.\n * Example: '((text))' becomes '«text»'.\n * @param {string} text - The input text to apply the rule to.\n * @returns {string} - The modified text with condensed brackets.\n */\nexport const replaceDoubleBracketsWithArrows = (text: string) => {\n    return text.replace(/\\(\\(\\s?/g, '«').replace(/\\s?\\)\\)/g, '»');\n};\n\n/**\n * Formats a multiline string by joining sentences and maintaining footnotes on their own lines.\n * Footnotes are identified by Arabic and English numerals.\n * Example: 'Sentence one.\\n(1) A footnote.\\nSentence two.' remains the same, while regular sentences are joined.\n * @param {string} input - The input text containing sentences and footnotes.\n * @returns {string} - The formatted text.\n */\nexport const formatStringBySentence = (input: string) => {\n    const footnoteRegex = /^\\((?:\\d+|۱|۲|۳|۴|۵|۶|۷|۸|۹)\\)\\s/;\n    const sentences: string[] = [];\n    const lines = input.split('\\n');\n    let currentSentence = '';\n\n    lines.forEach((line) => {\n        const trimmedLine = line.trim();\n        const isFootnote = footnoteRegex.test(trimmedLine);\n        const isNumber = /^\\(\\d+\\/\\d+\\)/.test(trimmedLine);\n\n        if (isFootnote && !isNumber) {\n            if (currentSentence) {\n                sentences.push(currentSentence.trim());\n                currentSentence = '';\n            }\n            sentences.push(trimmedLine);\n        } else {\n            currentSentence += `${trimmedLine} `;\n            const lastChar = currentSentence.trim().slice(-1);\n            if (/[.!؟]/.test(lastChar)) {\n                sentences.push(currentSentence.trim());\n                currentSentence = '';\n            }\n        }\n    });\n\n    // Add any remaining text to the output\n    if (currentSentence) {\n        sentences.push(currentSentence.trim());\n    }\n\n    return sentences.join('\\n');\n};\n\n/**\n * Removes unnecessary spaces around slashes in references.\n * Example: '127 / 11' becomes '127/11'.\n * @param {string} text - The input text containing references.\n * @returns {string} - The modified text with spaces removed around slashes.\n */\nexport const normalizeSlashInReferences = (text: string) => {\n    return text.replace(/(\\d+)\\s?\\/\\s?(\\d+)/g, '$1/$2');\n};\n\n/**\n * Reduces multiple spaces or tabs to a single space.\n * Example: 'This   is a   text' becomes 'This is a text'.\n * @param {string} text - The input text containing extra spaces.\n * @returns {string} - The modified text with reduced spaces.\n */\nexport const normalizeSpaces = (text: string) => {\n    return text.replace(/[ \\t]+/g, ' ');\n};\n\n/**\n * Ensures at most 1 space exists before any word before brackets.\n * Adds a space if there isn't one, or reduces multiple spaces to one.\n * @param {string} text - The input text to modify\n * @returns {string} - The modified text with proper spacing before brackets\n */\nexport const ensureSpaceBeforeBrackets = (text: string) => {\n    return text.replace(/(\\S) *(\\([^)]*\\))/g, '$1 $2');\n};\n\n/**\n * Removes redundant punctuation marks that follow Arabic question marks or exclamation marks.\n * This function cleans up text by removing periods (.) or Arabic commas (،) that immediately\n * follow Arabic question marks (؟) or exclamation marks (!), as they are considered redundant\n * in proper Arabic punctuation.\n *\n * @param text - The Arabic text to clean up\n * @returns The text with redundant punctuation removed\n *\n * @example\n * ```typescript\n * removeRedundantPunctuation('كيف حالك؟.') // Returns: 'كيف حالك؟'\n * removeRedundantPunctuation('ممتاز!،') // Returns: 'ممتاز!'\n * removeRedundantPunctuation('هذا جيد.') // Returns: 'هذا جيد.' (unchanged)\n * ```\n */\nexport const removeRedundantPunctuation = (text: string) => {\n    return text.replace(/([؟!])[.،]/g, '$1');\n};\n\n/**\n * Removes spaces inside brackets, parentheses, or square brackets.\n * Example: '( a b )' becomes '(a b)'.\n * @param {string} text - The input text with spaces inside brackets.\n * @returns {string} - The modified text with spaces removed inside brackets.\n */\nexport const removeSpaceInsideBrackets = (text: string) => {\n    return text.replace(/([[(])\\s*(.*?)\\s*([\\])])/g, '$1$2$3');\n};\n\n/**\n * Removes bold styling from text by normalizing the string and removing stylistic characters.\n * @param {string} text - The input text containing bold characters.\n * @returns {string} - The modified text with bold styling removed.\n */\nexport const stripBoldStyling = (text: string) => {\n    // Normalize the string to NFKD form\n    const normalizedString = text.normalize('NFKD');\n\n    // Remove combining marks (diacritics) and stylistic characters from the string\n    return normalizedString.replace(/[\\u0300-\\u036f]/g, '').trim();\n};\n\n/**\n * Removes italicized characters by replacing italic Unicode characters with their normal counterparts.\n * Example: '𝘼𝘽𝘾' becomes 'ABC'.\n * @param {string} text - The input text containing italicized characters.\n * @returns {string} - The modified text with italics removed.\n */\nexport const stripItalicsStyling = (text: string) => {\n    const italicMap: Record<string, string> = {\n        '\\uD835\\uDC4E': 'I',\n        '\\uD835\\uDC68': 'g',\n        '\\u{1D63C}': '!',\n        '\\uD835\\uDC4F': 'J',\n        '\\uD835\\uDC69': 'h',\n        '\\u{1D63D}': '?',\n        '\\uD835\\uDC50': 'K',\n        '\\uD835\\uDC6A': 'i',\n        '\\uD835\\uDC51': 'L',\n        '\\uD835\\uDC6B': 'j',\n        '\\u{1D63F}': ',',\n        '\\uD835\\uDC52': 'M',\n        '\\uD835\\uDC6C': 'k',\n        '\\u{1D640}': '.',\n        '\\uD835\\uDC53': 'N',\n        '\\uD835\\uDC6D': 'l',\n        '\\uD835\\uDC54': 'O',\n        '\\uD835\\uDC6E': 'm',\n        '\\uD835\\uDC6F': 'n',\n        '\\uD835\\uDC56': 'Q',\n        '\\uD835\\uDC70': 'o',\n        '\\uD835\\uDC57': 'R',\n        '\\uD835\\uDC71': 'p',\n        '\\uD835\\uDC58': 'S',\n        '\\uD835\\uDC72': 'q',\n        '\\uD835\\uDC59': 'T',\n        '\\uD835\\uDC73': 'r',\n        '\\u{1D647}': '-',\n        '\\uD835\\uDC5A': 'U',\n        '\\uD835\\uDC74': 's',\n        '\\uD835\\uDC5B': 'V',\n        '\\uD835\\uDC75': 't',\n        '\\uD835\\uDC5C': 'W',\n        '\\uD835\\uDC76': 'u',\n        '\\uD835\\uDC5D': 'X',\n        '\\uD835\\uDC77': 'v',\n        '\\uD835\\uDC5E': 'Y',\n        '\\uD835\\uDC78': 'w',\n        '\\uD835\\uDC5F': 'Z',\n        '\\uD835\\uDC79': 'x',\n        '\\uD835\\uDC46': 'A',\n        '\\uD835\\uDC7A': 'y',\n        '\\uD835\\uDC47': 'B',\n        '\\uD835\\uDC7B': 'z',\n        '\\uD835\\uDC62': 'a',\n        '\\uD835\\uDC48': 'C',\n        '\\uD835\\uDC63': 'b',\n        '\\uD835\\uDC49': 'D',\n        '\\uD835\\uDC64': 'c',\n        '\\uD835\\uDC4A': 'E',\n        '\\uD835\\uDC65': 'd',\n        '\\uD835\\uDC4B': 'F',\n        '\\uD835\\uDC66': 'e',\n        '\\uD835\\uDC4C': 'G',\n        '\\uD835\\uDC67': 'f',\n        '\\uD835\\uDC4D': 'H',\n        '\\uD835\\uDC55': 'P',\n    };\n\n    return text.replace(/[\\uD835\\uDC62-\\uD835\\uDC7B\\uD835\\uDC46-\\uD835\\uDC5F\\u{1D63C}-\\u{1D647}]/gu, (match) => {\n        return italicMap[match] || match;\n    });\n};\n\n/**\n * Removes all bold and italic styling from the input text.\n * @param {string} text - The input text to remove styling from.\n * @returns {string} - The modified text with all styling removed.\n */\nexport const stripStyling = (text: string) => {\n    return stripItalicsStyling(stripBoldStyling(text));\n};\n\n/**\n * Removes unnecessary spaces inside quotes.\n * Example: '“ Text ”' becomes '“Text”'.\n * @param {string} text - The input text with spaces inside quotes.\n * @returns {string} - The modified text with spaces removed inside quotes.\n */\nexport const trimSpaceInsideQuotes = (text: string) => {\n    return text.replace(/([“”\"]|«) *(.*?) *([“”\"]|»)/g, '$1$2$3');\n};\n","/**\n * Converts a string that resembles JSON but with numeric keys and single-quoted values\n * into valid JSON format. This function replaces numeric keys with quoted numeric keys\n * and ensures all values are double-quoted as required by JSON.\n *\n * @param {string} str - The input string that needs to be fixed into valid JSON.\n * @returns {string} - A valid JSON string.\n *\n * @example\n * const result = normalizeJsonSyntax(\"{10: 'abc', 20: 'def'}\");\n * console.log(result); // '{\"10\": \"abc\", \"20\": \"def\"}'\n */\nexport const normalizeJsonSyntax = (str: string) => {\n    let input = str.replace(/(\\b\\d+\\b)(?=:)/g, '\"$1\"');\n    input = input.replace(/:\\s*'([^']+)'/g, ': \"$1\"');\n    input = input.replace(/:\\s*\"([^\"]+)\"/g, ': \"$1\"');\n\n    return JSON.stringify(JSON.parse(input));\n};\n\n/**\n * Checks if a given string resembles a JSON object with numeric or quoted keys and values\n * that are single or double quoted. This is useful for detecting malformed JSON-like\n * structures that can be fixed by the `normalizeJsonSyntax` function.\n *\n * @param {string} str - The input string to check.\n * @returns {boolean} - Returns true if the string is JSON-like, false otherwise.\n *\n * @example\n * const result = isJsonStructureValid(\"{10: 'abc', 'key': 'value'}\");\n * console.log(result); // true\n */\nexport const isJsonStructureValid = (str: string) => {\n    // Checks for a pattern with numeric keys or quoted keys and values in quotes\n    const jsonLikePattern =\n        /^{(\\s*(\\d+|'[^']*'|\"[^\"]*\")\\s*:\\s*('|\")[^'\"]*\\3\\s*,)*(?:\\s*(\\d+|'[^']*'|\"[^\"]*\")\\s*:\\s*('|\")[^'\"]*\\5\\s*)}$/;\n    return jsonLikePattern.test(str.trim());\n};\n\n/**\n * Splits a string by spaces and quoted substrings.\n *\n * This function takes an input string and splits it into parts where substrings\n * enclosed in double quotes are treated as a single part. Other substrings\n * separated by spaces are split normally.\n *\n * @param {string} query - The input string to be split.\n * @returns {string[]} An array of strings, with quoted substrings kept intact.\n *\n * @example\n * const result = splitByQuotes('\"This is\" \"a part of the\" \"string and\"');\n * console.log(result); // [\"This is\", \"a part of the\", \"string and\"]\n */\nexport const splitByQuotes = (query: string): string[] => {\n    const regex = /(?:[^\\s\"]+|\"(.*?)\")+/g;\n    return (query.match(regex) || []).map((s: string) => (s.startsWith('\"') ? s.slice(1, -1) : s));\n};\n\n/**\n * Checks if all double quotes in a string are balanced (even count).\n * A string has balanced quotes if every opening quote has a corresponding closing quote.\n *\n * @param str - The string to check for balanced quotes\n * @returns True if quotes are balanced (even count), false otherwise\n *\n * @example\n * ```typescript\n * areQuotesBalanced('Hello \"world\"') // Returns: true\n * areQuotesBalanced('Hello \"world') // Returns: false\n * areQuotesBalanced('No quotes') // Returns: true\n * ```\n */\nconst areQuotesBalanced = (str: string) => {\n    let quoteCount = 0;\n    for (const char of str) {\n        if (char === '\"') {\n            quoteCount++;\n        }\n    }\n    return quoteCount % 2 === 0;\n};\n\nconst brackets = { '(': ')', '[': ']', '{': '}' };\nconst openBrackets = new Set(['(', '[', '{']);\nconst closeBrackets = new Set([')', ']', '}']);\n\n/**\n * Checks if all brackets in a string are properly balanced and matched.\n * This function validates that every opening bracket has a corresponding closing bracket\n * in the correct order and of the matching type.\n *\n * Supported bracket types: parentheses (), square brackets [], curly braces {}\n *\n * @param str - The string to check for balanced brackets\n * @returns True if all brackets are properly balanced and matched, false otherwise\n *\n * @example\n * ```typescript\n * areBracketsBalanced('(hello [world])') // Returns: true\n * areBracketsBalanced('(hello [world)') // Returns: false (mismatched)\n * areBracketsBalanced('((hello))') // Returns: true\n * areBracketsBalanced('(hello') // Returns: false (unclosed)\n * ```\n */\n\nconst areBracketsBalanced = (str: string) => {\n    const stack: string[] = [];\n\n    for (const char of str) {\n        if (openBrackets.has(char)) {\n            stack.push(char);\n        } else if (closeBrackets.has(char)) {\n            const lastOpen = stack.pop();\n            if (!lastOpen || brackets[lastOpen as keyof typeof brackets] !== char) {\n                return false;\n            }\n        }\n    }\n\n    return stack.length === 0;\n};\n\n/**\n * Checks if both quotes and brackets are balanced in a string.\n * This function combines quote balance checking and bracket balance checking\n * to ensure the entire string has properly balanced punctuation.\n *\n * A string is considered balanced when:\n * - All double quotes have matching pairs (even count)\n * - All brackets (parentheses, square brackets, curly braces) are properly matched and nested\n *\n * @param str - The string to check for balanced quotes and brackets\n * @returns True if both quotes and brackets are balanced, false otherwise\n *\n * @example\n * ```typescript\n * isBalanced('He said \"Hello (world)!\"') // Returns: true\n * isBalanced('He said \"Hello (world!\"') // Returns: false (unbalanced quote)\n * isBalanced('He said \"Hello (world)\"') // Returns: false (unbalanced quote)\n * isBalanced('Hello (world) [test]') // Returns: true\n * ```\n */\nexport const isBalanced = (str: string) => {\n    return areQuotesBalanced(str) && areBracketsBalanced(str);\n};\n","/**\n * Removes various symbols, part references, and numerical markers from the text.\n * Example: '(1) (2/3)' becomes ''.\n * @param {string} text - The input text to apply the rule to.\n * @returns {string} - The modified text with symbols and part references removed.\n */\nexport const cleanSymbolsAndPartReferences = (text: string) => {\n    return text.replace(\n        / *\\(?:\\d+(?:\\/\\d+){0,2}\\)? *| *\\[\\d+(?:\\/\\d+)?\\] *| *«\\d+» *|\\d+\\/\\d+(?:\\/\\d+)?|[،§{}۝؍‎﴿﴾<>;_؟»«:!،؛[\\]…ـ¬.\\\\/*()\"]/g,\n        ' ',\n    );\n};\n\n/**\n * Removes trailing page numbers formatted as '-[46]-' from the text.\n * Example: 'This is some -[46]- text' becomes 'This is some text'.\n * @param {string} text - The input text with trailing page numbers.\n * @returns {string} - The modified text with page numbers removed.\n */\nexport const cleanTrailingPageNumbers = (text: string) => {\n    return text.replace(/-\\[\\d+\\]-/g, '');\n};\n\n/**\n * Replaces consecutive line breaks and whitespace characters with a single space.\n * Example: 'a\\nb' becomes 'a b'.\n * @param {string} text - The input text containing line breaks or multiple spaces.\n * @returns {string} - The modified text with spaces.\n */\nexport const replaceLineBreaksWithSpaces = (text: string) => {\n    return text.replace(/\\s+/g, ' ');\n};\n\n/**\n * Removes all numeric digits from the text.\n * Example: 'abc123' becomes 'abc'.\n * @param {string} text - The input text containing digits.\n * @returns {string} - The modified text with digits removed.\n */\nexport const stripAllDigits = (text: string) => {\n    return text.replace(/[0-9]/g, '');\n};\n\n/**\n * Removes death year references like \"(d. 390H)\" and \"[d. 100h]\" from the text.\n * Example: 'Sufyān ibn ‘Uyaynah (d. 198h)' becomes 'Sufyān ibn ‘Uyaynah'.\n * @param {string} text - The input text containing death year references.\n * @returns {string} - The modified text with death years removed.\n */\nexport const removeDeathYear = (text: string) => {\n    return text.replace(/\\[(d)\\.\\s*\\d{1,4}[hH]\\]\\s*|\\((d)\\.\\s*\\d{1,4}[hH]\\)\\s*/g, '');\n};\n\n/**\n * Removes numeric digits and dashes from the text.\n * Example: 'ABC 123-Xyz' becomes 'ABC Xyz'.\n * @param {string} text - The input text containing digits and dashes.\n * @returns {string} - The modified text with numbers and dashes removed.\n */\nexport const removeNumbersAndDashes = (text: string) => {\n    return text.replace(/[\\d-]/g, '');\n};\n\n/**\n * Removes single digit references like (1), «2», [3] from the text.\n * Example: 'Ref (1), Ref «2», Ref [3]' becomes 'Ref , Ref , Ref '.\n * @param {string} text - The input text containing single digit references.\n * @returns {string} - The modified text with single digit references removed.\n */\nexport const removeSingleDigitReferences = (text: string) => {\n    return text.replace(/\\(\\d{1}\\)|\\[\\d{1}\\]|«\\d»/g, '');\n};\n\n/**\n * Removes URLs from the text.\n * Example: 'Visit https://example.com' becomes 'Visit '.\n * @param {string} text - The input text containing URLs.\n * @returns {string} - The modified text with URLs removed.\n */\nexport const removeUrls = (text: string) => {\n    return text.replace(\n        /https?:\\/\\/(www\\.)?[-a-zA-Z0-9@:%._+~#=]{1,256}\\.[a-zA-Z0-9()]{1,6}\\b([-a-zA-Z0-9()@:%_+.~#?&//=]*)/g,\n        '',\n    );\n};\n\n/**\n * Truncates a string to a specified length, adding an ellipsis if truncated.\n *\n * @param val - The string to truncate\n * @param n - Maximum length of the string (default: 150)\n * @returns The truncated string with ellipsis if needed, otherwise the original string\n *\n * @example\n * ```javascript\n * truncate('The quick brown fox jumps over the lazy dog', 20);\n * // Output: 'The quick brown fox…'\n *\n * truncate('Short text', 50);\n * // Output: 'Short text'\n * ```\n */\nexport const truncate = (val: string, n = 150): string => (val.length > n ? `${val.substring(0, n - 1)}…` : val);\n\n/**\n * Truncates a string from the middle, preserving both the beginning and end portions.\n *\n * @param text - The string to truncate\n * @param maxLength - Maximum length of the resulting string (default: 50)\n * @param endLength - Number of characters to preserve at the end (default: 1/3 of maxLength, minimum 3)\n * @returns The truncated string with ellipsis in the middle if needed, otherwise the original string\n *\n * @example\n * ```javascript\n * truncateMiddle('The quick brown fox jumps right over the lazy dog', 20);\n * // Output: 'The quick bro…zy dog'\n *\n * truncateMiddle('The quick brown fox jumps right over the lazy dog', 25, 8);\n * // Output: 'The quick brown …lazy dog'\n *\n * truncateMiddle('Short text', 50);\n * // Output: 'Short text'\n * ```\n */\nexport const truncateMiddle = (text: string, maxLength: number = 50, endLength?: number) => {\n    if (text.length <= maxLength) {\n        return text;\n    }\n\n    // Default end length is roughly 1/3 of max length, minimum 3 characters\n    const defaultEndLength = Math.max(3, Math.floor(maxLength / 3));\n    const actualEndLength = endLength ?? defaultEndLength;\n\n    // Reserve space for the ellipsis character (1 char)\n    const availableLength = maxLength - 1;\n\n    // Calculate start length (remaining space after end portion)\n    const startLength = availableLength - actualEndLength;\n\n    // Ensure we have at least some characters at the start\n    if (startLength < 1) {\n        // If we can't fit both start and end, just truncate normally\n        return `${text.substring(0, maxLength - 1)}…`;\n    }\n\n    const startPortion = text.substring(0, startLength);\n    const endPortion = text.substring(text.length - actualEndLength);\n\n    return `${startPortion}…${endPortion}`;\n};\n\n/**\n * Unescapes backslash-escaped spaces and trims whitespace from both ends.\n * Commonly used to clean file paths that have been escaped when pasted into terminals.\n *\n * @param input - The string to unescape and clean\n * @returns The cleaned string with escaped spaces converted to regular spaces and trimmed\n *\n * @example\n * ```javascript\n * unescapeSpaces('My\\\\ Folder\\\\ Name');\n * // Output: 'My Folder Name'\n *\n * unescapeSpaces('  /path/to/My\\\\ Document.txt  ');\n * // Output: '/path/to/My Document.txt'\n *\n * unescapeSpaces('regular text');\n * // Output: 'regular text'\n * ```\n */\nexport const unescapeSpaces = (input: string) => input.replace(/\\\\ /g, ' ').trim();\n","import { normalizeSpaces } from './formatting';\n\n/**\n * Replaces common Arabic prefixes (like 'Al-', 'Ar-', 'Ash-', etc.) with 'al-' in the text.\n * Handles different variations of prefixes such as Ash- and Al- but not when the second word\n * does not start with 'S'.\n * Example: 'Ash-Shafiee' becomes 'al-Shafiee'.\n *\n * @param {string} text - The input text containing Arabic prefixes.\n * @returns {string} - The modified text with standardized 'al-' prefixes.\n */\nexport const normalizeArabicPrefixesToAl = (text: string) => {\n    return text\n        .replace(/(\\b|\\W)(Al |Al-|Ar-|As-|Adh-|Ad-|Ats-|Ath |Ath-|Az |Az-|az-|adh-|as-|ar-)/g, '$1al-')\n        .replace(/(\\b|\\W)(Ash-S|ash-S)/g, '$1al-S')\n        .replace(/al- (.+?)\\b/g, 'al-$1');\n};\n\n/**\n * Removes double occurrences of Arabic apostrophes such as ʿʿ or ʾʾ in the text.\n * Example: 'ʿulamāʾʾ' becomes 'ʿulamāʾ'.\n *\n * @param {string} text - The input text containing double apostrophes.\n * @returns {string} - The modified text with condensed apostrophes.\n */\nexport const normalizeDoubleApostrophes = (text: string) => {\n    return text.replace(/ʿʿ/g, 'ʿ').replace(/ʾʾ/g, 'ʾ');\n};\n\n/**\n * Replaces common salutations such as \"sallahu alayhi wasallam\" with \"ﷺ\" in the text.\n * It also handles variations of the salutation phrase, including 'peace and blessings be upon him'.\n * Example: 'Then Muḥammad (sallahu alayhi wasallam)' becomes 'Then Muḥammad ﷺ'.\n *\n * @param {string} text - The input text containing salutations.\n * @returns {string} - The modified text with salutations replaced.\n */\nexport const replaceSalutationsWithSymbol = (text: string) => {\n    return text\n        .replace(\n            /\\(peace be upon him\\)|(Messenger of (Allah|Allāh)|Messenger|Prophet|Mu[hḥ]ammad) *\\((s[^)]*m|peace[^)]*him|May[^)]*him|may[^)]*him)\\)*/gi,\n            '$1 ﷺ',\n        )\n        .replace(/,\\s*ﷺ\\s*,/g, ' ﷺ');\n};\n\n/**\n * Normalizes the text by removing diacritics, apostrophes, and dashes.\n * Example: 'Al-Jadwal' becomes 'AlJadwal'.\n *\n * @param {string} input - The input text to normalize.\n * @returns {string} - The normalized text.\n */\nexport const normalize = (input: string) => {\n    return input\n        .normalize('NFKD')\n        .replace(/[\\u0300-\\u036f]/g, '')\n        .replace(/`|ʾ|ʿ|-/g, '');\n};\n\n/**\n * Replaces various apostrophe characters (‛, ’, ‘) with the standard apostrophe (').\n * Example: '‛ulama’ al-su‘' becomes ''ulama' al-su''.\n *\n * @param {string} text - The input text containing different apostrophe characters.\n * @returns {string} - The modified text with normalized apostrophes.\n */\nexport const normalizeApostrophes = (text: string) => {\n    return text.replace(/‛|’|‘/g, \"'\");\n};\n\n/**\n * Strips common Arabic prefixes like 'al-', 'bi-', 'fī', 'wa-', etc. from the beginning of words.\n * Example: 'al-Bukhari' becomes 'Bukhari'.\n *\n * @param {string} text - The input text containing Arabic prefixes.\n * @returns {string} - The modified text with prefixes stripped.\n */\nexport const removeArabicPrefixes = (text: string) => {\n    return normalizeSpaces(text.replace(/(\\bal-|\\bli-|\\bbi-|\\bfī|\\bwa[-\\s]+|\\bl-|\\bliʿl|\\Bʿalá|\\Bʿan|\\bb\\.)/gi, ''));\n};\n\n/**\n * Simplifies English transliterations by removing diacritics, apostrophes, and common prefixes.\n * Example: 'Al-Jadwal' becomes 'Jadwal', and 'āḍġḥīṣṭū' becomes 'adghistu'.\n *\n * @param {string} text - The input text to simplify.\n * @returns {string} - The simplified text.\n */\nexport const normalizeTransliteratedEnglish = (text: string) => normalize(removeArabicPrefixes(text));\n\n/**\n * Extracts the initials from the input string, typically used for names or titles.\n * Example: 'Nayl al-Awtar' becomes 'NA'.\n *\n * @param {string} text - The input text to extract initials from.\n * @returns {string} - The extracted initials.\n */\nexport const extractInitials = (fullName: string) => {\n    const initials = normalizeTransliteratedEnglish(fullName)\n        .trim()\n        .split(/[ -]/)\n        .slice(0, 2)\n        .map((word) => {\n            return word.charAt(0).toUpperCase();\n        })\n        .join('');\n    return initials;\n};\n"],"names":[],"version":3,"file":"main.js.map","sourceRoot":"../"}

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "bitaboom",
     "description": "Use string utils library to format Arabic and English translations.",
-    "version": "1.1.1",
+    "version": "1.3.0",
     "author": "Ragaeeb Haq",
     "license": "MIT",
     "private": false,
@@ -14,7 +14,7 @@
         "url": "git+https://github.com/ragaeeb/bitaboom.git"
     },
     "engines": {
-        "node": ">=23.0.0"
+        "node": ">=22.0.0"
     },
     "files": [
         "dist/main.js",
@@ -30,24 +30,24 @@
         "arabic"
     ],
     "devDependencies": {
-        "@eslint/js": "^9.24.0",
-        "@parcel/packager-ts": "^2.14.4",
-        "@parcel/transformer-typescript-types": "^2.14.4",
+        "@eslint/js": "^9.28.0",
+        "@parcel/packager-ts": "^2.15.2",
+        "@parcel/transformer-typescript-types": "^2.15.2",
         "@semantic-release/git": "^10.0.1",
-        "@types/node": "^22.14.1",
-        "@vitest/coverage-v8": "^3.1.1",
-        "eslint": "^9.24.0",
-        "eslint-config-prettier": "^10.1.2",
-        "eslint-plugin-perfectionist": "^4.11.0",
-        "eslint-plugin-prettier": "^5.2.6",
-        "globals": "^16.0.0",
-        "parcel": "^2.14.4",
+        "@types/node": "^22.15.30",
+        "@vitest/coverage-v8": "^3.2.2",
+        "eslint": "^9.28.0",
+        "eslint-config-prettier": "^10.1.5",
+        "eslint-plugin-perfectionist": "^4.14.0",
+        "eslint-plugin-prettier": "^5.4.1",
+        "globals": "^16.2.0",
+        "parcel": "^2.15.2",
         "prettier": "^3.5.3",
-        "semantic-release": "^24.2.3",
+        "semantic-release": "^24.2.5",
         "ts-node": "^10.9.2",
         "typescript": "^5.8.3",
-        "typescript-eslint": "^8.30.1",
-        "vitest": "^3.1.1"
+        "typescript-eslint": "^8.33.1",
+        "vitest": "^3.2.2"
     },
-    "packageManager": "pnpm@10.8.1+sha512.c50088ba998c67b8ca8c99df8a5e02fd2ae2e2b29aaf238feaa9e124248d3f48f9fb6db2424949ff901cffbb5e0f0cc1ad6aedb602cd29450751d11c35023677"
+    "packageManager": "pnpm@10.12.1+sha512.f0dda8580f0ee9481c5c79a1d927b9164f2c478e90992ad268bbb2465a736984391d6333d2c327913578b2804af33474ca554ba29c04a8b13060a717675ae3ac"
 }