@atlaskit/section-message 6.1.13 → 6.2.0

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @atlaskit/section-message
 
+## 6.2.0
+
+### Minor Changes
+
+- [`24ff3516c8d`](https://bitbucket.org/atlassian/atlassian-frontend/commits/24ff3516c8d) - Updates `@emotion/core` to `@emotion/react`; v10 to v11. There is no expected behavior change.
+
+### Patch Changes
+
+- Updated dependencies
+
+## 6.1.15
+
+### Patch Changes
+
+- [`8d4228767b0`](https://bitbucket.org/atlassian/atlassian-frontend/commits/8d4228767b0) - Upgrade Typescript from `4.2.4` to `4.3.5`.
+
+## 6.1.14
+
+### Patch Changes
+
+- [`8202e37941b`](https://bitbucket.org/atlassian/atlassian-frontend/commits/8202e37941b) - Internal code change turning on new linting rules.
+
 ## 6.1.13
 
 ### Patch Changes

package/codemods/internal/{map-actions-prop.ts → map-actions-prop.tsx}

@@ -129,7 +129,7 @@ export const mapActionsProp = (
       const linkComponentAttributeValue = transferLinkComponentProp(j, element);
       actionsAttributes = getJSXAttributesByName(j, element, ACTIONS_PROP_NAME);
 
-      actionsAttributes.forEach((attribute: ASTPath<JSXAttribute>) => {
+      actionsAttributes?.forEach((attribute: ASTPath<JSXAttribute>) => {
         j(attribute)
           .find(j.JSXExpressionContainer)
           .forEach((expressionContainer: ASTPath<JSXExpressionContainer>) => {

package/dist/cjs/section-message-action.js

@@ -9,7 +9,7 @@ exports.default = void 0;
 
 var _react = require("react");
 
-var _core = require("@emotion/core");
+var _react2 = require("@emotion/react");
 
 var _standardButton = _interopRequireDefault(require("@atlaskit/button/standard-button"));
 
@@ -19,7 +19,7 @@ var _constants = require("@atlaskit/theme/constants");
 
 /** @jsx jsx */
 var actionsSeparatorWidth = (0, _constants.gridSize)() * 2;
-var actionStyles = (0, _core.css)({
+var actionStyles = (0, _react2.css)({
   display: 'flex',
   margin: 0,
   alignItems: 'center',
@@ -33,16 +33,26 @@ var actionStyles = (0, _core.css)({
     verticalAlign: 'middle'
   }
 });
+/**
+ * __Section message action__
+ *
+ * A section message action is designed to work with the `action` prop from
+ * `SectionMessage`. It renders either a button or a link depending on whether
+ * an `onClick` or `href` prop is supplied, with a dot seperator in between actions.
+ *
+ * - [Examples](https://atlassian.design/components/section-message/examples#actions)
+ */
+
 var SectionMessageAction = /*#__PURE__*/(0, _react.memo)(function SectionMessageAction(_ref) {
   var children = _ref.children,
       onClick = _ref.onClick,
       href = _ref.href,
       testId = _ref.testId,
       linkComponent = _ref.linkComponent;
-  return (0, _core.jsx)("li", {
+  return (0, _react2.jsx)("li", {
     css: actionStyles,
     "data-testid": testId
-  }, onClick || href ? (0, _core.jsx)(_standardButton.default, {
+  }, onClick || href ? (0, _react2.jsx)(_standardButton.default, {
     appearance: "link",
     spacing: "none",
     onClick: onClick,

package/dist/cjs/section-message.js

@@ -13,7 +13,7 @@ var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends")
 
 var _react = _interopRequireWildcard(require("react"));
 
-var _core = require("@emotion/core");
+var _react2 = require("@emotion/react");
 
 var _colors = require("@atlaskit/theme/colors");
 
@@ -39,16 +39,16 @@ var titleColor = {
   light: "var(--ds-text, ".concat(_colors.N800, ")"),
   dark: "var(--ds-text, ".concat(_colors.DN600, ")")
 };
-var containerStyles = (0, _core.css)({
+var containerStyles = (0, _react2.css)({
   display: 'flex',
   padding: "".concat(containerPadding, "px"),
   borderRadius: "".concat((0, _constants.borderRadius)(), "px")
 });
-var contentContainerStyles = (0, _core.css)({
+var contentContainerStyles = (0, _react2.css)({
   flexGrow: 1,
   wordBreak: 'break-word'
 });
-var titleStyles = (0, _core.css)({
+var titleStyles = (0, _react2.css)({
   margin: "0 0 ".concat(titleMarginBottom, "px"),
   fontSize: "".concat(_typography.headingSizes.h500.size / (0, _constants.fontSize)(), "em"),
   fontStyle: 'inherit',
@@ -56,7 +56,7 @@ var titleStyles = (0, _core.css)({
   letterSpacing: '-0.006em',
   lineHeight: "".concat(_typography.headingSizes.h500.lineHeight / _typography.headingSizes.h500.size)
 });
-var actionsStyles = (0, _core.css)({
+var actionsStyles = (0, _react2.css)({
   display: 'flex',
   marginTop: "".concat(actionMarginTop, "px"),
   paddingLeft: 0,
@@ -67,7 +67,7 @@ var actionsStyles = (0, _core.css)({
 // Since the icons will have a consistent size, we can treat them as pre-calculated
 // space.
 
-var iconWrapperStyles = (0, _core.css)({
+var iconWrapperStyles = (0, _react2.css)({
   display: 'flex',
   margin: '-2px 0',
   flex: "0 0 ".concat(iconWrapperWidth, "px")
@@ -100,31 +100,41 @@ var SectionMessageWithMode = /*#__PURE__*/(0, _react.forwardRef)(function Sectio
 
   var actionsArray = _react.default.Children.toArray(actions);
 
-  return (0, _core.jsx)("section", {
+  return (0, _react2.jsx)("section", {
     css: containerStyles,
     style: containerStyleWithBackground,
     "data-testid": testId,
     ref: ref
-  }, (0, _core.jsx)("div", {
+  }, (0, _react2.jsx)("div", {
     css: iconWrapperStyles
-  }, (0, _core.jsx)(Icon, {
+  }, (0, _react2.jsx)(Icon, {
     primaryColor: primaryIconColor,
     secondaryColor: backgroundColor
-  })), (0, _core.jsx)("div", {
+  })), (0, _react2.jsx)("div", {
     css: contentContainerStyles,
     "data-testid": testId && "".concat(testId, "--content")
-  }, title ? (0, _core.jsx)("h1", {
+  }, title ? (0, _react2.jsx)("h1", {
     css: titleStyles,
     style: memoizedTitleColor
-  }, title) : null, (0, _core.jsx)("div", null, children), actionsArray.length > 0 ? (0, _core.jsx)("ul", {
+  }, title) : null, (0, _react2.jsx)("div", null, children), actionsArray.length > 0 ? (0, _react2.jsx)("ul", {
     css: actionsStyles,
     "data-testid": testId && "".concat(testId, "--actions")
   }, actionsArray) : null));
 });
+/**
+ * __Section message__
+ *
+ * A section message is used to alert users to a particular section of the screen.
+ *
+ * - [Examples](https://atlassian.design/components/section-message/examples)
+ * - [Code](https://atlassian.design/components/section-message/code)
+ * - [Usage](https://atlassian.design/components/section-message/usage)
+ */
+
 var SectionMessage = /*#__PURE__*/(0, _react.forwardRef)(function SectionMessage(props, ref) {
-  return (0, _core.jsx)(_components.default.Consumer, null, function (_ref2) {
+  return (0, _react2.jsx)(_components.default.Consumer, null, function (_ref2) {
     var mode = _ref2.mode;
-    return (0, _core.jsx)(SectionMessageWithMode, (0, _extends2.default)({}, props, {
+    return (0, _react2.jsx)(SectionMessageWithMode, (0, _extends2.default)({}, props, {
       mode: mode,
       ref: ref
     }));

package/dist/cjs/version.json

@@ -1,5 +1,5 @@
 {
 	"name": "@atlaskit/section-message",
-	"version": "6.1.13",
+	"version": "6.2.0",
 	"sideEffects": false
 }

package/dist/es2019/section-message-action.js

@@ -1,6 +1,6 @@
 /** @jsx jsx */
 import { memo } from 'react';
-import { css, jsx } from '@emotion/core';
+import { css, jsx } from '@emotion/react';
 import Button from '@atlaskit/button/standard-button';
 import { N500 } from '@atlaskit/theme/colors';
 import { gridSize } from '@atlaskit/theme/constants';
@@ -19,6 +19,16 @@ const actionStyles = css({
     verticalAlign: 'middle'
   }
 });
+/**
+ * __Section message action__
+ *
+ * A section message action is designed to work with the `action` prop from
+ * `SectionMessage`. It renders either a button or a link depending on whether
+ * an `onClick` or `href` prop is supplied, with a dot seperator in between actions.
+ *
+ * - [Examples](https://atlassian.design/components/section-message/examples#actions)
+ */
+
 const SectionMessageAction = /*#__PURE__*/memo(function SectionMessageAction({
   children,
   onClick,

package/dist/es2019/section-message.js

@@ -2,7 +2,7 @@ import _extends from "@babel/runtime/helpers/extends";
 
 /** @jsx jsx */
 import React, { forwardRef, useMemo } from 'react';
-import { css, jsx } from '@emotion/core';
+import { css, jsx } from '@emotion/react';
 import { DN600, N800 } from '@atlaskit/theme/colors';
 import GlobalTheme from '@atlaskit/theme/components';
 import { borderRadius, fontSize, gridSize } from '@atlaskit/theme/constants';
@@ -92,6 +92,16 @@ const SectionMessageWithMode = /*#__PURE__*/forwardRef(function SectionMessage({
     "data-testid": testId && `${testId}--actions`
   }, actionsArray) : null));
 });
+/**
+ * __Section message__
+ *
+ * A section message is used to alert users to a particular section of the screen.
+ *
+ * - [Examples](https://atlassian.design/components/section-message/examples)
+ * - [Code](https://atlassian.design/components/section-message/code)
+ * - [Usage](https://atlassian.design/components/section-message/usage)
+ */
+
 const SectionMessage = /*#__PURE__*/forwardRef(function SectionMessage(props, ref) {
   return jsx(GlobalTheme.Consumer, null, ({
     mode

package/dist/es2019/version.json

@@ -1,5 +1,5 @@
 {
 	"name": "@atlaskit/section-message",
-	"version": "6.1.13",
+	"version": "6.2.0",
 	"sideEffects": false
 }

package/dist/esm/section-message-action.js

@@ -1,6 +1,6 @@
 /** @jsx jsx */
 import { memo } from 'react';
-import { css, jsx } from '@emotion/core';
+import { css, jsx } from '@emotion/react';
 import Button from '@atlaskit/button/standard-button';
 import { N500 } from '@atlaskit/theme/colors';
 import { gridSize } from '@atlaskit/theme/constants';
@@ -19,6 +19,16 @@ var actionStyles = css({
     verticalAlign: 'middle'
   }
 });
+/**
+ * __Section message action__
+ *
+ * A section message action is designed to work with the `action` prop from
+ * `SectionMessage`. It renders either a button or a link depending on whether
+ * an `onClick` or `href` prop is supplied, with a dot seperator in between actions.
+ *
+ * - [Examples](https://atlassian.design/components/section-message/examples#actions)
+ */
+
 var SectionMessageAction = /*#__PURE__*/memo(function SectionMessageAction(_ref) {
   var children = _ref.children,
       onClick = _ref.onClick,

package/dist/esm/section-message.js

@@ -2,7 +2,7 @@ import _extends from "@babel/runtime/helpers/extends";
 
 /** @jsx jsx */
 import React, { forwardRef, useMemo } from 'react';
-import { css, jsx } from '@emotion/core';
+import { css, jsx } from '@emotion/react';
 import { DN600, N800 } from '@atlaskit/theme/colors';
 import GlobalTheme from '@atlaskit/theme/components';
 import { borderRadius, fontSize, gridSize } from '@atlaskit/theme/constants';
@@ -97,6 +97,16 @@ var SectionMessageWithMode = /*#__PURE__*/forwardRef(function SectionMessage(_re
     "data-testid": testId && "".concat(testId, "--actions")
   }, actionsArray) : null));
 });
+/**
+ * __Section message__
+ *
+ * A section message is used to alert users to a particular section of the screen.
+ *
+ * - [Examples](https://atlassian.design/components/section-message/examples)
+ * - [Code](https://atlassian.design/components/section-message/code)
+ * - [Usage](https://atlassian.design/components/section-message/usage)
+ */
+
 var SectionMessage = /*#__PURE__*/forwardRef(function SectionMessage(props, ref) {
   return jsx(GlobalTheme.Consumer, null, function (_ref2) {
     var mode = _ref2.mode;

package/dist/esm/version.json

@@ -1,5 +1,5 @@
 {
 	"name": "@atlaskit/section-message",
-	"version": "6.1.13",
+	"version": "6.2.0",
 	"sideEffects": false
 }

package/dist/types/section-message-action.d.ts

@@ -1,4 +1,13 @@
 /// <reference types="react" />
 import type { SectionMessageActionProps } from './types';
+/**
+ * __Section message action__
+ *
+ * A section message action is designed to work with the `action` prop from
+ * `SectionMessage`. It renders either a button or a link depending on whether
+ * an `onClick` or `href` prop is supplied, with a dot seperator in between actions.
+ *
+ * - [Examples](https://atlassian.design/components/section-message/examples#actions)
+ */
 declare const SectionMessageAction: import("react").NamedExoticComponent<SectionMessageActionProps>;
 export default SectionMessageAction;

package/dist/types/section-message.d.ts

@@ -1,5 +1,14 @@
 /** @jsx jsx */
 import React from 'react';
 import type { SectionMessageProps } from './types';
+/**
+ * __Section message__
+ *
+ * A section message is used to alert users to a particular section of the screen.
+ *
+ * - [Examples](https://atlassian.design/components/section-message/examples)
+ * - [Code](https://atlassian.design/components/section-message/code)
+ * - [Usage](https://atlassian.design/components/section-message/usage)
+ */
 declare const SectionMessage: React.ForwardRefExoticComponent<SectionMessageProps & React.RefAttributes<HTMLElement>>;
 export default SectionMessage;

package/dist/types/types.d.ts

@@ -1,18 +1,57 @@
 import type { ReactElement } from 'react';
 import type { UIAnalyticsEvent } from '@atlaskit/analytics-next';
-/** Appearance determines the icon and background color pairing indicating the message type */
+/**
+ * Appearance determines the icon and background color pairing indicating the message type
+ */
 export declare type Appearance = 'information' | 'warning' | 'error' | 'success' | 'discovery';
 export interface SectionMessageProps {
-    /** The appearance styling to use for the section message. */
+    /**
+     * The appearance styling to use for the section message.
+     */
     appearance?: Appearance;
+    /**
+     * The main content of the section message. This accepts a react node, although
+     * we recommend that this should be a paragraph.
+     */
     children: React.ReactNode;
+    /**
+     * The heading of the section message.
+     */
     title?: string;
+    /**
+     * Actions for the user to take after reading the section message. Accepts a ReactElement
+     * or an array of one or more SectionMessageAction React elements, which are applied as link buttons.
+     * Middle dots are automatically added between multiple link buttons, so no elements
+     * should be present between multiple actions.
+     *
+     * In general, avoid using more than two actions.
+     */
     actions?: ReactElement | ReactElement<SectionMessageActionProps>[];
+    /**
+     * An Icon component to be rendered instead of the default icon for the component.
+     * This should only be an `@atlaskit/icon` icon. You can check out [this example](/packages/design-system/section-message/example/custom-icon)
+     * to see how to provide this icon.
+     */
     icon?: React.ElementType;
+    /**
+     * A `testId` prop 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;
 }
 export interface SectionMessageActionProps {
+    /**
+     * The text that needs to be displayed for section message action.
+     */
     children: React.ReactNode;
+    /**
+     * A custom link component. This prop is designed to allow a custom link
+     * component to be passed to the rendered link button. The
+     * intended use-case is for when a custom router component such as react router
+     * is being used within the application.
+     *
+     * This component will only be used if a href prop is passed.
+     */
     linkComponent?: React.ComponentType<any>;
     /**
      * Click handler which will be attached to the rendered link button. The second argument can be used to
@@ -23,5 +62,9 @@ export interface SectionMessageActionProps {
      * The URL that the rendered link button will point to.
      */
     href?: string;
+    /**
+     * A `testId` prop 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atlaskit/section-message",
-  "version": "6.1.13",
+  "version": "6.2.0",
   "description": "A section message is used to alert users to a particular section of the screen.",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/"
@@ -13,28 +13,29 @@
   "module:es2019": "dist/es2019/index.js",
   "types": "dist/types/index.d.ts",
   "sideEffects": false,
-  "atlaskit:src": "src/index.ts",
+  "atlaskit:src": "src/index.tsx",
   "atlassian": {
     "team": "Design System Team",
     "releaseModel": "scheduled",
     "website": {
-      "name": "Section message"
+      "name": "Section message",
+      "category": "Components"
     }
   },
   "af:exports": {
-    "./section-message": "./src/entry-points/section-message.ts",
-    "./section-message-action": "./src/entry-points/section-message-action.ts",
-    "./types": "./src/entry-points/types.ts",
-    ".": "./src/index.ts"
+    "./section-message": "./src/entry-points/section-message.tsx",
+    "./section-message-action": "./src/entry-points/section-message-action.tsx",
+    "./types": "./src/entry-points/types.tsx",
+    ".": "./src/index.tsx"
   },
   "dependencies": {
     "@atlaskit/button": "^16.3.0",
     "@atlaskit/codemod-utils": "^4.1.0",
     "@atlaskit/icon": "^21.10.0",
-    "@atlaskit/theme": "^12.1.0",
+    "@atlaskit/theme": "^12.2.0",
     "@atlaskit/tokens": "^0.10.0",
     "@babel/runtime": "^7.0.0",
-    "@emotion/core": "^10.0.9"
+    "@emotion/react": "^11.7.1"
   },
   "peerDependencies": {
     "react": "^16.8.0"
@@ -43,6 +44,7 @@
     "@atlaskit/analytics-next": "^8.1.2",
     "@atlaskit/code": "^14.3.0",
     "@atlaskit/docs": "*",
+    "@atlaskit/ds-lib": "^2.1.0",
     "@atlaskit/range": "^6.0.0",
     "@atlaskit/ssr": "*",
     "@atlaskit/visual-regression": "*",
@@ -55,13 +57,15 @@
     "react-dom": "^16.8.0",
     "react-test-renderer": "^16.8.0",
     "storybook-addon-performance": "^0.16.0",
-    "typescript": "4.2.4"
+    "typescript": "4.3.5"
   },
   "techstack": {
     "@atlassian/frontend": {
       "import-structure": "atlassian-conventions"
     },
     "@repo/internal": {
+      "design-system": "v1",
+      "dom-events": "use-bind-event-listener",
       "ui-components": "lite-mode",
       "analytics": "analytics-next",
       "styling": [

package/report.api.md

@@ -0,0 +1,57 @@
+## API Report File for "@atlaskit/section-message"
+
+> Do not edit this file. It is a report generated by [API Extractor](https://api-extractor.com/).
+
+```ts
+/// <reference types="react" />
+
+import { NamedExoticComponent } from 'react';
+import { default as React_2 } from 'react';
+import type { ReactElement } from 'react';
+import type { UIAnalyticsEvent } from '@atlaskit/analytics-next';
+
+/** Appearance determines the icon and background color pairing indicating the message type */
+export declare type Appearance =
+  | 'information'
+  | 'warning'
+  | 'error'
+  | 'success'
+  | 'discovery';
+
+declare const SectionMessage: React_2.ForwardRefExoticComponent<
+  SectionMessageProps & React_2.RefAttributes<HTMLElement>
+>;
+export default SectionMessage;
+
+export declare const SectionMessageAction: NamedExoticComponent<SectionMessageActionProps>;
+
+export declare interface SectionMessageActionProps {
+  children: React.ReactNode;
+  linkComponent?: React.ComponentType<any>;
+  /**
+   * Click handler which will be attached to the rendered link button. The second argument can be used to
+   * track analytics data. See the tutorial in the analytics-next package for details.
+   */
+  onClick?: (
+    e: React.MouseEvent<HTMLElement>,
+    analyticsEvent: UIAnalyticsEvent,
+  ) => void;
+  /**
+   * The URL that the rendered link button will point to.
+   */
+  href?: string;
+  testId?: string;
+}
+
+export declare interface SectionMessageProps {
+  /** The appearance styling to use for the section message. */
+  appearance?: Appearance;
+  children: React.ReactNode;
+  title?: string;
+  actions?: ReactElement | ReactElement<SectionMessageActionProps>[];
+  icon?: React.ElementType;
+  testId?: string;
+}
+
+export {};
+```