@microsoft/connected-workbooks 3.2.2-beta → 3.3.1-beta

package/README.md

@@ -1,203 +1,408 @@
+<div align="center">
+
 # Open In Excel
+
+[![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?style=flat&logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
 [![License](https://img.shields.io/github/license/microsoft/connected-workbooks)](https://github.com/microsoft/connected-workbooks/blob/master/LICENSE)
+[![npm version](https://img.shields.io/npm/v/@microsoft/connected-workbooks)](https://www.npmjs.com/package/@microsoft/connected-workbooks)
+[![Build Status](https://img.shields.io/github/workflow/status/microsoft/connected-workbooks/CI)](https://github.com/microsoft/connected-workbooks/actions)
+
+**Open your data directly in Excel for the Web with zero installation** - A JavaScript library that converts web tables and data into interactive Excel workbooks with Power Query integration and custom branded templates
+
+<div align="center">
+<img src="./assets/template example.gif" alt="Connected Workbooks Demo" >
+</div>
+
+
+</div>
+
+---
+
+## ✨ Key Features & Benefits
+
+Transform your web applications with enterprise-grade Excel integration that goes far beyond simple CSV exports.
+
+### 🎯 **Interactive Excel Workbooks, Not Static Files**
+Convert raw data or HTML tables arrays to Excel tables while preserving data types, ensuring your data maintains its structure and formatting. instead of basic CSV exports that lose all structure and functionality.
+
+### 🌐 **Zero-Installation Excel Experience**
+Launch workbooks directly in Excel for the Web through any browser without requiring Excel desktop installation, making your data accessible to any user anywhere. No installation required, works on any device.
+
+### 🎨 **Corporate Branding & Custom Dashboards**
+Inject your data into pre-built Excel templates containing your company branding, PivotTables, charts, and business logic while preserving all formatting and calculations. Use your own branded Excel templates with PivotTables and charts to maintain corporate identity and pre-built analytics.
+
+### 🔄 **Live Data Connections with Power Query**
+Create workbooks that automatically refresh from your web APIs, databases, or data sources using Microsoft's Power Query technology, eliminating manual data updates. Create workbooks that refresh data on-demand using Power Query for real-time data updates and automated reporting.
+
+### ⚙️ **Advanced Configuration**
+Full control over document properties including title and description for professional document management, allowing you to customize metadata and maintain enterprise standards.
 
-A pure JS library, Microsoft backed, that provides xlsx workbook generation capabilities, allowing for:
-1. Fundemental **"Export to Excel"** capabilities for tabular data (landing in a table in Excel).
-2. Advanced capabilities of **"Export a Power Query connected workbook"**:
-    - Can refresh your data on open and/or on demand.
-    - Allows for initial data population.
-    - Supports more advanced scenarios where you provide branded/custom workbooks, and load your data into PivotTables or PivotCharts.
+---
 
-Open in Excel allows you to avoid "data dumps" in CSV form, providing a richer experience with Tables and/or connected Queries for when your business application supports it.
+## 🏢 Where is this library used?
 
-[Learn about Power Query here](https://powerquery.microsoft.com/en-us/)
+Open In Excel powers data export functionality across Microsoft's enterprise platforms:
 
-## Where is this library used? here are some examples:
+<div align="center">
 
-|<img src="https://github.com/microsoft/connected-workbooks/assets/7674478/b7a0c989-7ba4-4da8-851e-04650d8b600e" alt="Kusto" width="32"/>| <img src="https://github.com/microsoft/connected-workbooks/assets/7674478/76d22d23-5f2b-465f-992d-f1c71396904c" alt="LogAnalytics" width="32"/>	| <img src="https://github.com/microsoft/connected-workbooks/assets/7674478/436b4f53-bf25-4c45-aae5-55ee1b1feafc" alt="Datamart" width="32"/>	| <img src="https://github.com/microsoft/connected-workbooks/assets/7674478/3965f684-b461-42fe-9c62-e3059c0286eb" alt="VivaSales" width="32"/>	|
-|---------------------------------	|-------------------	|--------------	|----------------	|
-| **Azure Data Explorer** 	| **Log Analytics** 	| **Datamart** 	| **Viva Sales** 	|
+|<img src="https://github.com/microsoft/connected-workbooks/assets/7674478/b7a0c989-7ba4-4da8-851e-04650d8b600e" alt="Azure Data Explorer" width="48"/>|<img src="https://github.com/microsoft/connected-workbooks/assets/7674478/76d22d23-5f2b-465f-992d-f1c71396904c" alt="Log Analytics" width="48"/>|<img src="https://github.com/microsoft/connected-workbooks/assets/7674478/436b4f53-bf25-4c45-aae5-55ee1b1feafc" alt="Datamart" width="48"/>|<img src="https://github.com/microsoft/connected-workbooks/assets/7674478/3965f684-b461-42fe-9c62-e3059c0286eb" alt="Viva Sales" width="48"/>|
+|:---:|:---:|:---:|:---:|
+|**Azure Data Explorer**|**Log Analytics**|**Datamart**|**Viva Sales**|
 
-## How do I use it? here are some examples:
+</div>
+
+
+
+---
+
+## 🚀 Quick Start
+
+### Installation
+
+```bash
+npm install @microsoft/connected-workbooks
+```
+
+---
+
+## 💡 Usage Examples
+
+### 📋 **HTML Table Export**
+
+Perfect for quick data exports from existing web tables.
 
-### 1. Export a table directly from an Html page:
 ```typescript
-import workbookManager from '@microsoft/connected-workbooks';
+import { workbookManager } from '@microsoft/connected-workbooks';
 
-const blob = await workbookManager.generateTableWorkbookFromHtml(document.querySelector('table') as HTMLTableElement);    
-workbookManager.openInExcelWeb(blob, "MyTable.xlsx", true /*allowTyping*/);
+// One line of code to convert any table
+const blob = await workbookManager.generateTableWorkbookFromHtml(
+  document.querySelector('table') as HTMLTableElement
+);
+
+// Open in Excel for the Web with editing enabled
+workbookManager.openInExcelWeb(blob, "QuickExport.xlsx", true);
 ```
 
-### 2. Export a table from raw data:
+### 📊 **Smart Data Formatting**
+
+Transform raw data arrays into professionally formatted Excel tables.
+
 ```typescript
-import workbookManager from '@microsoft/connected-workbooks';
+import { workbookManager } from '@microsoft/connected-workbooks';
 
-const grid = {
-  config: { promoteHeaders:true, adjustColumnNames:true },
+const salesData = {
+  config: {
+    promoteHeaders: true,      // First row becomes headers
+    adjustColumnNames: true    // Clean up column names
+  },
   data: [
-      ["Product", "Price", "InStock", "Category", "Date"],
-      ["Widget A", 19.99, true, "Electronics", "10/26/2024"],
-      ["Gizmo B", 9.99, true, "Accessories", "10/26/2024"],
-      ["Bubala", 14.99, false, "Accessories", "10/22/2023"],
-      ["Thingamajig C", 50, false, "Tools", "5/12/2023"],
-      ["Doohickey D", 50.01, true, "Home", "8/12/2023"]
+    ["Product", "Revenue", "InStock", "Category", "LastUpdated"],
+    ["Surface Laptop", 1299.99, true, "Hardware", "2024-10-26"],
+    ["Office 365", 99.99, true, "Software", "2024-10-26"],
+    ["Azure Credits", 500.00, false, "Cloud", "2024-10-25"],
+    ["Teams Premium", 149.99, true, "Software", "2024-10-24"]
   ]
 };
-const blob = await workbookManager.generateTableWorkbookFromGrid(grid);    
-workbookManager.openInExcelWeb(blob, "MyTable.xlsx", true /*allowTyping*/);
+
+const blob = await workbookManager.generateTableWorkbookFromGrid(salesData);
+workbookManager.openInExcelWeb(blob, "SalesReport.xlsx", true);
 ```
-<img width="281" alt="image" src="https://github.com/microsoft/connected-workbooks/assets/7674478/b91e5d69-8444-4a19-a4b0-3fd721e5576f">
 
-### 3. Control Document Properties:
+<div align="center">
+<img width="450" alt="Smart Formatted Excel Table" src="https://github.com/microsoft/connected-workbooks/assets/7674478/b91e5d69-8444-4a19-a4b0-3fd721e5576f">
+</div>
+
+
+
+### 🎨 **Custom Branded Templates**
+
+Transform your data using pre-built Excel templates with your corporate branding.
+
+
+
+**Steps:**
+
+1.  **Prepare Your Template File**
+
+    Open Excel and create (or open) your branded file.
+2.  **Pick one sheet that will hold your data.**
+
+    The default "Sheet1"(3)
+3.  **Inside that sheet, choose were you want your data to be populated(1) and create a table (Insert → Table).**
+
+    The default table name is Table1(2)  
+    The table need to have the same column structure as your incoming data.
+4.  **Add any charts, formulas, or formatting that reference this table.**
+
+    Example: Pie chart using Gross column(4).
+5.  **Save the Excel file (e.g., my-template.xlsx).**
+6.  **Use the saved file as the template for your incoming data**
+
+The library will then populate the designated table with your data. Any functions, figures, or references linked to this table within the Excel template will automatically reflect the newly exported data.
+
+<div align="center">
+<img  alt="Custom Branded Excel Dashboard" src="./assets/template_before_after.png">
+</div>
+
+<div align="center">
+  <!-- Template example downloads -->
+  <a href="./assets/before.xlsx" download>Download before.xlsx</a> • <a href="./assets/after.xlsx" download>Download after.xlsx</a>
+</div>
+
+#### 📁 **Loading Template Files**
+
 ```typescript
-const blob = await workbookManager.generateTableWorkbookFromHtml(
-  document.querySelector('table') as HTMLTableElement, {
-    docProps: { 
-      createdBy: 'John Doe',
-      lastModifiedBy: 'Jane Doe',
-      description: 'This is a sample table'
+// Method 1: File upload from user
+const templateInput = document.querySelector('#template-upload') as HTMLInputElement;
+const templateFile = templateInput.files[0];
+
+// Method 2: Fetch from your server
+const templateResponse = await fetch('/assets/templates/sales-dashboard.xlsx');
+const templateFile = await templateResponse.blob();
+
+// Method 3: Drag and drop
+function handleTemplateDrop(event: DragEvent) {
+  const templateFile = event.dataTransfer.files[0];
+  // Use templateFile with the library
+}
+```
+
+#### 📊 **Generate Branded Workbook**
+
+```typescript
+const quarterlyData = {
+  config: { promoteHeaders: true, adjustColumnNames: true },
+  data: [
+    ["Region", "Q3_Revenue", "Q4_Revenue", "Growth", "Target_Met"],
+    ["North America", 2500000, 2750000, "10%", true],
+    ["Europe", 1800000, 2100000, "17%", true],
+    ["Asia Pacific", 1200000, 1400000, "17%", true],
+    ["Latin America", 800000, 950000, "19%", true]
+  ]
+};
+
+// Inject data into your branded template
+const blob = await workbookManager.generateTableWorkbookFromGrid(
+  quarterlyData,
+  undefined, // Use template's existing data structure
+  {
+    templateFile: templateFile,
+    TempleteSettings: {
+      sheetName: "Dashboard",     // Target worksheet
+      tableName: "QuarterlyData"  // Target table name
     }
   }
 );
-    
-workbookManager.downloadWorkbook(blob, "MyTable.xlsx");
+
+// Users get a fully branded report
+workbookManager.openInExcelWeb(blob, "Q4_Executive_Dashboard.xlsx", true);
 ```
-![image](https://github.com/microsoft/connected-workbooks/assets/7674478/c267c9eb-6367-419d-832d-5a835c7683f9)
 
-### 4. Export a Power Query connected workbook:
+<div align="center">
+<img  alt="Custom Branded Excel Dashboard" src="./assets/template_example.png">
+</div>
+
+> 💡 **Template Requirements**: Include a query named **"Query1"** connected to a **Table**.
+
+### 🔄 **Live Data Connections with Power Query**
+
+Create workbooks that automatically refresh from your data sources.
+
 ```typescript
-import workbookManager from '@microsoft/connected-workbooks';
+import { workbookManager } from '@microsoft/connected-workbooks';
 
+// Create a workbook that connects to your API
 const blob = await workbookManager.generateSingleQueryWorkbook({
-  queryMashup: 'let \
-                    Source = {1..10} \
-                in \
-                    Source',
+  queryMashup: `let 
+    Source = {1..10} 
+  in 
+    Source`,
   refreshOnOpen: true
 });
 
-workbookManager.downloadWorkbook(blob, "MyConnectedWorkbook.xlsx");
+workbookManager.openInExcelWeb(blob, "MyData.xlsx", true);
 ```
-![image](https://github.com/microsoft/connected-workbooks/assets/7674478/57bd986c-6309-4963-8d86-911ccf496c3f)
 
-(after refreshing on open)
-### Advanced Usage - bring your own template:
+> 📚 **Learn Power Query**: New to Power Query? Check out the [official documentation](https://docs.microsoft.com/en-us/power-query/) to unlock the full potential of live data connections.
+
+<div align="center">
+<img width="120" alt="Live Data Workbook" src="https://github.com/microsoft/connected-workbooks/assets/7674478/57bd986c-6309-4963-8d86-911ccf496c3f">
+</div>
+### 📄 **Professional Document Properties**
 
-You can use the library with your own workbook as a template!
+Add metadata and professional document properties for enterprise use.
 
 ```typescript
-const blob = await workbookManager.generateSingleQueryWorkbook(
-  { queryMashup: query, refreshOnOpen: true },
-  undefined /* optional Grid */,
-  templateFile);
-workbookManager.downloadWorkbook(blob, "MyBrandedWorkbook.xlsx");
+const blob = await workbookManager.generateTableWorkbookFromHtml(
+  document.querySelector('table') as HTMLTableElement, 
+  {
+    docProps: { 
+      createdBy: 'John Doe',
+      lastModifiedBy: 'Jane Doe',
+      description: 'Sales Report Q4 2024',
+      title: 'Quarterly Sales Data'
+    }
+  }
+);
+
+// Download for offline use
+workbookManager.downloadWorkbook(blob, "MyTable.xlsx");
 ```
-![image](https://github.com/microsoft/connected-workbooks/assets/7674478/e5377946-4348-4229-9b88-1910ff7ee025)
 
-Template requirements:
+<div align="center">
+<img width="400" alt="Professional Document Properties" src="https://github.com/microsoft/connected-workbooks/assets/7674478/c267c9eb-6367-419d-832d-5a835c7683f9">
+</div>
+
+## 📚 Complete API Reference
 
-Have a single query named **Query1** loaded to a **Query Table**, **Pivot Table**, or a **Pivot Chart**.
+### Core Functions
 
+#### 🔗 `generateSingleQueryWorkbook()`
+Create Power Query connected workbooks with live data refresh capabilities.
+
+```typescript
+async function generateSingleQueryWorkbook(
+  query: QueryInfo, 
+  grid?: Grid, 
+  fileConfigs?: FileConfigs
+): Promise<Blob>
+```
 
-⭐ Recommendation - have your product template baked and tested in your own product code, instead of your user providing it.
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `query` | [`QueryInfo`](#queryinfo) | ✅ **Required** | Power Query configuration |
+| `grid` | [`Grid`](#grid) |  Optional | Pre-populate with data |
+| `fileConfigs` | [`FileConfigs`](#fileconfigs) |  Optional | Customization options |
 
-⭐ For user templates - a common way to get the template workbook with React via user interaction:
+#### 📋 `generateTableWorkbookFromHtml()`
+Convert HTML tables to Excel workbooks instantly.
 
 ```typescript
-const [templateFile, setTemplateFile] = useState<File | null>(null);
-...
-<input type="file" id="file" accept=".xlsx" style={{ display: "none" }} onChange={(e) => {
-  if (e?.target?.files?.item(0) == null) return;
-  setTemplateFile(e!.target!.files!.item(0));
-}}/>
+async function generateTableWorkbookFromHtml(
+  htmlTable: HTMLTableElement, 
+  fileConfigs?: FileConfigs
+): Promise<Blob>
 ```
-### API
-The library exposes a workbookManager, which generates a workbook via several APIs:
 
-#### 1. Generate a Power Query connected workbook
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `htmlTable` | `HTMLTableElement` | ✅ **Required** | Source HTML table |
+| `fileConfigs` | [`FileConfigs`](#fileconfigs) |  Optional | Customization options |
+
+#### 📊 `generateTableWorkbookFromGrid()`
+Transform raw data arrays into formatted Excel tables.
+
 ```typescript
- async function `generateSingleQueryWorkbook`: `Promise<Blob>`
+async function generateTableWorkbookFromGrid(
+  grid: Grid, 
+  fileConfigs?: FileConfigs
+): Promise<Blob>
 ```
- 
-|Parameter   | Type   | Required   | Description   |
-|---      |---    |---          |---            |
-|query   | [QueryInfo](#queryinfo)   | __required__  | Power Query mashup  | 
-| grid  | [Grid](#grid)   | optional   | Initial grid data  | 
-| fileConfigs  | [FileConfigs](#fileconfigs)   | optional  | Custom file configurations |
 
-#### 2. Generate a table workbook from a Html page
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `grid` | [`Grid`](#grid) | ✅ **Required** | Data and configuration |
+| `fileConfigs` | [`FileConfigs`](#fileconfigs) |  Optional | Customization options |
+
+#### 🌐 `openInExcelWeb()`
+Open workbooks directly in Excel for the Web.
+
 ```typescript
-async function `generateTableWorkbookFromHtml`: `Promise<Blob>`
+async function openInExcelWeb(
+  blob: Blob, 
+  filename?: string, 
+  allowTyping?: boolean
+): Promise<void>
 ```
 
-|Parameter   | Type   | Required   | Description   |
-|---      |---    |---          |---            |
-| htmlTable  | HTMLTableElement   | __required__   | Initial data loaded to workbook  | 
-| fileConfigs  | [FileConfigs](#fileconfigs)   | optional  | Custom file configurations |
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `blob` | `Blob` | ✅ **Required** | Generated workbook |
+| `filename` | `string` |  Optional | Custom filename |
+| `allowTyping` | `boolean` |  Optional | Enable editing (default: false) |
+
+#### 💾 `downloadWorkbook()`
+Trigger browser download of the workbook.
 
-#### 3. Generate a table workbook with raw data
 ```typescript
-async function `generateTableWorkbookFromGrid`: `Promise<Blob>`
+function downloadWorkbook(file: Blob, filename: string): void
 ```
 
-|Parameter   | Type   | Required   | Description   |
-|---      |---    |---          |---            |
-| grid  | [Grid](#grid)   | __required__   | Initial data loaded to workbook  | 
-| fileConfigs  | [FileConfigs](#fileconfigs)   | optional  | Custom file configurations |
+#### 🔗 `getExcelForWebWorkbookUrl()` 
+Get the Excel for Web URL without opening (useful for custom integrations).
 
-#### 3. Open the created workbook in excel for the web
 ```typescript
-async function `openInExcelWeb`: `Promise<void>`
+async function getExcelForWebWorkbookUrl(
+  file: Blob, 
+  filename?: string, 
+  allowTyping?: boolean
+): Promise<string>
 ```
 
-⭐ This API is supported only for an HTTPS domain.
+---
 
-|Parameter   | Type   | Required   | Description   |
-|---      |---    |---          |---            |
-| blob  | [Blob](https://developer.mozilla.org/docs/Web/API/Blob)   | __required__   | Initial data loaded to workbook  | 
-| filename  |  string  | optional  | Custom the opened file name |
-| allowTyping  |  boolean  | optional  | allow user editing (typing) |
-</br>
+## 🔧 Type Definitions
 
-### Types
+### QueryInfo
+Power Query configuration for connected workbooks.
 
-#### QueryInfo
-|Parameter   | Type   | Required   | Description   |
-|---|---|---|---|
-| queryMashup | string | __required__ | Mashup string
-| refreshOnOpen | boolean | __required__ | Should workbook data refresh upon open
-| queryName | string | optional | Query name, defaults to "Query1"
+```typescript
+interface QueryInfo {
+  queryMashup: string;        // Power Query M language code
+  refreshOnOpen: boolean;     // Auto-refresh when opened
+  queryName?: string;         // Query identifier (default: "Query1")
+}
+```
 
-#### Grid
-|Parameter   | Type   | Required   | Description   |
-|---|---|---|---|
-| data | (string \| number \| boolean)[][] | __required__ | Grid data
-| config | GridConfig | optional | customizations to Grid handling (see GridConfig)
+### Grid
+Data structure for tabular information.
+
+```typescript
+interface Grid {
+  data: (string | number | boolean)[][];  // Raw data rows
+  config?: GridConfig;                    // Processing options
+}
+
+interface GridConfig {
+  promoteHeaders?: boolean;     // Use first row as headers
+  adjustColumnNames?: boolean;  // Fix duplicate/invalid names
+}
+```
+
+### FileConfigs
+Advanced customization options.
+
+```typescript
+interface FileConfigs {
+  templateFile?: File;              // Custom Excel template
+  docProps?: DocProps;              // Document metadata
+  hostName?: string;                // Creator application name
+  TempleteSettings?: TempleteSettings; // Template-specific settings
+}
+
+interface TempleteSettings {
+  tableName?: string;    // Target table name in template
+  sheetName?: string;    // Target worksheet name
+}
+```
 
-#### GridConfig
-|Parameter   | Type   | Required   | Description   |
-|---|---|---|---|
-| promoteHeaders | boolean | optional | Should first row of gridData be used as the header, defaults to false - generating "Column1", "Column2"...
-| adjustColumnNames | boolean | optional | Should column names be adjusted to be valid Excel names (Fix duplicates for example), defaults to true
+### DocProps
+Document metadata and properties.
 
-#### FileConfigs
-|Parameter   | Type   | Required   | Description   |
-|---|---|---|---|
-| templateFile | File | optional   | Custom Excel workbook  |
-| docProps  | [DocProps](#docprops)   | optional  | Custom workbook properties |
-| hostName  | string | optional  | specify the host creator name |
+```typescript
+interface DocProps {
+  title?: string;           // Document title
+  subject?: string;         // Document subject
+  keywords?: string;        // Search keywords
+  createdBy?: string;       // Author name
+  description?: string;     // Document description
+  lastModifiedBy?: string;  // Last editor
+  category?: string;        // Document category
+  revision?: string;        // Version number
+}
+```
 
-#### DocProps
-|Parameter   | Type   | Required  
-|---|---|---|
-| title | string | optional 
-| subject | string | optional 
-| keywords | string | optional 
-| createdBy | string | optional 
-| description | string | optional 
-| lastModifiedBy | string | optional 
-| category | string | optional 
-| revision | number | optional 
+---
 
 ## Contributing
 
@@ -213,6 +418,35 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope
 For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
 contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
 
+### Getting Started
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Add tests for new functionality
+5. Submit a pull request
+
+### Development Setup
+```bash
+git clone https://github.com/microsoft/connected-workbooks.git
+cd connected-workbooks
+npm install
+npm run build
+npm test
+```
+---
+
+## 📄 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## 🔗 Related Resources
+
+- [📖 Power Query Documentation](https://powerquery.microsoft.com/en-us/)
+- [🏢 Excel for Developers](https://docs.microsoft.com/en-us/office/dev/excel/)
+- [🔧 Microsoft Graph Excel APIs](https://docs.microsoft.com/en-us/graph/api/resources/excel)
+
+---
+
 ## Trademarks
 
 This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft
@@ -220,3 +454,9 @@ trademarks or logos is subject to and must follow
 [Microsoft's Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).
 Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.
 Any use of third-party trademarks or logos are subject to those third-party's policies.
+
+---
+
+## Keywords
+
+Power Query, Excel, Office, Workbook, Refresh, Table, xlsx, export, CSV, data export, HTML table, web to Excel, JavaScript Excel, TypeScript Excel, Excel template, PivotTable, connected data, live data, data refresh, Excel for Web, browser Excel, spreadsheet, data visualization, Microsoft Office, Office 365, Excel API, workbook generation, table export, grid export, Excel automation, data processing, business intelligence