@atlaskit/dynamic-table 14.13.1 → 14.15.0

package/dist/types/styled/dynamic-table.d.ts

@@ -2,6 +2,7 @@
 import { FC, HTMLProps, ReactNode } from 'react';
 export type TableProps = HTMLProps<HTMLTableElement> & {
     isFixedSize?: boolean;
+    isLoading?: boolean;
     hasDataRow: boolean;
     testId?: string;
 };
@@ -11,10 +12,11 @@ export declare const tableRowCSSVars: {
     CSS_VAR_HOVER_HIGHLIGHTED_BACKGROUND: string;
     CSS_VAR_ROW_FOCUS_OUTLINE: string;
 };
-export declare const Table: import("react").ForwardRefExoticComponent<Pick<TableProps, "headers" | "method" | "rows" | "isFixedSize" | "testId" | "label" | "cite" | "data" | "form" | "slot" | "span" | "style" | "summary" | "title" | "pattern" | "key" | "defaultChecked" | "defaultValue" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "accessKey" | "className" | "contentEditable" | "contextMenu" | "dir" | "draggable" | "hidden" | "id" | "lang" | "placeholder" | "spellCheck" | "tabIndex" | "translate" | "radioGroup" | "role" | "about" | "datatype" | "inlist" | "prefix" | "property" | "resource" | "typeof" | "vocab" | "autoCapitalize" | "autoCorrect" | "autoSave" | "color" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "results" | "security" | "unselectable" | "inputMode" | "is" | "aria-activedescendant" | "aria-atomic" | "aria-autocomplete" | "aria-busy" | "aria-checked" | "aria-colcount" | "aria-colindex" | "aria-colspan" | "aria-controls" | "aria-current" | "aria-describedby" | "aria-details" | "aria-disabled" | "aria-dropeffect" | "aria-errormessage" | "aria-expanded" | "aria-flowto" | "aria-grabbed" | "aria-haspopup" | "aria-hidden" | "aria-invalid" | "aria-keyshortcuts" | "aria-label" | "aria-labelledby" | "aria-level" | "aria-live" | "aria-modal" | "aria-multiline" | "aria-multiselectable" | "aria-orientation" | "aria-owns" | "aria-placeholder" | "aria-posinset" | "aria-pressed" | "aria-readonly" | "aria-relevant" | "aria-required" | "aria-roledescription" | "aria-rowcount" | "aria-rowindex" | "aria-rowspan" | "aria-selected" | "aria-setsize" | "aria-sort" | "aria-valuemax" | "aria-valuemin" | "aria-valuenow" | "aria-valuetext" | "children" | "dangerouslySetInnerHTML" | "onCopy" | "onCopyCapture" | "onCut" | "onCutCapture" | "onPaste" | "onPasteCapture" | "onCompositionEnd" | "onCompositionEndCapture" | "onCompositionStart" | "onCompositionStartCapture" | "onCompositionUpdate" | "onCompositionUpdateCapture" | "onFocus" | "onFocusCapture" | "onBlur" | "onBlurCapture" | "onChange" | "onChangeCapture" | "onBeforeInput" | "onBeforeInputCapture" | "onInput" | "onInputCapture" | "onReset" | "onResetCapture" | "onSubmit" | "onSubmitCapture" | "onInvalid" | "onInvalidCapture" | "onLoad" | "onLoadCapture" | "onError" | "onErrorCapture" | "onKeyDown" | "onKeyDownCapture" | "onKeyPress" | "onKeyPressCapture" | "onKeyUp" | "onKeyUpCapture" | "onAbort" | "onAbortCapture" | "onCanPlay" | "onCanPlayCapture" | "onCanPlayThrough" | "onCanPlayThroughCapture" | "onDurationChange" | "onDurationChangeCapture" | "onEmptied" | "onEmptiedCapture" | "onEncrypted" | "onEncryptedCapture" | "onEnded" | "onEndedCapture" | "onLoadedData" | "onLoadedDataCapture" | "onLoadedMetadata" | "onLoadedMetadataCapture" | "onLoadStart" | "onLoadStartCapture" | "onPause" | "onPauseCapture" | "onPlay" | "onPlayCapture" | "onPlaying" | "onPlayingCapture" | "onProgress" | "onProgressCapture" | "onRateChange" | "onRateChangeCapture" | "onSeeked" | "onSeekedCapture" | "onSeeking" | "onSeekingCapture" | "onStalled" | "onStalledCapture" | "onSuspend" | "onSuspendCapture" | "onTimeUpdate" | "onTimeUpdateCapture" | "onVolumeChange" | "onVolumeChangeCapture" | "onWaiting" | "onWaitingCapture" | "onAuxClick" | "onAuxClickCapture" | "onClick" | "onClickCapture" | "onContextMenu" | "onContextMenuCapture" | "onDoubleClick" | "onDoubleClickCapture" | "onDrag" | "onDragCapture" | "onDragEnd" | "onDragEndCapture" | "onDragEnter" | "onDragEnterCapture" | "onDragExit" | "onDragExitCapture" | "onDragLeave" | "onDragLeaveCapture" | "onDragOver" | "onDragOverCapture" | "onDragStart" | "onDragStartCapture" | "onDrop" | "onDropCapture" | "onMouseDown" | "onMouseDownCapture" | "onMouseEnter" | "onMouseLeave" | "onMouseMove" | "onMouseMoveCapture" | "onMouseOut" | "onMouseOutCapture" | "onMouseOver" | "onMouseOverCapture" | "onMouseUp" | "onMouseUpCapture" | "onSelect" | "onSelectCapture" | "onTouchCancel" | "onTouchCancelCapture" | "onTouchEnd" | "onTouchEndCapture" | "onTouchMove" | "onTouchMoveCapture" | "onTouchStart" | "onTouchStartCapture" | "onPointerDown" | "onPointerDownCapture" | "onPointerMove" | "onPointerMoveCapture" | "onPointerUp" | "onPointerUpCapture" | "onPointerCancel" | "onPointerCancelCapture" | "onPointerEnter" | "onPointerEnterCapture" | "onPointerLeave" | "onPointerLeaveCapture" | "onPointerOver" | "onPointerOverCapture" | "onPointerOut" | "onPointerOutCapture" | "onGotPointerCapture" | "onGotPointerCaptureCapture" | "onLostPointerCapture" | "onLostPointerCaptureCapture" | "onScroll" | "onScrollCapture" | "onWheel" | "onWheelCapture" | "onAnimationStart" | "onAnimationStartCapture" | "onAnimationEnd" | "onAnimationEndCapture" | "onAnimationIteration" | "onAnimationIterationCapture" | "onTransitionEnd" | "onTransitionEndCapture" | "default" | "width" | "height" | "content" | "hasDataRow" | "accept" | "acceptCharset" | "action" | "allowFullScreen" | "allowTransparency" | "alt" | "as" | "async" | "autoComplete" | "autoFocus" | "autoPlay" | "capture" | "cellPadding" | "cellSpacing" | "charSet" | "challenge" | "checked" | "classID" | "cols" | "colSpan" | "controls" | "coords" | "crossOrigin" | "dateTime" | "defer" | "disabled" | "download" | "encType" | "formAction" | "formEncType" | "formMethod" | "formNoValidate" | "formTarget" | "frameBorder" | "high" | "href" | "hrefLang" | "htmlFor" | "httpEquiv" | "integrity" | "keyParams" | "keyType" | "kind" | "list" | "loop" | "low" | "manifest" | "marginHeight" | "marginWidth" | "max" | "maxLength" | "media" | "mediaGroup" | "min" | "minLength" | "multiple" | "muted" | "name" | "nonce" | "noValidate" | "open" | "optimum" | "playsInline" | "poster" | "preload" | "readOnly" | "rel" | "required" | "reversed" | "rowSpan" | "sandbox" | "scope" | "scoped" | "scrolling" | "seamless" | "selected" | "shape" | "size" | "sizes" | "src" | "srcDoc" | "srcLang" | "srcSet" | "start" | "step" | "target" | "type" | "useMap" | "value" | "wmode" | "wrap"> & import("react").RefAttributes<HTMLTableElement>>;
+export declare const Table: import("react").ForwardRefExoticComponent<Pick<TableProps, "headers" | "method" | "rows" | "isLoading" | "isFixedSize" | "testId" | "label" | "cite" | "data" | "form" | "slot" | "span" | "style" | "summary" | "title" | "pattern" | "key" | "defaultChecked" | "defaultValue" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "accessKey" | "className" | "contentEditable" | "contextMenu" | "dir" | "draggable" | "hidden" | "id" | "lang" | "placeholder" | "spellCheck" | "tabIndex" | "translate" | "radioGroup" | "role" | "about" | "datatype" | "inlist" | "prefix" | "property" | "resource" | "typeof" | "vocab" | "autoCapitalize" | "autoCorrect" | "autoSave" | "color" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "results" | "security" | "unselectable" | "inputMode" | "is" | "aria-activedescendant" | "aria-atomic" | "aria-autocomplete" | "aria-busy" | "aria-checked" | "aria-colcount" | "aria-colindex" | "aria-colspan" | "aria-controls" | "aria-current" | "aria-describedby" | "aria-details" | "aria-disabled" | "aria-dropeffect" | "aria-errormessage" | "aria-expanded" | "aria-flowto" | "aria-grabbed" | "aria-haspopup" | "aria-hidden" | "aria-invalid" | "aria-keyshortcuts" | "aria-label" | "aria-labelledby" | "aria-level" | "aria-live" | "aria-modal" | "aria-multiline" | "aria-multiselectable" | "aria-orientation" | "aria-owns" | "aria-placeholder" | "aria-posinset" | "aria-pressed" | "aria-readonly" | "aria-relevant" | "aria-required" | "aria-roledescription" | "aria-rowcount" | "aria-rowindex" | "aria-rowspan" | "aria-selected" | "aria-setsize" | "aria-sort" | "aria-valuemax" | "aria-valuemin" | "aria-valuenow" | "aria-valuetext" | "children" | "dangerouslySetInnerHTML" | "onCopy" | "onCopyCapture" | "onCut" | "onCutCapture" | "onPaste" | "onPasteCapture" | "onCompositionEnd" | "onCompositionEndCapture" | "onCompositionStart" | "onCompositionStartCapture" | "onCompositionUpdate" | "onCompositionUpdateCapture" | "onFocus" | "onFocusCapture" | "onBlur" | "onBlurCapture" | "onChange" | "onChangeCapture" | "onBeforeInput" | "onBeforeInputCapture" | "onInput" | "onInputCapture" | "onReset" | "onResetCapture" | "onSubmit" | "onSubmitCapture" | "onInvalid" | "onInvalidCapture" | "onLoad" | "onLoadCapture" | "onError" | "onErrorCapture" | "onKeyDown" | "onKeyDownCapture" | "onKeyPress" | "onKeyPressCapture" | "onKeyUp" | "onKeyUpCapture" | "onAbort" | "onAbortCapture" | "onCanPlay" | "onCanPlayCapture" | "onCanPlayThrough" | "onCanPlayThroughCapture" | "onDurationChange" | "onDurationChangeCapture" | "onEmptied" | "onEmptiedCapture" | "onEncrypted" | "onEncryptedCapture" | "onEnded" | "onEndedCapture" | "onLoadedData" | "onLoadedDataCapture" | "onLoadedMetadata" | "onLoadedMetadataCapture" | "onLoadStart" | "onLoadStartCapture" | "onPause" | "onPauseCapture" | "onPlay" | "onPlayCapture" | "onPlaying" | "onPlayingCapture" | "onProgress" | "onProgressCapture" | "onRateChange" | "onRateChangeCapture" | "onSeeked" | "onSeekedCapture" | "onSeeking" | "onSeekingCapture" | "onStalled" | "onStalledCapture" | "onSuspend" | "onSuspendCapture" | "onTimeUpdate" | "onTimeUpdateCapture" | "onVolumeChange" | "onVolumeChangeCapture" | "onWaiting" | "onWaitingCapture" | "onAuxClick" | "onAuxClickCapture" | "onClick" | "onClickCapture" | "onContextMenu" | "onContextMenuCapture" | "onDoubleClick" | "onDoubleClickCapture" | "onDrag" | "onDragCapture" | "onDragEnd" | "onDragEndCapture" | "onDragEnter" | "onDragEnterCapture" | "onDragExit" | "onDragExitCapture" | "onDragLeave" | "onDragLeaveCapture" | "onDragOver" | "onDragOverCapture" | "onDragStart" | "onDragStartCapture" | "onDrop" | "onDropCapture" | "onMouseDown" | "onMouseDownCapture" | "onMouseEnter" | "onMouseLeave" | "onMouseMove" | "onMouseMoveCapture" | "onMouseOut" | "onMouseOutCapture" | "onMouseOver" | "onMouseOverCapture" | "onMouseUp" | "onMouseUpCapture" | "onSelect" | "onSelectCapture" | "onTouchCancel" | "onTouchCancelCapture" | "onTouchEnd" | "onTouchEndCapture" | "onTouchMove" | "onTouchMoveCapture" | "onTouchStart" | "onTouchStartCapture" | "onPointerDown" | "onPointerDownCapture" | "onPointerMove" | "onPointerMoveCapture" | "onPointerUp" | "onPointerUpCapture" | "onPointerCancel" | "onPointerCancelCapture" | "onPointerEnter" | "onPointerEnterCapture" | "onPointerLeave" | "onPointerLeaveCapture" | "onPointerOver" | "onPointerOverCapture" | "onPointerOut" | "onPointerOutCapture" | "onGotPointerCapture" | "onGotPointerCaptureCapture" | "onLostPointerCapture" | "onLostPointerCaptureCapture" | "onScroll" | "onScrollCapture" | "onWheel" | "onWheelCapture" | "onAnimationStart" | "onAnimationStartCapture" | "onAnimationEnd" | "onAnimationEndCapture" | "onAnimationIteration" | "onAnimationIterationCapture" | "onTransitionEnd" | "onTransitionEndCapture" | "default" | "width" | "height" | "content" | "hasDataRow" | "accept" | "acceptCharset" | "action" | "allowFullScreen" | "allowTransparency" | "alt" | "as" | "async" | "autoComplete" | "autoFocus" | "autoPlay" | "capture" | "cellPadding" | "cellSpacing" | "charSet" | "challenge" | "checked" | "classID" | "cols" | "colSpan" | "controls" | "coords" | "crossOrigin" | "dateTime" | "defer" | "disabled" | "download" | "encType" | "formAction" | "formEncType" | "formMethod" | "formNoValidate" | "formTarget" | "frameBorder" | "high" | "href" | "hrefLang" | "htmlFor" | "httpEquiv" | "integrity" | "keyParams" | "keyType" | "kind" | "list" | "loop" | "low" | "manifest" | "marginHeight" | "marginWidth" | "max" | "maxLength" | "media" | "mediaGroup" | "min" | "minLength" | "multiple" | "muted" | "name" | "nonce" | "noValidate" | "open" | "optimum" | "playsInline" | "poster" | "preload" | "readOnly" | "rel" | "required" | "reversed" | "rowSpan" | "sandbox" | "scope" | "scoped" | "scrolling" | "seamless" | "selected" | "shape" | "size" | "sizes" | "src" | "srcDoc" | "srcLang" | "srcSet" | "start" | "step" | "target" | "type" | "useMap" | "value" | "wmode" | "wrap"> & import("react").RefAttributes<HTMLTableElement>>;
 export declare const Caption: FC<{
     children: ReactNode;
 }>;
 export declare const PaginationWrapper: FC<{
     children: ReactNode;
+    testId?: string;
 }>;

