@atlaskit/smart-card 18.0.22 → 19.0.2

package/dist/cjs/view/FlexibleCard/components/elements/link/index.js

@@ -63,9 +63,9 @@ var getMaxLines = function getMaxLines(maxLines) {
   return maxLines;
 };
 /**
- * An element that represent.
- * @public
- * @param {LinkProps} LinkProps - The props necessary for the Icon element.
+ * A base element that represent an anchor.
+ * @internal
+ * @param {LinkProps} LinkProps - The props necessary for the Link element.
  * @see LinkIcon
  */
 

package/dist/cjs/view/FlexibleCard/components/elements/lozenge/index.js

@@ -19,8 +19,8 @@ var _templateObject;
 
 var styles = (0, _core.css)(_templateObject || (_templateObject = (0, _taggedTemplateLiteral2.default)(["\n  line-height: inherit;\n"])));
 /**
- * An element that displays a Lozenge.
- * @public
+ * A base element that displays a Lozenge.
+ * @internal
  * @param {LozengeProps} LozengeProps - The props necessary for the Lozenge element.
  * @see State
  */

package/dist/cjs/view/FlexibleCard/components/elements/media/index.js

@@ -29,8 +29,8 @@ var _templateObject;
  */
 var styles = (0, _core.css)(_templateObject || (_templateObject = (0, _taggedTemplateLiteral2.default)(["\n  aspect-ratio: 16 / 9;\n  display: flex;\n  width: 100%;\n\n  // fallback\n  @supports not (aspect-ratio: auto) {\n    padding-top: 56.25%; // 16:9 ratio (9 / 16 = 0.5625)\n    height: 0;\n    position: relative;\n    overflow: hidden;\n  }\n\n  > img {\n    min-height: 100%;\n    min-width: 100%;\n    max-height: 100%;\n    max-width: 100%;\n    object-fit: cover;\n    object-position: center center;\n\n    // fallback\n    @supports not (aspect-ratio: auto) {\n      position: absolute;\n      transform: translate(-50%, -50%);\n      left: 50%;\n      top: 50%;\n      width: auto;\n      height: auto;\n    }\n  }\n"])));
 /**
- * An element that displays a Media.
- * @public
+ * A base element that displays a Media.
+ * @internal
  * @param {MediaProps} MediaProps - The props necessary for the Media element.
  * @see Preview
  */

package/dist/cjs/view/FlexibleCard/components/elements/text/index.js

@@ -23,8 +23,8 @@ var getStyles = function getStyles(maxLines) {
   return (0, _core.css)(_templateObject || (_templateObject = (0, _taggedTemplateLiteral2.default)(["\n  color: ", ";\n  font-size: 0.75rem;\n  line-height: 1rem;\n  ", "\n"])), _token.tokens.text, (0, _utils.getTruncateStyles)(maxLines));
 };
 /**
- * An element that displays some Text.
- * @public
+ * A base element that displays some Text.
+ * @internal
  * @param {TextProps} TextProps - The props necessary for the Text element.
  * @see Title
  */

package/dist/es2019/client/index.js

