@types/office-js 1.0.407 → 1.0.408

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
office-js/README.md CHANGED
@@ -8,7 +8,7 @@ This package contains type definitions for office-js (https://github.com/OfficeD
8
8
  Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/office-js.
9
9
 
10
10
  ### Additional Details
11
- * Last updated: Thu, 01 Aug 2024 19:07:04 GMT
11
+ * Last updated: Tue, 06 Aug 2024 17:36:11 GMT
12
12
  * Dependencies: none
13
13
 
14
14
  # Credits
office-js/index.d.ts CHANGED
@@ -3137,7 +3137,7 @@ declare namespace Office {
3137
3137
  /**
3138
3138
  * Associates the ID or name of an action with a function.
3139
3139
  *
3140
- * @param actionId The ID of an action that is defined in an extended manifest or the name of the function as specified in a **FunctionName** element in the manifest.
3140
+ * @param actionId The ID of an action that is defined in the manifest.
3141
3141
  * @param actionFunction The function that is run when the action is invoked.
3142
3142
  */
3143
3143
  associate: (actionId: string, actionFunction: (arg?: any) => void) => void;
@@ -3152,14 +3152,14 @@ declare namespace Office {
3152
3152
  *
3153
3153
  * - {@link https://learn.microsoft.com/javascript/api/requirement-sets/common/shared-runtime-requirement-sets | SharedRuntime 1.1}
3154
3154
  *
3155
- * @param shortcuts An object of custom shortcuts with keys being the IDs of the actions (as defined in an extended manifest) and values being the shortcut combinations. For example, `{"SetItalic": "Ctrl+1", "SetBold": "Ctrl+2"}`.
3155
+ * @param shortcuts An object of custom shortcuts with keys being the IDs of the actions and values being the shortcut combinations. For example, `{"SetItalic": "Ctrl+1", "SetBold": "Ctrl+2"}`.
3156
3156
  * To learn how to specify a valid action ID and a key combination, see {@link https://learn.microsoft.com/office/dev/add-ins/design/keyboard-shortcuts | Add custom keyboard shortcuts to your Office Add-ins}. (Note that a key combination can be `null`, in which case, the action keeps the key combination specified in the JSON file.)
3157
3157
  * @returns A promise that resolves when every custom shortcut assignment in `shortcuts` has been registered. Even if there is a conflict with existing shortcuts, the customized shortcut will be registered.
3158
3158
  * Otherwise, the promise will be rejected with error code and error message. An "InvalidOperation" error code is returned if any action ID in `shortcuts` does not exist, or if shortcut combination is invalid.
3159
3159
  */
3160
3160
  replaceShortcuts(shortcuts: {[actionId: string]: string}): Promise<void>;
3161
3161
  /**
3162
- * Gets the existing shortcuts for the add-in. The set always includes (1) the shortcuts defined in the add-in's extended manifest for keyboard shortcuts and (2) the current user's custom shortcuts if those exist.
3162
+ * Gets the existing shortcuts for the add-in. The set always includes (1) the shortcuts defined in the add-in's manifest for keyboard shortcuts and (2) the current user's custom shortcuts if those exist.
3163
3163
  * The shortcut can be `null` if it conflicts with the shortcut of another add-in or with the Office application. Specifically, it would be `null` if, when prompted to choose which shortcut to use, the user didn't choose the action of the current add-in. For more information about conflicts with shortcuts, see {@link https://learn.microsoft.com/office/dev/add-ins/design/keyboard-shortcuts#avoid-key-combinations-in-use-by-other-add-ins | Avoid key combinations in use by other add-ins}.
3164
3164
  *
3165
3165
  * @remarks
@@ -3170,7 +3170,7 @@ declare namespace Office {
3170
3170
  *
3171
3171
  * - {@link https://learn.microsoft.com/javascript/api/requirement-sets/common/shared-runtime-requirement-sets | SharedRuntime 1.1}
3172
3172
  *
3173
- * @returns A promise that resolves to an object of shortcuts, with keys being the IDs of the actions (as defined in an extended manifest) and values being the shortcut combinations. For example, `{"SetItalic": "Ctrl+1", "SetBold": "Ctrl+2", "SetUnderline": null}`.
3173
+ * @returns A promise that resolves to an object of shortcuts, with keys being the IDs of the actions (as defined in an manifest) and values being the shortcut combinations. For example, `{"SetItalic": "Ctrl+1", "SetBold": "Ctrl+2", "SetUnderline": null}`.
3174
3174
  */
3175
3175
  getShortcuts(): Promise<{[actionId: string]: string|null}>;
3176
3176
  /**
@@ -8440,7 +8440,7 @@ declare namespace Office {
8440
8440
  * This method is available in the DialogApi requirement set for Excel, PowerPoint, or Word add-ins, and in the Mailbox requirement set 1.4
8441
8441
  * for Outlook. For more on how to specify a requirement set in your manifest, see
8442
8442
  * {@link https://learn.microsoft.com/office/dev/add-ins/develop/specify-office-hosts-and-api-requirements | Specify Office applications and API requirements},
8443
- * if you're using the XML manifest. If you're using the unified manifest for Microsoft 365, see
8443
+ * if you're using the add-in only manifest. If you're using the unified manifest for Microsoft 365, see
8444
8444
  * {@link https://learn.microsoft.com/office/dev/add-ins/develop/unified-manifest-overview | Office Add-ins with the unified app manifest for Microsoft 365}.
8445
8445
  *
8446
8446
  * The initial page must be on the same domain as the parent page (the startAddress parameter). After the initial page loads, you can go to
@@ -8543,7 +8543,7 @@ declare namespace Office {
8543
8543
  * This method is available in the DialogApi requirement set for Excel, PowerPoint, or Word add-ins, and in the Mailbox requirement set 1.4
8544
8544
  * for Outlook. For more on how to specify a requirement set in your manifest, see
8545
8545
  * {@link https://learn.microsoft.com/office/dev/add-ins/develop/specify-office-hosts-and-api-requirements | Specify Office applications and API requirements},
8546
- * if you're using the XML manifest. If you're using the unified manifest for Microsoft 365, see
8546
+ * if you're using the add-in only manifest. If you're using the unified manifest for Microsoft 365, see
8547
8547
  * {@link https://learn.microsoft.com/office/dev/add-ins/develop/unified-manifest-overview | Office Add-ins with the unified app manifest for Microsoft 365}.
8548
8548
  *
8549
8549
  * The initial page must be on the same domain as the parent page (the startAddress parameter). After the initial page loads, you can go to
@@ -8712,7 +8712,7 @@ declare namespace Office {
8712
8712
  * this API isn't supported in add-ins that implement a task pane. On these clients, the API is only supported in add-ins that implement event-based activation
8713
8713
  * or integrated spam reporting.
8714
8714
  *
8715
- * - If your add-in uses the XML manifest, the URL returned matches the `resid` value of the **RuntimeOverride** element of type `javascript`.
8715
+ * - If your add-in uses the add-in only manifest, the URL returned matches the `resid` value of the **RuntimeOverride** element of type `javascript`.
8716
8716
  * To learn more, see {@link https://learn.microsoft.com/javascript/api/manifest/override#override-element-for-runtime | Override element for Runtime}.
8717
8717
  *
8718
8718
  * - If your add-in uses the unified manifest for Microsoft 365, the URL returned matches the value of the `script` property in the
@@ -12092,7 +12092,7 @@ declare namespace Office {
12092
12092
  */
12093
12093
  getEntitiesByType(entityType: MailboxEnums.EntityType | string): Array<string | Contact | MeetingSuggestion | PhoneNumber | TaskSuggestion>;
12094
12094
  /**
12095
- * Returns well-known entities in the selected item that pass the named filter defined in an XML manifest file.
12095
+ * Returns well-known entities in the selected item that pass the named filter defined in an add-in only manifest file.
12096
12096
  *
12097
12097
  * **Warning**: Entity-based contextual Outlook add-ins are now retired. However, regular expression rules are still supported.
12098
12098
  * We recommend updating your contextual add-in to use regular expression rules as an alternative solution.
@@ -12103,7 +12103,7 @@ declare namespace Office {
12103
12103
  *
12104
12104
  * @returns
12105
12105
  * The entities that match the regular expression defined in the `ItemHasKnownEntity` rule element in the
12106
- * manifest XML file with the specified `FilterName` element value. If there's no `ItemHasKnownEntity` element in the manifest with a
12106
+ * add-in manifest file with the specified `FilterName` element value. If there's no `ItemHasKnownEntity` element in the manifest with a
12107
12107
  * `FilterName` element value that matches the `name` parameter, the method returns `null`. If the `name` parameter matches an
12108
12108
  * `ItemHasKnownEntity` element in the manifest, but there are no entities in the current item that match, the method returns an empty array.
12109
12109
  *
@@ -12152,10 +12152,10 @@ declare namespace Office {
12152
12152
  */
12153
12153
  getInitializationContextAsync(callback: (asyncResult: Office.AsyncResult<string>) => void): void;
12154
12154
  /**
12155
- * Returns string values in the selected item that match the regular expressions defined in an XML manifest file.
12155
+ * Returns string values in the selected item that match the regular expressions defined in an add-in only manifest file.
12156
12156
  *
12157
12157
  * @returns
12158
- * An object that contains arrays of strings that match the regular expressions defined in the manifest XML file.
12158
+ * An object that contains arrays of strings that match the regular expressions defined in the add-in manifest file.
12159
12159
  * The name of each array is equal to the corresponding value of the RegExName attribute of the matching `ItemHasRegularExpressionMatch` rule.
12160
12160
  * For an `ItemHasRegularExpressionMatch` rule, a matching string has to occur in the property
12161
12161
  * of the item that's specified by that rule. The `PropertyName` simple type defines the supported properties.
@@ -12186,10 +12186,10 @@ declare namespace Office {
12186
12186
  */
12187
12187
  getRegExMatches(): any;
12188
12188
  /**
12189
- * Returns string values in the selected item that match the named regular expression defined in an XML manifest file.
12189
+ * Returns string values in the selected item that match the named regular expression defined in an add-in only manifest file.
12190
12190
  *
12191
12191
  * @returns
12192
- * An array that contains the strings that match the regular expression defined in the `ItemHasRegularExpressionMatch` rule element in the manifest XML file,
12192
+ * An array that contains the strings that match the regular expression defined in the `ItemHasRegularExpressionMatch` rule element in the add-in manifest file,
12193
12193
  * with the specified `RegExName` element value.
12194
12194
  *
12195
12195
  * @remarks
@@ -12240,11 +12240,11 @@ declare namespace Office {
12240
12240
  */
12241
12241
  getSelectedEntities(): Entities;
12242
12242
  /**
12243
- * Returns string values in a highlighted match that match the regular expressions defined in an XML manifest file.
12243
+ * Returns string values in a highlighted match that match the regular expressions defined in an add-in only manifest file.
12244
12244
  * Highlighted matches apply to contextual add-ins.
12245
12245
  *
12246
12246
  * @returns
12247
- * An object that contains arrays of strings that match the regular expressions defined in the manifest XML file.
12247
+ * An object that contains arrays of strings that match the regular expressions defined in the add-in manifest file.
12248
12248
  * The name of each array is equal to the corresponding value of the `RegExName` attribute of the matching `ItemHasRegularExpressionMatch` rule.
12249
12249
  * For an `ItemHasRegularExpressionMatch` rule, a matching string has to occur in the property of the item that's specified by that rule.
12250
12250
  * The `PropertyName` simple type defines the supported properties.
@@ -18135,7 +18135,7 @@ declare namespace Office {
18135
18135
  */
18136
18136
  getEntitiesByType(entityType: MailboxEnums.EntityType | string): Array<string | Contact | MeetingSuggestion | PhoneNumber | TaskSuggestion>;
18137
18137
  /**
18138
- * Returns well-known entities in the selected item that pass the named filter defined in an XML manifest file.
18138
+ * Returns well-known entities in the selected item that pass the named filter defined in an add-in only manifest file.
18139
18139
  *
18140
18140
  * **Warning**: Entity-based contextual Outlook add-ins are now retired. However, regular expression rules are still supported.
18141
18141
  * We recommend updating your contextual add-in to use regular expression rules as an alternative solution.
@@ -18146,7 +18146,7 @@ declare namespace Office {
18146
18146
  *
18147
18147
  * @returns
18148
18148
  * The entities that match the regular expression defined in the `ItemHasKnownEntity` rule element in the
18149
- * manifest XML file with the specified `FilterName` element value. If there's no `ItemHasKnownEntity` element in the manifest with a
18149
+ * add-in manifest file with the specified `FilterName` element value. If there's no `ItemHasKnownEntity` element in the manifest with a
18150
18150
  * `FilterName` element value that matches the `name` parameter, the method returns `null`. If the `name` parameter matches an
18151
18151
  * `ItemHasKnownEntity` element in the manifest, but there are no entities in the current item that match, the method returns an empty array.
18152
18152
  *
@@ -18195,10 +18195,10 @@ declare namespace Office {
18195
18195
  */
18196
18196
  getInitializationContextAsync(callback: (asyncResult: Office.AsyncResult<string>) => void): void;
18197
18197
  /**
18198
- * Returns string values in the selected item that match the regular expressions defined in an XML manifest file.
18198
+ * Returns string values in the selected item that match the regular expressions defined in an add-in only manifest file.
18199
18199
  *
18200
18200
  * @returns
18201
- * An object that contains arrays of strings that match the regular expressions defined in the manifest XML file.
18201
+ * An object that contains arrays of strings that match the regular expressions defined in the add-in manifest file.
18202
18202
  * The name of each array is equal to the corresponding value of the RegExName attribute of the matching `ItemHasRegularExpressionMatch` rule.
18203
18203
  * For an `ItemHasRegularExpressionMatch` rule, a matching string has to occur in the property
18204
18204
  * of the item that's specified by that rule. The `PropertyName` simple type defines the supported properties.
@@ -18229,10 +18229,10 @@ declare namespace Office {
18229
18229
  */
18230
18230
  getRegExMatches(): any;
18231
18231
  /**
18232
- * Returns string values in the selected item that match the named regular expression defined in an XML manifest file.
18232
+ * Returns string values in the selected item that match the named regular expression defined in an add-in only manifest file.
18233
18233
  *
18234
18234
  * @returns
18235
- * An array that contains the strings that match the regular expression defined in the `ItemHasRegularExpressionMatch` rule element in the manifest XML file,
18235
+ * An array that contains the strings that match the regular expression defined in the `ItemHasRegularExpressionMatch` rule element in the add-in manifest file,
18236
18236
  * with the specified `RegExName` element value.
18237
18237
  *
18238
18238
  * @remarks
@@ -18283,11 +18283,11 @@ declare namespace Office {
18283
18283
  */
18284
18284
  getSelectedEntities(): Entities;
18285
18285
  /**
18286
- * Returns string values in a highlighted match that match the regular expressions defined in an XML manifest file.
18286
+ * Returns string values in a highlighted match that match the regular expressions defined in an add-in only manifest file.
18287
18287
  * Highlighted matches apply to contextual add-ins.
18288
18288
  *
18289
18289
  * @returns
18290
- * An object that contains arrays of strings that match the regular expressions defined in the manifest XML file.
18290
+ * An object that contains arrays of strings that match the regular expressions defined in the add-in manifest file.
18291
18291
  * The name of each array is equal to the corresponding value of the `RegExName` attribute of the matching `ItemHasRegularExpressionMatch` rule.
18292
18292
  * For an `ItemHasRegularExpressionMatch` rule, a matching string has to occur in the property of the item that's specified by that rule.
18293
18293
  * The `PropertyName` simple type defines the supported properties.
@@ -20447,9 +20447,9 @@ declare namespace Office {
20447
20447
  * The `commandId` value must match the task pane ID specified in the manifest of your add-in. The markup depends on the type of manifest your
20448
20448
  * add-in uses.
20449
20449
  *
20450
- * - **XML manifest**: The `id` attribute of the {@link https://learn.microsoft.com/javascript/api/manifest/control | Control} element representing the task pane.
20450
+ * - **Add-in only manifest**: The `id` attribute of the {@link https://learn.microsoft.com/javascript/api/manifest/control | Control} element representing the task pane.
20451
20451
  *
20452
- * - **Unified manifest for Microsoft 365 (preview)**: The "id" property of the task pane command in the "controls" array.
20452
+ * - **Unified manifest for Microsoft 365**: The "id" property of the task pane command in the "controls" array.
20453
20453
  *
20454
20454
  * If you specify the `contextData` option in your `event.completed` call, you must also assign a task pane ID to the `commandId` option.
20455
20455
  * Otherwise, the JSON data assigned to `contextData` is ignored.
office-js/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@types/office-js",
3
- "version": "1.0.407",
3
+ "version": "1.0.408",
4
4
  "description": "TypeScript definitions for office-js",
5
5
  "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/office-js",
6
6
  "license": "MIT",
@@ -45,6 +45,6 @@
45
45
  },
46
46
  "scripts": {},
47
47
  "dependencies": {},
48
- "typesPublisherContentHash": "3be230465bfcb2311397b01307aa15c7a05cad1948c8d993782b7d12eecf8542",
48
+ "typesPublisherContentHash": "d814d45d3ea73b6e8513036e038b2eb8548a88744614d9a04c9bf27c15be131b",
49
49
  "typeScriptVersion": "4.8"
50
50
  }