@atlaskit/smart-card 19.1.27 → 19.1.30

package/dist/types/state/flexible-ui-context/types.d.ts

@@ -52,6 +52,10 @@ export declare type FlexibleUiDataContext = {
      * @see CreatedOn
      */
     createdOn?: string;
+    /**
+     * Contains the information about the latest commit in the repository
+     */
+    latestCommit?: string;
     /**
      * Contains the favicon of the resource.
      * @type Icon
@@ -88,12 +92,24 @@ export declare type FlexibleUiDataContext = {
      * @see ProgrammingLanguage
      */
     programmingLanguage?: string;
+    /**
+     * Contains the provider icon of the linked resource.
+     * @type Icon
+     * @see Provider
+     */
+    provider?: Icon;
     /**
      * Contains the snippet of the resource.
      * @type string
      * @see Snippet
      */
     snippet?: string;
+    /**
+     * Contains the source branch name of the link typed pull request.
+     * @type string
+     * @see SourceBranch
+     */
+    sourceBranch?: string;
     /**
      * Contains the number of subscribers of the linked resource.
      * @type number
@@ -106,6 +122,12 @@ export declare type FlexibleUiDataContext = {
      * @see SubscriberCount
      */
     state?: LinkLozenge;
+    /**
+     * Contains the target branch name of the link typed pull request.
+     * @type string
+     * @see TargetBranch
+     */
+    targetBranch?: string;
     /**
      * Contains the Title of the linked resource.
      * @type string
@@ -118,16 +140,6 @@ export declare type FlexibleUiDataContext = {
      * @see Title
      */
     url?: string;
-    /**
-     * Contains the provider icon of the linked resource.
-     * @type Icon
-     * @see Provider
-     */
-    provider?: Icon;
-    /**
-     * Contains the information about the latest commit in the repository
-     */
-    latestCommit?: string;
 };
 export declare type Icon = {
     icon?: IconType;

package/dist/types/view/FlexibleCard/components/blocks/types.d.ts

@@ -103,7 +103,7 @@ export declare type ActionItem = NamedActionItem | CustomActionItem;
 /**
  * A type that contains all the possible combinations of elements with their corresponding props.
  */
-export declare type ElementItemProps = AuthorGroup | CollaboratorGroup | CommentCount | CreatedBy | CreatedOn | LatestCommit | LinkIcon | ModifiedBy | ModifiedOn | Preview | Priority | ProgrammingLanguage | Provider | ReactCount | Snippet | State | SubscriberCount | Title | ViewCount | VoteCount;
+export declare type ElementItemProps = AuthorGroup | CollaboratorGroup | CommentCount | CreatedBy | CreatedOn | LatestCommit | LinkIcon | ModifiedBy | ModifiedOn | Preview | Priority | ProgrammingLanguage | Provider | ReactCount | Snippet | SourceBranch | State | SubscriberCount | TargetBranch | Title | ViewCount | VoteCount;
 /**
  * Represents the props available for an AuthorGroup element.
  * @see AuthorGroup
@@ -217,6 +217,13 @@ export declare type ReactCount = {
 export declare type Snippet = {
     name: ElementName.Snippet;
 };
+/**
+ * Represents the props available for an SourceBranch element.
+ * @see SourceBranch
+ */
+export declare type SourceBranch = {
+    name: ElementName.SourceBranch;
+};
 /**
  * Represents the props available for an State element.
  * @see State
@@ -231,6 +238,13 @@ export declare type State = {
 export declare type SubscriberCount = {
     name: ElementName.SubscriberCount;
 };
+/**
+ * Represents the props available for an TargetBranch element.
+ * @see TargetBranch
+ */
+export declare type TargetBranch = {
+    name: ElementName.TargetBranch;
+};
 /**
  * Represents the props available for an Title element.
  * @see Title

package/dist/types/view/FlexibleCard/components/elements/index.d.ts

@@ -81,6 +81,11 @@ export declare const ReactCount: import("react").FC<BadgeProps>;
  * @see Text
  */
 export declare const Snippet: import("react").FC<TextProps>;
+/**
+ * Creates a SourceBranch Text element using the data from sourceBranch in the Flexible UI Context.
+ * @see Text
+ */
+export declare const SourceBranch: import("react").FC<TextProps>;
 /**
  * Creates a State Lozenge element using the data from State in the Flexible UI Context.
  * @see Lozenge
@@ -91,6 +96,11 @@ export declare const State: import("react").FC<LozengeProps>;
  * @see Badge
  */
 export declare const SubscriberCount: import("react").FC<BadgeProps>;
+/**
+ * Creates a TargetBranch Text element using the data from targetBranch in the Flexible UI Context.
+ * @see Text
+ */
+export declare const TargetBranch: import("react").FC<TextProps>;
 /**
  * Creates a Title Link element using the data from Title in the Flexible UI Context.
  * This represents the main link text within the Smart Link.

package/dist/types/view/FlexibleCard/components/elements/types.d.ts

@@ -1,6 +1,12 @@
 import { SerializedStyles } from '@emotion/core';
-import { SmartLinkSize } from '../../../../constants';
+import { ElementName, SmartLinkSize } from '../../../../constants';
 export declare type ElementProps = {
+    /**
+     * Name of the element, can be used as a selector.
+     * E.g. [data-smart-element="Provider"]
+     * @internal
+     */
+    name?: ElementName;
     /**
      * Any additional CSS properties to apply to the element.
      */

package/dist/types/view/HoverCard/types.d.ts

@@ -13,6 +13,7 @@ export declare type PreviewInvokeMethod = 'keyboard' | 'mouse_hover' | 'mouse_cl
 export interface MetadataOptions {
     primary: Array<ElementItem>;
     secondary: Array<ElementItem>;
+    subtitle: Array<ElementItem>;
 }
 export declare type HoverCardContentProps = {
     analytics: AnalyticsFacade;

package/dist/types/view/HoverCard/utils.d.ts

@@ -1,3 +1,3 @@
 import { JsonLd } from 'json-ld-types';
 export declare const HOVER_CARD_ANALYTICS_DISPLAY = "flexible";
-export declare const getSimulatedMetadata: (extensionKey?: string) => JsonLd.Primitives.Property<any>;
+export declare const getSimulatedMetadata: (extensionKey?: string, types?: JsonLd.Primitives.ObjectType[]) => JsonLd.Primitives.Property<any>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atlaskit/smart-card",
-  "version": "19.1.27",
+  "version": "19.1.30",
   "description": "Smart card component",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/"
@@ -50,7 +50,7 @@
     "@emotion/styled": "^10.0.7",
     "@formatjs/intl-utils": "^3.8.4",
     "facepaint": "^1.2.1",
-    "json-ld-types": "2.4.2",
+    "json-ld-types": "3.0.2",
     "react-error-boundary": "^3.1.3",
     "react-lazily-render": "^1.2.0",
     "react-loadable": "^5.1.0",

package/report.api.md

@@ -0,0 +1,505 @@
+## API Report File for "@atlaskit/smart-card"
+
+> Do not edit this file. It is a report generated by [API Extractor](https://api-extractor.com/).
+
+```ts
+/// <reference types="react" />
+
+import { APIError } from '@atlaskit/linking-common';
+import { Appearance } from '@atlaskit/button/types';
+import { BlockCardAdf } from '@atlaskit/linking-common';
+import { CardAdf } from '@atlaskit/linking-common';
+import { CardAppearance } from '@atlaskit/linking-common';
+import { CardContext } from '@atlaskit/link-provider';
+import { CardPlatform } from '@atlaskit/linking-common';
+import { CardType } from '@atlaskit/linking-common';
+import { CardClient as Client } from '@atlaskit/link-provider';
+import { CreateUIAnalyticsEvent } from '@atlaskit/analytics-next';
+import { EditorCardProvider } from '@atlaskit/link-provider';
+import { editorCardProvider } from '@atlaskit/link-provider';
+import { EmbedCardAdf } from '@atlaskit/linking-common';
+import { GasPayload } from '@atlaskit/analytics-gas-types';
+import { InlineCardAdf } from '@atlaskit/linking-common';
+import { JsonLd } from 'json-ld-types';
+import { MessageDescriptor } from 'react-intl-next';
+import { SmartCardProvider as Provider } from '@atlaskit/link-provider';
+import { ProviderProps } from '@atlaskit/link-provider';
+import { default as React_2 } from 'react';
+import { ReactChild } from 'react';
+import { SerializedStyles } from '@emotion/core';
+import { SmartCardContext } from '@atlaskit/link-provider';
+import { WithAnalyticsEventsProps } from '@atlaskit/analytics-next';
+import { WithContextProps } from '@atlaskit/analytics-next';
+import { WithIntlProps } from 'react-intl-next';
+import { WrappedComponentProps } from 'react-intl-next';
+
+// @public (undocumented)
+export type ActionItem = NamedActionItem | CustomActionItem;
+
+// @public
+export enum ActionName {
+  // (undocumented)
+  CustomAction = 'CustomAction',
+  // (undocumented)
+  DeleteAction = 'DeleteAction',
+  // (undocumented)
+  EditAction = 'EditAction',
+}
+
+// @public (undocumented)
+export type AnalyticsAction =
+  | 'resolved'
+  | 'unresolved'
+  | 'connectSucceeded'
+  | 'connectFailed'
+  | 'connected'
+  | 'clicked'
+  | 'closed'
+  | 'renderFailed'
+  | 'renderWithStatus'
+  | 'renderSuccess'
+  | 'inserted'
+  | 'viewed'
+  | 'dismissed'
+  | 'created';
+
+// @public (undocumented)
+export type AnalyticsActionSubject =
+  | 'smartLink'
+  | 'smartLinkAction'
+  | 'applicationAccount'
+  | 'button'
+  | 'consentModal'
+  | 'hoverCard';
+
+// @public (undocumented)
+export type AnalyticsHandler = (event: AnalyticsPayload) => void;
+
+// @public (undocumented)
+export type AnalyticsPayload = GasPayload & {
+  action?: AnalyticsAction;
+  actionSubject: AnalyticsActionSubject;
+  attributes: GasPayload['attributes'] & {
+    display?: CardInnerAppearance;
+  };
+};
+
+export { APIError };
+
+export { BlockCardAdf };
+
+// @public (undocumented)
+export const blockCardContentClassName = 'block-card-content';
+
+// @public (undocumented)
+export const blockCardContentHeaderClassName = 'block-card-content-header';
+
+// @public (undocumented)
+export const blockCardContentHeaderNameClassName =
+  'block-card-content-header-name';
+
+// @public (undocumented)
+export const blockCardErroredViewClassName = 'block-card-errored-view';
+
+// @public (undocumented)
+export const blockCardForbiddenViewClassName = 'block-card-forbidden-view';
+
+// @public (undocumented)
+export const blockCardForbiddenViewLinkClassName =
+  'block-card-forbidden-view-link';
+
+// @public (undocumented)
+export const blockCardIconImageClassName = 'block-card-icon-image';
+
+// @public (undocumented)
+export const blockCardNotFoundViewClassName = 'block-card-not-found-view';
+
+// @public (undocumented)
+export const blockCardResolvedViewByClassName = 'block-card-resolved-view-by';
+
+// @public (undocumented)
+export const blockCardResolvedViewClassName = 'block-card-resolved-view';
+
+// @public (undocumented)
+export const blockCardResolvingViewClassName = 'block-card-resolving-view';
+
+// @public (undocumented)
+export const Card: React_2.ForwardRefExoticComponent<
+  Pick<
+    Omit<
+      React_2.PropsWithChildren<
+        WithIntlProps<CardProps & WrappedComponentProps<'intl'>>
+      >,
+      keyof WithAnalyticsEventsProps
+    > &
+      React_2.RefAttributes<any> &
+      WithContextProps,
+    | 'children'
+    | 'data'
+    | 'appearance'
+    | 'testId'
+    | 'isSelected'
+    | 'inheritDimensions'
+    | 'id'
+    | 'placeholder'
+    | 'onClick'
+    | 'analyticsContext'
+    | 'key'
+    | 'url'
+    | 'ui'
+    | 'showActions'
+    | 'onResolve'
+    | 'platform'
+    | 'isFrameVisible'
+    | 'embedIframeRef'
+    | 'showHoverPreview'
+    | 'inlinePreloaderStyle'
+    | 'importer'
+    | 'container'
+    | 'analyticsEvents'
+    | 'forwardedRef'
+  > &
+    React_2.RefAttributes<any>
+>;
+
+export { CardAdf };
+
+export { CardAppearance };
+
+export { CardContext };
+
+export { CardPlatform };
+
+// @public (undocumented)
+export interface CardProps extends WithAnalyticsEventsProps {
+  // (undocumented)
+  analyticsEvents?: AnalyticsFacade;
+  // (undocumented)
+  appearance: CardAppearance;
+  // (undocumented)
+  children?: React.ReactNode;
+  // (undocumented)
+  container?: HTMLElement;
+  // (undocumented)
+  data?: any;
+  // (undocumented)
+  embedIframeRef?: React.Ref<HTMLIFrameElement>;
+  // (undocumented)
+  id?: string;
+  // (undocumented)
+  importer?: (target: any) => void;
+  // (undocumented)
+  inheritDimensions?: boolean;
+  // (undocumented)
+  inlinePreloaderStyle?: InlinePreloaderStyle;
+  // (undocumented)
+  isFrameVisible?: boolean;
+  // (undocumented)
+  isSelected?: boolean;
+  // (undocumented)
+  onClick?: React.EventHandler<React.MouseEvent | React.KeyboardEvent>;
+  // (undocumented)
+  onResolve?: OnResolveCallback;
+  // (undocumented)
+  placeholder?: string;
+  // (undocumented)
+  platform?: CardPlatform;
+  // (undocumented)
+  showActions?: boolean;
+  // (undocumented)
+  showHoverPreview?: boolean;
+  // (undocumented)
+  testId?: string;
+  // (undocumented)
+  ui?: FlexibleUiOptions;
+  // (undocumented)
+  url?: string;
+}
+
+export { CardType };
+
+export { Client };
+
+// @public (undocumented)
+export const contentFooterClassName = 'smart-link-content-footer';
+
+export { EditorCardProvider };
+
+export { editorCardProvider };
+
+// @public
+export type ElementItem = {
+  overrideCss?: SerializedStyles;
+  size?: SmartLinkSize;
+  testId?: string;
+} & ElementItemProps;
+
+// @public
+export enum ElementName {
+  // (undocumented)
+  AuthorGroup = 'AuthorGroup',
+  // (undocumented)
+  CollaboratorGroup = 'CollaboratorGroup',
+  // (undocumented)
+  CommentCount = 'CommentCount',
+  // (undocumented)
+  CreatedBy = 'CreatedBy',
+  // (undocumented)
+  CreatedOn = 'CreatedOn',
+  // (undocumented)
+  LatestCommit = 'LatestCommit',
+  // (undocumented)
+  LinkIcon = 'LinkIcon',
+  // (undocumented)
+  ModifiedBy = 'ModifiedBy',
+  // (undocumented)
+  ModifiedOn = 'ModifiedOn',
+  // (undocumented)
+  Preview = 'Preview',
+  // (undocumented)
+  Priority = 'Priority',
+  // (undocumented)
+  ProgrammingLanguage = 'ProgrammingLanguage',
+  // (undocumented)
+  Provider = 'Provider',
+  // (undocumented)
+  ReactCount = 'ReactCount',
+  // (undocumented)
+  Snippet = 'Snippet',
+  // (undocumented)
+  SourceBranch = 'SourceBranch',
+  // (undocumented)
+  State = 'State',
+  // (undocumented)
+  SubscriberCount = 'SubscriberCount',
+  // (undocumented)
+  TargetBranch = 'TargetBranch',
+  // (undocumented)
+  Title = 'Title',
+  // (undocumented)
+  ViewCount = 'ViewCount',
+  // (undocumented)
+  VoteCount = 'VoteCount',
+}
+
+export { EmbedCardAdf };
+
+// @public (undocumented)
+export const embedHeaderHeight = 32;
+
+// @public (undocumented)
+export class EmbedResizeMessageListener extends React_2.Component<
+  Props,
+  State
+> {
+  // (undocumented)
+  componentDidMount(): void;
+  // (undocumented)
+  componentWillUnmount(): void;
+  // (undocumented)
+  render(): React_2.ReactNode;
+}
+
+// @public
+export const FooterBlock: React_2.FC<FooterBlockProps>;
+
+export { InlineCardAdf };
+
+// @public (undocumented)
+export const loadingPlaceholderClassName = 'smart-link-loading-placeholder';
+
+// @public
+export const MetadataBlock: React_2.FC<MetadataBlockProps>;
+
+// @public (undocumented)
+export const metadataListClassName = 'smart-link-metadata-list';
+
+// @public
+export const PreviewBlock: React_2.FC<PreviewBlockProps>;
+
+export { Provider };
+
+export { ProviderProps };
+
+// @public (undocumented)
+export type ResolveResponse = JsonLd.Response;
+
+export { SmartCardContext as Context };
+export { SmartCardContext };
+
+// @public
+export enum SmartLinkDirection {
+  // (undocumented)
+  Horizontal = 'horizontal',
+  // (undocumented)
+  Vertical = 'vertical',
+}
+
+// @public (undocumented)
+export class SmartLinkEvents {
+  // (undocumented)
+  insertSmartLink(
+    url: string,
+    type: CardInnerAppearance,
+    createAnalyticsEvent?: CreateUIAnalyticsEvent,
+  ): void;
+}
+
+// @public
+export enum SmartLinkPosition {
+  // (undocumented)
+  Center = 'center',
+  // (undocumented)
+  Top = 'top',
+}
+
+// @public
+export enum SmartLinkSize {
+  // (undocumented)
+  Large = 'large',
+  // (undocumented)
+  Medium = 'medium',
+  // (undocumented)
+  Small = 'small',
+  // (undocumented)
+  XLarge = 'xlarge',
+}
+
+// @public
+export enum SmartLinkTheme {
+  // (undocumented)
+  Black = 'black',
+  // (undocumented)
+  Link = 'link',
+}
+
+// @public
+export const SnippetBlock: React_2.FC<SnippetBlockProps>;
+
+// @public
+export const TitleBlock: React_2.FC<TitleBlockProps>;
+
+// @public
+export const useSmartLinkAnalytics: (
+  url: string,
+  dispatchAnalytics: AnalyticsHandler,
+  id?: string | undefined,
+  defaultLocation?: string | undefined,
+) => {
+  ui: {
+    authEvent: (
+      display: CardInnerAppearance,
+      definitionId?: string | undefined,
+      extensionKey?: string | undefined,
+    ) => void;
+    authAlternateAccountEvent: (
+      display: CardInnerAppearance,
+      definitionId?: string | undefined,
+      extensionKey?: string | undefined,
+    ) => void;
+    cardClickedEvent: (
+      id: string | undefined,
+      display: CardInnerAppearance,
+      status: CardType,
+      definitionId?: string | undefined,
+      extensionKey?: string | undefined,
+      isModifierKeyPressed?: boolean | undefined,
+      location?: string | undefined,
+      destinationProduct?: DestinationProduct | string | undefined,
+      destinationSubproduct?: DestinationSubproduct | string | undefined,
+      actionSubjectId?: string | undefined,
+    ) => void;
+    actionClickedEvent: (
+      id: string | undefined,
+      extensionKey: string | undefined,
+      actionType: string,
+      display: CardInnerAppearance,
+      invokeType: InvokeType,
+    ) => void;
+    hoverCardOpenLinkClickedEvent: (
+      previewDisplay: PreviewDisplay,
+      definitionId?: string | undefined,
+      extensionKey?: string | undefined,
+      previewInvokeMethod?: PreviewInvokeMethod | undefined,
+    ) => void;
+    closedAuthEvent: (
+      display: CardInnerAppearance,
+      definitionId?: string | undefined,
+      extensionKey?: string | undefined,
+    ) => void;
+    renderSuccessEvent: (
+      display: CardInnerAppearance,
+      status: CardType,
+      id?: string,
+      definitionId?: string | undefined,
+      extensionKey?: string | undefined,
+    ) => void;
+    hoverCardViewedEvent: (
+      previewDisplay: PreviewDisplay,
+      previewInvokeMethod?: PreviewInvokeMethod | undefined,
+      id?: string,
+      definitionId?: string | undefined,
+      extensionKey?: string | undefined,
+    ) => void;
+    hoverCardDismissedEvent: (
+      previewDisplay: PreviewDisplay,
+      hoverTime: number,
+      previewInvokeMethod?: PreviewInvokeMethod | undefined,
+      id?: string,
+      definitionId?: string | undefined,
+      extensionKey?: string | undefined,
+    ) => void;
+  };
+  operational: {
+    invokeSucceededEvent: (
+      id: string | undefined,
+      extensionKey: string | undefined,
+      actionType: string,
+      display: CardInnerAppearance,
+    ) => void;
+    invokeFailedEvent: (
+      id: string | undefined,
+      providerKey: string | undefined,
+      actionType: string,
+      display: CardInnerAppearance,
+      reason: string,
+    ) => void;
+    connectSucceededEvent: (
+      id?: string,
+      definitionId?: string | undefined,
+      extensionKey?: string | undefined,
+    ) => void;
+    connectFailedEvent: (
+      id?: string,
+      definitionId?: string | undefined,
+      extensionKey?: string | undefined,
+      reason?: string | undefined,
+    ) => void;
+    instrument: (
+      id: string | undefined,
+      status: CardType,
+      definitionId?: string | undefined,
+      extensionKey?: string | undefined,
+      resourceType?: string | undefined,
+      error?: APIError | undefined,
+    ) => void;
+  };
+  track: {
+    appAccountConnected: (
+      definitionId?: string | undefined,
+      extensionKey?: string | undefined,
+    ) => void;
+  };
+  screen: {
+    authPopupEvent: (
+      definitionId?: string | undefined,
+      extensionKey?: string | undefined,
+    ) => void;
+  };
+};
+
+// @public (undocumented)
+export function useSmartLinkEvents(): SmartLinkEvents;
+
+// (No @packageDocumentation comment for this package)
+```