@@ -1,214 +1 @@
-import _defineProperty from "@babel/runtime/helpers/defineProperty";
-// import setimmediate to temporary fix dataloader 2.0.0 bug
-// @see https://github.com/graphql/dataloader/issues/249
-import 'setimmediate';
-import DataLoader from 'dataloader';
-import retry from 'async-retry';
-import * as api from './api';
-import { APIError } from './errors';
-import { getResolverUrl } from './utils/environments';
-import pThrottle from 'p-throttle';
-import { isSuccessfulResponse, isErrorResponse } from './types/responses';
-const MAX_BATCH_SIZE = 50;
-const MIN_TIME_BETWEEN_BATCHES = 250;
-export default class CardClient {
-  constructor(envKey) {
-    _defineProperty(this, "batchResolve", async urls => {
-      // De-duplicate requested URLs (see `this.createLoader` for more detail).
-      const deDuplicatedUrls = [...new Set(urls)];
-      let resolvedUrls = [];
-
-      try {
-        // Ask the backend to resolve the URLs for us.
-        resolvedUrls = await api.request('post', `${this.resolverUrl}/resolve/batch`, deDuplicatedUrls.map(resourceUrl => ({
-          resourceUrl
-        })));
-      } catch (error) {
-        // we make sure we return a valid dataloader response by creating an error
-        // response for each url
-        resolvedUrls = urls.map(() => {
-          const status = isErrorResponse(error) ? error.status : 500;
-          const errorResponse = {
-            status,
-            error
-          };
-          return errorResponse;
-        });
-      } // Reduce into a map to make accessing faster and easier.
-
-
-      const map = {}; // NOTE: the batch endpoint returns the URLs in the same order they were given.
-
-      for (let i = 0; i < deDuplicatedUrls.length; ++i) {
-        const url = deDuplicatedUrls[i];
-        const data = resolvedUrls[i];
-        map[url] = data;
-      } // Reconvert list back into the original order in which it was given to us.
-
-
-      return urls.map(originalUrl => map[originalUrl]);
-    });
-
-    this.resolverUrl = getResolverUrl(envKey);
-    this.loadersByDomain = {};
-    this.retryConfig = {
-      retries: 2
-    };
-    this.resolvedCache = {};
-  }
-
-  createLoader() {
-    const batchResolveThrottler = pThrottle({
-      limit: 1,
-      interval: MIN_TIME_BETWEEN_BATCHES
-    });
-    const throttledBatchResolve = batchResolveThrottler(this.batchResolve);
-    return new DataLoader( // We place all calls to `batchResolve` in a limiter so we don't send off several simultaneous batch requests.
-    // This is for two reasons:
-    //  1: we want to avoid getting rate limited upstream (eg: forge and other APIs)
-    //  2: we want to avoid sending out heaps of requests from the client at once
-    urls => throttledBatchResolve(urls), {
-      maxBatchSize: MAX_BATCH_SIZE,
-      // NOTE: we turn off DataLoader's cache because it doesn't work for our use-case. Consider the following:
-      // - a smartlink to a restricted item is resolved to "forbidden" with a "request access button"
-      // - the user clicks "request access", and then following the auth prompts and gets access
-      // - the frontend now re-renders the smartlink, but due to DataLoader's caching, the previous "forbidden" state is
-      //   because the smartlink's URL (which is the cache key) is exactly the same
-      //
-      // For this reason, we disable DataLoader's cache.
-      // This means that URLs will not be de-duplicated by DataLoader, so we perform the de-duplication logic
-      // ourselves in `this.batchResolve`.
-      cache: false
-    });
-  }
-
-  getLoader(hostname) {
-    if (!this.loadersByDomain[hostname]) {
-      this.loadersByDomain[hostname] = this.createLoader();
-    }
-
-    return this.loadersByDomain[hostname];
-  }
-
-  async prefetchData(url) {
-    // 1. Queue the URL as part of a dataloader batch.
-    const hostname = new URL(url).hostname;
-    const loader = this.getLoader(hostname);
-    const response = await loader.load(url);
-
-    if (isSuccessfulResponse(response)) {
-      // 2. If the URL resolves, send it back.
-      return response.body;
-    } else {
-      try {
-        // 3. If the URL does not resolve, retry it with exponential backoff.
-        // This is done so that we avoid the scenario where users are unable to
-        // see a resolved Smart Link, when their expectation is to be able to.
-        const retriedResponse = await retry(async () => {
-          // We check if the link has resolved in the cache and stop trying if so.
-          // We do this by triggering an error that the link has already been resolved.
-          // This cascades <retryCount> times after which it is handled like a normal
-          // 'error', returning `undefined`.
-          if (!this.resolvedCache[url]) {
-            const response = await loader.load(url);
-
-            if (isSuccessfulResponse(response)) {
-              return response;
-            } else {
-              throw new Error('Retry for URL failed');
-            }
-          } else {
-            // Short-circuit each of the retries, as described above.
-            throw new Error('Retry unneeded - link has been resolved.');
-          }
-        }, this.retryConfig); // Trigger callback after successful backoff.
-
-        return retriedResponse.body;
-      } catch (err) {
-        // Do nothing in the case of an error - prefetching
-        // failures should be silent. Once a link is visible,
-        // it will be re-fetched anyhow, in which case a
-        // user-facing error is required.
-        return undefined;
-      }
-    }
-  }
-
-  async fetchData(url) {
-    const hostname = new URL(url).hostname;
-    const loader = this.getLoader(hostname);
-    const response = await loader.load(url);
-
-    if (!isSuccessfulResponse(response)) {
-      // Catch non-200 server responses to fallback or return useful information.
-      if (response.error) {
-        const errorType = response.error.type;
-        const errorMessage = response.error.message; // this means there was a network error and we fallback to blue link
-        // without impacting SLO's
-
-        if (response.error instanceof api.NetworkError) {
-          throw new APIError('fallback', hostname, errorMessage, errorType);
-        }
-
-        switch (errorType) {
-          // BadRequestError - indicative of an API error, render
-          // a blue link to mitigate customer impact.
-          case 'ResolveBadRequestError':
-            throw new APIError('fallback', hostname, errorMessage, errorType);
-          // AuthError - if the user logs in, we may be able
-          // to recover. Render an unauthorized card.
-
-          case 'ResolveAuthError':
-            throw new APIError('auth', hostname, errorMessage, errorType);
-          // UnsupportedError - we do not know how to render this URL.
-          // Bail out and ask the Editor to render as a blue link.
-
-          case 'ResolveUnsupportedError':
-            // URL isn't supported
-            throw new APIError('fatal', hostname, errorMessage, errorType);
-          // ResolveFailedError - link resolver may have failed.
-          // We could recover on re-resolve; render with fallback state.
-
-          case 'ResolveFailedError':
-            // Timeouts
-            throw new APIError('error', hostname, errorMessage, errorType);
-          // TimeoutError - link resolver may be taking a long time.
-          // We could recover on re-resolve; render with fallback state.
-
-          case 'ResolveTimeoutError':
-            // Timeouts
-            throw new APIError('error', hostname, errorMessage, errorType);
-          // InternalServerError - API call failed.
-          // We may recover later; render with fallback state.
-
-          case 'InternalServerError':
-            // ORS failures
-            throw new APIError('error', hostname, errorMessage, errorType);
-        }
-      } // Catch all: we don't know this error, bail out.
-
-
-      throw new APIError('fatal', hostname, response.toString(), 'UnexpectedError');
-    } else {
-      // Set a flag in the `resolvedCache` for this URL. The intent of this is
-      // to ensure that the exponential backoff method in `prefetchData` does
-      // not continue to retry fetching for this URL, especially if it was previously
-      // in a failed state. Note: this scenario only occurs on initial page load, if the
-      // user scrolls through the page very fast. Once the URL is visible, prefetching
-      // no longer takes place.
-      this.resolvedCache[url] = true; // Return the JSON-LD response back up!
-
-      return response.body;
-    }
-  }
-
-  async postData(data) {
-    const request = {
-      key: data.key,
-      action: data.action,
-      context: data.context
-    };
-    return await api.request('post', `${this.resolverUrl}/invoke`, request);
-  }
-
-}
+export { CardClient as default } from '@atlaskit/link-provider';

