@bnsights/bbsf-utilities 1.0.69-beta.1 → 1.0.69-beta.19-1

package/README.md

@@ -4,6 +4,63 @@ BBSF Utilities package is part of BBSF 3 packages. It has all the common service
 
 For more info please visit [BBSF Controls documentation](https://bbsfadmin.bnsights.com/controls) or [BBSF documentation](https://bnsightsprojects.visualstudio.com/BBSF%203/_wiki/wikis/BBSF-3.wiki/65/BBSF-Documentation)
 
+## 🔄 Two Ways to Use This Library
+
+### 1️⃣ **Backward Compatible** (All-in-One Module)
+
+For existing applications or quick setup, import the `BBSFUtilitiesModule` to get everything:
+
+```typescript
+// app.module.ts
+import { BBSFUtilitiesModule } from '@bnsights/bbsf-utilities';
+
+@NgModule({
+  imports: [
+    BBSFUtilitiesModule,  // Includes ALL services and modules
+    // ... other imports
+  ]
+})
+export class AppModule { }
+```
+
+**What you get:**
+- ✅ All services automatically registered
+- ✅ BlockUI and Toastr modules pre-configured
+- ✅ Works exactly like the original version
+- ⚠️ Larger bundle size (includes all dependencies)
+
+### 2️⃣ **Modular** (Optimized for Bundle Size)
+
+For new applications or to optimize bundle size, use secondary entry points:
+
+```typescript
+// app.module.ts
+import { EnvironmentService } from '@bnsights/bbsf-utilities';
+import { AuthService } from '@bnsights/bbsf-utilities/auth';
+import { BBSFTranslateService } from '@bnsights/bbsf-utilities/translate';
+import { UtilityService } from '@bnsights/bbsf-utilities/ui';
+import { RequestHandlerService } from '@bnsights/bbsf-utilities/http';
+
+@NgModule({
+  providers: [
+    EnvironmentService,
+    AuthService,
+    BBSFTranslateService,
+    UtilityService,
+    RequestHandlerService,
+    // Only import what you need
+  ]
+})
+export class AppModule { }
+```
+
+**Benefits:**
+- 🚀 Smaller bundle size (only include what you use)
+- 📦 Better tree-shaking
+- ⚡ Faster build times
+
+---
+
 ## 📦 Secondary Entry Points (Optimized Dependencies)
 
 To optimize bundle size, the library now supports **secondary entry points** - only install what you use!
@@ -14,7 +71,7 @@ To optimize bundle size, the library now supports **secondary entry points** - o
 |---------|-------------|--------------|------|
 | **Core** (Environment, Styling) | `@bnsights/bbsf-utilities` | `lodash` `nanoid` `tslib` | 2 MB |
 | **Authentication** | `@bnsights/bbsf-utilities/auth` | `@auth0/angular-jwt` `ngx-cookie-service` `oidc-client` | +3 MB |
-| **Word Generation** | `@bnsights/bbsf-utilities/word` | `jszip` `xmlbuilder2` `html-to-vdom` `virtual-dom` + 5 more | +8 MB |
+| **Word Generation** ⚡ | `@bnsights/bbsf-utilities/word` | `jszip` `xmlbuilder2` `html-to-vdom` `virtual-dom` + 5 more | +8 MB (lazy-loaded) |
 | **Translation/i18n** | `@bnsights/bbsf-utilities/translate` | `@ngx-translate/core` | +2 MB |
 | **UI Services** (Toasts, Loading, Validation) | `@bnsights/bbsf-utilities/ui` | `ng-block-ui` `ngx-toastr` | +3 MB |
 | **HTTP Handling** | `@bnsights/bbsf-utilities/http` | `class-transformer` | +1 MB |
@@ -49,14 +106,63 @@ import { AuthService } from '@bbsf';  // Simple! ✅
 - **Core + Auth:** 67% smaller (15MB → 5MB)
 - **Everything:** Same size (but other apps save!)
 
+### ⚡ Word Generation - Automatic Lazy Loading
+Word generation dependencies (xmlbuilder2, jszip, etc.) use **dynamic imports** - they're automatically split into a separate chunk and only loaded when you first call `generateWordByteFile()`. No code changes needed!
+
+**Benefits:**
+- ✅ Main bundle: ~8 MB smaller
+- ✅ Word chunk: Loaded on-demand only when needed
+- ✅ Backward compatible: Works with existing code
+- ✅ Automatic: Handled by build tools
+
+See [XMLBUILDER2_FIX.md](./XMLBUILDER2_FIX.md) for technical details.
+
 ### 📚 Documentation
 
-- **[USAGE.md](./USAGE.md)** - Complete feature table & examples ⭐ START HERE
-- **[MIGRATION_GUIDE.md](./MIGRATION_GUIDE.md)** - Migrate existing apps
+- **[BACKWARD_COMPATIBILITY.md](./BACKWARD_COMPATIBILITY.md)** - Understand both usage patterns (BBSFUtilitiesModule vs Modular) ⭐ START HERE
+- **[USAGE.md](./USAGE.md)** - Complete feature table & examples
+- **[MIGRATION_GUIDE.md](./MIGRATION_GUIDE.md)** - Migrate to modular imports (optional)
 - **[TROUBLESHOOTING.md](./TROUBLESHOOTING.md)** - Fix import issues
 
 # Change Log
 
+## 1.0.72 / 27/10/2025
+
+=====================
+
+### 🔄 Enhanced Backward Compatibility
+
+- **Clarified BBSFUtilitiesModule usage**: The module now explicitly exports all necessary Angular modules (CommonModule, RouterModule, BlockUIModule, ToastrModule) for complete backward compatibility
+- **Two usage patterns supported**:
+  1. **All-in-One**: Import `BBSFUtilitiesModule` for everything (original behavior maintained)
+  2. **Modular**: Import from secondary entry points for optimized bundles
+- **No breaking changes**: Existing applications using `BBSFUtilitiesModule` continue to work unchanged
+- **Documentation added**: 
+  - `BACKWARD_COMPATIBILITY.md` - Quick reference guide
+  - Updated README with clear comparison of both approaches
+  - Enhanced MIGRATION_GUIDE.md with "no migration required" section
+
+### Benefits
+- ✅ Zero migration required for existing apps
+- ✅ Full flexibility for new projects
+- ✅ Clear documentation for both patterns
+- ✅ All services and modules properly exported
+
+## 1.0.71 / 27/10/2025
+
+=====================
+
+### 🚀 Major Bundle Size Optimization
+
+- **Fixed xmlbuilder2 bundling issue**: Word generation dependencies (~8 MB) are now lazy-loaded using dynamic imports
+- **Benefit**: Main application bundle is ~8 MB smaller - word dependencies only loaded when actually generating documents
+- **Breaking Changes**: None - fully backward compatible
+- **Technical Details**: See [XMLBUILDER2_FIX.md](./XMLBUILDER2_FIX.md)
+
+### Changes
+- Modified `WordDocumentService.generateWordByteFile()` to use dynamic imports
+- Word generation dependencies (xmlbuilder2, jszip, html-to-vdom, etc.) automatically split into separate chunk
+- Consuming applications get automatic bundle size reduction without code changes
 
 ## 1.0.70 / 26/10/2025