urdu-text-utils 0.1.3 → 0.1.4

package/dist/index.d.cts

@@ -110,9 +110,29 @@ declare function hasUrduSpecificLetters(input: string): boolean;
 declare function countWords(input: string): number;
 /** The word list behind {@link countWords}. Useful for tokenizing before search or indexing. */
 declare function splitWords(input: string): string[];
-/** Sentences, split on ۔ ؟ ! . and ellipsis. */
-declare function countSentences(input: string): number;
-declare function splitSentences(input: string): string[];
+interface SplitSentenceOptions {
+    /** If true, the sentence-ending punctuation (۔ ؟ ! . etc.) is preserved with each sentence. Default `false`. */
+    preserveTerminators?: boolean;
+}
+/**
+ * Sentences count, split on Urdu and standard terminators (۔ ؟ ! . …).
+ * Protects common titles, abbreviations, and numeric decimals from false splits.
+ */
+declare function countSentences(input: string, options?: SplitSentenceOptions): number;
+/**
+ * Split text into sentences using Urdu punctuation rules.
+ *
+ * Handles Urdu full stop `۔`, Arabic question mark `؟`, exclamation `!`,
+ * ASCII `.`, `?`, `!`, and ellipses `…`, while protecting abbreviations and numbers.
+ *
+ * @param input - Input text.
+ * @param options - Options controlling termination preservation.
+ *
+ * @example
+ * splitSentences("پاکستان ایک خوبصورت ملک ہے۔ اس کی تاریخ پرانی ہے۔")
+ * // ["پاکستان ایک خوبصورت ملک ہے", "اس کی تاریخ پرانی ہے"]
+ */
+declare function splitSentences(input: string, options?: SplitSentenceOptions): string[];
 interface UrduStats {
     /** Every codepoint, including spaces and diacritics. */
     characters: number;
@@ -137,6 +157,46 @@ interface UrduStats {
  */
 declare function analyzeUrdu(input: string): UrduStats;
 
+/**
+ * Standard list of Urdu stop words.
+ *
+ * Covers pronouns, postpositions, auxiliaries, conjunctions, particles,
+ * and high-frequency functional words used across Urdu texts.
+ * All keys are canonical normalized Urdu.
+ */
+declare const URDU_STOP_WORDS: Set<string>;
+/**
+ * Checks if a given Urdu word is a stop word.
+ *
+ * @param word - Word to test.
+ * @param customStopWords - Optional custom stop words set or array. Defaults to {@link URDU_STOP_WORDS}.
+ *
+ * @example
+ * isStopWord("اور") // true
+ * isStopWord("کتاب") // false
+ */
+declare function isStopWord(word: string, customStopWords?: Set<string> | string[]): boolean;
+/**
+ * Filters out stop words from an array of words.
+ *
+ * @param words - Array of words to filter.
+ * @param customStopWords - Optional custom stop words set or array.
+ *
+ * @example
+ * filterStopWords(["یہ", "ایک", "اچھی", "کتاب", "ہے"]) // ["اچھی", "کتاب"]
+ */
+declare function filterStopWords(words: string[], customStopWords?: Set<string> | string[]): string[];
+/**
+ * Removes stop words from an Urdu text string, returning the cleaned text.
+ *
+ * @param text - Input Urdu text.
+ * @param customStopWords - Optional custom stop words set or array.
+ *
+ * @example
+ * removeStopWords("یہ ایک بہترین کتاب ہے") // "بہترین کتاب"
+ */
+declare function removeStopWords(text: string, customStopWords?: Set<string> | string[]): string;
+
 /**
  * Comparator for Urdu strings, usable directly in `Array.prototype.sort`.
  * Diacritics and Unicode variants are folded first, so spelling noise does not
@@ -242,4 +302,4 @@ interface SlugOptions {
  */
 declare function urduSlug(input: string, options?: SlugOptions): string;
 
-export { type DigitStyle, type IsUrduOptions, type NormalizeOptions, type SearchOptions, type SearchResult, type SlugOptions, type SortOptions, type UrduStats, analyzeUrdu, compareUrdu, convertNumbers, countSentences, countWords, editDistance, foldUrdu, hasUrduSpecificLetters, highlightUrdu, isUrdu, normalizeUrdu, numberToUrduWords, parseUrduNumber, removeDiacritics, romanToUrdu, romanize, searchUrdu, searchUrduRanked, sortUrdu, splitSentences, splitWords, toArabicIndicDigits, toEnglishDigits, toUrduDigits, urduRatio, urduSlug };
+export { type DigitStyle, type IsUrduOptions, type NormalizeOptions, type SearchOptions, type SearchResult, type SlugOptions, type SortOptions, type SplitSentenceOptions, URDU_STOP_WORDS, type UrduStats, analyzeUrdu, compareUrdu, convertNumbers, countSentences, countWords, editDistance, filterStopWords, foldUrdu, hasUrduSpecificLetters, highlightUrdu, isStopWord, isUrdu, normalizeUrdu, numberToUrduWords, parseUrduNumber, removeDiacritics, removeStopWords, romanToUrdu, romanize, searchUrdu, searchUrduRanked, sortUrdu, splitSentences, splitWords, toArabicIndicDigits, toEnglishDigits, toUrduDigits, urduRatio, urduSlug };

package/dist/index.d.ts

@@ -110,9 +110,29 @@ declare function hasUrduSpecificLetters(input: string): boolean;
 declare function countWords(input: string): number;
 /** The word list behind {@link countWords}. Useful for tokenizing before search or indexing. */
 declare function splitWords(input: string): string[];
-/** Sentences, split on ۔ ؟ ! . and ellipsis. */
-declare function countSentences(input: string): number;
-declare function splitSentences(input: string): string[];
+interface SplitSentenceOptions {
+    /** If true, the sentence-ending punctuation (۔ ؟ ! . etc.) is preserved with each sentence. Default `false`. */
+    preserveTerminators?: boolean;
+}
+/**
+ * Sentences count, split on Urdu and standard terminators (۔ ؟ ! . …).
+ * Protects common titles, abbreviations, and numeric decimals from false splits.
+ */
+declare function countSentences(input: string, options?: SplitSentenceOptions): number;
+/**
+ * Split text into sentences using Urdu punctuation rules.
+ *
+ * Handles Urdu full stop `۔`, Arabic question mark `؟`, exclamation `!`,
+ * ASCII `.`, `?`, `!`, and ellipses `…`, while protecting abbreviations and numbers.
+ *
+ * @param input - Input text.
+ * @param options - Options controlling termination preservation.
+ *
+ * @example
+ * splitSentences("پاکستان ایک خوبصورت ملک ہے۔ اس کی تاریخ پرانی ہے۔")
+ * // ["پاکستان ایک خوبصورت ملک ہے", "اس کی تاریخ پرانی ہے"]
+ */
+declare function splitSentences(input: string, options?: SplitSentenceOptions): string[];
 interface UrduStats {
     /** Every codepoint, including spaces and diacritics. */
     characters: number;
@@ -137,6 +157,46 @@ interface UrduStats {
  */
 declare function analyzeUrdu(input: string): UrduStats;
 
+/**
+ * Standard list of Urdu stop words.
+ *
+ * Covers pronouns, postpositions, auxiliaries, conjunctions, particles,
+ * and high-frequency functional words used across Urdu texts.
+ * All keys are canonical normalized Urdu.
+ */
+declare const URDU_STOP_WORDS: Set<string>;
+/**
+ * Checks if a given Urdu word is a stop word.
+ *
+ * @param word - Word to test.
+ * @param customStopWords - Optional custom stop words set or array. Defaults to {@link URDU_STOP_WORDS}.
+ *
+ * @example
+ * isStopWord("اور") // true
+ * isStopWord("کتاب") // false
+ */
+declare function isStopWord(word: string, customStopWords?: Set<string> | string[]): boolean;
+/**
+ * Filters out stop words from an array of words.
+ *
+ * @param words - Array of words to filter.
+ * @param customStopWords - Optional custom stop words set or array.
+ *
+ * @example
+ * filterStopWords(["یہ", "ایک", "اچھی", "کتاب", "ہے"]) // ["اچھی", "کتاب"]
+ */
+declare function filterStopWords(words: string[], customStopWords?: Set<string> | string[]): string[];
+/**
+ * Removes stop words from an Urdu text string, returning the cleaned text.
+ *
+ * @param text - Input Urdu text.
+ * @param customStopWords - Optional custom stop words set or array.
+ *
+ * @example
+ * removeStopWords("یہ ایک بہترین کتاب ہے") // "بہترین کتاب"
+ */
+declare function removeStopWords(text: string, customStopWords?: Set<string> | string[]): string;
+
 /**
  * Comparator for Urdu strings, usable directly in `Array.prototype.sort`.
  * Diacritics and Unicode variants are folded first, so spelling noise does not
@@ -242,4 +302,4 @@ interface SlugOptions {
  */
 declare function urduSlug(input: string, options?: SlugOptions): string;
 
-export { type DigitStyle, type IsUrduOptions, type NormalizeOptions, type SearchOptions, type SearchResult, type SlugOptions, type SortOptions, type UrduStats, analyzeUrdu, compareUrdu, convertNumbers, countSentences, countWords, editDistance, foldUrdu, hasUrduSpecificLetters, highlightUrdu, isUrdu, normalizeUrdu, numberToUrduWords, parseUrduNumber, removeDiacritics, romanToUrdu, romanize, searchUrdu, searchUrduRanked, sortUrdu, splitSentences, splitWords, toArabicIndicDigits, toEnglishDigits, toUrduDigits, urduRatio, urduSlug };
+export { type DigitStyle, type IsUrduOptions, type NormalizeOptions, type SearchOptions, type SearchResult, type SlugOptions, type SortOptions, type SplitSentenceOptions, URDU_STOP_WORDS, type UrduStats, analyzeUrdu, compareUrdu, convertNumbers, countSentences, countWords, editDistance, filterStopWords, foldUrdu, hasUrduSpecificLetters, highlightUrdu, isStopWord, isUrdu, normalizeUrdu, numberToUrduWords, parseUrduNumber, removeDiacritics, removeStopWords, romanToUrdu, romanize, searchUrdu, searchUrduRanked, sortUrdu, splitSentences, splitWords, toArabicIndicDigits, toEnglishDigits, toUrduDigits, urduRatio, urduSlug };

package/dist/index.js

@@ -298,12 +298,51 @@ function splitWords(input) {
   if (!input) return [];
   return input.split(WORD_SPLIT_RE).map((w) => w.trim()).filter((w) => w.length > 0);
 }
-function countSentences(input) {
-  return splitSentences(input).length;
+var ABBREVIATIONS = [
+  "\u0688\u0627\u06A9\u0679\u0631",
+  "\u067E\u0631\u0648\u0641\u06CC\u0633\u0631",
+  "\u0627\u0646\u062C\u06CC\u0646\u0626\u0631",
+  "\u0627\u06CC\u0688\u0648\u0648\u06A9\u06CC\u0679",
+  "\u062C\u0646\u0627\u0628",
+  "\u0635\u0627\u062D\u0628",
+  "\u0635\u0627\u062D\u0628\u06C1",
+  "\u0645\u062D\u062A\u0631\u0645",
+  "\u0645\u062D\u062A\u0631\u0645\u06C1",
+  "\u0645\u0648\u0644\u0627\u0646\u0627",
+  "\u0645\u0641\u062A\u06CC",
+  "\u0639\u0644\u0627\u0645\u06C1",
+  "\u0628\u06CC\u06AF\u0645",
+  "\u0648\u063A\u06CC\u0631\u06C1",
+  "\u0631\u062D\u0645\u062A\u06C1",
+  "\u0631\u0636\u06CC",
+  "\u062A\u0639\u0627\u0644\u06CC",
+  "\u062A\u0639\u0627\u0644\u06CC\u0670",
+  "\u0639\u0644\u06CC\u06C1",
+  "\u0627\u0644\u0633\u0644\u0627\u0645",
+  "\u0635\u0644\u06CC",
+  "\u0648\u0633\u0644\u0645"
+];
+var ABBREV_PATTERN = new RegExp(`(?:${ABBREVIATIONS.join("|")})[.\u06D4]`, "gu");
+function countSentences(input, options) {
+  return splitSentences(input, options).length;
 }
-function splitSentences(input) {
+function splitSentences(input, options = {}) {
   if (!input) return [];
-  return input.split(SENTENCE_SPLIT_RE).map((s) => s.trim()).filter((s) => s.length > 0);
+  const { preserveTerminators = false } = options;
+  const PROTECTED_DOT = "\uE000";
+  const PROTECTED_URDU_FULL_STOP = "\uE001";
+  let sanitized = input.replace(/(\d)\.(\d)/gu, `$1${PROTECTED_DOT}$2`).replace(ABBREV_PATTERN, (match) => {
+    return match.replace(/\./g, PROTECTED_DOT).replace(/۔/g, PROTECTED_URDU_FULL_STOP);
+  });
+  if (preserveTerminators) {
+    const matches = sanitized.match(/[^۔؟?!.…]+[۔؟?!.…]+|[^۔؟?!.…]+$/gu) ?? [];
+    return matches.map(
+      (s) => s.replace(new RegExp(PROTECTED_DOT, "gu"), ".").replace(new RegExp(PROTECTED_URDU_FULL_STOP, "gu"), "\u06D4").trim()
+    ).filter((s) => s.length > 0);
+  }
+  return sanitized.split(SENTENCE_SPLIT_RE).map(
+    (s) => s.replace(new RegExp(PROTECTED_DOT, "gu"), ".").replace(new RegExp(PROTECTED_URDU_FULL_STOP, "gu"), "\u06D4").trim()
+  ).filter((s) => s.length > 0);
 }
 function analyzeUrdu(input) {
   const text = input ?? "";
@@ -326,6 +365,264 @@ function analyzeUrdu(input) {
   };
 }
 
+// src/stopwords.ts
+var URDU_STOP_WORDS = /* @__PURE__ */ new Set([
+  // Tense auxiliaries & copulas
+  "\u06C1\u06D2",
+  "\u06C1\u06CC\u06BA",
+  "\u06C1\u0648\u06BA",
+  "\u06C1\u0648",
+  "\u062A\u06BE\u0627",
+  "\u062A\u06BE\u06CC",
+  "\u062A\u06BE\u06D2",
+  "\u062A\u06BE\u06CC\u06BA",
+  "\u06C1\u0648\u06AF\u0627",
+  "\u06C1\u0648\u06AF\u06CC",
+  "\u06C1\u0648\u0646\u06AF\u06D2",
+  "\u06C1\u0648\u06BA\u06AF\u06D2",
+  "\u06C1\u0648\u0646\u0627",
+  "\u06C1\u0648\u0646\u06D2",
+  "\u06C1\u0648\u0627",
+  "\u06C1\u0648\u0626\u06CC",
+  "\u06C1\u0648\u0626\u06D2",
+  // Postpositions, relations & prepositions
+  "\u06A9\u0627",
+  "\u06A9\u06CC",
+  "\u06A9\u06D2",
+  "\u06A9\u0648",
+  "\u0646\u06D2",
+  "\u0633\u06D2",
+  "\u067E\u0631",
+  "\u062A\u06A9",
+  "\u0645\u06CC\u06BA",
+  "\u0644\u06CC\u06D2",
+  "\u0633\u0627\u062A\u06BE",
+  "\u0628\u063A\u06CC\u0631",
+  "\u0637\u0631\u062D",
+  "\u0637\u0631\u0641",
+  "\u0628\u0627\u0631\u06D2",
+  "\u0628\u0639\u062F",
+  "\u067E\u06C1\u0644\u06D2",
+  "\u062F\u0648\u0631\u0627\u0646",
+  "\u062F\u0631\u0645\u06CC\u0627\u0646",
+  "\u0639\u0644\u0627\u0648\u06C1",
+  "\u0633\u0648\u0627\u0626\u06D2",
+  "\u0633\u0648\u0627",
+  "\u0645\u0637\u0627\u0628\u0642",
+  "\u0628\u0627\u0639\u062B",
+  "\u0630\u0631\u06CC\u0639\u06D2",
+  "\u062A\u062D\u062A",
+  "\u0627\u0648\u067E\u0631",
+  "\u0646\u06CC\u0686\u06D2",
+  "\u0622\u06AF\u06D2",
+  "\u067E\u06CC\u0686\u06BE\u06D2",
+  "\u0627\u0646\u062F\u0631",
+  "\u0628\u0627\u06C1\u0631",
+  "\u067E\u0627\u0633",
+  "\u0642\u0631\u06CC\u0628",
+  "\u0646\u0632\u062F\u06CC\u06A9",
+  // Conjunctions & discourse markers
+  "\u0627\u0648\u0631",
+  "\u06CC\u0627",
+  "\u0627\u06AF\u0631",
+  "\u0644\u06CC\u06A9\u0646",
+  "\u0645\u06AF\u0631",
+  "\u062A\u0648",
+  "\u0628\u06BE\u06CC",
+  "\u06C1\u06CC",
+  "\u0646\u06C1",
+  "\u0646\u06C1\u06CC\u06BA",
+  "\u0645\u062A",
+  "\u0646\u0627",
+  "\u0628\u0644\u06A9\u06C1",
+  "\u062D\u0627\u0644\u0627\u0646\u06A9\u06C1",
+  "\u0686\u0648\u0646\u06A9\u06C1",
+  "\u06A9\u06CC\u0648\u0646\u06A9\u06C1",
+  "\u062A\u0627\u06A9\u06C1",
+  "\u0648\u0631\u0646\u06C1",
+  "\u0627\u0644\u0628\u062A\u06C1",
+  "\u0645\u062B\u0644\u0627\u064B",
+  "\u06CC\u0639\u0646\u06CC",
+  "\u062E\u0635\u0648\u0635\u0627\u064B",
+  "\u0639\u0645\u0648\u0645\u0627\u064B",
+  "\u0686\u0646\u0627\u0646\u0686\u06C1",
+  "\u062E\u0648\u0627\u06C1",
+  "\u0686\u0627\u06C1\u06D2",
+  "\u06AF\u0648\u06CC\u0627",
+  "\u062A\u0627\u06C1\u0645",
+  "\u0646\u06CC\u0632",
+  "\u062D\u062A\u06CC",
+  "\u0648\u063A\u06CC\u0631\u06C1",
+  "\u0635\u0631\u0641",
+  "\u0645\u062D\u0636",
+  "\u0641\u0642\u0637",
+  // Pronouns, determiners & question words
+  "\u06C1\u0645",
+  "\u062A\u0645",
+  "\u0622\u067E",
+  "\u0648\u06C1",
+  "\u06CC\u06C1",
+  "\u0645\u06CC\u0631\u0627",
+  "\u0645\u06CC\u0631\u06CC",
+  "\u0645\u06CC\u0631\u06D2",
+  "\u06C1\u0645\u0627\u0631\u0627",
+  "\u06C1\u0645\u0627\u0631\u06CC",
+  "\u06C1\u0645\u0627\u0631\u06D2",
+  "\u062A\u0645\u06C1\u0627\u0631\u0627",
+  "\u062A\u0645\u06C1\u0627\u0631\u06CC",
+  "\u062A\u0645\u06C1\u0627\u0631\u06D2",
+  "\u0622\u067E\u06A9\u0627",
+  "\u0622\u067E\u06A9\u06CC",
+  "\u0622\u067E\u06A9\u06D2",
+  "\u0627\u0633",
+  "\u0627\u0633\u06A9\u0627",
+  "\u0627\u0633\u06A9\u06CC",
+  "\u0627\u0633\u06A9\u06D2",
+  "\u0627\u0633\u06D2",
+  "\u0627\u0646",
+  "\u0627\u0646\u06A9\u0627",
+  "\u0627\u0646\u06A9\u06CC",
+  "\u0627\u0646\u06A9\u06D2",
+  "\u0627\u0646\u06C1\u06CC\u06BA",
+  "\u0645\u062C\u06BE\u06D2",
+  "\u06C1\u0645\u06CC\u06BA",
+  "\u062A\u0645\u06C1\u06CC\u06BA",
+  "\u062C\u0633",
+  "\u062C\u0633\u06A9\u0627",
+  "\u062C\u0633\u06A9\u06CC",
+  "\u062C\u0633\u06A9\u06D2",
+  "\u062C\u0633\u06D2",
+  "\u062C\u0646",
+  "\u062C\u0646\u06A9\u0627",
+  "\u062C\u0646\u06A9\u06CC",
+  "\u062C\u0646\u06A9\u06D2",
+  "\u062C\u0646\u06C1\u0648\u06BA",
+  "\u0627\u0646\u06C1\u0648\u06BA",
+  "\u06A9\u0633",
+  "\u06A9\u0633\u06A9\u0627",
+  "\u06A9\u0633\u06A9\u06CC",
+  "\u06A9\u0633\u06A9\u06D2",
+  "\u06A9\u0633\u06D2",
+  "\u06A9\u0633\u06A9\u0648",
+  "\u06A9\u0648\u0646",
+  "\u06A9\u06CC\u0627",
+  "\u06A9\u06C1\u0627\u06BA",
+  "\u06A9\u062F\u06BE\u0631",
+  "\u0627\u062F\u06BE\u0631",
+  "\u062C\u062F\u06BE\u0631",
+  "\u06A9\u0628",
+  "\u06A9\u06CC\u0648\u06BA",
+  "\u06A9\u06CC\u0633\u06D2",
+  "\u06A9\u06CC\u0633\u0627",
+  "\u06A9\u06CC\u0633\u06CC",
+  "\u06A9\u062A\u0646\u0627",
+  "\u06A9\u062A\u0646\u06CC",
+  "\u06A9\u062A\u0646\u06D2",
+  "\u062C\u0648",
+  "\u0633\u0628",
+  "\u0633\u0628\u06BE\u06CC",
+  "\u06A9\u0648\u0626\u06CC",
+  "\u06A9\u0686\u06BE",
+  "\u06C1\u0631",
+  "\u0627\u06CC\u06A9",
+  "\u0627\u067E\u0646\u0627",
+  "\u0627\u067E\u0646\u06CC",
+  "\u0627\u067E\u0646\u06D2",
+  "\u062E\u0648\u062F",
+  // Common light/auxiliary verb forms
+  "\u06A9\u0631\u0646\u0627",
+  "\u06A9\u0631\u062A\u0627",
+  "\u06A9\u0631\u062A\u06CC",
+  "\u06A9\u0631\u062A\u06D2",
+  "\u06A9\u0631\u06CC\u06BA",
+  "\u06A9\u0631\u0648",
+  "\u06A9\u0631",
+  "\u06A9\u0631\u0646\u06D2",
+  "\u06A9\u06CC\u06D2",
+  "\u062C\u0627\u0646\u0627",
+  "\u062C\u0627\u062A\u0627",
+  "\u062C\u0627\u062A\u06CC",
+  "\u062C\u0627\u062A\u06D2",
+  "\u062C\u0627\u0626\u06D2",
+  "\u062C\u0627\u0626\u06CC\u06BA",
+  "\u062C\u0627\u0624",
+  "\u062C\u0627",
+  "\u062C\u0627\u0646\u06D2",
+  "\u06AF\u06CC\u0627",
+  "\u06AF\u0626\u06CC",
+  "\u06AF\u0626\u06D2",
+  "\u0622\u0646\u0627",
+  "\u0622\u062A\u0627",
+  "\u0622\u062A\u06CC",
+  "\u0622\u062A\u06D2",
+  "\u0622\u0626\u06D2",
+  "\u0622\u0626\u06CC\u06BA",
+  "\u0622\u06CC\u0627",
+  "\u0622\u0626\u06CC",
+  "\u0622\u0646\u06D2",
+  "\u0622\u0624",
+  "\u0622",
+  "\u062F\u06CC\u0646\u0627",
+  "\u062F\u06CC\u062A\u0627",
+  "\u062F\u06CC\u062A\u06CC",
+  "\u062F\u06CC\u062A\u06D2",
+  "\u062F\u06CC\u0627",
+  "\u062F\u06CC\u06D2",
+  "\u062F\u06D2",
+  "\u062F\u0648",
+  "\u062F\u06CC\u06BA",
+  "\u062F\u06CC\u0646\u06D2",
+  "\u0644\u06CC\u0646\u0627",
+  "\u0644\u06CC\u062A\u0627",
+  "\u0644\u06CC\u062A\u06CC",
+  "\u0644\u06CC\u062A\u06D2",
+  "\u0644\u06CC\u0627",
+  "\u0644\u06D2",
+  "\u0644\u0648",
+  "\u0644\u06CC\u06BA",
+  "\u0644\u06CC\u0646\u06D2",
+  "\u0631\u06C1\u0646\u0627",
+  "\u0631\u06C1\u0627",
+  "\u0631\u06C1\u06CC",
+  "\u0631\u06C1\u06D2",
+  "\u0631\u06C1\u062A\u0627",
+  "\u0631\u06C1\u062A\u06CC",
+  "\u0631\u06C1\u062A\u06D2",
+  "\u0631\u06C1\u0646\u06D2",
+  "\u0633\u06A9\u0646\u0627",
+  "\u0633\u06A9\u062A\u0627",
+  "\u0633\u06A9\u062A\u06CC",
+  "\u0633\u06A9\u062A\u06D2",
+  "\u0648\u0627\u0644\u0627",
+  "\u0648\u0627\u0644\u06CC",
+  "\u0648\u0627\u0644\u06D2"
+]);
+function toStopWordSet(custom) {
+  if (!custom) return URDU_STOP_WORDS;
+  if (custom instanceof Set) return custom;
+  return new Set(custom.map((w) => normalizeUrdu(w.trim())));
+}
+function isStopWord(word, customStopWords) {
+  if (!word) return false;
+  const normalized = normalizeUrdu(word.trim());
+  const stopSet = toStopWordSet(customStopWords);
+  return stopSet.has(normalized);
+}
+function filterStopWords(words, customStopWords) {
+  if (!words || words.length === 0) return [];
+  const stopSet = toStopWordSet(customStopWords);
+  return words.filter((w) => {
+    const normalized = normalizeUrdu(w.trim());
+    return normalized.length > 0 && !stopSet.has(normalized);
+  });
+}
+function removeStopWords(text, customStopWords) {
+  if (!text) return "";
+  const words = splitWords(text);
+  const filtered = filterStopWords(words, customStopWords);
+  return filtered.join(" ");
+}
+
 // src/collate.ts
 var ALPHABET = [
   "\u0627",
@@ -2997,6 +3294,6 @@ function urduSlug(input, options = {}) {
   return slug;
 }
 
-export { analyzeUrdu, compareUrdu, convertNumbers, countSentences, countWords, editDistance, foldUrdu, hasUrduSpecificLetters, highlightUrdu, isUrdu, normalizeUrdu, numberToUrduWords, parseUrduNumber, removeDiacritics, romanToUrdu, romanize, searchUrdu, searchUrduRanked, sortUrdu, splitSentences, splitWords, toArabicIndicDigits, toEnglishDigits, toUrduDigits, urduRatio, urduSlug };
+export { URDU_STOP_WORDS, analyzeUrdu, compareUrdu, convertNumbers, countSentences, countWords, editDistance, filterStopWords, foldUrdu, hasUrduSpecificLetters, highlightUrdu, isStopWord, isUrdu, normalizeUrdu, numberToUrduWords, parseUrduNumber, removeDiacritics, removeStopWords, romanToUrdu, romanize, searchUrdu, searchUrduRanked, sortUrdu, splitSentences, splitWords, toArabicIndicDigits, toEnglishDigits, toUrduDigits, urduRatio, urduSlug };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map