package/dist/es2019/constants.js

@@ -109,9 +109,6 @@ export let ElementName;
   ElementName["AuthorGroup"] = "AuthorGroup";
   ElementName["CollaboratorGroup"] = "CollaboratorGroup";
   ElementName["CommentCount"] = "CommentCount";
-  ElementName["ViewCount"] = "ViewCount";
-  ElementName["ReactCount"] = "ReactCount";
-  ElementName["VoteCount"] = "VoteCount";
   ElementName["CreatedBy"] = "CreatedBy";
   ElementName["CreatedOn"] = "CreatedOn";
   ElementName["LinkIcon"] = "LinkIcon";
@@ -120,11 +117,14 @@ export let ElementName;
   ElementName["Preview"] = "Preview";
   ElementName["Priority"] = "Priority";
   ElementName["ProgrammingLanguage"] = "ProgrammingLanguage";
+  ElementName["Provider"] = "Provider";
+  ElementName["ReactCount"] = "ReactCount";
   ElementName["Snippet"] = "Snippet";
   ElementName["State"] = "State";
   ElementName["SubscriberCount"] = "SubscriberCount";
   ElementName["Title"] = "Title";
-  ElementName["Provider"] = "Provider";
+  ElementName["ViewCount"] = "ViewCount";
+  ElementName["VoteCount"] = "VoteCount";
 })(ElementName || (ElementName = {}));
 
 export let ActionName;

