@atlaskit/smart-card 26.34.4 → 26.35.1

package/dist/types-ts4.5/view/FlexibleCard/components/actions/action/action-button/types.d.ts

@@ -0,0 +1,10 @@
+/// <reference types="react" />
+import { SmartLinkSize } from '../../../../../../constants';
+import { ActionProps } from '../types';
+export type ActionButtonProps = ActionProps & {
+    iconAfter?: React.ReactChild;
+    iconBefore?: React.ReactChild;
+    isLoading?: boolean;
+    size: SmartLinkSize;
+    isDisabled?: boolean;
+};

package/dist/types-ts4.5/view/FlexibleCard/components/actions/action/action-dropdown-item/index.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import { ActionDropdownItemProps } from './types';
+declare const ActionDropdownItem: React.FC<ActionDropdownItemProps>;
+export default ActionDropdownItem;

package/dist/types-ts4.5/view/FlexibleCard/components/actions/action/action-dropdown-item/types.d.ts

@@ -0,0 +1,9 @@
+/// <reference types="react" />
+export type ActionDropdownItemProps = {
+    content?: React.ReactNode;
+    iconAfter?: React.ReactNode;
+    iconBefore?: React.ReactNode;
+    isLoading?: boolean;
+    onClick: () => any;
+    testId?: string;
+};

package/dist/types-ts4.5/view/FlexibleCard/components/actions/action/action-icon/index.d.ts

@@ -0,0 +1,5 @@
+/** @jsx jsx */
+import React from 'react';
+import { ActionIconProps } from './types';
+declare const ActionIcon: React.FC<ActionIconProps>;
+export default ActionIcon;

package/dist/types-ts4.5/view/FlexibleCard/components/actions/action/action-icon/types.d.ts

@@ -0,0 +1,8 @@
+import { ReactChild } from 'react';
+import { SmartLinkSize } from '../../../../../../constants';
+export type ActionIconProps = {
+    size?: SmartLinkSize;
+    icon?: ReactChild;
+    testId?: string;
+    isDisabled?: boolean;
+};

package/dist/types-ts4.5/view/FlexibleCard/components/actions/action/download-action/index.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import { DownloadActionProps } from './types';
+declare const DownloadAction: React.FC<DownloadActionProps>;
+export default DownloadAction;

package/dist/types-ts4.5/view/FlexibleCard/components/actions/action/download-action/types.d.ts

@@ -0,0 +1,5 @@
+import { ActionProps } from '../types';
+export type DownloadActionProps = ActionProps & {
+    downloadUrl?: string;
+    url: string;
+};

package/dist/types-ts4.5/view/FlexibleCard/components/actions/action/index.d.ts

@@ -0,0 +1,13 @@
+/** @jsx jsx */
+import React from 'react';
+import { ActionProps, InternalActionProps } from './types';
+/**
+ * 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
+ * @see CustomAction
+ */
+declare const Action: React.FC<ActionProps & InternalActionProps>;
+export default Action;

package/dist/types-ts4.5/view/FlexibleCard/components/actions/action/preview-action/index.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import { PreviewActionProps } from './types';
+declare const PreviewAction: React.FC<PreviewActionProps>;
+export default PreviewAction;

package/dist/types-ts4.5/view/FlexibleCard/components/actions/action/preview-action/types.d.ts

@@ -0,0 +1,12 @@
+import { Icon } from '../../../../../../state/flexible-ui-context/types';
+import { ActionProps } from '../types';
+export type PreviewActionProps = ActionProps & FlexibleEmbedProps;
+export type FlexibleEmbedProps = {
+    downloadUrl?: string;
+    linkIcon?: Icon;
+    providerName?: string;
+    src?: string;
+    title?: string;
+    url: string;
+    isSupportTheming?: boolean;
+};

package/dist/types-ts4.5/view/FlexibleCard/components/actions/action/server-action/index.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import { ServerActionProps } from './types';
+declare const ServerAction: React.FC<ServerActionProps>;
+export default ServerAction;

package/dist/types-ts4.5/view/FlexibleCard/components/actions/action/server-action/types.d.ts

@@ -0,0 +1,6 @@
+import { ActionProps } from '../types';
+import { InvokeRequestWithCardDetails } from '../../../../../../state/hooks/use-invoke/types';
+export type ServerActionProps = Omit<ActionProps, 'onClick'> & {
+    action?: InvokeRequestWithCardDetails;
+    onClick?: ActionProps['onClick'];
+};

