Sync Main

CHANGELOG.md

@@ -1,3 +1,10 @@
+## 2.1.7
+
+### Added
+- **Package Lifecycle API**:
+  - `SafeTextFilter.isInitialized` getter — check whether word lists have been loaded and the Trie is built.
+  - `SafeTextFilter.reset()` method — clear loaded Trie word lists and reset initialization state, useful when dynamically switching languages or releasing memory.
+
 ## 2.1.6
 
 ### Documentation

README.md

@@ -28,6 +28,7 @@ A high-performance Flutter package for filtering offensive language (profanity)
 - [Quick Start](#quick-start)
 - [API Reference](#api-reference)
   - [`SafeTextFilter.init`](#safetextfilterinit)
+  - [`SafeTextFilter.isInitialized` \& `SafeTextFilter.reset`](#safetextfilterisinitialized--safetextfilterreset)
   - [`SafeTextFilter.filterText`](#safetextfilterfiltertext)
     - [Masking Strategies](#masking-strategies)
   - [`SafeTextFilter.containsBadWord`](#safetextfiltercontainsbadword)
@@ -67,7 +68,7 @@ Or manually add it to your `pubspec.yaml`:
 
 ```yaml
 dependencies:
-  safe_text: ^2.1.6
+  safe_text: ^2.1.7
 ```
 
 Then run:
@@ -143,6 +144,21 @@ await SafeTextFilter.init(language: Language.all);
 
 > **Note:** If neither parameter is provided, the filter defaults to `Language.english`.
 
+### `SafeTextFilter.isInitialized` & `SafeTextFilter.reset`
+
+Check initialization status or reset loaded word lists dynamically (e.g., when switching languages):
+
+```dart
+// Check if initialized
+if (!SafeTextFilter.isInitialized) {
+  await SafeTextFilter.init(language: Language.english);
+}
+
+// Reset state to reload with a different language
+SafeTextFilter.reset();
+await SafeTextFilter.init(language: Language.spanish);
+```
+
 ---
 
 ### `SafeTextFilter.filterText`

pubspec.yaml

@@ -1,6 +1,6 @@
 name: safe_text
 description: A fast Flutter profanity & swear word filter with phone number detection, powered by Aho-Corasick. Supports 80+ languages and 55,000+ curated bad words.
-version: 2.1.6
+version: 2.1.7
 homepage: https://github.com/master-wayne7/safe_text
 repository: https://github.com/master-wayne7/safe_text
 issue_tracker: https://github.com/master-wayne7/safe_text/issues