@microsoft/sp-adaptive-card-extension-base 1.19.0-beta.0 → 1.19.0

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.
Files changed (2) hide show
  1. package/dist/index-internal.d.ts +20 -173
  2. package/package.json +13 -13
@@ -78,11 +78,7 @@ export declare class AdaptiveCardExtensionContext extends BaseComponentContext {
78
78
  * Provides a sdk that gets current context of device. See {@link IPartialSDKs}
79
79
  */
80
80
  get sdks(): IPartialSDKs | undefined;
81
- /**
82
- * @beta
83
- * Provides a promise that gets current location of the device
84
- */
85
- get location(): Promise<ILocation>;
81
+ /* Excluded from this release type: location */
86
82
  /* Excluded from this release type: _logEditCustomerPromiseFailure */
87
83
  }
88
84
 
@@ -219,17 +215,7 @@ export declare class BaseAdaptiveCardExtension<TProperties extends {} = {}, TSta
219
215
  * @virtual
220
216
  */
221
217
  protected get propertiesMetadata(): IAdaptiveCardExtensionPropertiesMetadata | undefined;
222
- /**
223
- * Indicates whether the ACE is rendering in async mode.
224
- *
225
- * @remarks
226
- * If the ACE overrides this field to return true, then it needs to call renderCompleted API after the ACE finishes initializing.
227
- *
228
- * The default value is false.
229
- *
230
- * @beta
231
- */
232
- protected get isRenderAsync(): boolean;
218
+ /* Excluded from this release type: isRenderAsync */
233
219
  /**
234
220
  * Gets the custom state of the Adaptive Card Extension.
235
221
  *
@@ -284,41 +270,9 @@ export declare class BaseAdaptiveCardExtension<TProperties extends {} = {}, TSta
284
270
  * @virtual
285
271
  */
286
272
  protected loadPropertyPaneResources(): Promise<void>;
287
- /**
288
- * Override the default cache settings.
289
- *
290
- * @beta
291
- * @virtual
292
- */
293
- protected getCacheSettings(): Partial<ICacheSettings>;
294
- /**
295
- * This virtual method returns a subset of the state object that will be cached by the client.
296
- *
297
- * @remarks If not overriden, this will return an empty object.
298
- * @param state - A shallow clone of the AdaptiveCardExtension state object.
299
- *
300
- * @beta
301
- * @virtual
302
- */
303
- protected getCachedState(state: TState): Partial<TState>;
304
- /**
305
- * Lifecycle method called when a notification is received for this Adaptive Card Extension.
306
- *
307
- * @remarks If the notification should be handled by this Adaptive Card Extension then a registered quick view id
308
- * should be returned. Otherwise, returning undefined will result in the next, if any, Adaptive Card Extension
309
- * to potentially handle the notification event.
310
- *
311
- * @remarks Only one Adaptive Card Extension can handle a notification event. If the event is handled,
312
- * then propagation is finished.
313
- *
314
- * @param notificationArguments - The {@link INotificationArguments} for the current notification event.
315
- *
316
- * @returns A registered quick view id to open or undefined.
317
- *
318
- * @beta
319
- * @virtual
320
- */
321
- onNotificationReceived(notificationArguments: Readonly<INotificationArguments<{}>>): INotificationResponse | undefined;
273
+ /* Excluded from this release type: getCacheSettings */
274
+ /* Excluded from this release type: getCachedState */
275
+ /* Excluded from this release type: onNotificationReceived */
322
276
  /**
323
277
  * Lifecycle method called before Action is passed to {@link IAdaptiveCardExtensionActionView.onAction}.
324
278
  *
@@ -399,19 +353,7 @@ export declare class BaseAdaptiveCardExtension<TProperties extends {} = {}, TSta
399
353
  * @virtual
400
354
  */
401
355
  onInit(): Promise<void>;