package/dist/types-ts4.5/view/FlexibleCard/components/actions/action/types.d.ts

@@ -0,0 +1,64 @@
+import { SerializedStyles } from '@emotion/react';
+import { SmartLinkSize } from '../../../../../constants';
+import { Appearance } from '@atlaskit/button/types';
+import { ReactChild } from 'react';
+export type ActionProps = {
+    /**
+     * Determines the size of the Action. Corresponds to an Action appearance.
+     */
+    size?: SmartLinkSize;
+    /**
+     * Determines the text content of the Action.
+     */
+    content?: React.ReactNode;
+    /**
+     * Determines the appearance of the action. Corresponds to the Atlaskit action appearance.
+     */
+    appearance?: Appearance;
+    /**
+     * Determines the onClick behaviour of the Action.
+     */
+    onClick: () => any;
+    /**
+     * Determines the icon rendered within the Action.
+     */
+    icon?: ReactChild;
+    /**
+     * Determines where the icon should be rendered if text is provided.
+     */
+    iconPosition?: 'before' | 'after';
+    /**
+     * Determines the tooltip message when hovering over the Action.
+     */
+    tooltipMessage?: React.ReactNode;
+    /**
+     * Used to determine whether the Action is in a Dropdown.
+     */
+    asDropDownItem?: boolean;
+    /**
+     * Additional CSS properties on the Action.
+     */
+    overrideCss?: SerializedStyles;
+    /**
+     * A `testId` prop is provided for specified elements, which is a unique
+     * string that appears as a data attribute `data-testid` in the rendered code,
+     * serving as a hook for automated tests
+     */
+    testId?: string;
+    /**
+     * Determines whether the button displays as disabled.
+     */
+    isDisabled?: boolean;
+};
+/**
+ * The internal props that should only be controlled by internal components
+ * and/or used by experiment. If there is a use case where these props/feature
+ * should be available as part of smart-card, please move them to ActionProps.
+ */
+export type InternalActionProps = {
+    /**
+     * Conditionally show a spinner over the top of a button or disable a dropdown item
+     * while server action is executing.
+     */
+    isLoading?: boolean;
+};

package/dist/types-ts4.5/view/FlexibleCard/components/actions/action/view-action/index.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import { ViewActionProps } from './types';
+declare const ViewAction: React.FC<ViewActionProps>;
+export default ViewAction;

package/dist/types-ts4.5/view/FlexibleCard/components/actions/action/view-action/types.d.ts

@@ -0,0 +1,5 @@
+import { ActionProps } from '../types';
+export type ViewActionProps = ActionProps & {
+    viewUrl?: string;
+    url: string;
+};

package/dist/types-ts4.5/view/FlexibleCard/components/actions/follow-action/index.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import type { ActionProps } from '../action/types';
+declare const FollowAction: React.FC<ActionProps>;
+export default FollowAction;

package/dist/types-ts4.5/view/FlexibleCard/components/actions/follow-action/unfollow-icon/index.d.ts

@@ -0,0 +1,4 @@
+/// <reference types="react" />
+import { type IconProps } from '@atlaskit/icon';
+declare const UnfollowIcon: (props: IconProps) => JSX.Element;
+export default UnfollowIcon;

package/dist/types-ts4.5/view/FlexibleCard/components/actions/index.d.ts

@@ -0,0 +1,42 @@
+/// <reference types="react" />
+import { ActionProps } from './action/types';
+import { PreviewActionProps } from './action/preview-action/types';
+import { ViewActionProps } from './action/view-action/types';
+import { DownloadActionProps } from './action/download-action/types';
+export { default as FollowAction } from './follow-action';
+/**
+ * Creates a DeleteAction component. Accepts default ActionProps, but defaults
+ * the icon to a cross icon.
+ * @see Action
+ */
+export declare const DeleteAction: import("react").FC<ActionProps>;
+/**
+ * Creates a EditAction component. Accepts default ActionProps, but defaults
+ * the icon to an edit (pencil) icon.
+ * @see Action
+ */
+export declare const EditAction: import("react").FC<ActionProps>;
+/**
+ * Creates a PreviewAction component. Accepts default PreviewActionProps, and defaults
+ * to the text 'Preview' inside the button.
+ * @see Action
+ */
+export declare const PreviewAction: import("react").FC<PreviewActionProps>;
+/**
+ * Creates a ViewAction component. Accepts default ViewActionProps, and defaults
+ * to the text 'View' inside the button.
+ * @see Action
+ */
+export declare const ViewAction: import("react").FC<ViewActionProps>;
+/**
+ * Creates a DownloadAction component. Accepts default DownloadActionProps, and defaults
+ * to the text 'Download' inside the button.
+ * @see Action
+ */
+export declare const DownloadAction: import("react").FC<DownloadActionProps>;
+/**
+ * Creates a CustomAction component. Accepts default ActionProps. Required to provide
+ * your own icon or text.
+ * @see Action
+ */
+export declare const CustomAction: import("react").FC<ActionProps>;