package/dist/types/types.d.ts

@@ -42,7 +42,8 @@ export interface I18nShape {
 }
 export interface StatelessProps extends WithAnalyticsEventsProps {
     /**
-     * Caption for the table styled as a heading.
+     * Caption for the table styled as a heading. This appears before the table header, and is announced when people who use assistive technology land on the table.
+     * If you don’t want the caption to appear on the page but do want it to be available for assistive technology, surround the caption with `<VisuallyHidden>`.
      */
     caption?: React.ReactNode;
     /**
@@ -62,8 +63,8 @@ export interface StatelessProps extends WithAnalyticsEventsProps {
      */
     emptyView?: React.ReactElement<any>;
     /**
-     * Configuration of the loading spinner shown when `isLoading` is true.
-     * Defaults to `"large"` when a page has more than two rows, else `"small"`.
+     * Sets the size of the loading spinner when `isLoading` is true.
+     * Defaults to `"large"` when a page has more than two rows, otherwise it will be `"small"`.
      */
     loadingSpinnerSize?: LoadingSpinnerSizeType;
     /**
@@ -71,7 +72,11 @@ export interface StatelessProps extends WithAnalyticsEventsProps {
      */
     isLoading?: boolean;
     /**
-     * Displays columns as their initial width regardless of the content that loads in.
+     * Accessible name for loading states spinner. Can be used for internationalization. Default is "Loading table".
+     */
+    loadingLabel?: string;
+    /**
+     * Use this to force columns to use their initial width regardless of the size of the content that loads in.
      */
     isFixedSize?: boolean;
     /**
@@ -83,21 +88,20 @@ export interface StatelessProps extends WithAnalyticsEventsProps {
      */
     totalRows?: number;
     /**
-     * Callback fired when the table page has changed,
-     * useful when wanting to control the pagination of the table.
+     * A callback that happens when the table page has changed.
+     * Use this when you want to control the pagination of the table.
      */
     onSetPage?: (page: number, UIAnalyticsEvent?: UIAnalyticsEvent) => void;
     /**
-     * Callback fired when a column heading has been sorted,
-     * useful when wanting to control the sort order of the table.
+     * A callback that happens when a column heading has been sorted. Use this to provide custom sorting for the table.
      */
     onSort?: (data: any, UIAnalyticsEvent?: UIAnalyticsEvent) => void;
     /**
-     * Callback fired when the rows displayed on a page have changed.
+     * A callback that happens when the rows displayed on a page have changed.
      */
     onPageRowsUpdate?: (pageRows: Array<RowType>) => void;
     /**
-     * Page the table should show. Set by default to 1, so never undefined.
+     * Page the table should show. Set by default to 1, so that it's never undefined.
      */
     page?: number;
     /**
@@ -110,29 +114,29 @@ export interface StatelessProps extends WithAnalyticsEventsProps {
      */
     sortOrder?: SortOrderType;
     /**
-     * Enables drag & drop sorting of table rows.
+     * Use this to enable drag and drop sorting of table rows.
      */
     isRankable?: boolean;
     /**
      * Disables being able to drop rows on the table.
-     * Drag will still function.
+     * We recommend using `isRankable` instead of this prop, and it will be deprecated in a future release.
      */
     isRankingDisabled?: boolean;
     /**
-     * Callback fired when a drag of a row has started.
+     * A callback that happens when a drag of a row has started.
      */
     onRankStart?: (rankStart: RankStart) => void;
     /**
-     * Callback fired when a drop of a row has completed.
+     * A callback that happens when a drop of a row has completed.
      */
     onRankEnd?: (rankEnd: RankEnd, uiAnalyticsEvent?: UIAnalyticsEvent) => void;
     /**
      * Labels for the pagination wrapper, previous and next buttons used in pagination.
-     * Defaults to `"page"`, `"pagination"`, `"previous"` and `"next"`.
+     * Defaults to `"Page"`, `"Pagination"`, `"Previous"` and `"Next"`.
      */
     paginationi18n?: I18nShape;
     /**
-     * Will highlight a row(s) of the table. Should be used to draw attention to a row; not to indicate selection.
+     * Use this to set which rows will be highlighted. Never use highlighted rows to indicate that a person has selected or focused on the row.
      */
     highlightedRowIndex?: number | number[];
     /**
@@ -152,19 +156,20 @@ export interface StatelessProps extends WithAnalyticsEventsProps {
      */
     testId?: string;
     /**
-     * Used to provide a better description of the table for users with assistive technologies.
-     * Rather than a screen reader speaking "Entering table", passing in an label
-     * allows a custom message like "Entering Sample Numerical Data table".
+     * If you don’t use a caption, then you’ll need to use label to describe the table for assistive technologies.
+     * Avoid using both at the same time as they may conflict.
+     * Rather than a screen reader speaking "Entering table", passing in an label allows a custom message like "Entering Jira Issues table".
      */
     label?: string;
 }
 export interface StatefulProps extends WithAnalyticsEventsProps {
     /**
-     * Caption for the table styled as a heading.
+     * Caption for the table styled as a heading. This appears before the table header, and is announced when people who use assistive technology land on the table.
+     * If you don’t want the caption to appear on the page but do want it to be available for assistive technology, surround the caption with `<VisuallyHidden>`.
      */
     caption?: React.ReactNode;
     /**
-     * Cells to be placed in the head of the table.
+     * Cells to be placed in the head of the table. Never put controls, like links and buttons in the table header.
      * Each element in the head creates a new column.
      */
     head?: HeadType;
@@ -189,50 +194,51 @@ export interface StatefulProps extends WithAnalyticsEventsProps {
      */
     isLoading?: boolean;
     /**
-     * Displays columns as their initial width regardless of the content that loads in.
+     * Use this to set a label for assistive technology that describes the loading state.
+     * The default label is "Loading table". You can customize this to be more specific to your table, for example “Loading issue table”.
+     */
+    loadingLabel?: string;
+    /**
+     * Use this to force columns to use their initial width regardless of the size of the content that loads in.
      */
     isFixedSize?: boolean;
     /**
-     * Controls how many rows should be displayed per page. If set, also turns on pagination, if there is more than one page to show.
+     * Use this to control how many rows should be displayed per page. If the number of rows exceed one page, this will enable pagination.
      */
     rowsPerPage?: number;
     /**
-     * Callback fired when the table page has changed,
-     * useful when wanting to control dynamic table.
+     * A callback that happens when the table page has changed.
      */
     onSetPage?: (page: number, UIAnalyticsEvent?: UIAnalyticsEvent) => void;
     /**
-     * Callback fired when a column heading has been sorted,
-     * useful when wanting to control dynamic table.
+     * A callback that happens when a column heading has been sorted. Use this to provide custom sorting.
      */
     onSort?: (data: any, UIAnalyticsEvent?: UIAnalyticsEvent) => void;
     /**
-     * Callback fired when the rows displayed on a page have changed.
+     * A callback that happens when the rows displayed on a page have changed.
      */
     onPageRowsUpdate?: (pageRows: Array<RowType>) => void;
     /**
      * Page the table should show.
-     * Useful when wanting to control dynamic table.
      */
     page?: number;
     /**
-     * Default page dynamic table should show when initially rendering.
+     * When the table is initially rendered, use this to set which page number is shown by default.
+     * In most circumstances, people will expect this to be page `1`.
      */
     defaultPage?: number;
     /**
      * Column key that the rows should be sorted by.
      * Corresponds to the `key`'s defined in the `head` prop.
-     * Useful when wanting to control dynamic table.
      */
     sortKey?: string;
     /**
-     * Default column sort key that the rows should be sorted by.
+     * Sets which column the rows should be sorted by when the table is initially rendered.
      * Corresponds to the `key`'s defined in the `head` prop.
      */
     defaultSortKey?: string;
     /**
      * Column sort order.
-     * Useful when wanting to control dynamic table.
      */
     sortOrder?: SortOrderType;
     /**
@@ -241,29 +247,29 @@ export interface StatefulProps extends WithAnalyticsEventsProps {
      */
     defaultSortOrder?: SortOrderType;
     /**
-     * Enables drag & drop sorting of table rows.
+     * Use this to enable drag and drop sorting of table rows.
      */
     isRankable?: boolean;
     /**
      * Disables being able to drop rows on the table.
-     * Drag will still function.
+     * We recommend using `isRankable` instead of this prop, and it will be deprecated in a future release.
      */
     isRankingDisabled?: boolean;
     /**
-     * Callback fired when a drag of a row has started.
+     * A callback that happens when a drag of a row has started.
      */
     onRankStart?: (rankStart: RankStart) => void;
     /**
-     * Callback fired when a drop of a row has completed.
+     * A callback that happens when a drop of a row has completed.
      */
     onRankEnd?: (rankEnd: RankEnd) => void;
     /**
      * Labels for the previous and next buttons used in pagination.
-     * Defaults to `"previous"` and `"next"`.
+     * Defaults to `"Previous"` and `"Next"`.
      */
     paginationi18n?: I18nShape;
     /**
-     * Will highlight a row(s) of the table.
+     * Use this to set if the row will be highlighted. Never use highlighted rows to indicate that a person has selected or focused on the row.
      */
     highlightedRowIndex?: number | number[];
     /**
@@ -282,9 +288,9 @@ export interface StatefulProps extends WithAnalyticsEventsProps {
      */
     testId?: string;
     /**
-     * Used to provide a better description of the table for users with assistive technologies.
-     * Rather than a screen reader speaking "Entering table", passing in an label
-     * allows a custom message like "Entering Sample Numerical Data table".
+     * If you don’t use a caption, then you’ll need to use label to describe the table for assistive technologies.
+     * Avoid using both at the same time as they may conflict.
+     * Rather than a screen reader speaking "Entering table", passing in an label allows a custom message like "Entering Jira Issues table".
      */
     label?: string;
 }
@@ -300,7 +306,7 @@ export interface RowType extends React.ComponentPropsWithoutRef<'tr'> {
      */
     onKeyPress?: React.KeyboardEventHandler;
     /**
-     * Highlights the row. Should be used to draw attention to a row; not to indicate selection.
+     * Use this to set if the row will be highlighted. Never use highlighted rows to indicate that a person has selected or focused on the row.
      */
     isHighlighted?: boolean;
     /**
@@ -329,7 +335,7 @@ export interface HeadCellType extends RowCellType {
      */
     width?: number;
     /**
-     * Whether the text in the cell will truncate or not if constrained.
+     * Whether the text in the cell will truncate or not if constrained. Avoid truncating content wherever possible.
      */
     shouldTruncate?: boolean;
 }

package/dist/types-ts4.5/components/loading-container-advanced.d.ts

@@ -6,6 +6,7 @@ export interface LoadingContainerAdvancedProps {
     contentsOpacity: number | string;
     targetRef?: () => HTMLTableSectionElement | null;
     testId?: string;
+    loadingLabel?: string;
 }
 export default class LoadingContainerAdvanced extends React.Component<LoadingContainerAdvancedProps, {}> {
     spinnerRef: React.RefObject<HTMLDivElement>;
@@ -14,6 +15,7 @@ export default class LoadingContainerAdvanced extends React.Component<LoadingCon
         isLoading: boolean;
         spinnerSize: string;
         contentsOpacity: "var(--ds-opacity-loading)";
+        loadingLabel: string;
     };
     componentDidMount: () => void;
     UNSAFE_componentWillReceiveProps: (nextProps: LoadingContainerAdvancedProps) => void;

package/dist/types-ts4.5/components/loading-container.d.ts

@@ -6,12 +6,14 @@ interface LoadingContainerProps {
     spinnerSize?: SpinnerSizeType;
     contentsOpacity: number;
     testId?: string;
+    loadingLabel?: string;
 }
 export default class LoadingContainer extends React.Component<LoadingContainerProps> {
     static defaultProps: {
         isLoading: boolean;
         spinnerSize: string;
         contentsOpacity: number;
+        loadingLabel: string;
     };
     render(): JSX.Element;
 }

package/dist/types-ts4.5/components/managed-pagination.d.ts

@@ -7,6 +7,7 @@ interface ManagedPaginationProps {
     total: number;
     i18n?: I18nShape;
     testId?: string;
+    isDisabled?: boolean;
 }
 export default class ManagedPagination extends React.Component<ManagedPaginationProps> {
     onChange: (_event: any, newValue: any, analyticsEvent?: UIAnalyticsEvent) => void;

package/dist/types-ts4.5/components/stateless.d.ts

@@ -39,7 +39,7 @@ declare class DynamicTable extends React.Component<Props, State> {
     render(): JSX.Element;
 }
 export { DynamicTable as DynamicTableWithoutAnalytics };
-declare const _default: React.ForwardRefExoticComponent<Pick<Pick<Omit<Props, keyof import("@atlaskit/analytics-next").WithAnalyticsEventsProps>, "head" | "caption" | "rows" | "emptyView" | "loadingSpinnerSize" | "totalRows" | "onPageRowsUpdate" | "sortKey" | "sortOrder" | "highlightedRowIndex" | "testId" | "label"> & Partial<Pick<Omit<Props, keyof import("@atlaskit/analytics-next").WithAnalyticsEventsProps>, "isLoading" | "isFixedSize" | "rowsPerPage" | "onSetPage" | "onSort" | "page" | "isRankable" | "isRankingDisabled" | "onRankStart" | "onRankEnd" | "paginationi18n">> & Partial<Pick<{
+declare const _default: React.ForwardRefExoticComponent<Pick<Pick<Omit<Props, keyof import("@atlaskit/analytics-next").WithAnalyticsEventsProps>, "head" | "caption" | "rows" | "emptyView" | "loadingSpinnerSize" | "loadingLabel" | "totalRows" | "onPageRowsUpdate" | "sortKey" | "sortOrder" | "highlightedRowIndex" | "testId" | "label"> & Partial<Pick<Omit<Props, keyof import("@atlaskit/analytics-next").WithAnalyticsEventsProps>, "isLoading" | "isFixedSize" | "rowsPerPage" | "onSetPage" | "onSort" | "page" | "isRankable" | "isRankingDisabled" | "onRankStart" | "onRankEnd" | "paginationi18n">> & Partial<Pick<{
     isLoading: boolean;
     isFixedSize: boolean;
     rowsPerPage: number;
@@ -56,5 +56,5 @@ declare const _default: React.ForwardRefExoticComponent<Pick<Pick<Omit<Props, ke
         label: string;
         pageLabel: string;
     };
-}, never>> & React.RefAttributes<any> & import("@atlaskit/analytics-next").WithContextProps, "head" | "caption" | "rows" | "emptyView" | "loadingSpinnerSize" | "isLoading" | "isFixedSize" | "rowsPerPage" | "totalRows" | "onSetPage" | "onSort" | "onPageRowsUpdate" | "page" | "sortKey" | "sortOrder" | "isRankable" | "isRankingDisabled" | "onRankStart" | "onRankEnd" | "paginationi18n" | "highlightedRowIndex" | "testId" | "label" | "key" | "analyticsContext"> & React.RefAttributes<any>>;
+}, never>> & React.RefAttributes<any> & import("@atlaskit/analytics-next").WithContextProps, "head" | "caption" | "rows" | "emptyView" | "loadingSpinnerSize" | "isLoading" | "loadingLabel" | "isFixedSize" | "rowsPerPage" | "totalRows" | "onSetPage" | "onSort" | "onPageRowsUpdate" | "page" | "sortKey" | "sortOrder" | "isRankable" | "isRankingDisabled" | "onRankStart" | "onRankEnd" | "paginationi18n" | "highlightedRowIndex" | "testId" | "label" | "key" | "analyticsContext"> & React.RefAttributes<any>>;
 export default _default;

package/dist/types-ts4.5/styled/dynamic-table.d.ts

@@ -2,6 +2,7 @@
 import { FC, HTMLProps, ReactNode } from 'react';
 export type TableProps = HTMLProps<HTMLTableElement> & {
     isFixedSize?: boolean;
+    isLoading?: boolean;
     hasDataRow: boolean;
     testId?: string;
 };
@@ -11,10 +12,11 @@ export declare const tableRowCSSVars: {
     CSS_VAR_HOVER_HIGHLIGHTED_BACKGROUND: string;
     CSS_VAR_ROW_FOCUS_OUTLINE: string;
 };
-export declare const Table: import("react").ForwardRefExoticComponent<Pick<TableProps, "headers" | "method" | "rows" | "isFixedSize" | "testId" | "label" | "cite" | "data" | "form" | "slot" | "span" | "style" | "summary" | "title" | "pattern" | "key" | "defaultChecked" | "defaultValue" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "accessKey" | "className" | "contentEditable" | "contextMenu" | "dir" | "draggable" | "hidden" | "id" | "lang" | "placeholder" | "spellCheck" | "tabIndex" | "translate" | "radioGroup" | "role" | "about" | "datatype" | "inlist" | "prefix" | "property" | "resource" | "typeof" | "vocab" | "autoCapitalize" | "autoCorrect" | "autoSave" | "color" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "results" | "security" | "unselectable" | "inputMode" | "is" | "aria-activedescendant" | "aria-atomic" | "aria-autocomplete" | "aria-busy" | "aria-checked" | "aria-colcount" | "aria-colindex" | "aria-colspan" | "aria-controls" | "aria-current" | "aria-describedby" | "aria-details" | "aria-disabled" | "aria-dropeffect" | "aria-errormessage" | "aria-expanded" | "aria-flowto" | "aria-grabbed" | "aria-haspopup" | "aria-hidden" | "aria-invalid" | "aria-keyshortcuts" | "aria-label" | "aria-labelledby" | "aria-level" | "aria-live" | "aria-modal" | "aria-multiline" | "aria-multiselectable" | "aria-orientation" | "aria-owns" | "aria-placeholder" | "aria-posinset" | "aria-pressed" | "aria-readonly" | "aria-relevant" | "aria-required" | "aria-roledescription" | "aria-rowcount" | "aria-rowindex" | "aria-rowspan" | "aria-selected" | "aria-setsize" | "aria-sort" | "aria-valuemax" | "aria-valuemin" | "aria-valuenow" | "aria-valuetext" | "children" | "dangerouslySetInnerHTML" | "onCopy" | "onCopyCapture" | "onCut" | "onCutCapture" | "onPaste" | "onPasteCapture" | "onCompositionEnd" | "onCompositionEndCapture" | "onCompositionStart" | "onCompositionStartCapture" | "onCompositionUpdate" | "onCompositionUpdateCapture" | "onFocus" | "onFocusCapture" | "onBlur" | "onBlurCapture" | "onChange" | "onChangeCapture" | "onBeforeInput" | "onBeforeInputCapture" | "onInput" | "onInputCapture" | "onReset" | "onResetCapture" | "onSubmit" | "onSubmitCapture" | "onInvalid" | "onInvalidCapture" | "onLoad" | "onLoadCapture" | "onError" | "onErrorCapture" | "onKeyDown" | "onKeyDownCapture" | "onKeyPress" | "onKeyPressCapture" | "onKeyUp" | "onKeyUpCapture" | "onAbort" | "onAbortCapture" | "onCanPlay" | "onCanPlayCapture" | "onCanPlayThrough" | "onCanPlayThroughCapture" | "onDurationChange" | "onDurationChangeCapture" | "onEmptied" | "onEmptiedCapture" | "onEncrypted" | "onEncryptedCapture" | "onEnded" | "onEndedCapture" | "onLoadedData" | "onLoadedDataCapture" | "onLoadedMetadata" | "onLoadedMetadataCapture" | "onLoadStart" | "onLoadStartCapture" | "onPause" | "onPauseCapture" | "onPlay" | "onPlayCapture" | "onPlaying" | "onPlayingCapture" | "onProgress" | "onProgressCapture" | "onRateChange" | "onRateChangeCapture" | "onSeeked" | "onSeekedCapture" | "onSeeking" | "onSeekingCapture" | "onStalled" | "onStalledCapture" | "onSuspend" | "onSuspendCapture" | "onTimeUpdate" | "onTimeUpdateCapture" | "onVolumeChange" | "onVolumeChangeCapture" | "onWaiting" | "onWaitingCapture" | "onAuxClick" | "onAuxClickCapture" | "onClick" | "onClickCapture" | "onContextMenu" | "onContextMenuCapture" | "onDoubleClick" | "onDoubleClickCapture" | "onDrag" | "onDragCapture" | "onDragEnd" | "onDragEndCapture" | "onDragEnter" | "onDragEnterCapture" | "onDragExit" | "onDragExitCapture" | "onDragLeave" | "onDragLeaveCapture" | "onDragOver" | "onDragOverCapture" | "onDragStart" | "onDragStartCapture" | "onDrop" | "onDropCapture" | "onMouseDown" | "onMouseDownCapture" | "onMouseEnter" | "onMouseLeave" | "onMouseMove" | "onMouseMoveCapture" | "onMouseOut" | "onMouseOutCapture" | "onMouseOver" | "onMouseOverCapture" | "onMouseUp" | "onMouseUpCapture" | "onSelect" | "onSelectCapture" | "onTouchCancel" | "onTouchCancelCapture" | "onTouchEnd" | "onTouchEndCapture" | "onTouchMove" | "onTouchMoveCapture" | "onTouchStart" | "onTouchStartCapture" | "onPointerDown" | "onPointerDownCapture" | "onPointerMove" | "onPointerMoveCapture" | "onPointerUp" | "onPointerUpCapture" | "onPointerCancel" | "onPointerCancelCapture" | "onPointerEnter" | "onPointerEnterCapture" | "onPointerLeave" | "onPointerLeaveCapture" | "onPointerOver" | "onPointerOverCapture" | "onPointerOut" | "onPointerOutCapture" | "onGotPointerCapture" | "onGotPointerCaptureCapture" | "onLostPointerCapture" | "onLostPointerCaptureCapture" | "onScroll" | "onScrollCapture" | "onWheel" | "onWheelCapture" | "onAnimationStart" | "onAnimationStartCapture" | "onAnimationEnd" | "onAnimationEndCapture" | "onAnimationIteration" | "onAnimationIterationCapture" | "onTransitionEnd" | "onTransitionEndCapture" | "default" | "width" | "height" | "content" | "hasDataRow" | "accept" | "acceptCharset" | "action" | "allowFullScreen" | "allowTransparency" | "alt" | "as" | "async" | "autoComplete" | "autoFocus" | "autoPlay" | "capture" | "cellPadding" | "cellSpacing" | "charSet" | "challenge" | "checked" | "classID" | "cols" | "colSpan" | "controls" | "coords" | "crossOrigin" | "dateTime" | "defer" | "disabled" | "download" | "encType" | "formAction" | "formEncType" | "formMethod" | "formNoValidate" | "formTarget" | "frameBorder" | "high" | "href" | "hrefLang" | "htmlFor" | "httpEquiv" | "integrity" | "keyParams" | "keyType" | "kind" | "list" | "loop" | "low" | "manifest" | "marginHeight" | "marginWidth" | "max" | "maxLength" | "media" | "mediaGroup" | "min" | "minLength" | "multiple" | "muted" | "name" | "nonce" | "noValidate" | "open" | "optimum" | "playsInline" | "poster" | "preload" | "readOnly" | "rel" | "required" | "reversed" | "rowSpan" | "sandbox" | "scope" | "scoped" | "scrolling" | "seamless" | "selected" | "shape" | "size" | "sizes" | "src" | "srcDoc" | "srcLang" | "srcSet" | "start" | "step" | "target" | "type" | "useMap" | "value" | "wmode" | "wrap"> & import("react").RefAttributes<HTMLTableElement>>;
+export declare const Table: import("react").ForwardRefExoticComponent<Pick<TableProps, "headers" | "method" | "rows" | "isLoading" | "isFixedSize" | "testId" | "label" | "cite" | "data" | "form" | "slot" | "span" | "style" | "summary" | "title" | "pattern" | "key" | "defaultChecked" | "defaultValue" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "accessKey" | "className" | "contentEditable" | "contextMenu" | "dir" | "draggable" | "hidden" | "id" | "lang" | "placeholder" | "spellCheck" | "tabIndex" | "translate" | "radioGroup" | "role" | "about" | "datatype" | "inlist" | "prefix" | "property" | "resource" | "typeof" | "vocab" | "autoCapitalize" | "autoCorrect" | "autoSave" | "color" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "results" | "security" | "unselectable" | "inputMode" | "is" | "aria-activedescendant" | "aria-atomic" | "aria-autocomplete" | "aria-busy" | "aria-checked" | "aria-colcount" | "aria-colindex" | "aria-colspan" | "aria-controls" | "aria-current" | "aria-describedby" | "aria-details" | "aria-disabled" | "aria-dropeffect" | "aria-errormessage" | "aria-expanded" | "aria-flowto" | "aria-grabbed" | "aria-haspopup" | "aria-hidden" | "aria-invalid" | "aria-keyshortcuts" | "aria-label" | "aria-labelledby" | "aria-level" | "aria-live" | "aria-modal" | "aria-multiline" | "aria-multiselectable" | "aria-orientation" | "aria-owns" | "aria-placeholder" | "aria-posinset" | "aria-pressed" | "aria-readonly" | "aria-relevant" | "aria-required" | "aria-roledescription" | "aria-rowcount" | "aria-rowindex" | "aria-rowspan" | "aria-selected" | "aria-setsize" | "aria-sort" | "aria-valuemax" | "aria-valuemin" | "aria-valuenow" | "aria-valuetext" | "children" | "dangerouslySetInnerHTML" | "onCopy" | "onCopyCapture" | "onCut" | "onCutCapture" | "onPaste" | "onPasteCapture" | "onCompositionEnd" | "onCompositionEndCapture" | "onCompositionStart" | "onCompositionStartCapture" | "onCompositionUpdate" | "onCompositionUpdateCapture" | "onFocus" | "onFocusCapture" | "onBlur" | "onBlurCapture" | "onChange" | "onChangeCapture" | "onBeforeInput" | "onBeforeInputCapture" | "onInput" | "onInputCapture" | "onReset" | "onResetCapture" | "onSubmit" | "onSubmitCapture" | "onInvalid" | "onInvalidCapture" | "onLoad" | "onLoadCapture" | "onError" | "onErrorCapture" | "onKeyDown" | "onKeyDownCapture" | "onKeyPress" | "onKeyPressCapture" | "onKeyUp" | "onKeyUpCapture" | "onAbort" | "onAbortCapture" | "onCanPlay" | "onCanPlayCapture" | "onCanPlayThrough" | "onCanPlayThroughCapture" | "onDurationChange" | "onDurationChangeCapture" | "onEmptied" | "onEmptiedCapture" | "onEncrypted" | "onEncryptedCapture" | "onEnded" | "onEndedCapture" | "onLoadedData" | "onLoadedDataCapture" | "onLoadedMetadata" | "onLoadedMetadataCapture" | "onLoadStart" | "onLoadStartCapture" | "onPause" | "onPauseCapture" | "onPlay" | "onPlayCapture" | "onPlaying" | "onPlayingCapture" | "onProgress" | "onProgressCapture" | "onRateChange" | "onRateChangeCapture" | "onSeeked" | "onSeekedCapture" | "onSeeking" | "onSeekingCapture" | "onStalled" | "onStalledCapture" | "onSuspend" | "onSuspendCapture" | "onTimeUpdate" | "onTimeUpdateCapture" | "onVolumeChange" | "onVolumeChangeCapture" | "onWaiting" | "onWaitingCapture" | "onAuxClick" | "onAuxClickCapture" | "onClick" | "onClickCapture" | "onContextMenu" | "onContextMenuCapture" | "onDoubleClick" | "onDoubleClickCapture" | "onDrag" | "onDragCapture" | "onDragEnd" | "onDragEndCapture" | "onDragEnter" | "onDragEnterCapture" | "onDragExit" | "onDragExitCapture" | "onDragLeave" | "onDragLeaveCapture" | "onDragOver" | "onDragOverCapture" | "onDragStart" | "onDragStartCapture" | "onDrop" | "onDropCapture" | "onMouseDown" | "onMouseDownCapture" | "onMouseEnter" | "onMouseLeave" | "onMouseMove" | "onMouseMoveCapture" | "onMouseOut" | "onMouseOutCapture" | "onMouseOver" | "onMouseOverCapture" | "onMouseUp" | "onMouseUpCapture" | "onSelect" | "onSelectCapture" | "onTouchCancel" | "onTouchCancelCapture" | "onTouchEnd" | "onTouchEndCapture" | "onTouchMove" | "onTouchMoveCapture" | "onTouchStart" | "onTouchStartCapture" | "onPointerDown" | "onPointerDownCapture" | "onPointerMove" | "onPointerMoveCapture" | "onPointerUp" | "onPointerUpCapture" | "onPointerCancel" | "onPointerCancelCapture" | "onPointerEnter" | "onPointerEnterCapture" | "onPointerLeave" | "onPointerLeaveCapture" | "onPointerOver" | "onPointerOverCapture" | "onPointerOut" | "onPointerOutCapture" | "onGotPointerCapture" | "onGotPointerCaptureCapture" | "onLostPointerCapture" | "onLostPointerCaptureCapture" | "onScroll" | "onScrollCapture" | "onWheel" | "onWheelCapture" | "onAnimationStart" | "onAnimationStartCapture" | "onAnimationEnd" | "onAnimationEndCapture" | "onAnimationIteration" | "onAnimationIterationCapture" | "onTransitionEnd" | "onTransitionEndCapture" | "default" | "width" | "height" | "content" | "hasDataRow" | "accept" | "acceptCharset" | "action" | "allowFullScreen" | "allowTransparency" | "alt" | "as" | "async" | "autoComplete" | "autoFocus" | "autoPlay" | "capture" | "cellPadding" | "cellSpacing" | "charSet" | "challenge" | "checked" | "classID" | "cols" | "colSpan" | "controls" | "coords" | "crossOrigin" | "dateTime" | "defer" | "disabled" | "download" | "encType" | "formAction" | "formEncType" | "formMethod" | "formNoValidate" | "formTarget" | "frameBorder" | "high" | "href" | "hrefLang" | "htmlFor" | "httpEquiv" | "integrity" | "keyParams" | "keyType" | "kind" | "list" | "loop" | "low" | "manifest" | "marginHeight" | "marginWidth" | "max" | "maxLength" | "media" | "mediaGroup" | "min" | "minLength" | "multiple" | "muted" | "name" | "nonce" | "noValidate" | "open" | "optimum" | "playsInline" | "poster" | "preload" | "readOnly" | "rel" | "required" | "reversed" | "rowSpan" | "sandbox" | "scope" | "scoped" | "scrolling" | "seamless" | "selected" | "shape" | "size" | "sizes" | "src" | "srcDoc" | "srcLang" | "srcSet" | "start" | "step" | "target" | "type" | "useMap" | "value" | "wmode" | "wrap"> & import("react").RefAttributes<HTMLTableElement>>;
 export declare const Caption: FC<{
     children: ReactNode;
 }>;
 export declare const PaginationWrapper: FC<{
     children: ReactNode;
+    testId?: string;
 }>;