402
- /**
403
- * Lifecycle method called during initialization.
404
- *
405
- * @remarks Asynchronous data fetches should be started during this lifecycle. Rendering can either be dependent on the result
406
- * or, if resolved immediately, a fetching data state can be rendered.
407
- *
408
- * @param cachedLoadParameters - Parameters containing the cached state object (see {@link BaseAdaptiveCardExtension.getCachedState}), which can be used to rehydrate the AdaptiveCardExtension.
409
- * If undefined, the AdaptiveCardExtension was not cached or the cache expired.
410
- *
411
- * @beta
412
- * @virtual
413
- */
414
- onInit(cachedLoadParameters?: ICachedLoadParameters): Promise<void>;
356
+ /* Excluded from this release type: onInit */
415
357
  /* Excluded from this release type: _initializeCardNavigator */
416
358
  /* Excluded from this release type: _initializeQuickViewNavigator */
417
359
  /**
@@ -460,19 +402,7 @@ export declare class BaseAdaptiveCardExtension<TProperties extends {} = {}, TSta
460
402
  */
461
403
  get isVisible(): boolean;
462
404
  set isVisible(value: boolean);
463
- /**
464
- * Lifecycle method that signifies ACE has finished loading.
465
- * When this API is called, performance data will be generated.
466
- * Depending on `didUpdate` parameter, end marker for the rendering lifecycle can change.
467
- * If an ACE received LKG data and does NOT need to update, render is completed when LKG is used.
468
- * If an ACE received LKG data and DOES need to update, render is completed when new render arguments are used.
469
- * If an ACE does not receive LKG data, render is completed when new render arguments are used.
470
- *
471
- * @param didUpdate - boolean value indicating if ACE has updated.
472
- *
473
- * @beta
474
- */
475
- renderCompleted(didUpdate: boolean): void;
405
+ /* Excluded from this release type: renderCompleted */
476
406
  private _endMarkForRenderComplete;
477
407
  private _resolveRenderCompleted;
478
408
  /**
@@ -605,16 +535,7 @@ export declare abstract class BaseAdaptiveCardQuickView<TProperties = {}, TState
605
535
  * @virtual
606
536
  */
607
537
  onAction(action: IActionArguments): void;
608
- /**
609
- * @beta
610
- *
611
- * Error handler for Adaptive Card Actions.
612
- *
613
- * @param error - The {@link IActionErrorArguments} for the current event.
614
- *
615
- * @virtual
616
- */
617
- onActionError(error: IActionErrorArguments): void;
538
+ /* Excluded from this release type: onActionError */
618
539
  }
619
540
 
620
541
  /**
@@ -694,16 +615,7 @@ export declare abstract class BaseCardView<TProperties = {}, TState = {}> extend
694
615
  * @virtual
695
616
  */
696
617
  onAction(action: IActionArguments): void;
697
- /**
698
- * @beta
699
- *
700
- * Error handler for Adaptive Card Actions.
701
- *
702
- * @param error - The {@link IActionErrorArguments} for the current event.
703
- *
704
- * @virtual
705
- */
706
- onActionError(error: IActionErrorArguments): void;
618
+ /* Excluded from this release type: onActionError */
707
619
  }
708
620
 
709
621
  /**
@@ -1019,12 +931,7 @@ export declare type GenericCardViewFooterParameters = CardViewActionsFooterParam
1019
931
  */
1020
932
  export declare type IActionArguments = ISubmitActionArguments | IShowCardActionArguments | ISelectMediaActionArguments | IGetLocationActionArguments | IExecuteActionArguments;
1021
933
 
1022
- /**
1023
- * @beta
1024
- */
1025
- export declare interface IActionError {
1026
- code: string;
1027
- }
934
+ /* Excluded from this release type: IActionError */
1028
935
 
1029
936
  /**
1030
937
  * The object passed to {@link IAdaptiveCardExtensionActionView.onActionError} when an error occured while executing Adaptive Card Action.
@@ -1051,14 +958,7 @@ export declare interface IAdaptiveCardExtensionActionView extends BaseView {
1051
958
  * @param action - The {@link IActionArguments} for the current event.
1052
959
  */