package/dist/types-ts4.5/view/FlexibleCard/components/actions/utils.d.ts

@@ -0,0 +1,4 @@
+import { ActionName } from '../../../../constants';
+import React from 'react';
+export declare const createDataAction: <P extends {}>(name: ActionName) => React.FC<P>;
+export declare const createUIAction: <P extends {}>(name: ActionName) => React.FC<P>;

package/dist/types-ts4.5/view/FlexibleCard/components/blocks/action-group/action-group-item/index.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+import { Appearance } from '@atlaskit/button';
+import { SmartLinkSize } from '../../../../../../constants';
+import { ActionItem } from '../../types';
+declare const ActionGroupItem: React.FC<{
+    item: ActionItem;
+    size: SmartLinkSize;
+    appearance?: Appearance;
+    asDropDownItems?: boolean;
+    onActionItemClick?: () => void;
+}>;
+export default ActionGroupItem;

package/dist/types-ts4.5/view/FlexibleCard/components/blocks/action-group/index.d.ts

@@ -0,0 +1,11 @@
+/// <reference types="react" />
+import { ActionGroupProps } from './types';
+/**
+ * Creates a group of Action components. Accepts an array of Actions, in addition to some styling
+ * preferences.
+ * @internal
+ * @param {ActionGroupProps} ActionGroupProps
+ * @see Action
+ */
+declare const ActionGroup: React.FC<ActionGroupProps>;
+export default ActionGroup;

package/dist/types-ts4.5/view/FlexibleCard/components/blocks/action-group/types.d.ts

@@ -0,0 +1,37 @@
+import { SmartLinkSize, SmartLinkDirection } from '../../../../../constants';
+import { ActionItem } from '../types';
+import { Appearance } from '@atlaskit/button';
+export type ActionGroupProps = {
+    /**
+     * Determines the actions within the Action Group.
+     */
+    items: ActionItem[];
+    /**
+     * Determines the default size of the actions within the Action Group.
+     */
+    size?: SmartLinkSize;
+    /**
+     * Determines the direction that the actions are rendered. Can be vertical
+     * or horizontal.
+     */
+    direction?: SmartLinkDirection;
+    /**
+     * Determines the default appearance of the Action Group.
+     */
+    appearance?: Appearance;
+    /**
+     * Determines the maximum number of singular actions that should be rendered
+     * before collapsing all actions into a Dropdown.
+     */
+    visibleButtonsNum?: number;
+    /**
+     * Called when the action dropdown menu (if present) is open/closed.
+     */
+    onDropdownOpenChange?: (isOpen: boolean) => void;
+    /**
+     * A `testId` prop is provided for specified elements, which is a unique
+     * string that appears as a data attribute `data-testid` in the rendered code,
+     * serving as a hook for automated tests
+     */
+    testId?: string;
+};

package/dist/types-ts4.5/view/FlexibleCard/components/blocks/block/index.d.ts

@@ -0,0 +1,12 @@
+/** @jsx jsx */
+import React from 'react';
+import { BlockProps } from '../types';
+/**
+ * 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
+ */
+declare const Block: React.FC<BlockProps>;
+export default Block;

package/dist/types-ts4.5/view/FlexibleCard/components/blocks/element-group/index.d.ts

@@ -0,0 +1,15 @@
+/** @jsx jsx */
+import React from 'react';
+import { SerializedStyles } from '@emotion/react';
+import { ElementGroupProps } from './types';
+import { SmartLinkAlignment, SmartLinkDirection, SmartLinkPosition, SmartLinkSize, SmartLinkWidth } from '../../../../../constants';
+export declare const getElementGroupStyles: (direction: SmartLinkDirection, size: SmartLinkSize, align: SmartLinkAlignment, width: SmartLinkWidth, position: SmartLinkPosition) => SerializedStyles;
+/**
+ * Creates a group of Action components. Accepts an array of Actions, in addition to some styling
+ * preferences.
+ * @internal
+ * @param {ActionGroupProps} ActionGroupProps
+ * @see Action
+ */
+declare const ElementGroup: React.FC<ElementGroupProps>;
+export default ElementGroup;

