@digital-ai/dot-components 2.28.0 → 3.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@digital-ai/dot-components",
-  "version": "2.28.0",
+  "version": "3.1.0",
   "private": false,
   "license": "SEE LICENSE IN <LICENSE.md>",
   "contributors": [
@@ -40,6 +40,7 @@
   "author": "Matt Haff",
   "dependencies": {
     "@digital-ai/dot-icons": "latest",
+    "@digital-ai/dot-illustrations": "latest",
     "@emotion/react": "^11.10.4",
     "@emotion/styled": "^11.10.4",
     "@mui/material": "^5.2.5",

package/src/lib/components/alert-banner/AlertBanner.d.ts

@@ -15,5 +15,7 @@ export interface AlertBannerProps extends CommonProps {
     severity: AlertBannerSeverity;
     /** when specified, will control the text that is used inside the alert banner */
     textVariant?: TypographyVariant;
+    /** when specified, will control the width of the encapsulated Alert component */
+    width?: string;
 }
-export declare const DotAlertBanner: ({ action, ariaLabel, children, className, "data-pendoid": dataPendoId, "data-testid": dataTestId, onClose, roundedCorners, severity, textVariant, }: AlertBannerProps) => import("react/jsx-runtime").JSX.Element;
+export declare const DotAlertBanner: ({ action, ariaLabel, children, className, "data-pendoid": dataPendoId, "data-testid": dataTestId, onClose, roundedCorners, severity, textVariant, width, }: AlertBannerProps) => import("react/jsx-runtime").JSX.Element;

package/src/lib/components/empty-state/EmptyState.d.ts

@@ -3,6 +3,8 @@ import { CommonProps } from '../CommonProps';
 export interface EmptyStateProps extends CommonProps {
     /** primary button properties */
     buttonProps?: ButtonProps;
+    /** id of illustration to use, overrides imageSrc **/
+    illustrationId?: string;
     /** alt text of image */
     imageAltText?: string;
     /** location of image */
@@ -12,4 +14,4 @@ export interface EmptyStateProps extends CommonProps {
     /** title text displayed */
     title: string;
 }
-export declare const DotEmptyState: ({ ariaLabel, buttonProps, className, "data-testid": dataTestId, imageAltText, imageSrc, subtitle, title, }: EmptyStateProps) => import("react/jsx-runtime").JSX.Element;
+export declare const DotEmptyState: ({ ariaLabel, buttonProps, className, "data-testid": dataTestId, illustrationId, imageAltText, imageSrc, subtitle, title, }: EmptyStateProps) => import("react/jsx-runtime").JSX.Element;

package/src/lib/components/illustration/Illustration.d.ts

@@ -0,0 +1,18 @@
+import { CommonProps } from '../CommonProps';
+import { TooltipPlacement } from '../tooltip/Tooltip';
+import { ThemeOptions } from '../../theme-provider/ThemeProvider';
+export interface IllustrationProps extends CommonProps {
+    /** Alternative text for the illustration image **/
+    alt?: string;
+    /** The ID of the illustration to display on the img */
+    illustrationId: string;
+    /** The theme of the illustration (dark or light) **/
+    theme?: ThemeOptions;
+    /** Title text for the illustration image **/
+    title?: string;
+    /** Tooltip text displayed on hover */
+    tooltip?: string;
+    /** Placement for tooltip **/
+    tooltipPlacement?: TooltipPlacement;
+}
+export declare const DotIllustration: ({ alt, ariaLabel, ariaRole, className, "data-testid": dataTestId, illustrationId, theme, title, tooltip, tooltipPlacement, }: IllustrationProps) => import("react/jsx-runtime").JSX.Element;

package/src/lib/components/illustration/Illustration.styles.d.ts

@@ -0,0 +1,3 @@
+import '@digital-ai/dot-illustrations';
+export declare const rootClassName = "dot-illustration";
+export declare const StyledIllustration: import("styled-components").StyledComponent<"span", any, {}, never>;

package/src/lib/components/index.d.ts

@@ -32,7 +32,7 @@ export type { DividerOrientation, DividerProps, DividerVariant, } from './divide
 export type { BadgeProps, BadgeOverlap, BadgeVariant } from './badge';
 export type { TruncateWithTooltipProps } from './truncate-with-tooltip';
 export type { DraggableItem, DraggableListChangeHandler, } from './draggable-list';
-export type { SnackbarProps, SnackbarSeverity, SnackbarOrigin, } from './snackbar';
+export type { SnackbarProps, SnackbarSeverity, SnackbarOrigin, SnackbarPrimaryAction, SnackbarSecondaryAction, } from './snackbar';
 export type { CharactersLimit, InlineEditProps } from './inline-edit';
 export type { progressColorOptions, progressVariantOptions, ProgressProps, } from './progress';
 export type { FileItemProps, FileUploadError, FileUploadProps, ListItemFile, MappedFile, MappedListItemFile, } from './file-upload';
@@ -77,6 +77,7 @@ export { DotForm } from './form/Form';
 export { DotFormGroup } from './form-group/FormGroup';
 export { DotDynamicForm } from './dynamic-form/DynamicForm';
 export { DotIcon } from './icon/Icon';
+export { DotIllustration } from './illustration/Illustration';
 export { DotInlineEdit } from './inline-edit';
 export { DotInputText } from './input-form-fields/InputText';
 export { DotInputSelect } from './input-form-fields/InputSelect';

package/src/lib/components/snackbar/Snackbar.d.ts

@@ -2,11 +2,19 @@ import { ReactNode } from 'react';
 import { CommonProps } from '../CommonProps';
 import { SnackbarOrigin } from './';
 export type SnackbarSeverity = 'error' | 'warning' | 'info' | 'success';
+export interface SnackbarPrimaryAction {
+    label: string;
+    onClick: () => void;
+}
+export interface SnackbarSecondaryAction {
+    href: string;
+    label: string;
+}
 export interface SnackbarProps extends CommonProps {
-    /** Property used for creating a custom action button. */
-    action?: ReactNode;
     /** The anchor of the Snackbar. On smaller screens, the component grows to occupy all the available width, the horizontal alignment is ignored. */
     anchorOrigin?: SnackbarOrigin;
+    /** When specified, will set `top` property (in pixels) only for the vertical top origins  */
+    anchorOriginTop?: number;
     /** The number of milliseconds to wait before automatically closing the snackbar. If null is passed, then the snackbar never automatically closes. If the prop is not passed at all, then snackbars close after 10 seconds (except error snackbar which never closes automatically). */
     autoHideDuration?: number | null;
     /** The message the user sees once the alert displays. */
@@ -14,12 +22,16 @@ export interface SnackbarProps extends CommonProps {
     /** If false, then snackbar does not close when clicking away. True by default. */
     hideOnClickAway?: boolean;
     /** A callback to handle closing the alert. */
-    onClose?: () => void;
+    onClose: () => void;
     /** Boolean value to switch between opening and closing the alert. */
     open: boolean;
+    /** When specified, will render button underneath snackbar message */
+    primaryAction?: SnackbarPrimaryAction;
+    /** When specified, will render link next to primary action button */
+    secondaryAction?: SnackbarSecondaryAction;
     /** An alert level, indicating the importance of the message. */
     severity: SnackbarSeverity;
     /** Width of the encapsulated Alert component. */
     width?: string;
 }
-export declare const DotSnackbar: ({ action, anchorOrigin, ariaLabel, autoHideDuration, children, className, "data-testid": dataTestId, hideOnClickAway, onClose, open, severity, width, }: SnackbarProps) => import("react/jsx-runtime").JSX.Element;
+export declare const DotSnackbar: ({ anchorOrigin, anchorOriginTop, ariaLabel, autoHideDuration, children, className, "data-testid": dataTestId, hideOnClickAway, onClose, open, primaryAction, secondaryAction, severity, width, }: SnackbarProps) => import("react/jsx-runtime").JSX.Element;

package/src/lib/components/snackbar/Snackbar.styles.d.ts

@@ -2,7 +2,9 @@ import { Snackbar } from '@mui/material';
 import { SnackbarSeverity } from './Snackbar';
 export declare const rootClassName = "dot-snackbar";
 interface StyledProps {
+    $anchorOriginTop?: number;
     severity: SnackbarSeverity;
+    width?: string;
 }
 export declare const StyledSnackbar: import("styled-components").StyledComponent<typeof Snackbar, any, StyledProps, never>;
 export {};

package/src/lib/components/snackbar/index.d.ts

@@ -1,4 +1,4 @@
 export type { SnackbarOrigin } from '@mui/material';
-export type { SnackbarProps, SnackbarSeverity } from './Snackbar';
+export type { SnackbarProps, SnackbarSeverity, SnackbarPrimaryAction, SnackbarSecondaryAction, } from './Snackbar';
 export { DotSnackbar } from './Snackbar';
 export { DotSnackbarContainer, DotSnackbarProvider, useDotSnackbarContext, } from './SnackbarProvider';

package/src/lib/components/snackbar/utils/helpers.d.ts

@@ -0,0 +1,2 @@
+import { SnackbarSeverity } from '../Snackbar';
+export declare const getSnackbarTitleFromSeverity: (severity: SnackbarSeverity) => "Success" | "Warning" | "Error" | "Info";