1053
960
  onAction: (action: IActionArguments) => void;
1054
- /**
1055
- * @beta
1056
- *
1057
- * Error handler for Adaptive Card Extension Actions.
1058
- *
1059
- * @param error - The {@link IActionErrorArguments} for the current event.
1060
- */
1061
- onActionError: (error: IActionErrorArguments) => void;
961
+ /* Excluded from this release type: onActionError */
1062
962
  }
1063
963
 
1064
964
  /* Excluded from this release type: _IAdaptiveCardExtensionCache */
@@ -1113,6 +1013,8 @@ export declare interface IAdaptiveCardExtensionImage {
1113
1013
 
1114
1014
  /* Excluded from this release type: _IAdaptiveCardExtensionLoadContext */
1115
1015
 
1016
+ /* Excluded from this release type: IAdaptiveCardExtensionManifest */
1017
+
1116
1018
  /**
1117
1019
  * This structure is used to define metadata for Adaptive Card Extension properties as a map of string to `IAdaptiveCardExtensionPropertiesMetadata`
1118
1020
  *
@@ -1200,21 +1102,9 @@ export declare interface IBaseActionArguments {
1200
1102
  * @public
1201
1103
  */
1202
1104
  export declare interface IBaseActionErrorArguments {
1203
- /**
1204
- * The type of Adaptive Card Action thsat caused the error.
1205
- * @beta
1206
- */
1207
- type: 'Submit' | 'ShowCard' | 'Execute' | 'VivaAction.SelectMedia' | 'VivaAction.GetLocation' | 'VivaAction.ShowLocation';
1208
- /**
1209
- * The id specified in the Adaptive Card template
1210
- * @beta
1211
- */
1212
- id?: string;
1213
- /**
1214
- * The error thrown by the action
1215
- * @beta
1216
- */
1217
- error: IActionError;
1105
+ /* Excluded from this release type: type */
1106
+ /* Excluded from this release type: id */
1107
+ /* Excluded from this release type: error */
1218
1108
  }
1219
1109
 
1220
1110
  /**
@@ -1332,35 +1222,9 @@ export declare interface IBasicTextCardViewConfiguration extends Omit<ICardViewC
1332
1222
 
1333
1223
  /* Excluded from this release type: _IBot */
1334
1224
 
1335
- /**
1336
- * Parameters used to rehydrate the AdaptiveCardExtension during a cached load
1337
- *
1338
- * @beta
1339
- * @remarks API under active development and not ready for use.
1340
- */
1341
- export declare interface ICachedLoadParameters {
1342
- state: any;
1343
- cardNavigatorState: string[];
1344
- }
1225
+ /* Excluded from this release type: ICachedLoadParameters */
1345
1226
 
1346
- /**
1347
- * @beta
1348
- */
1349
- export declare interface ICacheSettings {
1350
- /**
1351
- * Whether cache is enabled. Default: true
1352
- */
1353
- isEnabled: boolean;
1354
- /**
1355
- * Expiry time in seconds. Default: 86400 seconds (24 hours)
1356
- */
1357
- expiryTimeInSeconds: number;
1358
- /**
1359
- * Returns the Card View used to generate the cached card.
1360
- * By default, the currently rendered Card View will be used to cache the card.
1361
- */
1362
- cachedCardView?: () => BaseCardView;
1363
- }
1227
+ /* Excluded from this release type: ICacheSettings */
1364
1228
 
1365
1229
  /**
1366
1230
  * Type of handler for when a button is pressed.
@@ -2300,26 +2164,9 @@ export declare function ImageCardView(configuration: IImageCardViewConfiguration
2300
2164
 
2301
2165
  /* Excluded from this release type: _INavigationBarProperties */
2302
2166
 
2303
- /**
2304
- * The object passed to {@link BaseAdaptiveCardExtension.onNotificationReceived} when a notification is received.
2305
- *
2306
- * @beta
2307
- */
2308
- export declare interface INotificationArguments<T extends {}> {
2309
- version: Version;
2310
- data: T;
2311
- }
2167
+ /* Excluded from this release type: INotificationArguments */
2312
2168
 
2313
- /**
2314
- * The object returned from {@link BaseAdaptiveCardExtension.onNotificationReceived} if it has handled the notification.
2315
- *
2316
- * @remarks ACE should return the registered quickViewId which it wants to display for the notification.
2317
- *
2318
- * @beta
2319
- */
2320
- export declare interface INotificationResponse {
2321
- quickViewId: string;
2322
- }
2169
+ /* Excluded from this release type: INotificationResponse */
2323
2170
 
2324
2171
  /**
2325
2172
  * The object passed to {@link BaseAdaptiveCardExtension.onBeforeAction} when an Adaptive Card Action is executed.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@microsoft/sp-adaptive-card-extension-base",
3
- "version": "1.19.0-beta.0",
3
+ "version": "1.19.0",
4
4
  "description": "SharePoint Framework Adaptive Card Extensions",
5
5
  "license": "https://aka.ms/spfx/license",
6
6
  "homepage": "http://aka.ms/spfx",
@@ -17,29 +17,29 @@
17
17
  "@microsoft/teams-js-v2": "npm:@microsoft/teams-js@2.12.0",
18
18
  "adaptivecards": "2.11.2",
19
19
  "tslib": "2.3.1",
20
- "@microsoft/sp-core-library": "1.19.0-beta.0",
21
- "@microsoft/sp-component-base": "1.19.0-beta.0",
22
- "@microsoft/sp-diagnostics": "1.19.0-beta.0",
23
- "@microsoft/sp-http": "1.19.0-beta.0",
24
- "@microsoft/sp-http-base": "1.19.0-beta.0",
25
- "@microsoft/sp-loader": "1.19.0-beta.0",
26
- "@microsoft/sp-lodash-subset": "1.19.0-beta.0",
20
+ "@microsoft/sp-component-base": "1.19.0",
21
+ "@microsoft/sp-core-library": "1.19.0",
22
+ "@microsoft/sp-http": "1.19.0",
23
+ "@microsoft/sp-http-base": "1.19.0",
24
+ "@microsoft/sp-diagnostics": "1.19.0",
25
+ "@microsoft/sp-loader": "1.19.0",
26
+ "@microsoft/sp-lodash-subset": "1.19.0",
27
27
  "@microsoft/sp-module-interfaces": "1.20.1",
28
- "@microsoft/sp-property-pane": "1.19.0-beta.0"
28
+ "@microsoft/sp-property-pane": "1.19.0"
29
29
  },
30
30
  "devDependencies": {
31
31
  "@rushstack/heft": "0.66.0",
32
32
  "@types/react": "17.0.45",
33
33
  "eslint": "8.7.0",
34
34
  "jest-environment-jsdom": "29.5.0",
35
- "@microsoft/sp-page-context": "1.19.0-beta.0",
36
- "@microsoft/sp-webpart-base": "1.19.0-beta.0",
35
+ "@microsoft/sp-page-context": "1.19.0",
37
36
  "@ms/odsp-analytics": "0.2.64",
37
+ "@microsoft/sp-webpart-base": "1.19.0",
38
38
  "@ms/sp-bingmap": "0.0.1",
39
39
  "@ms/sp-pages-core": "0.1.0",
40
- "@ms/sp-telemetry": "0.32.6",
40
+ "@ms/sp-secure-broker-lib": "0.1.0",
41
41
  "@ms/spfx-internal-web-build-rig": "0.1.0",
42
- "@ms/sp-secure-broker-lib": "0.1.0"
42
+ "@ms/sp-telemetry": "0.32.6"
43
43
  },
44
44
  "scripts": {
45
45
  "build": "heft test --clean",