package/dist/types-ts4.5/view/FlexibleCard/components/blocks/element-group/types.d.ts

@@ -0,0 +1,11 @@
+import { SerializedStyles } from '@emotion/react';
+import { SmartLinkAlignment, SmartLinkDirection, SmartLinkPosition, SmartLinkSize, SmartLinkWidth } from '../../../../../constants';
+export type ElementGroupProps = {
+    align?: SmartLinkAlignment;
+    direction?: SmartLinkDirection;
+    overrideCss?: SerializedStyles;
+    size?: SmartLinkSize;
+    width?: SmartLinkWidth;
+    testId?: string;
+    position?: SmartLinkPosition;
+};

package/dist/types-ts4.5/view/FlexibleCard/components/blocks/footer-block/index.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+import { FooterBlockProps } from './types';
+/**
+ * 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
+ */
+declare const FooterBlock: React.FC<FooterBlockProps>;
+export default FooterBlock;

package/dist/types-ts4.5/view/FlexibleCard/components/blocks/footer-block/types.d.ts

@@ -0,0 +1,15 @@
+import { ActionItem, BlockProps } from '../types';
+import { OnActionMenuOpenChangeOptions } from '../types';
+export type FooterBlockProps = {
+    /**
+     * An array of actions to be displayed on the right.
+     * Adding more than three actions will result in the second and following
+     * actions being hidden inside of a dropdown
+     * @see ActionItem
+     */
+    actions?: ActionItem[];
+    /**
+     * Function to be called when footer action dropdown open state is changed.
+     */
+    onActionMenuOpenChange?: (options: OnActionMenuOpenChangeOptions) => void;
+} & BlockProps;

package/dist/types-ts4.5/view/FlexibleCard/components/blocks/index.d.ts

@@ -0,0 +1,6 @@
+export { default as FooterBlock } from './footer-block';
+export { default as MetadataBlock } from './metadata-block';
+export { default as PreviewBlock } from './preview-block';
+export { default as SnippetBlock } from './snippet-block';
+export { default as TitleBlock } from './title-block';
+export { default as CustomBlock } from './block';

package/dist/types-ts4.5/view/FlexibleCard/components/blocks/metadata-block/index.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+import { MetadataBlockProps } from './types';
+/**
+ * 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
+ */
+declare const MetadataBlock: React.FC<MetadataBlockProps>;
+export default MetadataBlock;

package/dist/types-ts4.5/view/FlexibleCard/components/blocks/metadata-block/types.d.ts

@@ -0,0 +1,26 @@
+import { BlockProps, ElementItem } from '../types';
+export type MetadataBlockProps = {
+    /**
+     * Determines the number of lines the metadata should span across.
+     * Default is 2. Maximum is 2.
+     */
+    maxLines?: number;
+    /**
+     * An array of metadata elements to display on the left.
+     * By default elements will be shown to the right of the TitleBlock.
+     * The visibility of the element is determine by the link data.
+     * If link contain no data to display a particular element, the element
+     * will simply not show up.
+     * @see ElementItem
+     */
+    primary?: ElementItem[];
+    /**
+     * An array of metadata elements to display on the right.
+     * By default elements will be shown to the right of the TitleBlock.
+     * The visibility of the element is determine by the link data.
+     * If link contain no data to display a particular element, the element
+     * will simply not show up.
+     * @see ElementItem
+     */
+    secondary?: ElementItem[];
+} & BlockProps;

package/dist/types-ts4.5/view/FlexibleCard/components/blocks/preview-block/index.d.ts

@@ -0,0 +1,11 @@
+/** @jsx jsx */
+import React from 'react';
+import { PreviewBlockProps } from './types';
+/**
+ * Represents a PreviewBlock, which typically contains media or other large format content.
+ * @public
+ * @param {PreviewBlockProps} PreviewBlock
+ * @see Block
+ */
+declare const PreviewBlock: React.FC<PreviewBlockProps>;
+export default PreviewBlock;

