@microsoft/connected-workbooks 3.0.0 → 3.1.1-beta.1

package/README.md

@@ -1,5 +1,4 @@
 # Connected Workbooks
-[![Build Status](https://obilshield.visualstudio.com/ConnectedWorkbooks/_apis/build/status/microsoft.connected-workbooks?branchName=main)](https://obilshield.visualstudio.com/ConnectedWorkbooks/_build/latest?definitionId=14&branchName=main)
 [![License](https://img.shields.io/github/license/microsoft/connected-workbooks)](https://github.com/microsoft/connected-workbooks/blob/master/LICENSE)
 
 A pure JS library, Microsoft backed, that provides xlsx workbook generation capabilities, allowing for:
@@ -26,7 +25,7 @@ Connected Workbooks allows you to avoid "data dumps" in CSV form, providing a ri
 import workbookManager from '@microsoft/connected-workbooks';
 
 const blob = await workbookManager.generateTableWorkbookFromHtml(document.querySelector('table') as HTMLTableElement);    
-workbookManager.downloadWorkbook(blob, "MyTable.xlsx");
+workbookManager.openInExcelWeb(blob, "MyTable.xlsx", true /*allowTyping*/);
 ```
 
 ### 2. Export a table from raw data:
@@ -34,7 +33,7 @@ workbookManager.downloadWorkbook(blob, "MyTable.xlsx");
 import workbookManager from '@microsoft/connected-workbooks';
 
 const grid = {
-  config: { promoteHeaders:true, adjustColumnNames:true }
+  config: { promoteHeaders:true, adjustColumnNames:true },
   data: [
       ["Product", "Price", "InStock", "Category", "Date"],
       ["Widget A", 19.99, true, "Electronics", "10/26/2024"],
@@ -45,7 +44,7 @@ const grid = {
   ]
 };
 const blob = await workbookManager.generateTableWorkbookFromGrid(grid);    
-workbookManager.downloadWorkbook(blob, "MyTable.xlsx");
+workbookManager.openInExcelWeb(blob, "MyTable.xlsx", true /*allowTyping*/);
 ```
 <img width="281" alt="image" src="https://github.com/microsoft/connected-workbooks/assets/7674478/b91e5d69-8444-4a19-a4b0-3fd721e5576f">
 
@@ -145,6 +144,19 @@ async function `generateTableWorkbookFromGrid`: `Promise<Blob>`
 |---      |---    |---          |---            |
 | grid  | [Grid](#grid)   | __required__   | Initial data loaded to workbook  | 
 | fileConfigs  | [FileConfigs](#fileconfigs)   | optional  | Custom file configurations |
+
+#### 3. Open the created workbook in excel for the web
+```typescript
+async function `openInExcelWeb`: `Promise<void>`
+```
+
+⭐ 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>
 
 ### Types
@@ -173,6 +185,7 @@ async function `generateTableWorkbookFromGrid`: `Promise<Blob>`
 |---|---|---|---|
 | templateFile | File | optional   | Custom Excel workbook  |
 | docProps  | [DocProps](#docprops)   | optional  | Custom workbook properties |
+| hostName  | string | optional  | specify the host creator name |
 
 #### DocProps
 |Parameter   | Type   | Required  

package/dist/generators.js

@@ -1,14 +1,9 @@
-"use strict";
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT license.
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateCustomXmlFilePath = exports.generateSingleQueryMashup = exports.generateMashupXMLTemplate = void 0;
-const generateMashupXMLTemplate = (base64) => `<?xml version="1.0" encoding="utf-16"?><DataMashup xmlns="http://schemas.microsoft.com/DataMashup">${base64}</DataMashup>`;
-exports.generateMashupXMLTemplate = generateMashupXMLTemplate;
-const generateSingleQueryMashup = (queryName, query) => `section Section1;
-    
-    shared #"${queryName}" = 
-    ${query};`;
-exports.generateSingleQueryMashup = generateSingleQueryMashup;
-const generateCustomXmlFilePath = (i) => `customXml/item${i}.xml`;
-exports.generateCustomXmlFilePath = generateCustomXmlFilePath;
+export var generateMashupXMLTemplate = function (base64) {
+    return "<?xml version=\"1.0\" encoding=\"utf-16\"?><DataMashup xmlns=\"http://schemas.microsoft.com/DataMashup\">".concat(base64, "</DataMashup>");
+};
+export var generateSingleQueryMashup = function (queryName, query) {
+    return "section Section1;\n    \n    shared #\"".concat(queryName, "\" = \n    ").concat(query, ";");
+};
+export var generateCustomXmlFilePath = function (i) { return "customXml/item".concat(i, ".xml"); };

package/dist/index.js

@@ -1,32 +1,6 @@
-"use strict";
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT license.
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DataTypes = void 0;
-const workbookManager = __importStar(require("./workbookManager"));
-const types_1 = require("./types");
-Object.defineProperty(exports, "DataTypes", { enumerable: true, get: function () { return types_1.DataTypes; } });
-exports.default = workbookManager;
+import * as workbookManager from "./workbookManager";
+import { DataTypes } from "./types";
+export { DataTypes };
+export default workbookManager;