@atlaskit/editor-common 125.3.0 → 126.0.0

package/CHANGELOG.md

@@ -1,5 +1,60 @@
 # @atlaskit/editor-common
 
+## 126.0.0
+
+### Major Changes
+
+- [`f502381f5d221`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/f502381f5d221) -
+  Complete AI Suggestions analytics for right-rail lifecycle, empty-state interactions,
+  cancellation, suggestion lifecycle and source context, agent attribution, and aggregate
+  discard-all actions.
+
+### Patch Changes
+
+- Updated dependencies
+
+## 125.4.0
+
+### Minor Changes
+
+- [`a034f535638cc`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/a034f535638cc) -
+  Add structured Quick Insert previews with localised title, description and attribution under
+  platform_editor_slash_command.
+
+  Exclude footer and category navigation actions from previews. Left-align attribution, use subtle
+  title and attribution text, and default description text.
+
+  Show text previews even without preview metadata, and reserve a fixed image area while images load
+  or when they fail. Keep previews within the viewport, flipping left when needed, with compact
+  panel dimensions and typography.
+
+  Replace baked panel screenshots with image-only assets. Remove image fields from text-only legacy
+  previews while preserving their attribution.
+
+  Let extension providers own their preview images and attribution. Pass preview metadata through
+  the Company Hub manifest factory and remove Editor's fallback preview registry.
+
+  Localize provider attribution names and display Confluence and Jira product icons instead of the
+  attribution prefix when an icon is present. Allow the Dropbox manifest to receive the host's
+  message formatter.
+
+- [`7306003a7565b`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/7306003a7565b) -
+  Add shared measured list and adaptive popup sizing helpers, and align category heading spacing for
+  platform_editor_slash_command.
+- [`f5ec508f7f5ba`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/f5ec508f7f5ba) -
+  Add an optional `renderAgentMentionCard` render-prop to `ProfilecardProvider`, gated behind
+  `platform_editor_agent_profile_card_update`. This lets 1P products inject
+  `@atlassian/agent-profile-card` for agent mentions in the editor and renderer, while public editor
+  consumers and products that haven't wired the hook keep the existing `@atlaskit/profilecard` agent
+  card.
+
+  Widen `@atlassian/agent-profile-card`'s `onChatClick` to also receive the Studio agent ID, and add
+  an `isReadOnly` prop that suppresses the card's chat button, dropdown and favourite star.
+
+### Patch Changes
+
+- Updated dependencies
+
 ## 125.3.0
 
 ### Minor Changes

package/afm-products/tsconfig.json

@@ -103,6 +103,9 @@
 		{
 			"path": "../../../linking-platform/link-picker/afm-products/tsconfig.json"
 		},
+		{
+			"path": "../../../design-system/logo/afm-products/tsconfig.json"
+		},
 		{
 			"path": "../../../media/media-card/afm-products/tsconfig.json"
 		},

package/dist/cjs/analytics/types/enums.js

