Title
Content here
';\r\nconst buffer = await this.wordService.generateWordByteFile(model);\r\n```\r\n\r\n### Table Example\r\n\r\n```typescript\r\nmodel.body = `\r\n| Name | \r\nValue | \r\n
|---|---|
| Item 1 | \r\n100 | \r\n
| Item 2 | \r\n200 | \r\n
Blue Heading
\r\n\r\n This is bold and this is italic.\r\n
\r\nCentered text
\r\n`;\r\n```\r\n\r\n### Image Embedding\r\n\r\n```typescript\r\nmodel.body = `\r\n![\"Online](\"https://example.com/image.jpg\")
\r\n`;\r\n```\r\n\r\n### Custom Page Size (A4)\r\n\r\n```typescript\r\nmodel.options.pageWidth = 8.27; // 210mm = 8.27 inches\r\nmodel.options.pageHeight = 11.69; // 297mm = 11.69 inches\r\nmodel.options.top = 0.79; // 20mm = 0.79 inches\r\nmodel.options.bottom = 0.79;\r\nmodel.options.left = 0.79;\r\nmodel.options.right = 0.79;\r\n```\r\n\r\n### Landscape Document\r\n\r\n```typescript\r\nmodel.options.isLandscape = true;\r\nmodel.options.pageWidth = 11;\r\nmodel.options.pageHeight = 8.5;\r\n```\r\n\r\n## 🔧 Dependencies\r\n\r\nThis package includes all necessary dependencies:\r\n- `xmlbuilder2` - XML generation\r\n- `jszip` - ZIP file creation\r\n- `html-to-vdom` - HTML parsing\r\n- `virtual-dom` - Virtual DOM handling\r\n- `image-size` - Image dimension detection\r\n- `image-to-base64` - Image encoding\r\n- `color-name` - Color conversion\r\n- `escape-html` - HTML escaping\r\n- `mime-types` - MIME type detection\r\n\r\n## 📦 Bundle Size\r\n\r\n- **Package size**: ~8 MB (uncompressed)\r\n- **Minified**: ~2 MB\r\n- **Gzipped**: ~500 KB\r\n\r\n**Note**: This is why document generation is now a separate package - apps that don't need it won't bundle these dependencies.\r\n\r\n## 🔄 Migration from bbsf-utilities\r\n\r\nIf you were using `WordDocumentService` from `@bnsights/bbsf-utilities`, see [MIGRATION_GUIDE.md](./MIGRATION_GUIDE.md) for easy migration steps.\r\n\r\n**TL;DR**:\r\n```typescript\r\n// Before\r\nimport { WordDocumentService } from '@bnsights/bbsf-utilities';\r\n\r\n// After\r\nimport { WordDocumentService } from '@bnsights/bbsf-utilities-doc';\r\n```\r\n\r\n## 🐛 Troubleshooting\r\n\r\n### Issue: \"Module not found\"\r\n```bash\r\nnpm install @bnsights/bbsf-utilities-doc\r\n```\r\n\r\n### Issue: Images not showing\r\n- Ensure images are base64 encoded or accessible URLs\r\n- Check image size isn't too large (> 10MB)\r\n\r\n### Issue: Table formatting issues\r\n- Use inline styles for table cells\r\n- Set explicit widths when needed\r\n- Avoid complex nested tables\r\n\r\n### Issue: Build errors\r\n```bash\r\n# Clear cache\r\nrm -rf node_modules/.cache\r\nnpm install\r\nng build\r\n```\r\n\r\n## 📝 Future Features\r\n\r\n- [ ] PDF generation\r\n- [ ] Excel export (.xlsx)\r\n- [ ] Markdown conversion\r\n- [ ] Document templates\r\n- [ ] Mail merge support\r\n- [ ] Digital signatures\r\n\r\n## 🤝 Contributing\r\n\r\nThis package is part of the BBSF 3 framework. For contributions or issues, please refer to the main BBSF repository.\r\n\r\n## 📄 License\r\n\r\nPart of BBSF 3 - See main repository for license information.\r\n\r\n## 🔗 Related Packages\r\n\r\n- `@bnsights/bbsf-utilities` - Core utilities\r\n- `@bnsights/bbsf-admin-portal` - Admin portal components\r\n- `@bnsights/bbsf-controls` - UI controls\r\n\r\n---\r\n\r\n**Version**: 1.0.0 \r\n**Last Updated**: October 27, 2025 \r\n**Maintainers**: BBSF Team\r\n","readmeFilename":"README.md"}