package/dist/es2019/extractors/embed/index.js

@@ -1,6 +1,6 @@
-import { extractPreview } from '@atlaskit/linking-common';
 import { extractLink, extractTitle } from '../common/primitives';
 import { extractProvider } from '../common/context';
+import { extractPreview } from '@atlaskit/linking-common';
 import { extractIsTrusted } from '../common/meta/extractIsTrusted';
 
 const extractEmbedPreview = (jsonLd, platform) => {

package/dist/es2019/index.js

@@ -1,9 +1,9 @@
 export { SmartCardProvider as Provider, SmartCardContext } from './state';
-export { EditorCardProvider, editorCardProvider } from './providers/editor';
-export { default as Client } from './client';
-export { APIError } from './client/errors';
+export { EditorCardProvider, editorCardProvider } from '@atlaskit/link-provider';
+export { APIError } from '@atlaskit/linking-common';
+export { CardClient as Client } from '@atlaskit/link-provider';
 export { Card } from './view/Card';
-export { default as Context } from './state/context';
+export { SmartCardContext as Context } from '@atlaskit/link-provider';
 export { EmbedResizeMessageListener } from './view/EmbedCard/EmbedResizeMessageListener';
 export { embedHeaderHeight } from './view/EmbedCard/components/styled';
 export { SmartLinkEvents } from './utils/analytics/analytics';

package/dist/es2019/state/actions/constants.js

@@ -1,9 +1,3 @@
-export const ACTION_PENDING = 'pending';
-export const ACTION_RESOLVING = 'resolving';
-export const ACTION_RESOLVED = 'resolved';
-export const ACTION_ERROR = 'errored';
-export const ACTION_ERROR_FALLBACK = 'fallback';
-export const ACTION_PRELOAD = 'preload';
 export const ANALYTICS_RESOLVING = 'resolving';
 export const ANALYTICS_ERROR = 'errored';
 export const ANALYTICS_FALLBACK = 'fallback';

package/dist/es2019/state/actions/index.js

@@ -1,11 +1,11 @@
 import { useMemo, useCallback } from 'react';
 import { auth } from '@atlaskit/outbound-auth-flow-client';
-import { cardAction } from './helpers';
+import { APIError } from '@atlaskit/linking-common';
+import { useSmartLinkContext } from '@atlaskit/link-provider';
+import { ACTION_PENDING, ACTION_RESOLVED, ACTION_ERROR, ACTION_ERROR_FALLBACK, cardAction } from '@atlaskit/linking-common';
 import { getDefinitionId, getByDefinitionId, getServices, getStatus, getExtensionKey } from '../helpers';
-import { ACTION_PENDING, ACTION_RESOLVED, ACTION_ERROR, ERROR_MESSAGE_OAUTH, ERROR_MESSAGE_FATAL, ACTION_ERROR_FALLBACK } from './constants';
-import { useSmartLinkContext } from '../context';
+import { ERROR_MESSAGE_OAUTH, ERROR_MESSAGE_FATAL } from './constants';
 import * as measure from '../../utils/performance';
-import { APIError } from '../../client/errors';
 import { getUnauthorizedJsonLd } from '../../utils/jsonld';
 import { addMetadataToExperience } from '../analytics';
 export const useSmartCardActions = (id, url, analytics) => {

package/dist/es2019/state/analytics/useSmartLinkAnalytics.js

@@ -1,5 +1,5 @@
-import { uiAuthEvent, uiAuthAlternateAccountEvent, uiCardClickedEvent, uiActionClickedEvent, uiClosedAuthEvent, uiRenderSuccessEvent, uiHoverCardViewedEvent, uiHoverCardDismissedEvent, uiHoverCardOpenLinkClickedEvent, resolvedEvent, unresolvedEvent, invokeSucceededEvent, invokeFailedEvent, connectSucceededEvent, connectFailedEvent, trackAppAccountConnected, screenAuthPopupEvent, instrumentEvent } from '../../utils/analytics';
 import { useMemo } from 'react';
+import { uiAuthEvent, uiAuthAlternateAccountEvent, uiCardClickedEvent, uiActionClickedEvent, uiClosedAuthEvent, uiRenderSuccessEvent, uiHoverCardViewedEvent, uiHoverCardDismissedEvent, uiHoverCardOpenLinkClickedEvent, resolvedEvent, unresolvedEvent, invokeSucceededEvent, invokeFailedEvent, connectSucceededEvent, connectFailedEvent, trackAppAccountConnected, screenAuthPopupEvent, instrumentEvent } from '../../utils/analytics';
 import { failUfoExperience, startUfoExperience, succeedUfoExperience } from './ufoExperiences';
 export const useSmartLinkAnalytics = dispatchAnalytics => {
   const ui = useMemo(() => ({

package/dist/es2019/state/config/index.js

@@ -1,4 +1,4 @@
-import { useSmartLinkContext } from '../context';
+import { useSmartLinkContext } from '@atlaskit/link-provider';
 export const useSmartLinkConfig = () => {
   const context = useSmartLinkContext();
 

package/dist/es2019/state/helpers.js

@@ -8,11 +8,6 @@ export const getByDefinitionId = (definitionId, store) => {
     return details && details.meta.definitionId === definitionId;
   });
 };
-export const getUrl = (store, url) => {
-  return store.getState()[url] || {
-    status: 'pending'
-  };
-};
 export const getClickUrl = (url, jsonLd) => {
   if (jsonLd && jsonLd.data) {
     const visitUrl = extractVisitUrl(jsonLd.data);

package/dist/es2019/state/hooks/usePrefetch.js

@@ -1,5 +1,5 @@
 import { useCallback } from 'react';
-import { useSmartLinkContext } from '../context';
+import { useSmartLinkContext } from '@atlaskit/link-provider';
 export function usePrefetch(url) {
   const {
     store,

package/dist/es2019/state/index.js

@@ -1,2 +1,2 @@
-export { SmartCardContext, SmartCardProvider, useSmartLinkContext } from './context';
+export { SmartCardContext, SmartCardProvider, useSmartLinkContext } from '@atlaskit/link-provider';
 export { useSmartLink, usePrefetch } from './hooks';

package/dist/es2019/state/renderers/index.js

@@ -1,5 +1,5 @@
 import { useMemo } from 'react';
-import { useSmartLinkContext } from '../context';
+import { useSmartLinkContext } from '@atlaskit/link-provider';
 export const useSmartLinkRenderers = () => {
   const context = useSmartLinkContext();
   let renderers = context === null || context === void 0 ? void 0 : context.renderers;

package/dist/es2019/state/store/index.js

@@ -1,6 +1,6 @@
 import { useEffect, useState } from 'react';
-import { useSmartLinkContext } from '../context';
-import { getUrl } from '../helpers';
+import { useSmartLinkContext } from '@atlaskit/link-provider';
+import { getUrl } from '@atlaskit/linking-common';
 export function useSmartCardState(url) {
   const {
     store

package/dist/es2019/utils/mocks.js

@@ -1,4 +1,4 @@
-import CardClient from '../client';
+import { CardClient } from '@atlaskit/link-provider';
 export const mockContext = {
   '@vocab': 'https://www.w3.org/ns/activitystreams#',
   atlassian: 'https://schema.atlassian.com/ns/vocabulary#',

package/dist/es2019/utils/test-utils.js

@@ -1,6 +1,6 @@
 import _extends from "@babel/runtime/helpers/extends";
 import React from 'react';
-import CardClient from '../client';
+import { CardClient } from '@atlaskit/link-provider';
 import { SmartCardProvider } from '../state';
 
 const Hook = props => {

package/dist/es2019/version.json

@@ -1,5 +1,5 @@
 {
 	"name": "@atlaskit/smart-card",
-	"version": "18.0.22",
+	"version": "19.0.2",
 	"sideEffects": false
 }

package/dist/es2019/view/CardWithUrl/component-lazy/LazyIntersectionObserverCard.js

@@ -2,7 +2,8 @@ import _extends from "@babel/runtime/helpers/extends";
 import React, { useCallback, useState } from 'react';
 import { usePrefetch } from '../../../state';
 import { CardWithUrlContent } from '../component';
-import { LoadingCardLink } from './LazyFallback'; // This property enables the intersection observer to be run once the
+import { LoadingCardLink } from './LazyFallback';
+import { startUfoExperience } from '../../../state/analytics/ufoExperiences'; // This property enables the intersection observer to be run once the
 // HTML element being observed is within `X` px of the target container it is
 // being compared to. Since the default container is the `document`, we set this
 // up to check once a Smart Link is within `X` px from the bottom of the viewport.
@@ -13,7 +14,8 @@ export function LazyIntersectionObserverCard(props) {
   const {
     showActions,
     appearance,
-    url
+    url,
+    id
   } = props;
   const prefetch = usePrefetch(url);
   const Component = appearance === 'inline' ? 'span' : 'div';
@@ -22,12 +24,13 @@ export function LazyIntersectionObserverCard(props) {
     const isVisible = entries.some(entry => entry.isIntersecting);
 
     if (isVisible) {
+      startUfoExperience('smart-link-rendered', id);
       setIsIntersecting(true);
       observer.disconnect();
     } else {
       prefetch();
     }
-  }, [prefetch]);
+  }, [prefetch, id]);
   const onRef = useCallback(element => {
     if (!element) {
       return;

package/dist/es2019/view/CardWithUrl/component-lazy/LazyLazilyRenderCard.js

@@ -1,15 +1,21 @@
 import _extends from "@babel/runtime/helpers/extends";
-import React from 'react';
+import React, { useState } from 'react';
 import LazilyRender from 'react-lazily-render';
 import { CardWithUrlContent } from '../component';
 import { LoadingCardLink } from './LazyFallback';
+import { startUfoExperience } from '../../../state/analytics/ufoExperiences';
 export function LazyLazilyRenderCard(props) {
   const {
     appearance,
     container,
-    showActions
+    showActions,
+    id
   } = props;
   const offset = Math.ceil(window.innerHeight / 4);
+  useState(() => {
+    // Start of experience when intersectionObserver is not supported.
+    startUfoExperience('smart-link-rendered', id);
+  });
   return /*#__PURE__*/React.createElement(LazilyRender, {
     offset: offset,
     component: appearance === 'inline' ? 'span' : 'div',

package/dist/es2019/view/CardWithUrl/loader.js

@@ -9,12 +9,7 @@ const LazyCardWithUrlContent = /*#__PURE__*/lazy(() => import(
 /* webpackChunkName: "@atlaskit-internal_smartcard-urlcardcontent" */
 './component-lazy/index'));
 export function CardWithURLRenderer(props) {
-  const [id] = useState(() => uuid()); // Equivalent to ComponentWillMount
-
-  useState(() => {
-    // We want to start timing of render event only once and right at the start
-    startUfoExperience('smart-link-rendered', id);
-  });
+  const [id] = useState(() => uuid());
   useEffect(() => {
     // ComponentWillUnmount
     return () => {
@@ -68,7 +63,10 @@ export function CardWithURLRenderer(props) {
     else {
       const errorInfo = {
         componentStack
-      };
+      }; // Start and fail the smart-link-rendered experience. If it has already
+      // been started nothing happens.
+
+      startUfoExperience('smart-link-rendered', id);
       failUfoExperience('smart-link-rendered', id);
       failUfoExperience('smart-link-authenticated', id);
       dispatchAnalytics(uiRenderFailedEvent(appearance, error, errorInfo));

package/dist/es2019/view/FlexibleCard/components/actions/action/index.js

@@ -84,8 +84,8 @@ export const sizeToSpacing = {
   [SmartLinkSize.XLarge]: 'default'
 };
 /**
- * An action that can be triggered with an on click.
- * @public
+ * A base action that can be triggered with an on click.
+ * @internal
  * @param {ActionProps} ActionProps - The props necessary for the Action.
  * @see DeleteAction
  * @see EditAction

package/dist/es2019/view/FlexibleCard/components/blocks/action-group/index.js

@@ -29,6 +29,7 @@ const styles = css`
 /**
  * Creates a group of Action components. Accepts an array of Actions, in addition to some styling
  * preferences.
+ * @internal
  * @param {ActionGroupProps} ActionGroupProps
  * @see Action
  */

package/dist/es2019/view/FlexibleCard/components/blocks/block/index.js

@@ -13,8 +13,9 @@ const getBlockStyles = (direction, size) => css`
   }
 `;
 /**
- * A block represents a collection of elements and actions that are arranged in a row.
- * All elements and actions should be contained within a Block.
+ * A block represents a collection of elements and actions that are arranged
+ * in a row. All elements and actions should be contained within a Block.
+ * @internal
  * @param {ActionGroupProps} ActionGroupProps
  * @see Action
  */

package/dist/es2019/view/FlexibleCard/components/blocks/element-group/index.js

@@ -30,6 +30,7 @@ export const getElementGroupStyles = (direction, size, align, width) => css`
 /**
  * Creates a group of Action components. Accepts an array of Actions, in addition to some styling
  * preferences.
+ * @internal
  * @param {ActionGroupProps} ActionGroupProps
  * @see Action
  */

package/dist/es2019/view/FlexibleCard/components/blocks/footer-block/index.js

@@ -8,6 +8,7 @@ import ActionGroup from '../action-group';
 /**
  * Represents a FooterBlock, designed to contain elements and actions that should appear
  * at the bottom of a link card.
+ * @public
  * @param {FooterBlockProps} FooterBlockProps
  * @see Block
  */

package/dist/es2019/view/FlexibleCard/components/blocks/metadata-block/index.js

@@ -63,6 +63,7 @@ const getMaxLines = maxLines => {
 /**
  * Represents a MetadataBlock, designed to contain groups of metadata in the form of elements.
  * Accepts an array of elements to be shown either primary (left hand side) or secondary (right hand side).
+ * @public
  * @param {MetadataBlockProps} MetadataBlockProps
  * @see Block
  */

package/dist/es2019/view/FlexibleCard/components/blocks/preview-block/index.js

@@ -5,6 +5,7 @@ import Block from '../block';
 import { Preview } from '../../elements';
 /**
  * Represents a PreviewBlock, which typically contains media or other large format content.
+ * @public
  * @param {PreviewBlock} PreviewBlock
  * @see Block
  */

package/dist/es2019/view/FlexibleCard/components/blocks/snippet-block/index.js

@@ -9,6 +9,7 @@ const MAXIMUM_MAX_LINES = 3;
 const MINIMUM_MAX_LINES = 1;
 /**
  * Represents a SnippetBlock, which is used to display longer form text content, like descriptions.
+ * @public
  * @param {SnippetBlock} SnippetBlock
  * @see Block
  */

package/dist/es2019/view/FlexibleCard/components/blocks/title-block/index.js

@@ -42,10 +42,11 @@ const getTitleBlockViewComponent = status => {
   }
 };
 /**
- * Represents a TitleBlock, which is the foundation of all Flexible Smart Links.
+ * Represents a TitleBlock, which is the foundation of Flexible UI.
  * This contains an icon, the link, and any associated metadata and actions in one block.
  * The TitleBlock will also render differently given the state of the smart link.
  * This can be found in the corresponding Resolving, Resolved and Errored views.
+ * @public
  * @param {TitleBlockProps} TitleBlockProps
  * @see Block
  * @see TitleBlockResolvingView