@@ -43,6 +43,7 @@ var ACTION = exports.ACTION = /*#__PURE__*/function (ACTION) {
   ACTION["DEACTIVATED"] = "deactivated";
   ACTION["DECREMENTED"] = "decremented";
   ACTION["DELETED"] = "deleted";
+  ACTION["DISCARD_ALL"] = "discardAll";
   ACTION["DISCARDED_INVALID_STEPS_FROM_TRANSACTION"] = "discardedInvalidStepsFromTransaction";
   ACTION["DISCARDED"] = "discarded";
   /** used in @atlassian/editor-referentiality */
@@ -66,6 +67,7 @@ var ACTION = exports.ACTION = /*#__PURE__*/function (ACTION) {
   ACTION["ENTERED"] = "entered";
   ACTION["ERROR"] = "error";
   ACTION["ERRORED"] = "errored";
+  ACTION["EMPTY_STATE_EXPOSED"] = "emptyStateExposed";
   ACTION["EXPERIENCE_MEASURED"] = "experienceMeasured";
   ACTION["EXPERIENCE_SAMPLED"] = "experienceSampled";
   ACTION["EXPOSED"] = "exposed";
@@ -122,6 +124,7 @@ var ACTION = exports.ACTION = /*#__PURE__*/function (ACTION) {
   ACTION["REFERENCE_SYNCED_BLOCK_UPDATE"] = "referenceSyncedBlockUpdate";
   ACTION["REFERENCE_SYNCED_BLOCK_UNSYNC"] = "referenceSyncedBlockUnsync";
   ACTION["REFERENCE_SYNCED_BLOCK_COPY"] = "referenceSyncedBlockCopy";
+  ACTION["RIGHT_RAIL_CLOSED"] = "rightRailClosed";
   ACTION["RIGHT_RAIL_VIEWED"] = "rightRailViewed";
   ACTION["REPLACED_ALL"] = "replacedAll";
   ACTION["REPLACED_ONE"] = "replacedOne";

package/dist/cjs/extensions/buildMenuItem.js

@@ -11,15 +11,16 @@ var _manifestHelpers = require("./manifest-helpers");
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { (0, _defineProperty2.default)(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 function buildMenuItem(manifest, extensionModule) {
-  var _extensionModule$cate, _ref, _extensionModule$app;
+  var _extensionModule$prev, _extensionModule$cate, _ref, _extensionModule$app;
   var title = extensionModule.title || manifest.title;
   var key = "".concat(manifest.key, ":").concat(extensionModule.key);
   var node = (0, _manifestHelpers.buildAction)(extensionModule.action, manifest);
+  var preview = (_extensionModule$prev = extensionModule.preview) !== null && _extensionModule$prev !== void 0 ? _extensionModule$prev : manifest.preview;
   var category = (0, _isExperimentEnabled.isExperimentEnabled)('platform_editor_slash_command') ? (_extensionModule$cate = extensionModule.category) !== null && _extensionModule$cate !== void 0 ? _extensionModule$cate : manifest.category : undefined;
   if (!node) {
     throw new Error("Couldn't find any action for ".concat(title, " (").concat(key, ")"));
   }
-  return _objectSpread(_objectSpread(_objectSpread(_objectSpread({}, (0, _isExperimentEnabled.isExperimentEnabled)('platform_editor_slash_app_category_analytics') || (0, _isExperimentEnabled.isExperimentEnabled)('platform_editor_slash_command') ? {
+  return _objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread({}, (0, _isExperimentEnabled.isExperimentEnabled)('platform_editor_slash_app_category_analytics') || (0, _isExperimentEnabled.isExperimentEnabled)('platform_editor_slash_command') ? {
     app: (_ref = (_extensionModule$app = extensionModule.app) !== null && _extensionModule$app !== void 0 ? _extensionModule$app : manifest.app) !== null && _ref !== void 0 ? _ref : {
       key: manifest.key
     }
@@ -38,7 +39,9 @@ function buildMenuItem(manifest, extensionModule) {
     summary: manifest.summary,
     documentationUrl: manifest.documentationUrl,
     priority: extensionModule.priority
-  }, extensionModule.lozenge != null && {
+  }, preview != null && {
+    preview: preview
+  }), extensionModule.lozenge != null && {
     lozenge: extensionModule.lozenge
   }), {}, {
     icon: extensionModule.icon || manifest.icons['48'],

package/dist/cjs/monitoring/error.js

@@ -27,7 +27,7 @@ var NETWORK_FAILURE_REGEX = /^network failure/i;
 var RESIZE_OBSERVER_LOOP_REGEX = /ResizeObserver loop completed with undelivered notifications/;
 var SENTRY_DSN = 'https://0b10c8e02fb44d8796c047b102c9bee8@o55978.ingest.sentry.io/4505129224110080';
 var packageName = 'editor-common'; // Sentry doesn't accept '/' in its releases https://docs.sentry.io/platforms/javascript/configuration/releases/
-var packageVersion = "125.2.1";
+var packageVersion = "125.4.0";
 var sanitiseSentryEvents = function sanitiseSentryEvents(data, _hint) {
   // Remove URL as it has UGC
   // Ignored via go/ees007

package/dist/cjs/quick-insert/CompactQuickInsertMenuItem.compiled.css

@@ -1,7 +1,6 @@
 ._11c8wadc{font:var(--ds-font-body-small,normal 400 9pt/1pc "Atlassian Sans",ui-sans-serif,-apple-system,BlinkMacSystemFont,"Segoe UI",Ubuntu,"Helvetica Neue",sans-serif)}
 ._2rko12b0{border-radius:var(--ds-radius-small,4px)}
 ._2rko1mok{border-radius:var(--ds-radius-large,8px)}
-._2rko1qi0{border-radius:var(--ds-radius-medium,6px)}
 ._189ee4h9{border-width:var(--ds-border-width,1px)}
 ._18zr1b66{padding-inline:var(--ds-space-050,4px)}
 ._1dqonqa1{border-style:solid}

package/dist/cjs/quick-insert/CompactQuickInsertMenuItem.js

@@ -11,8 +11,6 @@ require("./CompactQuickInsertMenuItem.compiled.css");
 var _runtime = require("@compiled/react/runtime");
 var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
 var _react = _interopRequireWildcard(require("react"));
-var _buttonItem = _interopRequireDefault(require("@atlaskit/menu/button-item"));
-var _isExperimentEnabled = require("@atlaskit/platform-feature-experiments/is-experiment-enabled");
 var _primitives = require("@atlaskit/primitives");
 var _compiled = require("@atlaskit/primitives/compiled");
 var _QuickInsertHoverPreview = require("./QuickInsertHoverPreview");
@@ -23,7 +21,6 @@ function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r
 var styles = {
   iconContainer: "_4cvr1h6o _1e0c1txw _1o9zidpf _1bah1h6o _1tke1tcg _1ul91tcg",
   content: "_16jlkb7n _1o9zkb7n _i0dlidpf _1ul9idpf",
-  icon: "_2rko1qi0 _1reo15vq _18m915vq _1h6d1l7x _1dqonqa1 _189ee4h9 _4cvr1h6o _bfhk1bhr _1e0c1txw _4t3izwfg _1bah1h6o _1bsbzwfg",
   iconLarge: "_2rko1mok _1reo15vq _18m915vq _1h6d1l7x _1dqonqa1 _189ee4h9 _4cvr1h6o _bfhk1bhr _1e0c1txw _4t3izwfg _1bah1h6o _1bsbzwfg",
   shortcut: "_2rko12b0 _11c8wadc _1rjcv77o _18zr1b66 _bfhki8nm _syazazsu"
 };
@@ -81,12 +78,17 @@ var disabledItemStyles = (0, _primitives.xcss)({
   width: '100%'
 });
 var CompactQuickInsertMenuItem = exports.CompactQuickInsertMenuItem = function CompactQuickInsertMenuItem(_ref) {
+  var _ref3, _resolvedPreview$imag, _resolvedPreview$imag2, _resolvedPreview$attr;
   var ariaLabel = _ref.ariaLabel,
+    description = _ref.description,
     iconBefore = _ref.iconBefore,
     isDisabled = _ref.isDisabled,
     onSelect = _ref.onSelect,
+    preview = _ref.preview,
     previewImageUrls = _ref.previewImageUrls,
     shortcut = _ref.shortcut,
+    _ref$shouldShowPrevie = _ref.shouldShowPreview,
+    shouldShowPreview = _ref$shouldShowPrevie === void 0 ? true : _ref$shouldShowPrevie,
     _ref$shouldWrapIcon = _ref.shouldWrapIcon,
     shouldWrapIcon = _ref$shouldWrapIcon === void 0 ? true : _ref$shouldWrapIcon,
     title = _ref.title;
@@ -98,38 +100,27 @@ var CompactQuickInsertMenuItem = exports.CompactQuickInsertMenuItem = function C
     },
     id = _ref2.id,
     isSelected = _ref2.isSelected;
+  var resolvedDescription = description !== null && description !== void 0 ? description : item === null || item === void 0 ? void 0 : item.description;
+  var previewId = (0, _react.useId)();
   var handleClick = (0, _quickInsertMenuItemUtils.useQuickInsertMenuItemSelection)(onSelect);
   var _useState = (0, _react.useState)(null),
     _useState2 = (0, _slicedToArray2.default)(_useState, 2),
     referenceElement = _useState2[0],
     setReferenceElement = _useState2[1];
-  if (!(0, _isExperimentEnabled.isExperimentEnabled)('platform_editor_slash_command')) {
-    var _wrappedIcon = iconBefore && shouldWrapIcon ? /*#__PURE__*/_react.default.createElement(_compiled.Box, {
-      xcss: styles.icon
-    }, iconBefore) : iconBefore;
-    return /*#__PURE__*/_react.default.createElement(_buttonItem.default, {
-      "aria-label": ariaLabel,
-      "aria-selected": isSelected,
-      iconBefore: _wrappedIcon,
-      id: id,
-      isDisabled: isDisabled,
-      isSelected: isSelected,
-      onClick: handleClick,
-      role: "option"
-    }, /*#__PURE__*/_react.default.createElement(_compiled.Inline, {
-      alignBlock: "center",
-      spread: "space-between"
-    }, /*#__PURE__*/_react.default.createElement(_compiled.Text, null, title), shortcut && /*#__PURE__*/_react.default.createElement(_compiled.Box, {
-      as: "span",
-      xcss: styles.shortcut
-    }, shortcut)));
-  }
+  var resolvedPreview = (0, _react.useMemo)(function () {
+    return preview !== null && preview !== void 0 ? preview : previewImageUrls ? {
+      image: previewImageUrls
+    } : {};
+  }, [preview, previewImageUrls]);
+  var shouldRenderPreview = shouldShowPreview && isSelected && !isDisabled;
+  var hasAccessiblePreview = Boolean(resolvedDescription || (resolvedPreview === null || resolvedPreview === void 0 ? void 0 : resolvedPreview.attribution));
   var wrappedIcon = iconBefore && shouldWrapIcon ? /*#__PURE__*/_react.default.createElement(_compiled.Box, {
     xcss: styles.iconLarge
   }, iconBefore) : iconBefore;
   return /*#__PURE__*/_react.default.createElement(_react.default.Fragment, null, /*#__PURE__*/_react.default.createElement(_primitives.Pressable, {
     ref: setReferenceElement,
     "aria-label": ariaLabel,
+    "aria-describedby": shouldRenderPreview && hasAccessiblePreview ? previewId : undefined,
     "aria-selected": isSelected,
     id: id,
     isDisabled: isDisabled,
@@ -145,9 +136,12 @@ var CompactQuickInsertMenuItem = exports.CompactQuickInsertMenuItem = function C
   }, /*#__PURE__*/_react.default.createElement(_compiled.Text, null, title), shortcut && /*#__PURE__*/_react.default.createElement(_compiled.Box, {
     as: "span",
     xcss: styles.shortcut
-  }, shortcut))), isSelected && !isDisabled && (previewImageUrls === null || previewImageUrls === void 0 ? void 0 : previewImageUrls.light) && referenceElement && /*#__PURE__*/_react.default.createElement(_QuickInsertHoverPreview.QuickInsertHoverPreview, {
-    key: previewImageUrls.light,
-    previewImageUrls: previewImageUrls,
-    referenceElement: referenceElement
+  }, shortcut))), shouldRenderPreview && referenceElement && /*#__PURE__*/_react.default.createElement(_QuickInsertHoverPreview.QuickInsertHoverPreview, {
+    key: (_ref3 = (_resolvedPreview$imag = (_resolvedPreview$imag2 = resolvedPreview.image) === null || _resolvedPreview$imag2 === void 0 ? void 0 : _resolvedPreview$imag2.light) !== null && _resolvedPreview$imag !== void 0 ? _resolvedPreview$imag : (_resolvedPreview$attr = resolvedPreview.attribution) === null || _resolvedPreview$attr === void 0 ? void 0 : _resolvedPreview$attr.name) !== null && _ref3 !== void 0 ? _ref3 : title,
+    id: previewId,
+    description: resolvedDescription,
+    preview: resolvedPreview,
+    referenceElement: referenceElement,
+    title: title
   }));
 };

package/dist/cjs/quick-insert/QuickInsertHoverPreview.compiled.css

@@ -1,4 +1,45 @@
+._11c81qyo{font:var(--ds-font-heading-xsmall,normal 653 14px/20px "Atlassian Sans",ui-sans-serif,-apple-system,BlinkMacSystemFont,"Segoe UI",Ubuntu,"Helvetica Neue",sans-serif)}
+._11c8fhey{font:var(--ds-font-body,normal 400 14px/20px "Atlassian Sans",ui-sans-serif,-apple-system,BlinkMacSystemFont,"Segoe UI",Ubuntu,"Helvetica Neue",sans-serif)}
+._11c8wadc{font:var(--ds-font-body-small,normal 400 9pt/1pc "Atlassian Sans",ui-sans-serif,-apple-system,BlinkMacSystemFont,"Segoe UI",Ubuntu,"Helvetica Neue",sans-serif)}
+._2rko12b0{border-radius:var(--ds-radius-small,4px)}
+._2rko1qi0{border-radius:var(--ds-radius-medium,6px)}
+._zulp1b66{gap:var(--ds-space-050,4px)}
+._zulpu2gc{gap:var(--ds-space-100,8px)}
+._18zrutpp{padding-inline:var(--ds-space-150,9pt)}
+._1rjcutpp{padding-block:var(--ds-space-150,9pt)}
+._16jlidpf{flex-grow:0}
+._16qs130s{box-shadow:var(--ds-shadow-overlay,0 8px 9pt #1e1f2126,0 0 1px #1e1f214f)}
+._18m915vq{overflow-y:hidden}
+._1bah1h6o{justify-content:center}
+._1bsb1osq{width:100%}
+._1bsb7vkz{width:1pc}
+._1bsbncxg{width:264px}
+._1bsbp3fh{width:15pc}
+._1e0c1txw{display:flex}
 ._1e0c1ule{display:block}
+._1e0ccj1k{display:-webkit-box}
+._1i4qfg65{overflow-wrap:anywhere}
+._1o9zidpf{flex-shrink:0}
 ._1pby16oo{z-index:510}
+._1reo15vq{overflow-x:hidden}
+._1yyjcs5v{-webkit-line-clamp:2}
+._1yyjegat{-webkit-line-clamp:4}
+._2lx21bp4{flex-direction:column}
 ._3um015vq{visibility:hidden}
-._3um0ewfl{visibility:visible}
+._4cvr1h6o{align-items:center}
+._4t3i1osq{height:100%}
+._4t3i68cl{height:90pt}
+._4t3i7vkz{height:1pc}
+._5ral1f51{object-fit:contain}
+._6rthu2gc{margin-block-end:var(--ds-space-100,8px)}
+._bfhk1bhr{background-color:var(--ds-surface-overlay,#fff)}
+._bfhkhfxm{background-color:var(--ds-surface-sunken,#f8f8f8)}
+._c71l1kw7{max-height:inherit}
+._c71lk6is{max-height:calc(100vh - 1pc)}
+._i0dlexct{flex-basis:16px}
+._p12f1oec{max-width:calc(100vw - 1pc)}
+._p12f1osq{max-width:100%}
+._sudp1e54{-webkit-box-orient:vertical}
+._syazazsu{color:var(--ds-text-subtle,#505258)}
+._syazi7uo{color:var(--ds-text,#292a2e)}
+._vchhusvi{box-sizing:border-box}

package/dist/cjs/quick-insert/QuickInsertHoverPreview.js

@@ -11,93 +11,172 @@ require("./QuickInsertHoverPreview.compiled.css");
 var _react = _interopRequireWildcard(require("react"));
 var React = _react;
 var _runtime = require("@compiled/react/runtime");
-var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
 var _reactDom = require("react-dom");
-var _main = require("@atlaskit/popper/main");
+var _reactIntl = require("react-intl");
+var _reactPopper = require("@atlaskit/popper/react-popper");
+var _text = require("@atlaskit/primitives/compiled/text");
 var _useThemeObserver2 = require("@atlaskit/tokens/use-theme-observer");
+var _messages = require("./messages");
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != _typeof(e) && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (var _t in e) "default" !== _t && {}.hasOwnProperty.call(e, _t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, _t)) && (i.get || i.set) ? o(f, _t, i) : f[_t] = e[_t]); return f; })(e, t); }
-function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
-function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { (0, _defineProperty2.default)(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
-var PREVIEW_WIDTH = 294;
-var PREVIEW_OFFSET = [-4, 4];
+// Viewport calculations and multiline clamping require styles outside @atlaskit/css's schema.
+// Viewport clamping requires modifiers, which the top-layer adapter does not support.
 var PREVIEW_MODIFIERS = [{
+  name: 'offset',
+  options: {
+    offset: [0, 4]
+  }
+}, {
+  name: 'flip',
+  options: {
+    fallbackPlacements: ['left-start'],
+    // Choose the side by horizontal space; vertical overflow is shifted into view.
+    altAxis: false,
+    padding: 8,
+    rootBoundary: 'viewport'
+  }
+}, {
   name: 'preventOverflow',
   options: {
-    mainAxis: false
+    mainAxis: true,
+    altAxis: true,
+    tether: false,
+    padding: 8,
+    rootBoundary: 'viewport'
   }
 }];
 var styles = {
-  image: "_1e0c1ule _1pby16oo",
-  hidden: "_3um015vq",
-  visible: "_3um0ewfl"
+  positioner: "_c71lk6is _p12f1oec _1pby16oo",
+  panel: "_2rko1qi0 _1reo15vq _18m915vq _1rjcutpp _18zrutpp _vchhusvi _bfhk1bhr _16qs130s _c71l1kw7 _p12f1osq _1bsbncxg",
+  content: "_zulpu2gc _1e0c1txw _2lx21bp4",
+  title: "_11c81qyo _1reo15vq _18m915vq _syazazsu _1i4qfg65 _1e0ccj1k _sudp1e54 _1yyjcs5v",
+  description: "_11c8fhey _1reo15vq _18m915vq _syazi7uo _1e0ccj1k _1i4qfg65 _sudp1e54 _1yyjegat",
+  imageArea: "_2rko12b0 _1reo15vq _18m915vq _bfhkhfxm _4t3i68cl _6rthu2gc _p12f1osq _1bsbp3fh",
+  image: "_1e0c1ule _4t3i1osq _5ral1f51 _1bsb1osq",
+  imageHidden: "_3um015vq",
+  attribution: "_11c8wadc _zulp1b66 _4cvr1h6o _syazazsu _1e0c1txw _1i4qfg65",
+  attributionIcon: "_16jlidpf _1o9zidpf _i0dlexct _4cvr1h6o _1e0c1txw _4t3i7vkz _1bah1h6o _1bsb7vkz"
 };
 
-/** A non-interactive visual preview: keep focus and keyboard handling in the editor. */
+/** The selected item's description and attribution are announced through its aria-describedby. */
 var QuickInsertHoverPreview = exports.QuickInsertHoverPreview = function QuickInsertHoverPreview(_ref) {
-  var previewImageUrls = _ref.previewImageUrls,
-    referenceElement = _ref.referenceElement;
+  var description = _ref.description,
+    id = _ref.id,
+    preview = _ref.preview,
+    referenceElement = _ref.referenceElement,
+    title = _ref.title;
   var _useThemeObserver = (0, _useThemeObserver2.useThemeObserver)(),
     colorMode = _useThemeObserver.colorMode;
-  var previewImageUrl = colorMode === 'dark' && previewImageUrls.dark ? previewImageUrls.dark : previewImageUrls.light;
-  return /*#__PURE__*/React.createElement(QuickInsertHoverPreviewImage, {
-    key: previewImageUrl,
-    previewImageUrl: previewImageUrl,
-    referenceElement: referenceElement
-  });
-};
-var QuickInsertHoverPreviewImage = function QuickInsertHoverPreviewImage(_ref2) {
-  var previewImageUrl = _ref2.previewImageUrl,
-    referenceElement = _ref2.referenceElement;
-  var _useState = (0, _react.useState)(false),
-    _useState2 = (0, _slicedToArray2.default)(_useState, 2),
-    hasFailed = _useState2[0],
-    setHasFailed = _useState2[1];
-  var _useState3 = (0, _react.useState)(),
-    _useState4 = (0, _slicedToArray2.default)(_useState3, 2),
-    dimensions = _useState4[0],
-    setDimensions = _useState4[1];
-  if (hasFailed) {
-    return null;
-  }
-
-  // Unlike a dialog popup, this decorative preview must not introduce focus or ARIA ownership.
-  return /*#__PURE__*/(0, _reactDom.createPortal)( /*#__PURE__*/React.createElement(_main.Popper, {
-    offset: PREVIEW_OFFSET,
+  var imageUrl = preview.image ? colorMode === 'dark' && preview.image.dark ? preview.image.dark : preview.image.light : undefined;
+  var hasAccessibleContent = Boolean(description || preview.attribution);
+  return /*#__PURE__*/(0, _reactDom.createPortal)( /*#__PURE__*/React.createElement(_reactPopper.Popper, {
     placement: "right-start",
     referenceElement: referenceElement,
     strategy: "fixed",
-    shouldFitViewport: true,
     modifiers: PREVIEW_MODIFIERS
-  }, function (_ref3) {
-    var ref = _ref3.ref,
-      style = _ref3.style;
-    return /*#__PURE__*/React.createElement("img", {
+  }, function (_ref2) {
+    var ref = _ref2.ref,
+      style = _ref2.style,
+      update = _ref2.update;
+    return /*#__PURE__*/React.createElement("div", {
       ref: ref,
-      style: _objectSpread(_objectSpread({}, style), {}, {
-        height: dimensions === null || dimensions === void 0 ? void 0 : dimensions.height,
-        width: dimensions === null || dimensions === void 0 ? void 0 : dimensions.width
-      }),
-      "aria-hidden": "true",
-      "data-testid": "quick-insert-hover-preview",
-      src: previewImageUrl,
-      alt: "",
-      onLoad: function onLoad(event) {
-        var _event$currentTarget = event.currentTarget,
-          naturalHeight = _event$currentTarget.naturalHeight,
-          naturalWidth = _event$currentTarget.naturalWidth;
-        if (naturalWidth === 0) {
-          return;
-        }
-        setDimensions({
-          height: naturalHeight / naturalWidth * PREVIEW_WIDTH,
-          width: PREVIEW_WIDTH
-        });
-      },
-      onError: function onError() {
-        return setHasFailed(true);
-      },
-      className: (0, _runtime.ax)([styles.image, dimensions ? styles.visible : styles.hidden])
-    });
+      style: style,
+      className: (0, _runtime.ax)([styles.positioner])
+    }, /*#__PURE__*/React.createElement(QuickInsertPreviewPanel, {
+      description: description,
+      id: hasAccessibleContent ? id : undefined,
+      imageUrl: imageUrl,
+      preview: preview,
+      referenceElement: referenceElement,
+      title: title,
+      update: update
+    }));
   }), referenceElement.ownerDocument.body);
+};
+var QuickInsertPreviewPanel = function QuickInsertPreviewPanel(_ref3) {
+  var _preview$attribution;
+  var description = _ref3.description,
+    id = _ref3.id,
+    imageUrl = _ref3.imageUrl,
+    preview = _ref3.preview,
+    referenceElement = _ref3.referenceElement,
+    title = _ref3.title,
+    update = _ref3.update;
+  var _useIntl = (0, _reactIntl.useIntl)(),
+    formatMessage = _useIntl.formatMessage;
+  var _useState = (0, _react.useState)(null),
+    _useState2 = (0, _slicedToArray2.default)(_useState, 2),
+    panelElement = _useState2[0],
+    setPanelElement = _useState2[1];
+  var AttributionIcon = (_preview$attribution = preview.attribution) === null || _preview$attribution === void 0 ? void 0 : _preview$attribution.icon;
+  (0, _react.useLayoutEffect)(function () {
+    var _referenceElement$own;
+    void update();
+    var ResizeObserverConstructor = (_referenceElement$own = referenceElement.ownerDocument.defaultView) === null || _referenceElement$own === void 0 ? void 0 : _referenceElement$own.ResizeObserver;
+    if (!panelElement || !ResizeObserverConstructor) {
+      return;
+    }
+    var observer = new ResizeObserverConstructor(function () {
+      return void update();
+    });
+    observer.observe(panelElement);
+    return function () {
+      return observer.disconnect();
+    };
+  }, [panelElement, referenceElement, update]);
+  return /*#__PURE__*/React.createElement("div", {
+    ref: setPanelElement,
+    id: id,
+    role: id ? 'tooltip' : undefined,
+    "data-testid": "quick-insert-preview-panel",
+    className: (0, _runtime.ax)([styles.panel])
+  }, imageUrl && /*#__PURE__*/React.createElement(PreviewImage, {
+    key: imageUrl,
+    imageUrl: imageUrl
+  }), /*#__PURE__*/React.createElement("div", {
+    className: (0, _runtime.ax)([styles.content])
+  }, /*#__PURE__*/React.createElement("div", {
+    "aria-hidden": "true",
+    className: (0, _runtime.ax)([styles.title])
+  }, title), description && /*#__PURE__*/React.createElement("div", {
+    className: (0, _runtime.ax)([styles.description])
+  }, description), preview.attribution && /*#__PURE__*/React.createElement("div", {
+    className: (0, _runtime.ax)([styles.attribution])
+  }, AttributionIcon && /*#__PURE__*/React.createElement("span", {
+    "aria-hidden": "true",
+    className: (0, _runtime.ax)([styles.attributionIcon])
+  }, /*#__PURE__*/React.createElement(AttributionIcon, null)), /*#__PURE__*/React.createElement(_text.Text, {
+    size: "small",
+    color: "color.text.subtle"
+  }, AttributionIcon ? preview.attribution.name : formatMessage(_messages.messages.previewAttributionBy, {
+    name: preview.attribution.name
+  })))));
+};
+var PreviewImage = function PreviewImage(_ref4) {
+  var imageUrl = _ref4.imageUrl;
+  var _useState3 = (0, _react.useState)(false),
+    _useState4 = (0, _slicedToArray2.default)(_useState3, 2),
+    hasFailed = _useState4[0],
+    setHasFailed = _useState4[1];
+  var _useState5 = (0, _react.useState)(false),
+    _useState6 = (0, _slicedToArray2.default)(_useState5, 2),
+    hasLoaded = _useState6[0],
+    setHasLoaded = _useState6[1];
+  return /*#__PURE__*/React.createElement("div", {
+    "aria-hidden": "true",
+    "data-testid": "quick-insert-preview-image-area",
+    className: (0, _runtime.ax)([styles.imageArea])
+  }, !hasFailed && /*#__PURE__*/React.createElement("img", {
+    "aria-hidden": "true",
+    "data-testid": "quick-insert-hover-preview",
+    src: imageUrl,
+    alt: "",
+    onLoad: function onLoad() {
+      return setHasLoaded(true);
+    },
+    onError: function onError() {
+      return setHasFailed(true);
+    },
+    className: (0, _runtime.ax)([styles.image, !hasLoaded && styles.imageHidden])
+  }));
 };

package/dist/cjs/quick-insert/QuickInsertMenuItem.js

@@ -15,8 +15,10 @@ var QuickInsertMenuItem = exports.QuickInsertMenuItem = function QuickInsertMenu
     iconBefore = _ref.iconBefore,
     isDisabled = _ref.isDisabled,
     onSelect = _ref.onSelect,
+    preview = _ref.preview,
     previewImageUrls = _ref.previewImageUrls,
     shortcut = _ref.shortcut,
+    shouldShowPreview = _ref.shouldShowPreview,
     shouldWrapIcon = _ref.shouldWrapIcon,
     title = _ref.title;
   var _useQuickInsertContex = (0, _useQuickInsertContext.useQuickInsertContext)(),
@@ -36,8 +38,10 @@ var QuickInsertMenuItem = exports.QuickInsertMenuItem = function QuickInsertMenu
     iconBefore: iconBefore,
     isDisabled: isDisabled,
     onSelect: onSelect,
+    preview: preview,
     previewImageUrls: previewImageUrls,
     shortcut: shortcut,
+    shouldShowPreview: shouldShowPreview,
     shouldWrapIcon: shouldWrapIcon,
     title: title
   });

package/dist/cjs/quick-insert/QuickInsertMenuSection.js

@@ -6,11 +6,18 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.QuickInsertMenuSection = void 0;
 var _react = _interopRequireDefault(require("react"));
-var _section = _interopRequireDefault(require("@atlaskit/menu/section"));
+var _headingItem = _interopRequireDefault(require("@atlaskit/menu/heading-item"));
+var _box = require("@atlaskit/primitives/compiled/box");
 var QuickInsertMenuSection = exports.QuickInsertMenuSection = function QuickInsertMenuSection(_ref) {
   var children = _ref.children,
     title = _ref.title;
-  return /*#__PURE__*/_react.default.createElement(_section.default, {
-    title: title
-  }, children);
+  return /*#__PURE__*/_react.default.createElement(_box.Box, {
+    role: "group",
+    "aria-label": title
+  }, /*#__PURE__*/_react.default.createElement(_box.Box, {
+    paddingBlockStart: "space.150",
+    paddingBlockEnd: "space.050"
+  }, /*#__PURE__*/_react.default.createElement(_headingItem.default, {
+    "aria-hidden": true
+  }, title)), children);
 };

package/dist/cjs/quick-insert/confluence-attribution-icon.js

@@ -0,0 +1,18 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.ConfluenceAttributionIcon = void 0;
+var _react = _interopRequireDefault(require("react"));
+var _rawIcons = require("@atlaskit/logo/raw-icons");
+/** Decorative product icon accompanying the localized Confluence attribution name. */
+var ConfluenceAttributionIcon = exports.ConfluenceAttributionIcon = function ConfluenceAttributionIcon() {
+  return /*#__PURE__*/_react.default.createElement("img", {
+    src: _rawIcons.confluenceIcon,
+    alt: "",
+    width: 16,
+    height: 16
+  });
+};

package/dist/cjs/quick-insert/jira-attribution-icon.js

@@ -0,0 +1,18 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.JiraAttributionIcon = void 0;
+var _react = _interopRequireDefault(require("react"));
+var _rawIcons = require("@atlaskit/logo/raw-icons");
+/** Decorative product icon accompanying the localized Jira attribution name. */
+var JiraAttributionIcon = exports.JiraAttributionIcon = function JiraAttributionIcon() {
+  return /*#__PURE__*/_react.default.createElement("img", {
+    src: _rawIcons.jiraIcon,
+    alt: "",
+    width: 16,
+    height: 16
+  });
+};