package/dist/types-ts4.5/view/FlexibleCard/components/blocks/preview-block/resolved/index.d.ts

@@ -0,0 +1,11 @@
+/** @jsx jsx */
+import React from 'react';
+import { PreviewBlockProps } from '../types';
+/**
+ * Represents a resolved PreviewBlock, which typically contains media or other large format content.
+ * @public
+ * @param {PreviewBlock} PreviewBlock
+ * @see Block
+ */
+declare const PreviewBlockResolvedView: React.FC<PreviewBlockProps>;
+export default PreviewBlockResolvedView;

package/dist/types-ts4.5/view/FlexibleCard/components/blocks/preview-block/types.d.ts

@@ -0,0 +1,27 @@
+import { BlockProps } from '../types';
+import { MediaPlacement } from '../../../../../constants';
+export type OnPreviewRenderOptions = {
+    placement?: MediaPlacement;
+};
+export type PreviewBlockProps = {
+    /**
+     * Indicate whether preview block should ignore the padding its parent container.
+     * Default is false.
+     */
+    ignoreContainerPadding?: boolean;
+    /**
+     * Function to be called on error loading media.
+     * @internal
+     */
+    onError?: () => void;
+    /**
+     * The placement of the preview block in relation of its container.
+     * This makes the preview block leave flex layout to absolute positioning
+     * to the left/right of the container.
+     */
+    placement?: MediaPlacement;
+    /**
+     * An image URL to render. This will replace the default image from smart link data.
+     */
+    overrideUrl?: string;
+} & BlockProps;

package/dist/types-ts4.5/view/FlexibleCard/components/blocks/snippet-block/index.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+import { SnippetBlockProps } from './types';
+/**
+ * Represents a SnippetBlock, which is used to display longer form text content, like descriptions.
+ * @public
+ * @param {SnippetBlock} SnippetBlock
+ * @see Block
+ */
+declare const SnippetBlock: React.FC<SnippetBlockProps>;
+export default SnippetBlock;

package/dist/types-ts4.5/view/FlexibleCard/components/blocks/snippet-block/types.d.ts

@@ -0,0 +1,8 @@
+import { BlockProps } from '../types';
+export type SnippetBlockProps = {
+    /**
+     * Determines the maximum lines the text within the snippet block should
+     * spread over. Default is 3. Maximum is 3.
+     */
+    maxLines?: number;
+} & BlockProps;

package/dist/types-ts4.5/view/FlexibleCard/components/blocks/title-block/errored/index.d.ts

@@ -0,0 +1,12 @@
+/** @jsx jsx */
+import React from 'react';
+import { TitleBlockViewProps } from '../types';
+/**
+ * Represents an Errored TitleBlock view.
+ * This will render when a Smart Link did not successfully resolve.
+ * This may be a result of a Smart Link not having the correct credentials,
+ * or the backend response was errored or malformed.
+ * @see TitleBlock
+ */
+declare const TitleBlockErroredView: React.FC<TitleBlockViewProps>;
+export default TitleBlockErroredView;

package/dist/types-ts4.5/view/FlexibleCard/components/blocks/title-block/index.d.ts

@@ -0,0 +1,16 @@
+import React from 'react';
+import { TitleBlockProps } from './types';
+/**
+ * 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
+ * @see TitleBlockResolvedView
+ * @see TitleBlockErroredView
+ */
+declare const TitleBlock: React.FC<TitleBlockProps>;
+export default TitleBlock;

package/dist/types-ts4.5/view/FlexibleCard/components/blocks/title-block/resolved/index.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import { TitleBlockViewProps } from '../types';
+/**
+ * This renders a fully resolved TitleBlock.
+ * This should render when a Smart Link returns a valid response.
+ * @see TitleBlock
+ */
+declare const TitleBlockResolvedView: React.FC<TitleBlockViewProps>;
+export default TitleBlockResolvedView;

package/dist/types-ts4.5/view/FlexibleCard/components/blocks/title-block/resolving/index.d.ts

@@ -0,0 +1,11 @@
+/** @jsx jsx */
+import React from 'react';
+import { TitleBlockViewProps } from '../types';
+/**
+ * This represents a TitleBlock for a Smart Link that is currently waiting
+ * for a request to finish.
+ * This should render when a Smart Link has sent a request.
+ * @see TitleBlock
+ */
+declare const TitleBlockResolvingView: React.FC<TitleBlockViewProps>;
+export default TitleBlockResolvingView;