Update packages and preview docs (#405)

* Update packages

* Fix throws regex in preprocessor

Author: AlexJerabek

docs/docs-ref-autogen/excelscript/excelscript.chartseries.yml

@@ -1002,8 +1002,7 @@ methods:
     summary: >-
       Returns a range object that includes the current range and up to the edge
       of the range, based on the provided direction. This matches the
-      <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Arrow key</kbd> behavior in the
-      Excel on Windows UI.
+      Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
     remarks: ''
 
     isPreview: false
@@ -1749,8 +1748,8 @@ methods:
     fullName: getRangeEdge(direction, activeCell)
     summary: >-
       Returns a range object that is the edge cell of the data region that
-      corresponds to the provided direction. This matches the
-      <kbd>Ctrl</kbd>+<kbd>Arrow key</kbd> behavior in the Excel on Windows UI.
+      corresponds to the provided direction. This matches the Ctrl+Arrow key
+      behavior in the Excel on Windows UI.
     remarks: ''
 
     isPreview: false

docs/docs-ref-autogen/excelscript/excelscript.range.yml

@@ -4,8 +4,8 @@ name: OfficeScript
 type: package
 summary: ''
 interfaces:
+  - OfficeScript!OfficeScript.DownloadFileProperties:interface
   - OfficeScript!OfficeScript.EmailAttachment:interface
-  - OfficeScript!OfficeScript.FileProperties:interface
   - OfficeScript!OfficeScript.MailProperties:interface
 enums:
   - OfficeScript!OfficeScript.EmailContentType:enum
@@ -14,13 +14,10 @@ functions:
   - name: OfficeScript.convertToPdf()
     uid: OfficeScript!OfficeScript.convertToPdf:function(1)
     package: OfficeScript!
-    summary: >-
-      Converts the document to a PDF and returns the text encoding of it. Note:
-      Recent changes made to the workbook in Excel on the web, through Office
-      Scripts or the Excel UI, may not be captured in the PDF.
+    summary: Converts the document to a PDF and returns the text encoding of it.
     remarks: ''
 
-    isPreview: true
+    isPreview: false
     isDeprecated: false
     syntax:
       content: 'export function convertToPdf(): string;'
@@ -30,16 +27,16 @@ functions:
           The content of the workbook as a string, in PDF format.
 
 
-          **Throws**: `ConvertToPdfEmptyWorkbook` The error thrown if the
-          document is empty.
+          **Throws**: `ConvertToPdfEmptyWorkbook` Thrown if the document is
+          empty.
 
 
-          **Throws**: `ConvertToPdfProtectedWorkbook` The error thrown if
-          the document is protected.
+          **Throws**: `ConvertToPdfProtectedWorkbook` Thrown if the document
+          is protected.
 
 
-          **Throws**: `ExternalApiTimeout` The error thrown if the API
-          reaches the timeout limit of 30 seconds.
+          **Throws**: `ExternalApiTimeout` Thrown if the API reaches the
+          timeout limit of 30 seconds.
 
 
           #### Examples
@@ -73,31 +70,35 @@ functions:
       the local machine.
     remarks: ''
 
-    isPreview: true
+    isPreview: false
     isDeprecated: false
     syntax:
-      content: 'export function downloadFile(fileProperties: FileProperties): void;'
+      content: >-
+        export function downloadFile(fileProperties: DownloadFileProperties):
+        void;
       parameters:
         - id: fileProperties
           description: >-
             The file to download.
 
 
-            **Throws**: `DownloadFileNameMissing` The error thrown if the
-            name is empty.
+            **Throws**: `DownloadFileNameMissing` Thrown if the name is
+            empty.
 
 
-            **Throws**: `DownloadFileContentMissing` The error thrown if the
-            content is empty.
+            **Throws**: `DownloadFileContentMissing` Thrown if the content
+            is empty.
 
 
-            **Throws**: `DownloadFileInvalidExtension` The error thrown if
-            the file name extension is not ".txt" or ".pdf".
+            **Throws**: `DownloadFileInvalidExtension` Thrown if the file
+            name extension is not ".txt" or ".pdf".
 
 
-            **Throws**: `ExternalApiTimeout` The error thrown if the API
-            reaches the timeout limit of 30 seconds.
-          type: <xref uid="OfficeScript!OfficeScript.FileProperties:interface" />
+            **Throws**: `ExternalApiTimeout` Thrown if the API reaches the
+            timeout limit of 30 seconds.
+          type: >-
+            <xref
+            uid="OfficeScript!OfficeScript.DownloadFileProperties:interface" />
       return:
         type: void
         description: ''
@@ -107,7 +108,7 @@ functions:
     summary: Get the name of the currently running script.
     remarks: ''
 
-    isPreview: true
+    isPreview: false
     isDeprecated: false
     syntax:
       content: 'export function getScriptName(): string;'
@@ -119,10 +120,11 @@ functions:
     package: OfficeScript!
     summary: >-
       Saves a copy of the current workbook in OneDrive, in the same directory as
-      the original file, with the specified file name.
+      the original file, with the specified file name. This API must be called
+      before other APIs.
     remarks: ''
 
-    isPreview: true
+    isPreview: false
     isDeprecated: false
     syntax:
       content: 'export function saveCopyAs(filename: string): void;'
@@ -133,25 +135,29 @@ functions:
             with ".xlsx".
 
 
-            **Throws**: `InvalidExtensionError` The error thrown if the file
-            name doesn't end with ".xlsx".
+            **Throws**: `SaveCopyAsInvalidExtension` Thrown if the file name
+            doesn't end with ".xlsx".
+
+
+            **Throws**: `SaveCopyAsMustBeCalledFirst` Thrown if this method
+            is called after other APIs.
 
 
-            **Throws**: `SaveCopyAsFileMayAlreadyExistError` The error
-            thrown if the file name of the copy already exists.
+            **Throws**: `SaveCopyAsFileMayAlreadyExist` Thrown if the file
+            name of the copy already exists.
 
 
-            **Throws**: `SaveCopyAsErrorInvalidCharacters` The error thrown
-            if the file name contains invalid characters.
+            **Throws**: `SaveCopyAsInvalidCharacters` Thrown if the file
+            name contains invalid characters.
 
 
-            **Throws**: `SaveCopyAsFileNotOnOneDriveError` The error thrown
-            if the document is not saved to OneDrive.
+            **Throws**: `SaveCopyAsFileNotOnOneDrive` Thrown if the document
+            is not saved to OneDrive.
 
 
-            **Throws**: `ExternalApiTimeout` The error thrown if the API
-            reaches the timeout limit of 30 seconds. Note that the copy may
-            still be created.
+            **Throws**: `ExternalApiTimeout` Thrown if the API reaches the
+            timeout limit of 30 seconds. Note that the copy may still be
+            created.
           type: string
       return:
         type: void
@@ -164,7 +170,7 @@ functions:
       content and recipients of the email.
     remarks: ''
 
-    isPreview: true
+    isPreview: false
     isDeprecated: false
     syntax:
       content: 'export function sendMail(mailProperties: MailProperties): void;'

docs/docs-ref-autogen/officescript.yml

@@ -1,30 +1,30 @@
-### YamlMime:TSType
-name: OfficeScript.FileProperties
-uid: OfficeScript!OfficeScript.FileProperties:interface
+### YamlMime:TSType
+name: OfficeScript.DownloadFileProperties
+uid: OfficeScript!OfficeScript.DownloadFileProperties:interface
 package: OfficeScript!
-fullName: OfficeScript.FileProperties
+fullName: OfficeScript.DownloadFileProperties
 summary: The file to download.
 remarks: ''
 
-isPreview: true
+isPreview: false
 isDeprecated: false
 type: interface
 properties:
   - name: content
-    uid: OfficeScript!OfficeScript.FileProperties#content:member
+    uid: OfficeScript!OfficeScript.DownloadFileProperties#content:member
     package: OfficeScript!
     fullName: content
     summary: The content of the file.
     remarks: ''
 
-    isPreview: true
+    isPreview: false
     isDeprecated: false
     syntax:
       content: 'content: string;'
       return:
         type: string
   - name: name
-    uid: OfficeScript!OfficeScript.FileProperties#name:member
+    uid: OfficeScript!OfficeScript.DownloadFileProperties#name:member
     package: OfficeScript!
     fullName: name
     summary: >-
@@ -33,7 +33,7 @@ properties:
       ".txt".
     remarks: ''
 
-    isPreview: true
+    isPreview: false
     isDeprecated: false
     syntax:
       content: 'name: string;'

…cescript/officescript.fileproperties.yml …/officescript.downloadfileproperties.ymldocs/docs-ref-autogen/officescript/officescript.fileproperties.yml renamed to docs/docs-ref-autogen/officescript/officescript.downloadfileproperties.yml docs/docs-ref-autogen/officescript/officescript.fileproperties.yml renamed to docs/docs-ref-autogen/officescript/officescript.downloadfileproperties.yml

@@ -10,7 +10,7 @@ summary: >-
   enter a value for at least one of the "to", "cc", or "bcc" parameters."
 remarks: ''
 
-isPreview: true
+isPreview: false
 isDeprecated: false
 type: interface
 properties:
@@ -21,7 +21,7 @@ properties:
     summary: The contents of the file.
     remarks: ''
 
-    isPreview: true
+    isPreview: false
     isDeprecated: false
     syntax:
       content: 'content: string;'
@@ -36,7 +36,7 @@ properties:
       This string doesn't need to match the file name.
     remarks: ''
 
-    isPreview: true
+    isPreview: false
     isDeprecated: false
     syntax:
       content: 'name: string;'

docs/docs-ref-autogen/officescript/officescript.emailattachment.yml

@@ -6,7 +6,7 @@ fullName: OfficeScript.EmailContentType
 summary: The type of the content. Possible values are text or HTML.
 remarks: ''
 
-isPreview: true
+isPreview: false
 isDeprecated: false
 fields:
   - name: html

docs/docs-ref-autogen/officescript/officescript.emailcontenttype.yml

@@ -8,7 +8,7 @@ summary: >-
   importance values available in the Outlook UI.
 remarks: ''
 
-isPreview: true
+isPreview: false
 isDeprecated: false
 fields:
   - name: high

docs/docs-ref-autogen/officescript/officescript.emailimportance.yml

@@ -6,7 +6,7 @@ fullName: OfficeScript.MailProperties
 summary: The properties of the email to be sent.
 remarks: ''
 
-isPreview: true
+isPreview: false
 isDeprecated: false
 type: interface
 properties:
@@ -19,7 +19,7 @@ properties:
       Optional.
     remarks: ''
 
-    isPreview: true
+    isPreview: false
     isDeprecated: false
     syntax:
       content: 'attachments?: EmailAttachment | EmailAttachment[];'
@@ -36,7 +36,7 @@ properties:
       Optional.
     remarks: ''
 
-    isPreview: true
+    isPreview: false
     isDeprecated: false
     syntax:
       content: 'bcc?: string | string[];'
@@ -49,7 +49,7 @@ properties:
     summary: The carbon copy (CC) recipient or recipients of the email. Optional.
     remarks: ''
 
-    isPreview: true
+    isPreview: false
     isDeprecated: false
     syntax:
       content: 'cc?: string | string[];'
@@ -62,7 +62,7 @@ properties:
     summary: The content of the email. Optional.
     remarks: ''
 
-    isPreview: true
+    isPreview: false
     isDeprecated: false
     syntax:
       content: 'content?: string;'
@@ -77,7 +77,7 @@ properties:
       Optional.
     remarks: ''
 
-    isPreview: true
+    isPreview: false
     isDeprecated: false
     syntax:
       content: 'contentType?: EmailContentType;'
@@ -93,7 +93,7 @@ properties:
       Optional.
     remarks: ''
 
-    isPreview: true
+    isPreview: false
     isDeprecated: false
     syntax:
       content: 'importance?: EmailImportance;'
@@ -106,7 +106,7 @@ properties:
     summary: The subject of the email. Optional.
     remarks: ''
 
-    isPreview: true
+    isPreview: false
     isDeprecated: false
     syntax:
       content: 'subject?: string;'
@@ -119,7 +119,7 @@ properties:
     summary: The direct recipient or recipients of the email. Optional.
     remarks: ''
 
-    isPreview: true
+    isPreview: false
     isDeprecated: false
     syntax:
       content: 'to?: string | string[];'

docs/docs-ref-autogen/officescript/officescript.mailproperties.yml

@@ -653,9 +653,9 @@ items:
                 uid: OfficeScript!OfficeScript.EmailContentType:enum
               - name: EmailImportance
                 uid: OfficeScript!OfficeScript.EmailImportance:enum
+          - name: DownloadFileProperties
+            uid: OfficeScript!OfficeScript.DownloadFileProperties:interface
           - name: EmailAttachment
             uid: OfficeScript!OfficeScript.EmailAttachment:interface
-          - name: FileProperties
-            uid: OfficeScript!OfficeScript.FileProperties:interface
           - name: MailProperties
             uid: OfficeScript!OfficeScript.MailProperties:interface

docs/docs-ref-autogen/toc.yml

@@ -1,19 +1,2 @@
 | Class | Fields | Description |
 |:---|:---|:---|
-|*global*|[convertToPdf()](/javascript/api/office-scripts/officescript#officescript-officescript-converttopdf-function(1))|Converts the document to a PDF and returns the text encoding of it.|
-||[downloadFile(fileProperties: FileProperties)](/javascript/api/office-scripts/officescript#officescript-officescript-downloadfile-function(1))|Downloads a specified file to the default download location specified by the local machine.|
-||[getScriptName()](/javascript/api/office-scripts/officescript#officescript-officescript-getscriptname-function(1))|Get the name of the currently running script.|
-||[saveCopyAs(filename: string)](/javascript/api/office-scripts/officescript#officescript-officescript-savecopyas-function(1))|Saves a copy of the current workbook in OneDrive, in the same directory as the original file, with the specified file name.|
-||[sendMail(mailProperties: MailProperties)](/javascript/api/office-scripts/officescript#officescript-officescript-sendmail-function(1))|Send an email with an Office Script.|
-|[EmailAttachment](/javascript/api/office-scripts/officescript/officescript.emailattachment)|[content](/javascript/api/office-scripts/officescript/officescript.emailattachment#officescript-officescript-emailattachment-content-member)|The contents of the file.|
-||[name](/javascript/api/office-scripts/officescript/officescript.emailattachment#officescript-officescript-emailattachment-name-member)|The text that is displayed below the icon representing the attachment.|
-|[FileProperties](/javascript/api/office-scripts/officescript/officescript.fileproperties)|[content](/javascript/api/office-scripts/officescript/officescript.fileproperties#officescript-officescript-fileproperties-content-member)|The content of the file.|
-||[name](/javascript/api/office-scripts/officescript/officescript.fileproperties#officescript-officescript-fileproperties-name-member)|The name of the file once downloaded.|
-|[MailProperties](/javascript/api/office-scripts/officescript/officescript.mailproperties)|[attachments](/javascript/api/office-scripts/officescript/officescript.mailproperties#officescript-officescript-mailproperties-attachments-member)|A file (such as a text file or Excel workbook) attached to a message.|
-||[bcc](/javascript/api/office-scripts/officescript/officescript.mailproperties#officescript-officescript-mailproperties-bcc-member)|The blind carbon copy (BCC) recipient or recipients of the email.|
-||[cc](/javascript/api/office-scripts/officescript/officescript.mailproperties#officescript-officescript-mailproperties-cc-member)|The carbon copy (CC) recipient or recipients of the email.|
-||[content](/javascript/api/office-scripts/officescript/officescript.mailproperties#officescript-officescript-mailproperties-content-member)|The content of the email.|
-||[contentType](/javascript/api/office-scripts/officescript/officescript.mailproperties#officescript-officescript-mailproperties-contenttype-member)|The type of the content in the email.|
-||[importance](/javascript/api/office-scripts/officescript/officescript.mailproperties#officescript-officescript-mailproperties-importance-member)|The importance of the email.|
-||[subject](/javascript/api/office-scripts/officescript/officescript.mailproperties#officescript-officescript-mailproperties-subject-member)|The subject of the email.|
-||[to](/javascript/api/office-scripts/officescript/officescript.mailproperties#officescript-officescript-mailproperties-to-member)|The direct recipient or recipients of the email.|