@bnsights/bbsf-controls 1.0.194-beta.9 → 1.2.1

package/README.md

@@ -1,1245 +1,1315 @@
-# BnsightsControlLibrary
-
-BBSF Controls package is part of BBSF 3 packages. It has all the form controls that we use to build our application forms.
-
-For more info please visit [BBSF Controls documenation](https://bbsfadmin.bnsights.com/controls) or [BBSF documentation](https://bnsightsprojects.visualstudio.com/BBSF%203/_wiki/wikis/BBSF-3.wiki/65/BBSF-Documentation)
-
----
-
-## 🚀 NEW! Tree-Shakable Granular Modules (v2.0+)
-
-The package now supports **true tree-shaking** through granular modules for optimal bundle size!
-
-### 📦 Available Modules
-
-#### ✨ Granular Modules (RECOMMENDED - Best Bundle Optimization)
-
-| Module | Gzipped Size | Contains | Main Dependencies |
-|--------|--------------|----------|-------------------|
-| **BBSFFormsBasicModule** | ~30 KB | TextBox, TextArea, CheckBox, RadioButton, Toggle | ngx-mask, Material slide-toggle |
-| **BBSFDropdownModule** | ~130 KB | DropdownList | ng-select (~100 KB) |
-| **BBSFDateTimeModule** | ~220 KB | DateTimePicker + Date pipes | Owl DateTime (~200 KB) |
-| **BBSFPhoneModule** | ~90 KB | Phone input | intl-tel-input (~80 KB) |
-| **BBSFUtilityModule** | ~80 KB | Form, Modals, Paging, PageHeader, Recaptcha | SweetAlert2, NgBootstrap |
-| **BBSFMultilingualModule** | ~15 KB | MultiLingualTextBox, MultiLingualTextArea | None (lightweight) |
-
-#### 📚 Legacy Grouped Modules (For Backward Compatibility)
-
-| Module | Size | Contains |
-|--------|------|----------|
-| **BBSFCoreModule** ⚠️ | ~650-800 KB | ALL modules above (deprecated, use granular modules instead) |
-| **BBSFEditorsModule** | ~800 KB | HtmlEditor, MarkdownEditor, MultiLingualHtmlEditor |
-| **BBSFUploadsModule** | ~360 KB | FileUpload, ImageUpload, ProfileImageUploader |
-| **BBSFSpecializedModule** | ~300 KB | Calendar, MapAutoComplete, AutocompleteTextBox, TagsInput, Repeater |
-| **BBSFControlsModule** ⚠️ | ~2+ MB | Everything (deprecated) |
-
----
-
-### 📖 Usage Examples
-
-#### ✅ **Best Practice: Use Granular Modules**
-
-```typescript
-// Example 1: Basic form with text inputs only (~30 KB)
-import { BBSFFormsBasicModule } from '@bnsights/bbsf-controls';
-
-@NgModule({
-  imports: [BBSFFormsBasicModule]
-})
-export class SimpleFormModule { }
-```
-
-```typescript
-// Example 2: Form with dropdown (~160 KB - 75% smaller than BBSFCoreModule!)
-import { 
-  BBSFFormsBasicModule,    // ~30 KB
-  BBSFDropdownModule       // ~130 KB
-} from '@bnsights/bbsf-controls';
-
-@NgModule({
-  imports: [BBSFFormsBasicModule, BBSFDropdownModule]
-})
-export class FormWithDropdownModule { }
-```
-
-```typescript
-// Example 3: Form with date picker (~250 KB - 60% smaller!)
-import { 
-  BBSFFormsBasicModule,    // ~30 KB
-  BBSFDateTimeModule       // ~220 KB
-} from '@bnsights/bbsf-controls';
-
-@NgModule({
-  imports: [BBSFFormsBasicModule, BBSFDateTimeModule]
-})
-export class FormWithDateModule { }
-```
-
-```typescript
-// Example 4: Complex form with multiple controls (~565 KB - 13% smaller)
-import { 
-  BBSFFormsBasicModule,      // ~30 KB - TextBox, CheckBox, etc.
-  BBSFDropdownModule,        // ~130 KB - Dropdown
-  BBSFDateTimeModule,        // ~220 KB - Date/Time
-  BBSFPhoneModule,           // ~90 KB - Phone
-  BBSFUtilityModule,         // ~80 KB - Form, Modals, Paging
-  BBSFMultilingualModule     // ~15 KB - Multilingual
-} from '@bnsights/bbsf-controls';
-
-@NgModule({
-  imports: [
-    BBSFFormsBasicModule,
-    BBSFDropdownModule,
-    BBSFDateTimeModule,
-    BBSFPhoneModule,
-    BBSFUtilityModule,
-    BBSFMultilingualModule
-  ]
-})
-export class FullFormModule { }
-```
-
-```typescript
-// Example 5: Form with rich text editor (~830 KB)
-import { 
-  BBSFFormsBasicModule,
-  BBSFEditorsModule          // Rich text editors
-} from '@bnsights/bbsf-controls';
-
-@NgModule({
-  imports: [BBSFFormsBasicModule, BBSFEditorsModule]
-})
-export class ContentFormModule { }
-```
-
-#### ⚠️ **Legacy: Old Module Imports (Not Recommended)**
-
-```typescript
-// ❌ Old way 1: Loads ALL controls (~2+ MB)
-import { BBSFControlsModule } from '@bnsights/bbsf-controls';
-
-@NgModule({
-  imports: [BBSFControlsModule]  // Don't use this!
-})
-```
-
-```typescript
-// ⚠️ Old way 2: Still loads too much (~650 KB even if you use 1 control)
-import { BBSFCoreModule } from '@bnsights/bbsf-controls';
-
-@NgModule({
-  imports: [BBSFCoreModule]  // Use granular modules instead!
-})
-```
-
----
-
-### 📊 Performance Benefits
-
-#### Real-World Bundle Size Comparison
-
-| Use Case | Old (BBSFCoreModule) | New (Granular) | Savings |
-|----------|---------------------|----------------|---------|
-| **Basic form only** | 650 KB | 30 KB | **95%** ⬇️ |
-| **Form + Dropdown** | 650 KB | 160 KB | **75%** ⬇️ |
-| **Form + Date picker** | 650 KB | 250 KB | **60%** ⬇️ |
-| **Form + Phone** | 650 KB | 120 KB | **82%** ⬇️ |
-| **All core controls** | 650 KB | 565 KB | **13%** ⬇️ |
-| **+ Rich text editor** | 1450 KB | 830 KB | **43%** ⬇️ |
-
-#### Example: Typical Application Impact
-
-```
-Before (using BBSFCoreModule):
-├── TextBox ✓
-├── Dropdown ✓
-└── Unused: DateTimePicker ✗ (~200 KB wasted)
-              Phone ✗ (~80 KB wasted)
-              Paging ✗ (~30 KB wasted)
-              Modals ✗ (~50 KB wasted)
-              ... (~290 KB wasted)
-Total: 650 KB
-
-After (using granular modules):
-├── BBSFFormsBasicModule (~30 KB)
-└── BBSFDropdownModule (~130 KB)
-Total: 160 KB (490 KB saved! 75% reduction)
-```
-
----
-
-### 🔄 Migration Guide
-
-#### Step 1: Identify Your Controls
-
-Audit your application to see which controls you're actually using:
-
-```bash
-# Search for control usage in your codebase
-grep -r "bbsf-textbox\|bbsf-dropdown\|bbsf-datepicker" src/
-```
-
-#### Step 2: Map Controls to Granular Modules
-
-| If you use... | Import this module | Size |
-|--------------|-------------------|------|
-| TextBox, TextArea, CheckBox, Radio, Toggle | `BBSFFormsBasicModule` | ~30 KB |
-| DropdownList | `BBSFDropdownModule` | ~130 KB |
-| DateTimePicker | `BBSFDateTimeModule` | ~220 KB |
-| Phone | `BBSFPhoneModule` | ~90 KB |
-| Form, Modals, Paging, PageHeader | `BBSFUtilityModule` | ~80 KB |
-| MultiLingualTextBox/TextArea | `BBSFMultilingualModule` | ~15 KB |
-| HtmlEditor, MarkdownEditor | `BBSFEditorsModule` | ~800 KB |
-| FileUpload, ImageUpload | `BBSFUploadsModule` | ~360 KB |
-| Calendar, Maps, TagsInput, Repeater | `BBSFSpecializedModule` | ~300 KB |
-
-#### Step 3: Replace Imports
-
-**Migration Example 1: From BBSFControlsModule**
-```typescript
-// ❌ Before: Loading ALL controls (~2+ MB)
-import { BBSFControlsModule } from '@bnsights/bbsf-controls';
-
-@NgModule({
-  imports: [BBSFControlsModule]
-})
-export class UserFormModule { }
-
-// ✅ After: Only load what you need (~160 KB - 92% smaller!)
-import { 
-  BBSFFormsBasicModule,    // You use TextBox, CheckBox
-  BBSFDropdownModule       // You use Dropdown
-} from '@bnsights/bbsf-controls';
-
-@NgModule({
-  imports: [
-    BBSFFormsBasicModule,
-    BBSFDropdownModule
-  ]
-})
-export class UserFormModule { }
-```
-
-**Migration Example 2: From BBSFCoreModule**
-```typescript
-// ⚠️ Before: Loading all core controls (~650 KB)
-import { BBSFCoreModule } from '@bnsights/bbsf-controls';
-
-@NgModule({
-  imports: [BBSFCoreModule]
-})
-export class SimpleFormModule { }
-
-// ✅ After: Only basic forms (~30 KB - 95% smaller!)
-import { BBSFFormsBasicModule } from '@bnsights/bbsf-controls';
-
-@NgModule({
-  imports: [BBSFFormsBasicModule]
-})
-export class SimpleFormModule { }
-```
-
-**Migration Example 3: Complex Form**
-```typescript
-// ❌ Before: BBSFCoreModule (~650 KB) + BBSFEditorsModule (~800 KB) = 1.45 MB
-import { BBSFCoreModule, BBSFEditorsModule } from '@bnsights/bbsf-controls';
-
-@NgModule({
-  imports: [BBSFCoreModule, BBSFEditorsModule]
-})
-export class ArticleFormModule { }
-
-// ✅ After: Only what you need (~410 KB - 72% smaller!)
-import { 
-  BBSFFormsBasicModule,    // ~30 KB - TextBox, CheckBox
-  BBSFDropdownModule,      // ~130 KB - Dropdown
-  BBSFDateTimeModule,      // ~220 KB - DatePicker
-  BBSFFormsBasicModule     // ~30 KB - Basic forms
-} from '@bnsights/bbsf-controls';
-
-@NgModule({
-  imports: [
-    BBSFFormsBasicModule,
-    BBSFDropdownModule,
-    BBSFDateTimeModule
-  ]
-})
-export class ArticleFormModule { }
-```
-
-#### Step 4: Verify Bundle Size
-
-After migration, build your app and check the bundle size:
-
-```bash
-# Build with stats
-npm run build -- --stats-json
-
-# Analyze bundle (install if needed: npm i -g webpack-bundle-analyzer)
-npx webpack-bundle-analyzer dist/your-app/stats.json
-```
-
-Look for `@bnsights/bbsf-controls` in the bundle analyzer to see your savings!
-
-#### Step 5: Update All Modules
-
-Search and replace across your codebase:
-
-```bash
-# Find all BBSFControlsModule imports
-grep -r "BBSFControlsModule" src/
-
-# Find all BBSFCoreModule imports
-grep -r "BBSFCoreModule" src/
-```
-
-Then update each file based on which controls it actually uses.
-
----
-
-### ⚡ Quick Reference
-
-**Most Common Combinations:**
-
-```typescript
-// Basic form (~30 KB)
-import { BBSFFormsBasicModule } from '@bnsights/bbsf-controls';
-
-// Form with dropdown (~160 KB)
-import { BBSFFormsBasicModule, BBSFDropdownModule } from '@bnsights/bbsf-controls';
-
-// Form with date picker (~250 KB)
-import { BBSFFormsBasicModule, BBSFDateTimeModule } from '@bnsights/bbsf-controls';
-
-// Complete form (~565 KB)
-import { 
-  BBSFFormsBasicModule, 
-  BBSFDropdownModule, 
-  BBSFDateTimeModule, 
-  BBSFPhoneModule, 
-  BBSFUtilityModule 
-} from '@bnsights/bbsf-controls';
-
-// Content management (~830 KB)
-import { BBSFFormsBasicModule, BBSFEditorsModule } from '@bnsights/bbsf-controls';
-
-// Media management (~390 KB)
-import { BBSFFormsBasicModule, BBSFUploadsModule } from '@bnsights/bbsf-controls';
-```
-
----
-
-## Change Log
-
-## 1.0.194 / 16-10-2025
-
-=====================
-
-- Implement standalone components
-
-## 1.0.193 / 16-10-2025
-
-=====================
-
-- Fix Format for displayValues in Tags, multiSelect
-
-## 1.0.192 / 15-10-2025
-
-=====================
-
-- Fix Repeater URL Validation
-- Fix Clear singleSelection DropdownComponent
-- Remove Swal cancelButton style
-
-## 1.0.191 / 23/9/2025
-
-=====================
-
-- Initialize repeater control when custom validation
-- Handle attach image in HTML Editor Component
-- Validate files count when drag and drop file in single upload
-
-
-## 1.0.190 / 21/9/2025
-
-=====================
-
-- Add option to add buttons to hide in HTML Editor Component
-- Remove options from Html Editor component
-
-## 1.0.189 / 15/9/2025
-
-=====================
-
-- Add option to show password requirements
-
-## 1.0.188 / 15/9/2025
-
-=====================
-
-- Update utilities package to 1.0.68
-- Add Password Validation disclaimer
-
-## 1.0.187 / 15/9/2025
-
-=====================
-
-- Update utilities package to 1.0.67
-
-## 1.0.186 11-09-2025
-
-====================
-
-- Fixing password validation issue in TextBoxComponent
-
-## 1.0.185 07-09-2025
-
-====================
-
-- DropdownList Enable Select all.
-
-## 1.0.184 03-09-2025
-
-====================
-
-- dropdownlist place error message outside input style
-
-## 1.0.183 03-09-2025
-
-====================
-
-- Fix FileUpload issues
-- Fix TextArea SpeechRecognition issue.
-
-## 1.0.182 28-08-2025
-
-====================
-
-- Update utilities package to 1.0.66
-- Fix FileUpload issues
-- Enhancement for textarea, multi lingual textbox
-
-## 1.0.181 26-08-2025
-
-====================
-
-- Update utilities package to 1.0.64
-
-# 1.0.178 20-08-2025 (deprecated)
-====================
-- Fileupload component
-  - fix accepted types issue.
-  - fix error display issue.
-
-# 1.0.177 18-08-2025 (deprecated)
-====================
-- Enhance File-Upload Component
-- Fix FileUplaod typo to be FileUpload 
-
-# 1.0.176 11-08-2025
-====================
-- Updating utilities package version.
-
-# 1.0.173 06-08-2025
-====================
-- Add desplayValue getter in all controls to handle selected values
-- Fix some issue in file upload 
-
-# 1.0.172 06-08-2025
-====================
-- Add desplayValue in all controls to handle selected values 
-
-
-# 1.0.171 04-08-2025
-====================
-- add PreventDoubleClickDirective to handle double click issues
-
-# 1.0.168 03-08-2025
-====================
-- Fix mic in `text-area`.
-- Handle navigation event in paging `enableBrowserNavigation`.
-
-## 1.0.167 29-07-2025
-=====================
-- add fixes to `date-picker`, and `dropdownlist` components for pageFilter popup
-
-## 1.0.166 / 6/5/2025
-=====================
-Added extra options to **MapAutoCompleteOptions** advanced view mode
-- Sets the zoom level for the map > `zoom`
-- Finding a location by a specific address > `address`
-- Boolean to enable fallback behavior if the address lookup fails > `enableFallbackAddress`
-- Option to validates that the selected location is within a specific city boundary > `validateLocationWithinCity`
-- Added componentRestrictions Geo Restriction option > `country` 
-
-Fixed href issue in **FileUploaderComponent**
-
-## 1.0.161 / 12-3-2025
-=====================
-- Enable Grouping feature in dropdown control (Added hasGroup property in DropdownOptions and group property in DropdownListItem)
-## 1.0.160 / 26-2-2025
-=====================
-- Tag Fix value null check
-
-
-## 1.0.159 / 16-2-2025
-
-=====================
-
-- Update utilities package
-- Fix TextBox when value undenied in check max_length
-
-## 1.0.158 / 16-2-2025
-
-=====================
-
-- update utilities package
-
-## 1.0.157 / 30-12-2024
-
-=====================
-
-* Fix bug in TextBox when delete max limit chars
-
-## 1.0.156 / 28-11-2024
-
-=====================
-
-* Fix bug in TextArea when speechrecoginitoin is disabled
-
-## 1.0.155 / 28-11-2024
-
-=====================
-
-* Fix bug in Repeater table control on delete item
-
-## 1.0.154 / 28-11-2024
-
-=====================
-**Fix TextArea When Using in Repeater**
-
-## 1.0.153 / 27-11-2024
-
-=====================
-**Fix Repeater table control on delete item**
-
-## 1.0.152 / 3-9-2024
-
-=====================
--multi tenant
-
-## 1.0.151 / 19-8-2024
-
-======================
-
-* Added MarkdownEditor Control
-
-## 1.0.150 / 8-8-2024
-
-======================
-
-* Updated TextAreaComponent speech language select with UI fixes
-
-## 1.0.149 / 6-8-2024
-
-======================
-
-* Updated TextAreaComponent speech language select
-
-## 1.0.148 / 4-8-2024
-
-===================
-
-* fixed UI bug in speech to text of TextAreaComponent
-
-## 1.0.147 / 4-8-2024
-
-===================
-
-* fixed bug in speech to text of TextAreaComponent
-
-## 1.0.146 / 4-8-2024
-
-===================
-
-* added feature spech to text into TextAreaComponent
-
-## 1.0.145 / 24-7-2024
-
-===================
-
-* fix naming in file upload control
-
-## 1.0.144 / 24-7-2024
-
-===================
-
-* Fix viewing File upload control while options.isUploadFileAsync == false
-
-## 1.0.143 / 16-7-2024
-
-===================
-
-* Update imports for sweetalert package to avoid inline style injected to DOM
-  * import style inside your applications
-
-## 1.0.142 / 3-6-2024
-
-===================
-
-* Update Utilities Library verion
-
-## 1.0.141 / 18-4-2024
-
-===================
-
-* Fix File uploader loading issue
-
-## 1.0.140 / 3-4-2024
-
-===================
-
-* Fix delete in repeater
-
-## 1.0.139 / 2-4-2024
-
-===================
-
-* Update Utilities Library
-* Fix delete in repeater
-
-## 1.0.138 / 1-4-2024
-
-===================
-
-* Update Utilities Library
-
-## 1.0.137 / 31-3-2024
-
-===================
-
-* Fix File uploader drop zone
-
-## 1.0.136 / 28-3-2024
-
-===================
-
-* Update Utilities Library
-
-## 1.0.135 / 27-3-2024
-
-===================
-
-* Update Utilities Library
-* Fix Delete File & Allowed File Type Issue In FileUpload Control
-
-## 1.0.134 / 24-3-2024
-
-===================
-
-* Fix delete in repeater control
-
-## 1.0.133 / 24-3-2024
-
-===================
-
-* Fix naming convention in repeater control while edit
-
-## 1.0.132 / 21-3-2024
-
-===================
-
-* Add outputFunction Prop in ControlOptionsBase to use it while add a control in repeater
-* add new type of repeater (checkbox control)
-
-## 1.0.131 / 20-3-2024
-
-===================
-
-* Fix File-Upload Control DTO Bug
-
-## 1.0.130 / 19-3-2024
-
-===================
-
-* Fix Multiple File-Upload Control Bug
-
-## 1.0.129 / 14-3-2024
-
-===================
-
-* Fix File-Upload Control Name Bug
-
-## 1.0.128 / 12-3-2024
-
-===================
-
-* Update Utilities Library
-
-## 1.0.127 / 6-3-2024
-
-===================
-
-* Update Utilities Library
-
-## 1.0.126 / 6-3-2024
-
-===================
-
-* Update Utilities Library
-
-## 1.0.125 / 5-3-2024
-
-===================
-
-* Update Utilities Library
-
-## 1.0.124 / 27-2-2024
-
-===================
-
-* Fix Bug in TextBox,TextArea,MultLingualTextArea Max Length Validation Msg,FileUpload and DateTimePicker
-
-## 1.0.123 / 22-2-2024
-
-===================
-
-* Fix Bug in Paging Component
-
-## 1.0.122 / 15-2-2024
-
-===================
-
-* Disable History List Of AutoComplate Control
-* Fix Paging Control (Page Change Bug)
-
-## 1.0.121 / 14-2-2024
-
-===================
-
-* Fix English and Arabic Validation Error for MultiLingualTextBox and MultiLingualHtmlEditor
-* Fix Characters count validation message in MultLingualTextBox
-* Update resource key to be VAL_ArabicIsRequiredAndOnly50CharactersEnglish in MultilingualTextbox, MultilingualTextArea,textbox and ValidationErrorMessage
-* Fix placeholder in MultilingualTextbox and MultilingualTextArea
-* Update Paging component fill totalcount of paging options
-* Add new file types for filer uploader  in FileType Enums
-* Return file name, file type while upload file completed
-
-## 1.0.120 / 11-2-2024
-
-===================
-*Prevent Form Submit Twice
-
-## 1.0.119 / 8-2-2024
-
-===================
-
-* Update Utilities Library  
-
-## 1.0.118 / 8-2-2024
-
-===================
-
-* Update Utilities Library  
-* Fix FileUpload Loader issue
-
-## 1.0.117 / 7-2-2024
-
-===================
-
-* Fix MultiligualTextBox Arabic Binding issue
-
-## 1.0.116 / 7-2-2024
-
-===================
-
-* Fix AutoComplate Control Custom Validator Issue
-
-## 1.0.115 / 6-2-2024
-
-===================
-
-* Fix AutoComplate Control Custom Validator Issue
-
-## 1.0.114 / 5-2-2024
-
-===================
-
-* Update AutoComplate Control (Add Extra Filter- Take Name As Input)
-* Update TagsInput Control(Add Extra Filter- Take Name As Input)
-* Update Form Control(Allow Disable Submit With Enter Press)
-
-## 1.0.113 / 4-1-2024
-
-===================
-
-* Update Utilities Library  
-* Update File Upload Control To Allow Upload File Async  
-* Fix DateTimePicker Issue When Use In Filter Mode
-
-## 1.0.112 / 21-12-2023
-
-===================
-
-* update controls, controls options with new naming convention, and update datepicker controls (remove time zone offest)
-
-## 1.0.111 / 13-12-2023
-
-===================
-
-* Add Advanced map control.  
-
-## 1.0.110 / 11-12-2023
-
-===================
-
-* Upgraded Angular version (17) and upgraded related libraries.  
-
-## 1.0.109 / 3-12-2023
-
-===================
-
-* Update Utilities Library  
-
-## 1.0.108 / 3-12-2023
-
-===================
-
-* Update Utilities Library  
-
-## 1.0.107 / 29-11-2023
-
-===================
-
-* Update Utilities Library  
-
-## 1.0.106 / 19-11-2023
-
-===================
-
-* Update Utilities Library  
-
-## 1.0.105 / 16-11-2023
-
-===================
-
-* Update Utilities Library  
-
-## 1.0.104 / 16-10-2023
-
-===================
-
-* Update textbox control add (OnBlur) output when curser get out of input.
-
-## 1.0.103 / 15-10-2023
-
-===================
-
-* Update AutocompleteTextBox Control
-
-## 1.0.102 / 12-10-2023
-
-===================
-
-* Update AutocompleteTextBox Control
-
-## 1.0.101 / 14-9-2023
-
-===================
-
-* Add Custom Template to AutocompleteTextBox options
-
-## 1.0.100 / 15-8-2023
-
-===================
-
-* Update Utilities Library  
-
-## 1.0.99 / 15-8-2023
-
-===================
-
-* Update AutocompleteTextBox Control
-* Update FileUpload Control
-* Update Form Control
-
-## 1.0.97 / 19-7-2023
-
-===================
-
-* Update Utilities Library  
-* fix MultiLingualHtmlEditor Control
-
-## 1.0.96 / 18-7-2023
-
-===================
-
-* Add Default value when BBSF Control is Readonly and not has value.
-
-## 1.0.95 / 14-6-2023
-
-===================
-
-* Add Readonly Option to All BBSF Controls  
-
-## 1.0.94 / 21-5-2023
-
-===================
-
-* Fix File-Upload Control Bug (Delete file from multiple files has an error )
-
-## 1.0.93 / 02-5-2023
-
-===================
-
-* Fix Phone Control Bug
-
-## 1.0.92 / 13-4-2023
-
-===================
-
-* Fix Direction For All Control
-
-## 1.0.91 / 8-4-2023
-
-===================
-
-* Update Dropdown Control
-
-## 1.0.90 / 27-3-2023
-
-===================
-
-* Update Utilities Library
-* Update Controls
-
-## 1.0.89 / 26-3-2023 (!!!Warning!! Testing Release)
-
-===================
-
-* Update Utilities Library
-
-## 1.0.88 / 22-3-2023
-
-===================
-
-* Update Utilities Library
-
-## 1.0.86 / 14-2-2023
-
-===================
-
-* Solve Textarea Control Bugs
-* Solve Upload-File Control Bugs
-
-## 1.0.84 / 12-2-2023
-
-===================
-
-* Update AppBase Component
-* Solve UI Issue In All Controls
-
-## 1.0.83 / 25-1-2023
-
-===================
-
-* Fix Modal Dismiss Issue
-
-## 1.0.82 / 25-1-2023
-
-===================
-
-* Fix TextBox control
-* Fix MultiLingualTextBox control
-* Fix MultiLingualHTML control
-
-## 1.0.81 / 24-1-2023
-
-===================
-
-* Fix HTML Editor control
-* Fix Multilingual HTML Editor control
-* Fix Tag-Input control
-* Fix All UI Bugs
-
-## 1.0.80 / 18-1-2023
-
-===================
-
-* Fix HTML Editor control inline style
-* Fix Multilingual HTML Editor control inline style
-* Change Image Upload cropper tolltip to be translated
-
-## 1.0.79 / 15-1-2023
-
-===================
-*Update App Base and Controls
-
-## 1.0.78 / 11-1-2023
-
-===================
-
-* Solve Image Control Bug
-
-## 1.0.77 / 11-1-2023
-
-===================
-
-* Solve Image Control Bug
-
-## 1.0.74 / 9-1-2023
-
-===================
-
-* Add UI Changes
-
-## 1.0.73 / 5-1-2023
-
-===================
-
-* Update utilities Version
-
-## 1.0.72 / 3-1-2023
-
-===================
-
-* Update utilities Version
-
-## 1.0.71 / 25-12-2022
-
-===================
-
-* Update utilities Version
-
-## 1.0.70 / 22-12-2022
-
-===================
-
-* Update utilities Version
-
-## 1.0.69 / 05-12-2022
-
-===================
-*Add Page Header Control
-*Add BBSF Base Component
-*Update Captcha Control
-*Add Custom Date Pipe
-*Update Utilities version
-
-## 1.0.68 / 22-11-2022
-
-===================
-*Fix Range Number in Repeater Control when control type number
-
-## 1.0.66 / 20-11-2022
-
-* Controls UI revamp
-  * Textbox
-  * Textarea
-  * Multilingual Textbox
-  * Multilingual Textarea
-  * Checkbox
-  * Dropdown
-  * Repeater Table
-  * Image Upload
-  * Tags Input
-  * Paging
-
-## 1.0.65 / 15-11-2022
-
-===================
-
-* Add Captcha control
-
-## 1.0.64 / 07-11-2022
-
-===================
-
-* Enable two way binding to all controls
-* Add new options to Confirmation Modal (showCancelButton - showCloseButton)
-* Add option to all controls to allow label extra classes (LabelExtraClasses)
-
-## 1.0.63 / 18-10-2022
-
-===================
-
-* Fix Profile Image Upload control
-
-## 1.0.62 / 11-10-2022
-
-===================
-
-* Fix modal dismiss in form submission success
-* Add new property to (DisableModalDismiss) to FormOptions
-* Fix tags input control, add tag selected text when losing focus if AllowNewSelection set to true
-
-## 1.0.61 / 10-10-2022
-
-===================
-
-* Update tags input control validation (Handle unmatched selection when enabling add new selection)
-
-## 1.0.60 / 2-10-2022
-
-===================
-
-* Update lang-mode cases in MultiLingualTextArea & MultiLingualTextBox controls
-
-## 1.0.59 / 29-9-2022
-
-===================
-
-* Update repeater-table control
-  * Add DisableAddButton to remove add button from the table
-  * Add DisableDeleteButton to remove the delete button from the table
-  * Add IsHiddenInput to RepeaterField that allows hiding columns from the table
-* Update ControlOptionsBase, Add IsReadonly options that allow control to be submitted with the form instead of IsDisabled (only applied to text-box control)
-
-## 1.0.58 / 19-9-2022
-
-===================
-
-* Update tag-input control to allow reset and delete
-* Update repeater control
-
-## 1.0.57 / 11-9-2022
-
-===================
-
-* Fix tags input (hanle backspace to remove no matched error)
-
-## 1.0.53 / 18-8-2022
-
-===================
-
-* Update Location control(delete value when value empty)
-
-## 1.0.52 / 16-8-2022
-
-===================
-
-* Update Tag input control(custom validation mode)
-
-## 1.0.51 / 14-8-2022
-
-===================
-
-* Update utilities Version
-
-## 1.0.50 / 4-8-2022
-
-===================
-
-* Replace lang attribute with b-lang
-* Update MapAutoComplete control to enable edit mode
-
-## 1.0.49 / 28-7-2022
-
-===================
-
-* Fix bug in autocomplete control
-
-## 1.0.48 / 6-7-2022
-
-===================
-
-* Update tag input control
-* Update tag input dto
-* Update tag input options
-
-## 1.0.47 / 5-7-2022
-
-===================
-
-* Add DisableBlockUI and StartPagingCallback to paging control options
-
-## 1.0.46 / 4-7-2022
-
-===================
-
-* [Paging control] Add clearFilter method to reset all filters
-* [PagingOptions] Add property (ResetFilterButtonName) (string), to select button that clears filters
-* [Paging control] Check for ResetFilterButtonName, if not null then add event listener (click) to call clearFilter method
-* [Paging control] Add method (getFiltersValue) to get all filters in paging, Usually used in export method
-
-## 1.0.45 / 23-6-2022
-
-===================
-
-* Change paging control update items action,Pass PagingPayload object in body instead of params
-* Fix bug in form control ngAfterViewInit
-
-## 1.0.44 / 14-6-2022
-
-===================
-
-* Fix bugs in DropDown,TagsInput controls
-
-## 1.0.43 / 9-6-2022
-
-===================
-
-* Fix bugs in DateTimePicker,FileUpload,Form,Paging,Toggle slide controls
-
-## 1.0.42 / 2-6-2022
-
-===================
-*Fix FileUpload "Upload" resource
-*Fix MultiLingualTextBox Arabic validation
-*Fix TextBox Arabic validation
-*Fix TagsInput noItemsMAtch message
-*Add AreaOfFocus Guid to Enums
-*Fix License FileType to BN
-
-## 1.0.40/ 25-5-2022
-
-===================
-
-* Update repeater model
-
-## 1.0.38/ 16-5-2022
-
-===================
-
-* Update utilities library version
-
-## 1.0.37/ 16-5-2022
-
-===================
-
-* Update all control
-* Update all Models
-* Update utilities library version
-
-## 1.0.36/ 28-4-2022
-
-===================
-
-* Update Paging control
-
-## 1.0.35/ 27-4-2022
-
-===================
-
-* Solve all bugs
-* Implementing Controls Patch Updates
-* Implementing BBSFDateTime Pipe
-
-## 1.0.32 / 30-3-2022
-
-===================
-
-* Update utilities library version
-
-## 1.0.31 / 29-3-2022
-
-===================
-
-* Update repeater-table control
-
-## 1.0.29 / 27-3-2022
-
-===================
-
-* Add Repeater Table control
-* Update Complex Repeater control
+# BnsightsControlLibrary
+
+BBSF Controls package is part of BBSF 3 packages. It has all the form controls that we use to build our application forms.
+
+For more info please visit [BBSF Controls documenation](https://bbsfadmin.bnsights.com/controls) or [BBSF documentation](https://bnsightsprojects.visualstudio.com/BBSF%203/_wiki/wikis/BBSF-3.wiki/65/BBSF-Documentation)
+
+---
+
+## 🚀 NEW! Tree-Shakable Granular Modules (v2.0+)
+
+The package now supports **true tree-shaking** through granular modules for optimal bundle size!
+
+### 📦 Available Modules
+
+#### ✨ Granular Modules (RECOMMENDED - Best Bundle Optimization)
+
+| Module | Gzipped Size | Contains | Main Dependencies |
+|--------|--------------|----------|-------------------|
+| **BBSFFormsBasicModule** | ~30 KB | TextBox, TextArea, CheckBox, RadioButton, Toggle | ngx-mask, Material slide-toggle |
+| **BBSFDropdownModule** | ~130 KB | DropdownList | ng-select (~100 KB) |
+| **BBSFDateTimeModule** | ~220 KB | DateTimePicker + Date pipes | Owl DateTime (~200 KB) |
+| **BBSFPhoneModule** | ~90 KB | Phone input | intl-tel-input (~80 KB) |
+| **BBSFUtilityModule** | ~80 KB | Form, Modals, Paging, PageHeader, Recaptcha | SweetAlert2, NgBootstrap |
+| **BBSFMultilingualModule** | ~15 KB | MultiLingualTextBox, MultiLingualTextArea | None (lightweight) |
+
+#### 📚 Legacy Grouped Modules (For Backward Compatibility)
+
+| Module | Size | Contains |
+|--------|------|----------|
+| **BBSFCoreModule** ⚠️ | ~650-800 KB | ALL modules above (deprecated, use granular modules instead) |
+| **BBSFEditorsModule** | ~800 KB | HtmlEditor, MarkdownEditor, MultiLingualHtmlEditor |
+| **BBSFUploadsModule** | ~360 KB | FileUpload, ImageUpload, ProfileImageUploader |
+| **BBSFSpecializedModule** | ~300 KB | Calendar, MapAutoComplete, AutocompleteTextBox, TagsInput, Repeater |
+| **BBSFControlsModule** ⚠️ | ~2+ MB | Everything (deprecated) |
+
+---
+
+### 📖 Usage Examples
+
+#### ✅ **Best Practice: Use Granular Modules**
+
+```typescript
+// Example 1: Basic form with text inputs only (~30 KB)
+import { BBSFFormsBasicModule } from '@bnsights/bbsf-controls';
+
+@NgModule({
+  imports: [BBSFFormsBasicModule]
+})
+export class SimpleFormModule { }
+```
+
+```typescript
+// Example 2: Form with dropdown (~160 KB - 75% smaller than BBSFCoreModule!)
+import { 
+  BBSFFormsBasicModule,    // ~30 KB
+  BBSFDropdownModule       // ~130 KB
+} from '@bnsights/bbsf-controls';
+
+@NgModule({
+  imports: [BBSFFormsBasicModule, BBSFDropdownModule]
+})
+export class FormWithDropdownModule { }
+```
+
+```typescript
+// Example 3: Form with date picker (~250 KB - 60% smaller!)
+import { 
+  BBSFFormsBasicModule,    // ~30 KB
+  BBSFDateTimeModule       // ~220 KB
+} from '@bnsights/bbsf-controls';
+
+@NgModule({
+  imports: [BBSFFormsBasicModule, BBSFDateTimeModule]
+})
+export class FormWithDateModule { }
+```
+
+```typescript
+// Example 4: Complex form with multiple controls (~565 KB - 13% smaller)
+import { 
+  BBSFFormsBasicModule,      // ~30 KB - TextBox, CheckBox, etc.
+  BBSFDropdownModule,        // ~130 KB - Dropdown
+  BBSFDateTimeModule,        // ~220 KB - Date/Time
+  BBSFPhoneModule,           // ~90 KB - Phone
+  BBSFUtilityModule,         // ~80 KB - Form, Modals, Paging
+  BBSFMultilingualModule     // ~15 KB - Multilingual
+} from '@bnsights/bbsf-controls';
+
+@NgModule({
+  imports: [
+    BBSFFormsBasicModule,
+    BBSFDropdownModule,
+    BBSFDateTimeModule,
+    BBSFPhoneModule,
+    BBSFUtilityModule,
+    BBSFMultilingualModule
+  ]
+})
+export class FullFormModule { }
+```
+
+```typescript
+// Example 5: Form with rich text editor (~830 KB)
+import { 
+  BBSFFormsBasicModule,
+  BBSFEditorsModule          // Rich text editors
+} from '@bnsights/bbsf-controls';
+
+@NgModule({
+  imports: [BBSFFormsBasicModule, BBSFEditorsModule]
+})
+export class ContentFormModule { }
+```
+
+#### ⚠️ **Legacy: Old Module Imports (Not Recommended)**
+
+```typescript
+// ❌ Old way 1: Loads ALL controls (~2+ MB)
+import { BBSFControlsModule } from '@bnsights/bbsf-controls';
+
+@NgModule({
+  imports: [BBSFControlsModule]  // Don't use this!
+})
+```
+
+```typescript
+// ⚠️ Old way 2: Still loads too much (~650 KB even if you use 1 control)
+import { BBSFCoreModule } from '@bnsights/bbsf-controls';
+
+@NgModule({
+  imports: [BBSFCoreModule]  // Use granular modules instead!
+})
+```
+
+---
+
+### 📊 Performance Benefits
+
+#### Real-World Bundle Size Comparison
+
+| Use Case | Old (BBSFCoreModule) | New (Granular) | Savings |
+|----------|---------------------|----------------|---------|
+| **Basic form only** | 650 KB | 30 KB | **95%** ⬇️ |
+| **Form + Dropdown** | 650 KB | 160 KB | **75%** ⬇️ |
+| **Form + Date picker** | 650 KB | 250 KB | **60%** ⬇️ |
+| **Form + Phone** | 650 KB | 120 KB | **82%** ⬇️ |
+| **All core controls** | 650 KB | 565 KB | **13%** ⬇️ |
+| **+ Rich text editor** | 1450 KB | 830 KB | **43%** ⬇️ |
+
+#### Example: Typical Application Impact
+
+```
+Before (using BBSFCoreModule):
+├── TextBox ✓
+├── Dropdown ✓
+└── Unused: DateTimePicker ✗ (~200 KB wasted)
+              Phone ✗ (~80 KB wasted)
+              Paging ✗ (~30 KB wasted)
+              Modals ✗ (~50 KB wasted)
+              ... (~290 KB wasted)
+Total: 650 KB
+
+After (using granular modules):
+├── BBSFFormsBasicModule (~30 KB)
+└── BBSFDropdownModule (~130 KB)
+Total: 160 KB (490 KB saved! 75% reduction)
+```
+
+---
+
+### 🔄 Migration Guide
+
+#### Step 1: Identify Your Controls
+
+Audit your application to see which controls you're actually using:
+
+```bash
+# Search for control usage in your codebase
+grep -r "bbsf-textbox\|bbsf-dropdown\|bbsf-datepicker" src/
+```
+
+#### Step 2: Map Controls to Granular Modules
+
+| If you use... | Import this module | Size |
+|--------------|-------------------|------|
+| TextBox, TextArea, CheckBox, Radio, Toggle | `BBSFFormsBasicModule` | ~30 KB |
+| DropdownList | `BBSFDropdownModule` | ~130 KB |
+| DateTimePicker | `BBSFDateTimeModule` | ~220 KB |
+| Phone | `BBSFPhoneModule` | ~90 KB |
+| Form, Modals, Paging, PageHeader | `BBSFUtilityModule` | ~80 KB |
+| MultiLingualTextBox/TextArea | `BBSFMultilingualModule` | ~15 KB |
+| HtmlEditor, MarkdownEditor | `BBSFEditorsModule` | ~800 KB |
+| FileUpload, ImageUpload | `BBSFUploadsModule` | ~360 KB |
+| Calendar, Maps, TagsInput, Repeater | `BBSFSpecializedModule` | ~300 KB |
+
+#### Step 3: Replace Imports
+
+**Migration Example 1: From BBSFControlsModule**
+```typescript
+// ❌ Before: Loading ALL controls (~2+ MB)
+import { BBSFControlsModule } from '@bnsights/bbsf-controls';
+
+@NgModule({
+  imports: [BBSFControlsModule]
+})
+export class UserFormModule { }
+
+// ✅ After: Only load what you need (~160 KB - 92% smaller!)
+import { 
+  BBSFFormsBasicModule,    // You use TextBox, CheckBox
+  BBSFDropdownModule       // You use Dropdown
+} from '@bnsights/bbsf-controls';
+
+@NgModule({
+  imports: [
+    BBSFFormsBasicModule,
+    BBSFDropdownModule
+  ]
+})
+export class UserFormModule { }
+```
+
+**Migration Example 2: From BBSFCoreModule**
+```typescript
+// ⚠️ Before: Loading all core controls (~650 KB)
+import { BBSFCoreModule } from '@bnsights/bbsf-controls';
+
+@NgModule({
+  imports: [BBSFCoreModule]
+})
+export class SimpleFormModule { }
+
+// ✅ After: Only basic forms (~30 KB - 95% smaller!)
+import { BBSFFormsBasicModule } from '@bnsights/bbsf-controls';
+
+@NgModule({
+  imports: [BBSFFormsBasicModule]
+})
+export class SimpleFormModule { }
+```
+
+**Migration Example 3: Complex Form**
+```typescript
+// ❌ Before: BBSFCoreModule (~650 KB) + BBSFEditorsModule (~800 KB) = 1.45 MB
+import { BBSFCoreModule, BBSFEditorsModule } from '@bnsights/bbsf-controls';
+
+@NgModule({
+  imports: [BBSFCoreModule, BBSFEditorsModule]
+})
+export class ArticleFormModule { }
+
+// ✅ After: Only what you need (~410 KB - 72% smaller!)
+import { 
+  BBSFFormsBasicModule,    // ~30 KB - TextBox, CheckBox
+  BBSFDropdownModule,      // ~130 KB - Dropdown
+  BBSFDateTimeModule,      // ~220 KB - DatePicker
+  BBSFFormsBasicModule     // ~30 KB - Basic forms
+} from '@bnsights/bbsf-controls';
+
+@NgModule({
+  imports: [
+    BBSFFormsBasicModule,
+    BBSFDropdownModule,
+    BBSFDateTimeModule
+  ]
+})
+export class ArticleFormModule { }
+```
+
+#### Step 4: Verify Bundle Size
+
+After migration, build your app and check the bundle size:
+
+```bash
+# Build with stats
+npm run build -- --stats-json
+
+# Analyze bundle (install if needed: npm i -g webpack-bundle-analyzer)
+npx webpack-bundle-analyzer dist/your-app/stats.json
+```
+
+Look for `@bnsights/bbsf-controls` in the bundle analyzer to see your savings!
+
+#### Step 5: Update All Modules
+
+Search and replace across your codebase:
+
+```bash
+# Find all BBSFControlsModule imports
+grep -r "BBSFControlsModule" src/
+
+# Find all BBSFCoreModule imports
+grep -r "BBSFCoreModule" src/
+```
+
+Then update each file based on which controls it actually uses.
+
+---
+
+### ⚡ Quick Reference
+
+**Most Common Combinations:**
+
+```typescript
+// Basic form (~30 KB)
+import { BBSFFormsBasicModule } from '@bnsights/bbsf-controls';
+
+// Form with dropdown (~160 KB)
+import { BBSFFormsBasicModule, BBSFDropdownModule } from '@bnsights/bbsf-controls';
+
+// Form with date picker (~250 KB)
+import { BBSFFormsBasicModule, BBSFDateTimeModule } from '@bnsights/bbsf-controls';
+
+// Complete form (~565 KB)
+import { 
+  BBSFFormsBasicModule, 
+  BBSFDropdownModule, 
+  BBSFDateTimeModule, 
+  BBSFPhoneModule, 
+  BBSFUtilityModule 
+} from '@bnsights/bbsf-controls';
+
+// Content management (~830 KB)
+import { BBSFFormsBasicModule, BBSFEditorsModule } from '@bnsights/bbsf-controls';
+
+// Media management (~390 KB)
+import { BBSFFormsBasicModule, BBSFUploadsModule } from '@bnsights/bbsf-controls';
+```
+
+---
+
+## 🔧 Troubleshooting
+
+### Error: `export 'DOCUMENT' (imported as 'DOCUMENT') was not found in '@angular/core'`
+
+**Problem:** This error occurs when using Angular 19+ with the `BBSFEditorsModule` (which uses `@kolkov/angular-editor`). Angular 19's build system tries to process the `@kolkov/angular-editor` package and encounters compatibility issues.
+
+**Solution 1: Install @kolkov/angular-editor in your consuming app (Recommended)**
+
+Add `@kolkov/angular-editor` to your consuming app's `package.json` dependencies:
+
+```bash
+npm install @kolkov/angular-editor@^3.0.0-beta.2
+```
+
+This ensures the package is resolved correctly during the build process.
+
+**Solution 2: Use patch-package to fix the import**
+
+If Solution 1 doesn't work, you can patch the `@kolkov/angular-editor` package:
+
+1. Install patch-package in your consuming app:
+```bash
+npm install --save-dev patch-package postinstall-postinstall
+```
+
+2. Create a patch file:
+   - Navigate to `node_modules/@kolkov/angular-editor/fesm2020/kolkov-angular-editor.mjs`
+   - Verify that line 4 already has: `import { DOCUMENT, CommonModule } from '@angular/common';`
+   - If the issue persists, it may be a bundling issue with Angular 19
+
+3. If needed, manually patch the file and create a patch:
+```bash
+npx patch-package @kolkov/angular-editor
+```
+
+4. Add a postinstall script to your `package.json`:
+```json
+{
+  "scripts": {
+    "postinstall": "patch-package"
+  }
+}
+```
+
+**Solution 3: Configure your build to externalize @kolkov/angular-editor**
+
+If you're using a custom webpack configuration, you can configure it to externalize the package:
+
+```javascript
+// webpack.config.js or angular.json custom webpack config
+externals: {
+  '@kolkov/angular-editor': '@kolkov/angular-editor'
+}
+```
+
+**Solution 4: Use a different HTML editor**
+
+If the issue persists, consider using a different HTML editor component that's compatible with Angular 19, or wait for an updated version of `@kolkov/angular-editor`.
+
+**Note:** The library maintainers are aware of this issue. The `@kolkov/angular-editor` package version `3.0.0-beta.2` was built for Angular 13-15, and Angular 19 has stricter module resolution. The recommended workaround is Solution 1.
+
+---
+
+## Change Log
+
+## 1.0.194 / 16-10-2025
+
+=====================
+
+- Implement standalone components
+
+## 1.0.193 / 16-10-2025
+
+=====================
+
+- Fix Format for displayValues in Tags, multiSelect
+
+## 1.0.192 / 15-10-2025
+
+=====================
+
+- Fix Repeater URL Validation
+- Fix Clear singleSelection DropdownComponent
+- Remove Swal cancelButton style
+
+## 1.0.191 / 23/9/2025
+
+=====================
+
+- Initialize repeater control when custom validation
+- Handle attach image in HTML Editor Component
+- Validate files count when drag and drop file in single upload
+
+
+## 1.0.190 / 21/9/2025
+
+=====================
+
+- Add option to add buttons to hide in HTML Editor Component
+- Remove options from Html Editor component
+
+## 1.0.189 / 15/9/2025
+
+=====================
+
+- Add option to show password requirements
+
+## 1.0.188 / 15/9/2025
+
+=====================
+
+- Update utilities package to 1.0.68
+- Add Password Validation disclaimer
+
+## 1.0.187 / 15/9/2025
+
+=====================
+
+- Update utilities package to 1.0.67
+
+## 1.0.186 11-09-2025
+
+====================
+
+- Fixing password validation issue in TextBoxComponent
+
+## 1.0.185 07-09-2025
+
+====================
+
+- DropdownList Enable Select all.
+
+## 1.0.184 03-09-2025
+
+====================
+
+- dropdownlist place error message outside input style
+
+## 1.0.183 03-09-2025
+
+====================
+
+- Fix FileUpload issues
+- Fix TextArea SpeechRecognition issue.
+
+## 1.0.182 28-08-2025
+
+====================
+
+- Update utilities package to 1.0.66
+- Fix FileUpload issues
+- Enhancement for textarea, multi lingual textbox
+
+## 1.0.181 26-08-2025
+
+====================
+
+- Update utilities package to 1.0.64
+
+# 1.0.178 20-08-2025 (deprecated)
+====================
+- Fileupload component
+  - fix accepted types issue.
+  - fix error display issue.
+
+# 1.0.177 18-08-2025 (deprecated)
+====================
+- Enhance File-Upload Component
+- Fix FileUplaod typo to be FileUpload 
+
+# 1.0.176 11-08-2025
+====================
+- Updating utilities package version.
+
+# 1.0.173 06-08-2025
+====================
+- Add desplayValue getter in all controls to handle selected values
+- Fix some issue in file upload 
+
+# 1.0.172 06-08-2025
+====================
+- Add desplayValue in all controls to handle selected values 
+
+
+# 1.0.171 04-08-2025
+====================
+- add PreventDoubleClickDirective to handle double click issues
+
+# 1.0.168 03-08-2025
+====================
+- Fix mic in `text-area`.
+- Handle navigation event in paging `enableBrowserNavigation`.
+
+## 1.0.167 29-07-2025
+=====================
+- add fixes to `date-picker`, and `dropdownlist` components for pageFilter popup
+
+## 1.0.170 / 23-7-2024 (Using Angular 19)
+
+=====================
+
+- Update BBSF to use Angular 19
+- Update utilities package
+
+## 1.0.166 / 6/5/2025
+=====================
+Added extra options to **MapAutoCompleteOptions** advanced view mode
+- Sets the zoom level for the map > `zoom`
+- Finding a location by a specific address > `address`
+- Boolean to enable fallback behavior if the address lookup fails > `enableFallbackAddress`
+- Option to validates that the selected location is within a specific city boundary > `validateLocationWithinCity`
+- Added componentRestrictions Geo Restriction option > `country` 
+
+Fixed href issue in **FileUploaderComponent**
+
+## 1.0.161 / 12-3-2025
+=====================
+- Enable Grouping feature in dropdown control (Added hasGroup property in DropdownOptions and group property in DropdownListItem)
+## 1.0.160 / 26-2-2025
+=====================
+- Tag Fix value null check
+
+
+## 1.0.159 / 16-2-2025
+
+=====================
+
+- Update utilities package
+- Fix TextBox when value undenied in check max_length
+
+## 1.0.158 / 16-2-2025
+
+=====================
+
+- update utilities package
+
+## 1.0.157 / 30-12-2024
+
+=====================
+
+* Fix bug in TextBox when delete max limit chars
+
+## 1.0.156 / 28-11-2024
+
+=====================
+
+* Fix bug in TextArea when speechrecoginitoin is disabled
+
+## 1.0.155 / 28-11-2024
+
+=====================
+
+* Fix bug in Repeater table control on delete item
+
+## 1.0.154 / 28-11-2024
+
+=====================
+**Fix TextArea When Using in Repeater**
+
+## 1.0.153 / 27-11-2024
+
+=====================
+**Fix Repeater table control on delete item**
+
+## 1.0.152 / 3-9-2024
+
+=====================
+-multi tenant
+
+## 1.0.151 / 19-8-2024
+
+======================
+
+* Added MarkdownEditor Control
+
+## 1.0.150 / 8-8-2024
+
+======================
+
+* Updated TextAreaComponent speech language select with UI fixes
+
+## 1.0.149 / 6-8-2024
+
+======================
+
+* Updated TextAreaComponent speech language select
+
+## 1.0.148 / 4-8-2024
+
+===================
+
+* fixed UI bug in speech to text of TextAreaComponent
+
+## 1.0.147 / 4-8-2024
+
+===================
+
+* fixed bug in speech to text of TextAreaComponent
+
+## 1.0.146 / 4-8-2024
+
+===================
+
+* added feature spech to text into TextAreaComponent
+
+## 1.0.145 / 24-7-2024
+
+===================
+
+* fix naming in file upload control
+
+## 1.0.144 / 24-7-2024
+
+===================
+
+* Fix viewing File upload control while options.isUploadFileAsync == false
+
+## 1.0.143 / 16-7-2024
+
+===================
+
+* Update imports for sweetalert package to avoid inline style injected to DOM
+  * import style inside your applications
+
+## 1.0.142 / 3-6-2024
+
+===================
+
+* Update Utilities Library verion
+
+## 1.0.141 / 18-4-2024
+
+===================
+
+* Fix File uploader loading issue
+
+## 1.0.140 / 3-4-2024
+
+===================
+
+* Fix delete in repeater
+
+## 1.0.139 / 2-4-2024
+
+===================
+
+* Update Utilities Library
+* Fix delete in repeater
+
+## 1.0.138 / 1-4-2024
+
+===================
+
+* Update Utilities Library
+
+## 1.0.137 / 31-3-2024
+
+===================
+
+* Fix File uploader drop zone
+
+## 1.0.136 / 28-3-2024
+
+===================
+
+* Update Utilities Library
+
+## 1.0.135 / 27-3-2024
+
+===================
+
+* Update Utilities Library
+* Fix Delete File & Allowed File Type Issue In FileUpload Control
+
+## 1.0.134 / 24-3-2024
+
+===================
+
+* Fix delete in repeater control
+
+## 1.0.133 / 24-3-2024
+
+===================
+
+* Fix naming convention in repeater control while edit
+
+## 1.0.132 / 21-3-2024
+
+===================
+
+* Add outputFunction Prop in ControlOptionsBase to use it while add a control in repeater
+* add new type of repeater (checkbox control)
+
+## 1.0.131 / 20-3-2024
+
+===================
+
+* Fix File-Upload Control DTO Bug
+
+## 1.0.130 / 19-3-2024
+
+===================
+
+* Fix Multiple File-Upload Control Bug
+
+## 1.0.129 / 14-3-2024
+
+===================
+
+* Fix File-Upload Control Name Bug
+
+## 1.0.128 / 12-3-2024
+
+===================
+
+* Update Utilities Library
+
+## 1.0.127 / 6-3-2024
+
+===================
+
+* Update Utilities Library
+
+## 1.0.126 / 6-3-2024
+
+===================
+
+* Update Utilities Library
+
+## 1.0.125 / 5-3-2024
+
+===================
+
+* Update Utilities Library
+
+## 1.0.124 / 27-2-2024
+
+===================
+
+* Fix Bug in TextBox,TextArea,MultLingualTextArea Max Length Validation Msg,FileUpload and DateTimePicker
+
+## 1.0.123 / 22-2-2024
+
+===================
+
+* Fix Bug in Paging Component
+
+## 1.0.122 / 15-2-2024
+
+===================
+
+* Disable History List Of AutoComplate Control
+* Fix Paging Control (Page Change Bug)
+
+## 1.0.121 / 14-2-2024
+
+===================
+
+* Fix English and Arabic Validation Error for MultiLingualTextBox and MultiLingualHtmlEditor
+* Fix Characters count validation message in MultLingualTextBox
+* Update resource key to be VAL_ArabicIsRequiredAndOnly50CharactersEnglish in MultilingualTextbox, MultilingualTextArea,textbox and ValidationErrorMessage
+* Fix placeholder in MultilingualTextbox and MultilingualTextArea
+* Update Paging component fill totalcount of paging options
+* Add new file types for filer uploader  in FileType Enums
+* Return file name, file type while upload file completed
+
+## 1.0.120 / 11-2-2024
+
+===================
+*Prevent Form Submit Twice
+
+## 1.0.119 / 8-2-2024
+
+===================
+
+* Update Utilities Library  
+
+## 1.0.118 / 8-2-2024
+
+===================
+
+* Update Utilities Library  
+* Fix FileUpload Loader issue
+
+## 1.0.117 / 7-2-2024
+
+===================
+
+* Fix MultiligualTextBox Arabic Binding issue
+
+## 1.0.116 / 7-2-2024
+
+===================
+
+* Fix AutoComplate Control Custom Validator Issue
+
+## 1.0.115 / 6-2-2024
+
+===================
+
+* Fix AutoComplate Control Custom Validator Issue
+
+## 1.0.114 / 5-2-2024
+
+===================
+
+* Update AutoComplate Control (Add Extra Filter- Take Name As Input)
+* Update TagsInput Control(Add Extra Filter- Take Name As Input)
+* Update Form Control(Allow Disable Submit With Enter Press)
+
+## 1.0.113 / 4-1-2024
+
+===================
+
+* Update Utilities Library  
+* Update File Upload Control To Allow Upload File Async  
+* Fix DateTimePicker Issue When Use In Filter Mode
+
+## 1.0.112 / 21-12-2023
+
+===================
+
+* update controls, controls options with new naming convention, and update datepicker controls (remove time zone offest)
+
+## 1.0.111 / 13-12-2023
+
+===================
+
+* Add Advanced map control.  
+
+## 1.0.110 / 11-12-2023
+
+===================
+
+* Upgraded Angular version (17) and upgraded related libraries.  
+
+## 1.0.109 / 3-12-2023
+
+===================
+
+* Update Utilities Library  
+
+## 1.0.108 / 3-12-2023
+
+===================
+
+* Update Utilities Library  
+
+## 1.0.107 / 29-11-2023
+
+===================
+
+* Update Utilities Library  
+
+## 1.0.106 / 19-11-2023
+
+===================
+
+* Update Utilities Library  
+
+## 1.0.105 / 16-11-2023
+
+===================
+
+* Update Utilities Library  
+
+## 1.0.104 / 16-10-2023
+
+===================
+
+* Update textbox control add (OnBlur) output when curser get out of input.
+
+## 1.0.103 / 15-10-2023
+
+===================
+
+* Update AutocompleteTextBox Control
+
+## 1.0.102 / 12-10-2023
+
+===================
+
+* Update AutocompleteTextBox Control
+
+## 1.0.101 / 14-9-2023
+
+===================
+
+* Add Custom Template to AutocompleteTextBox options
+
+## 1.0.100 / 15-8-2023
+
+===================
+
+* Update Utilities Library  
+
+## 1.0.99 / 15-8-2023
+
+===================
+
+* Update AutocompleteTextBox Control
+* Update FileUpload Control
+* Update Form Control
+
+## 1.0.97 / 19-7-2023
+
+===================
+
+* Update Utilities Library  
+* fix MultiLingualHtmlEditor Control
+
+## 1.0.96 / 18-7-2023
+
+===================
+
+* Add Default value when BBSF Control is Readonly and not has value.
+
+## 1.0.95 / 14-6-2023
+
+===================
+
+* Add Readonly Option to All BBSF Controls  
+
+## 1.0.94 / 21-5-2023
+
+===================
+
+* Fix File-Upload Control Bug (Delete file from multiple files has an error )
+
+## 1.0.93 / 02-5-2023
+
+===================
+
+* Fix Phone Control Bug
+
+## 1.0.92 / 13-4-2023
+
+===================
+
+* Fix Direction For All Control
+
+## 1.0.91 / 8-4-2023
+
+===================
+
+* Update Dropdown Control
+
+## 1.0.90 / 27-3-2023
+
+===================
+
+* Update Utilities Library
+* Update Controls
+
+## 1.0.89 / 26-3-2023 (!!!Warning!! Testing Release)
+
+===================
+
+* Update Utilities Library
+
+## 1.0.88 / 22-3-2023
+
+===================
+
+* Update Utilities Library
+
+## 1.0.86 / 14-2-2023
+
+===================
+
+* Solve Textarea Control Bugs
+* Solve Upload-File Control Bugs
+
+## 1.0.84 / 12-2-2023
+
+===================
+
+* Update AppBase Component
+* Solve UI Issue In All Controls
+
+## 1.0.83 / 25-1-2023
+
+===================
+
+* Fix Modal Dismiss Issue
+
+## 1.0.82 / 25-1-2023
+
+===================
+
+* Fix TextBox control
+* Fix MultiLingualTextBox control
+* Fix MultiLingualHTML control
+
+## 1.0.81 / 24-1-2023
+
+===================
+
+* Fix HTML Editor control
+* Fix Multilingual HTML Editor control
+* Fix Tag-Input control
+* Fix All UI Bugs
+
+## 1.0.80 / 18-1-2023
+
+===================
+
+* Fix HTML Editor control inline style
+* Fix Multilingual HTML Editor control inline style
+* Change Image Upload cropper tolltip to be translated
+
+## 1.0.79 / 15-1-2023
+
+===================
+*Update App Base and Controls
+
+## 1.0.78 / 11-1-2023
+
+===================
+
+* Solve Image Control Bug
+
+## 1.0.77 / 11-1-2023
+
+===================
+
+* Solve Image Control Bug
+
+## 1.0.74 / 9-1-2023
+
+===================
+
+* Add UI Changes
+
+## 1.0.73 / 5-1-2023
+
+===================
+
+* Update utilities Version
+
+## 1.0.72 / 3-1-2023
+
+===================
+
+* Update utilities Version
+
+## 1.0.71 / 25-12-2022
+
+===================
+
+* Update utilities Version
+
+## 1.0.70 / 22-12-2022
+
+===================
+
+* Update utilities Version
+
+## 1.0.69 / 05-12-2022
+
+===================
+*Add Page Header Control
+*Add BBSF Base Component
+*Update Captcha Control
+*Add Custom Date Pipe
+*Update Utilities version
+
+## 1.0.68 / 22-11-2022
+
+===================
+*Fix Range Number in Repeater Control when control type number
+
+## 1.0.66 / 20-11-2022
+
+* Controls UI revamp
+  * Textbox
+  * Textarea
+  * Multilingual Textbox
+  * Multilingual Textarea
+  * Checkbox
+  * Dropdown
+  * Repeater Table
+  * Image Upload
+  * Tags Input
+  * Paging
+
+## 1.0.65 / 15-11-2022
+
+===================
+
+* Add Captcha control
+
+## 1.0.64 / 07-11-2022
+
+===================
+
+* Enable two way binding to all controls
+* Add new options to Confirmation Modal (showCancelButton - showCloseButton)
+* Add option to all controls to allow label extra classes (LabelExtraClasses)
+
+## 1.0.63 / 18-10-2022
+
+===================
+
+* Fix Profile Image Upload control
+
+## 1.0.62 / 11-10-2022
+
+===================
+
+* Fix modal dismiss in form submission success
+* Add new property to (DisableModalDismiss) to FormOptions
+* Fix tags input control, add tag selected text when losing focus if AllowNewSelection set to true
+
+## 1.0.61 / 10-10-2022
+
+===================
+
+* Update tags input control validation (Handle unmatched selection when enabling add new selection)
+
+## 1.0.60 / 2-10-2022
+
+===================
+
+* Update lang-mode cases in MultiLingualTextArea & MultiLingualTextBox controls
+
+## 1.0.59 / 29-9-2022
+
+===================
+
+* Update repeater-table control
+  * Add DisableAddButton to remove add button from the table
+  * Add DisableDeleteButton to remove the delete button from the table
+  * Add IsHiddenInput to RepeaterField that allows hiding columns from the table
+* Update ControlOptionsBase, Add IsReadonly options that allow control to be submitted with the form instead of IsDisabled (only applied to text-box control)
+
+## 1.0.58 / 19-9-2022
+
+===================
+
+* Update tag-input control to allow reset and delete
+* Update repeater control
+
+## 1.0.57 / 11-9-2022
+
+===================
+
+* Fix tags input (hanle backspace to remove no matched error)
+
+## 1.0.53 / 18-8-2022
+
+===================
+
+* Update Location control(delete value when value empty)
+
+## 1.0.52 / 16-8-2022
+
+===================
+
+* Update Tag input control(custom validation mode)
+
+## 1.0.51 / 14-8-2022
+
+===================
+
+* Update utilities Version
+
+## 1.0.50 / 4-8-2022
+
+===================
+
+* Replace lang attribute with b-lang
+* Update MapAutoComplete control to enable edit mode
+
+## 1.0.49 / 28-7-2022
+
+===================
+
+* Fix bug in autocomplete control
+
+## 1.0.48 / 6-7-2022
+
+===================
+
+* Update tag input control
+* Update tag input dto
+* Update tag input options
+
+## 1.0.47 / 5-7-2022
+
+===================
+
+* Add DisableBlockUI and StartPagingCallback to paging control options
+
+## 1.0.46 / 4-7-2022
+
+===================
+
+* [Paging control] Add clearFilter method to reset all filters
+* [PagingOptions] Add property (ResetFilterButtonName) (string), to select button that clears filters
+* [Paging control] Check for ResetFilterButtonName, if not null then add event listener (click) to call clearFilter method
+* [Paging control] Add method (getFiltersValue) to get all filters in paging, Usually used in export method
+
+## 1.0.45 / 23-6-2022
+
+===================
+
+* Change paging control update items action,Pass PagingPayload object in body instead of params
+* Fix bug in form control ngAfterViewInit
+
+## 1.0.44 / 14-6-2022
+
+===================
+
+* Fix bugs in DropDown,TagsInput controls
+
+## 1.0.43 / 9-6-2022
+
+===================
+
+* Fix bugs in DateTimePicker,FileUpload,Form,Paging,Toggle slide controls
+
+## 1.0.42 / 2-6-2022
+
+===================
+*Fix FileUpload "Upload" resource
+*Fix MultiLingualTextBox Arabic validation
+*Fix TextBox Arabic validation
+*Fix TagsInput noItemsMAtch message
+*Add AreaOfFocus Guid to Enums
+*Fix License FileType to BN
+
+## 1.0.40/ 25-5-2022
+
+===================
+
+* Update repeater model
+
+## 1.0.38/ 16-5-2022
+
+===================
+
+* Update utilities library version
+
+## 1.0.37/ 16-5-2022
+
+===================
+
+* Update all control
+* Update all Models
+* Update utilities library version
+
+## 1.0.36/ 28-4-2022
+
+===================
+
+* Update Paging control
+
+## 1.0.35/ 27-4-2022
+
+===================
+
+* Solve all bugs
+* Implementing Controls Patch Updates
+* Implementing BBSFDateTime Pipe
+
+## 1.0.32 / 30-3-2022
+
+===================
+
+* Update utilities library version
+
+## 1.0.31 / 29-3-2022
+
+===================
+
+* Update repeater-table control
+
+## 1.0.29 / 27-3-2022
+
+===================
+
+* Add Repeater Table control
+* Update Complex Repeater control