@atlaskit/editor-common 122.2.1 → 122.3.1

package/CHANGELOG.md

@@ -1,5 +1,44 @@
 # @atlaskit/editor-common
 
+## 122.3.1
+
+### Patch Changes
+
+- [`0165bd2a039d1`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/0165bd2a039d1) -
+  Clean up feature gate `platform_editor_blocks_patch_9`
+- Updated dependencies
+
+## 122.3.0
+
+### Minor Changes
+
+- [`e909670f087d4`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/e909670f087d4) -
+  Update i18n NPM package versions for editor,editor-extensions,activity-platform,media,elements
+  (Group 3)
+
+### Patch Changes
+
+- [`0265ca1688db1`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/0265ca1688db1) -
+  [EDITOR-8971] `VanillaTooltip` takes an optional container to append its tooltip to, instead of
+  appending it inside the trigger. Opt-in per caller, and used by the diff contributor tag; every
+  other tooltip is unchanged.
+
+  Diff contributor tag fixes, all behind `confluence_ncs_step_diffing_version_history`:
+  - The tag's full label no longer renders off screen. Its tooltip is hoisted out of the tag, so
+    Popper and the browser measure a top-layer popover from the same origin — inside the trigger
+    they disagreed whenever an ancestor was transformed, such as a wide image.
+  - Stepping to a change reveals only that change's tag, not every tag the active range touches.
+  - A contributor no longer gets two tags inside one navigation stop. Two of their changes that
+    merely touched each kept a tag, and the trailing one could be hovered but never stepped to; it
+    now folds into the leading tag and stays a hover target. Tags for different contributors sharing
+    a stop are still kept apart.
+  - A tag on deleted content no longer disappears when the document changes. Any change remaps the
+    decoration, which rebuilds its widget and fired the teardown — but the deleted-content widget's
+    DOM is reused as-is and runs no mount callback, so the tag was faded out of a change that was
+    still the active one. The tag is now kept whenever its host is still in a live editor.
+
+- Updated dependencies
+
 ## 122.2.1
 
 ### Patch Changes

package/codemods/117.0.0-upgrade-react-peer-dependencies.ts

@@ -6,22 +6,9 @@ const NEW_PEER_DEP_RANGE = '^18.2.0 || ^19.2.0'; // Ensure backwards compatible
 const NEW_DEV_DEP_RANGE = '^19.2.0'; // Ensure everyone is using React 19 types from now on
 const VALID_ORIGINAL_RANGES = [NEW_PEER_DEP_RANGE, NEW_DEV_DEP_RANGE, 'root:*', '^18.2.0'];
 
-const EXCLUDED_PACKAGE_JSON_PATHS = [
-	'packages/editor/renderer/package.json',
-	'packages/editor/editor-plugin-block-controls-tests/package.json',
-	'packages/editor/editor-plugin-media-tests/package.json',
-	'packages/editor/editor-plugin-ai/package.json',
-	'packages/editor/editor-common-tests/package.json',
-	'packages/editor/editor-core/package.json',
-	'packages/editor/editor-plugin-ai-tests/package.json',
-	'packages/editor/editor-plugin-extension-tests/package.json',
-	'packages/editor/editor-plugin-synced-block-tests/package.json',
-	'packages/editor/generative-ai-modal/package.json',
-	'packages/editor/editor-plugin-show-diff-tests/package.json',
-	'packages/editor/editor-plugin-table-tests/package.json',
-	'packages/editor/editor-plugin-quick-insert-tests/package.json',
-	'packages/editor/editor-referentiality/package.json',
-	'packages/editor/editor-synced-block-renderer-tests/package.json',
+const EXCLUDED_PACKAGE_JSON_PATHS: string[] = [
+	// Example - this will exclude editor-core from upgrade
+	// 'packages/editor/editor-core/package.json',
 ];
 
 type DependencyName = 'react' | 'react-dom' | '@types/react' | '@types/react-dom';

package/dist/cjs/copy-button/index.js

@@ -9,7 +9,6 @@ exports.toDOM = void 0;
 var _model = require("@atlaskit/editor-prosemirror/model");
 var _state = require("@atlaskit/editor-prosemirror/state");
 var _utils = require("@atlaskit/editor-prosemirror/utils");
-var _fg = require("@atlaskit/platform-feature-flags/fg");
 var _clipboard = require("../clipboard");
 var _browser = require("../utils/browser");
 function getSelectedNodeOrNodeParentByNodeType(_ref) {
@@ -57,10 +56,8 @@ var copyDomNodeWithResult = exports.copyDomNodeWithResult = function copyDomNode
   var isSyncedBlock = nodeType.name === 'syncBlock' || nodeType.name === 'bodiedSyncBlock';
   if (browser.safari && isSyncedBlock) {
     // clipboard-polyfill/native-first clipboard.write only reaches DOM fallback after rejection; Safari can
-    // resolve native writes without retaining synced-block HTML, so Patch 9 forces copy-event/execCommand while click activation is live.
-    if ((0, _fg.fg)('platform_editor_blocks_patch_9')) {
-      return (0, _clipboard.copyHTMLToClipboardSynchronously)(div);
-    }
+    // resolve native writes without retaining synced-block HTML, so we force copy-event/execCommand while click activation is live.
+    return (0, _clipboard.copyHTMLToClipboardSynchronously)(div);
   }
 
   // Safari's ClipboardItem API may not preserve HTML for extension nodes or mediaSingle nodes.

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 = "122.2.0";
+var packageVersion = "122.3.0";
 var sanitiseSentryEvents = function sanitiseSentryEvents(data, _hint) {
   // Remove URL as it has UGC
   // Ignored via go/ees007

package/dist/cjs/ui/DropList/index.js

@@ -24,7 +24,7 @@ function _isNativeReflectConstruct() { try { var t = !Boolean.prototype.valueOf.
  * @jsx jsx
  */ // eslint-disable-next-line @atlaskit/ui-styling-standard/use-compiled -- Ignored via go/DSP-18766
 var packageName = "@atlaskit/editor-common";
-var packageVersion = "122.2.0";
+var packageVersion = "122.3.0";
 var halfFocusRing = 1;
 var dropOffset = '0, 8';
 var fadeIn = (0, _react2.keyframes)({

package/dist/cjs/vanilla-tooltip/index.js

@@ -80,9 +80,9 @@ var VanillaTooltip = exports.VanillaTooltip = /*#__PURE__*/function () {
    * only element the browser honours `popovertarget` on. Anything else works, since this
    * class calls `showPopover()`/`hidePopover()` itself, but then make sure it:
    *
-   * - **Renders its children**, as the tooltip is appended to the trigger. `<img>`, `<input>`
-   *   and `<br>` accept the append without error but never render it, leaving the tooltip
-   *   silently at zero size.
+   * - **Renders its children**, as the tooltip is appended to the trigger — unless
+   *   `hoistContainer` is given. `<img>`, `<input>` and `<br>` accept the append without error
+   *   but never render it, leaving the tooltip silently at zero size.
    * - **Is reachable**, if keyboard and screen reader users need the tooltip — usually
    *   `tabindex="0"` plus a role and accessible name, since `focus`/`blur` are bound to the
    *   trigger and `aria-describedby` is set on it.
@@ -116,6 +116,22 @@ var VanillaTooltip = exports.VanillaTooltip = /*#__PURE__*/function () {
      */
     onShow = arguments.length > 6 ? arguments[6] : undefined;
     var placement = arguments.length > 7 && arguments[7] !== undefined ? arguments[7] : 'top';
+    var
+    /**
+     * Where to append the tooltip, instead of inside the trigger.
+     *
+     * Pass a container when anything between the trigger and the viewport is transformed. The
+     * browser resolves a top-layer popover's position against the viewport, while Popper — which
+     * reads `offsetParent`, and gets `null` for anything in the top layer — falls back to the
+     * nearest ancestor with a `transform`. Inside a wide image that ancestor is `.rich-media-item`,
+     * whose `translateX(-50%)` threw the tooltip off screen (EDITOR-8971). Appended to a container
+     * with no transform above it, the two measure from the same origin.
+     *
+     * Opt-in per caller: the tooltip leaves the trigger's subtree, so anything styling it through
+     * an ancestor stops matching — including `VANILLA_TOOLTIP_DEFAULT_CLASS`, whose rule is scoped
+     * under `.ProseMirror`. Pass `styles` for the look instead.
+     */
+    hoistContainer = arguments.length > 8 ? arguments[8] : undefined;
     (0, _classCallCheck2.default)(this, VanillaTooltip);
     (0, _defineProperty2.default)(this, "listeners", []);
     (0, _defineProperty2.default)(this, "shouldHidePopover", false);
@@ -124,6 +140,7 @@ var VanillaTooltip = exports.VanillaTooltip = /*#__PURE__*/function () {
     this.timeout = timeout;
     this.onShow = onShow;
     this.placement = placement;
+    this.hoistContainer = hoistContainer;
     // Created in the trigger's own document rather than the global one, so nothing depends on
     // the parent realm when the editor renders inside an iframe. Gated alongside the Escape
     // listener's window so the whole iframe fix moves as a single unit.
@@ -143,7 +160,7 @@ var VanillaTooltip = exports.VanillaTooltip = /*#__PURE__*/function () {
       Object.assign(tooltip.style, styles);
     }
     this.tooltip = tooltip;
-    this.trigger.appendChild(tooltip);
+    (hoistContainer !== null && hoistContainer !== void 0 ? hoistContainer : this.trigger).appendChild(tooltip);
     this.trigger.setAttribute('popovertarget', tooltip.id);
     this.trigger.setAttribute('aria-describedby', tooltip.id);
     var showEvents = ['mouseenter', 'focus'];
@@ -192,12 +209,22 @@ var VanillaTooltip = exports.VanillaTooltip = /*#__PURE__*/function () {
   }
 
   /**
-   * Closes the popover, tolerating it already being closed.
-   *
-   * A `hint` popover is light-dismissed by the browser whenever another `hint` or `auto` popover
-   * opens, so the caller can never be sure this one is still showing.
+   * The tooltip element, for callers that own its accessibility semantics — a hoisted tooltip is no
+   * longer reachable from the trigger.
    */
   return (0, _createClass2.default)(VanillaTooltip, [{
+    key: "element",
+    get: function get() {
+      return this.tooltip;
+    }
+
+    /**
+     * Closes the popover, tolerating it already being closed.
+     *
+     * A `hint` popover is light-dismissed by the browser whenever another `hint` or `auto` popover
+     * opens, so the caller can never be sure this one is still showing.
+     */
+  }, {
     key: "closePopover",
     value: function closePopover() {
       try {
@@ -257,8 +284,9 @@ var VanillaTooltip = exports.VanillaTooltip = /*#__PURE__*/function () {
       });
 
       // Undoes what the constructor added to the trigger, matching the React `@atlaskit/tooltip`
-      // callers are moving off, whose unmount took its DOM with it.
-      if ((0, _isExperimentEnabled.isExperimentEnabled)('platform_editor_use_vanilla_components')) {
+      // callers are moving off, whose unmount took its DOM with it. A hoisted tooltip is removed
+      // either way: it sits outside the trigger, so nothing else takes it away with it.
+      if ((0, _isExperimentEnabled.isExperimentEnabled)('platform_editor_use_vanilla_components') || this.hoistContainer) {
         // A popover removed while still showing is never light-dismissed, so the top layer
         // keeps treating it as open.
         this.closePopover();

package/dist/es2019/copy-button/index.js

@@ -1,7 +1,6 @@
 import { DOMSerializer } from '@atlaskit/editor-prosemirror/model';
 import { NodeSelection } from '@atlaskit/editor-prosemirror/state';
 import { findParentNodeOfType, findSelectedNodeOfType } from '@atlaskit/editor-prosemirror/utils';
-import { fg } from '@atlaskit/platform-feature-flags/fg';
 import { copyHTMLToClipboard, copyHTMLToClipboardPolyfill, copyHTMLToClipboardSynchronously } from '../clipboard';
 import { getBrowserInfo } from '../utils/browser';
 export function getSelectedNodeOrNodeParentByNodeType({
@@ -50,10 +49,8 @@ const copyDomNodeWithResult = (domNode, nodeType, selection) => {
   const isSyncedBlock = nodeType.name === 'syncBlock' || nodeType.name === 'bodiedSyncBlock';
   if (browser.safari && isSyncedBlock) {
     // clipboard-polyfill/native-first clipboard.write only reaches DOM fallback after rejection; Safari can
-    // resolve native writes without retaining synced-block HTML, so Patch 9 forces copy-event/execCommand while click activation is live.
-    if (fg('platform_editor_blocks_patch_9')) {
-      return copyHTMLToClipboardSynchronously(div);
-    }
+    // resolve native writes without retaining synced-block HTML, so we force copy-event/execCommand while click activation is live.
+    return copyHTMLToClipboardSynchronously(div);
   }
 
   // Safari's ClipboardItem API may not preserve HTML for extension nodes or mediaSingle nodes.

package/dist/es2019/monitoring/error.js

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

package/dist/es2019/ui/DropList/index.js

@@ -14,7 +14,7 @@ import withAnalyticsEvents from '@atlaskit/analytics-next/withAnalyticsEvents';
 import { fg } from '@atlaskit/platform-feature-flags/fg';
 import Layer from '../Layer';
 const packageName = "@atlaskit/editor-common";
-const packageVersion = "122.2.0";
+const packageVersion = "122.3.0";
 const halfFocusRing = 1;
 const dropOffset = '0, 8';
 const fadeIn = keyframes({

package/dist/es2019/vanilla-tooltip/index.js

@@ -67,9 +67,9 @@ export class VanillaTooltip {
    * only element the browser honours `popovertarget` on. Anything else works, since this
    * class calls `showPopover()`/`hidePopover()` itself, but then make sure it:
    *
-   * - **Renders its children**, as the tooltip is appended to the trigger. `<img>`, `<input>`
-   *   and `<br>` accept the append without error but never render it, leaving the tooltip
-   *   silently at zero size.
+   * - **Renders its children**, as the tooltip is appended to the trigger — unless
+   *   `hoistContainer` is given. `<img>`, `<input>` and `<br>` accept the append without error
+   *   but never render it, leaving the tooltip silently at zero size.
    * - **Is reachable**, if keyboard and screen reader users need the tooltip — usually
    *   `tabindex="0"` plus a role and accessible name, since `focus`/`blur` are bound to the
    *   trigger and `aria-describedby` is set on it.
@@ -104,7 +104,22 @@ export class VanillaTooltip {
    * Defaults to `'top'`, matching the default `position` of "@atlaskit/tooltip". Use
    * `'bottom'` to match its `position="mouse"`, which places the tooltip below the cursor.
    */
-  placement = 'top') {
+  placement = 'top',
+  /**
+   * Where to append the tooltip, instead of inside the trigger.
+   *
+   * Pass a container when anything between the trigger and the viewport is transformed. The
+   * browser resolves a top-layer popover's position against the viewport, while Popper — which
+   * reads `offsetParent`, and gets `null` for anything in the top layer — falls back to the
+   * nearest ancestor with a `transform`. Inside a wide image that ancestor is `.rich-media-item`,
+   * whose `translateX(-50%)` threw the tooltip off screen (EDITOR-8971). Appended to a container
+   * with no transform above it, the two measure from the same origin.
+   *
+   * Opt-in per caller: the tooltip leaves the trigger's subtree, so anything styling it through
+   * an ancestor stops matching — including `VANILLA_TOOLTIP_DEFAULT_CLASS`, whose rule is scoped
+   * under `.ProseMirror`. Pass `styles` for the look instead.
+   */
+  hoistContainer) {
     _defineProperty(this, "listeners", []);
     _defineProperty(this, "shouldHidePopover", false);
     _defineProperty(this, "isDisplayed", false);
@@ -112,6 +127,7 @@ export class VanillaTooltip {
     this.timeout = timeout;
     this.onShow = onShow;
     this.placement = placement;
+    this.hoistContainer = hoistContainer;
     // Created in the trigger's own document rather than the global one, so nothing depends on
     // the parent realm when the editor renders inside an iframe. Gated alongside the Escape
     // listener's window so the whole iframe fix moves as a single unit.
@@ -131,7 +147,7 @@ export class VanillaTooltip {
       Object.assign(tooltip.style, styles);
     }
     this.tooltip = tooltip;
-    this.trigger.appendChild(tooltip);
+    (hoistContainer !== null && hoistContainer !== void 0 ? hoistContainer : this.trigger).appendChild(tooltip);
     this.trigger.setAttribute('popovertarget', tooltip.id);
     this.trigger.setAttribute('aria-describedby', tooltip.id);
     const showEvents = ['mouseenter', 'focus'];
@@ -175,6 +191,14 @@ export class VanillaTooltip {
     }
   }
 
+  /**
+   * The tooltip element, for callers that own its accessibility semantics — a hoisted tooltip is no
+   * longer reachable from the trigger.
+   */
+  get element() {
+    return this.tooltip;
+  }
+
   /**
    * Closes the popover, tolerating it already being closed.
    *
@@ -233,8 +257,9 @@ export class VanillaTooltip {
     });
 
     // Undoes what the constructor added to the trigger, matching the React `@atlaskit/tooltip`
-    // callers are moving off, whose unmount took its DOM with it.
-    if (isExperimentEnabled('platform_editor_use_vanilla_components')) {
+    // callers are moving off, whose unmount took its DOM with it. A hoisted tooltip is removed
+    // either way: it sits outside the trigger, so nothing else takes it away with it.
+    if (isExperimentEnabled('platform_editor_use_vanilla_components') || this.hoistContainer) {
       // A popover removed while still showing is never light-dismissed, so the top layer
       // keeps treating it as open.
       this.closePopover();

package/dist/esm/copy-button/index.js

@@ -1,7 +1,6 @@
 import { DOMSerializer } from '@atlaskit/editor-prosemirror/model';
 import { NodeSelection } from '@atlaskit/editor-prosemirror/state';
 import { findParentNodeOfType, findSelectedNodeOfType } from '@atlaskit/editor-prosemirror/utils';
-import { fg } from '@atlaskit/platform-feature-flags/fg';
 import { copyHTMLToClipboard, copyHTMLToClipboardPolyfill, copyHTMLToClipboardSynchronously } from '../clipboard';
 import { getBrowserInfo } from '../utils/browser';
 export function getSelectedNodeOrNodeParentByNodeType(_ref) {
@@ -49,10 +48,8 @@ var copyDomNodeWithResult = function copyDomNodeWithResult(domNode, nodeType, se
   var isSyncedBlock = nodeType.name === 'syncBlock' || nodeType.name === 'bodiedSyncBlock';
   if (browser.safari && isSyncedBlock) {
     // clipboard-polyfill/native-first clipboard.write only reaches DOM fallback after rejection; Safari can
-    // resolve native writes without retaining synced-block HTML, so Patch 9 forces copy-event/execCommand while click activation is live.
-    if (fg('platform_editor_blocks_patch_9')) {
-      return copyHTMLToClipboardSynchronously(div);
-    }
+    // resolve native writes without retaining synced-block HTML, so we force copy-event/execCommand while click activation is live.
+    return copyHTMLToClipboardSynchronously(div);
   }
 
   // Safari's ClipboardItem API may not preserve HTML for extension nodes or mediaSingle nodes.

package/dist/esm/monitoring/error.js

@@ -19,7 +19,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 = "122.2.0";
+var packageVersion = "122.3.0";
 var sanitiseSentryEvents = function sanitiseSentryEvents(data, _hint) {
   // Remove URL as it has UGC
   // Ignored via go/ees007

package/dist/esm/ui/DropList/index.js

@@ -21,7 +21,7 @@ import withAnalyticsEvents from '@atlaskit/analytics-next/withAnalyticsEvents';
 import { fg } from '@atlaskit/platform-feature-flags/fg';
 import Layer from '../Layer';
 var packageName = "@atlaskit/editor-common";
-var packageVersion = "122.2.0";
+var packageVersion = "122.3.0";
 var halfFocusRing = 1;
 var dropOffset = '0, 8';
 var fadeIn = keyframes({

package/dist/esm/vanilla-tooltip/index.js

@@ -73,9 +73,9 @@ export var VanillaTooltip = /*#__PURE__*/function () {
    * only element the browser honours `popovertarget` on. Anything else works, since this
    * class calls `showPopover()`/`hidePopover()` itself, but then make sure it:
    *
-   * - **Renders its children**, as the tooltip is appended to the trigger. `<img>`, `<input>`
-   *   and `<br>` accept the append without error but never render it, leaving the tooltip
-   *   silently at zero size.
+   * - **Renders its children**, as the tooltip is appended to the trigger — unless
+   *   `hoistContainer` is given. `<img>`, `<input>` and `<br>` accept the append without error
+   *   but never render it, leaving the tooltip silently at zero size.
    * - **Is reachable**, if keyboard and screen reader users need the tooltip — usually
    *   `tabindex="0"` plus a role and accessible name, since `focus`/`blur` are bound to the
    *   trigger and `aria-describedby` is set on it.
@@ -109,6 +109,22 @@ export var VanillaTooltip = /*#__PURE__*/function () {
      */
     onShow = arguments.length > 6 ? arguments[6] : undefined;
     var placement = arguments.length > 7 && arguments[7] !== undefined ? arguments[7] : 'top';
+    var
+    /**
+     * Where to append the tooltip, instead of inside the trigger.
+     *
+     * Pass a container when anything between the trigger and the viewport is transformed. The
+     * browser resolves a top-layer popover's position against the viewport, while Popper — which
+     * reads `offsetParent`, and gets `null` for anything in the top layer — falls back to the
+     * nearest ancestor with a `transform`. Inside a wide image that ancestor is `.rich-media-item`,
+     * whose `translateX(-50%)` threw the tooltip off screen (EDITOR-8971). Appended to a container
+     * with no transform above it, the two measure from the same origin.
+     *
+     * Opt-in per caller: the tooltip leaves the trigger's subtree, so anything styling it through
+     * an ancestor stops matching — including `VANILLA_TOOLTIP_DEFAULT_CLASS`, whose rule is scoped
+     * under `.ProseMirror`. Pass `styles` for the look instead.
+     */
+    hoistContainer = arguments.length > 8 ? arguments[8] : undefined;
     _classCallCheck(this, VanillaTooltip);
     _defineProperty(this, "listeners", []);
     _defineProperty(this, "shouldHidePopover", false);
@@ -117,6 +133,7 @@ export var VanillaTooltip = /*#__PURE__*/function () {
     this.timeout = timeout;
     this.onShow = onShow;
     this.placement = placement;
+    this.hoistContainer = hoistContainer;
     // Created in the trigger's own document rather than the global one, so nothing depends on
     // the parent realm when the editor renders inside an iframe. Gated alongside the Escape
     // listener's window so the whole iframe fix moves as a single unit.
@@ -136,7 +153,7 @@ export var VanillaTooltip = /*#__PURE__*/function () {
       Object.assign(tooltip.style, styles);
     }
     this.tooltip = tooltip;
-    this.trigger.appendChild(tooltip);
+    (hoistContainer !== null && hoistContainer !== void 0 ? hoistContainer : this.trigger).appendChild(tooltip);
     this.trigger.setAttribute('popovertarget', tooltip.id);
     this.trigger.setAttribute('aria-describedby', tooltip.id);
     var showEvents = ['mouseenter', 'focus'];
@@ -185,12 +202,22 @@ export var VanillaTooltip = /*#__PURE__*/function () {
   }
 
   /**
-   * Closes the popover, tolerating it already being closed.
-   *
-   * A `hint` popover is light-dismissed by the browser whenever another `hint` or `auto` popover
-   * opens, so the caller can never be sure this one is still showing.
+   * The tooltip element, for callers that own its accessibility semantics — a hoisted tooltip is no
+   * longer reachable from the trigger.
    */
   return _createClass(VanillaTooltip, [{
+    key: "element",
+    get: function get() {
+      return this.tooltip;
+    }
+
+    /**
+     * Closes the popover, tolerating it already being closed.
+     *
+     * A `hint` popover is light-dismissed by the browser whenever another `hint` or `auto` popover
+     * opens, so the caller can never be sure this one is still showing.
+     */
+  }, {
     key: "closePopover",
     value: function closePopover() {
       try {
@@ -250,8 +277,9 @@ export var VanillaTooltip = /*#__PURE__*/function () {
       });
 
       // Undoes what the constructor added to the trigger, matching the React `@atlaskit/tooltip`
-      // callers are moving off, whose unmount took its DOM with it.
-      if (isExperimentEnabled('platform_editor_use_vanilla_components')) {
+      // callers are moving off, whose unmount took its DOM with it. A hoisted tooltip is removed
+      // either way: it sits outside the trigger, so nothing else takes it away with it.
+      if (isExperimentEnabled('platform_editor_use_vanilla_components') || this.hoistContainer) {
         // A popover removed while still showing is never light-dismissed, so the top layer
         // keeps treating it as open.
         this.closePopover();

package/dist/types/vanilla-tooltip/index.d.ts

@@ -18,9 +18,9 @@ export declare class VanillaTooltip {
      * only element the browser honours `popovertarget` on. Anything else works, since this
      * class calls `showPopover()`/`hidePopover()` itself, but then make sure it:
      *
-     * - **Renders its children**, as the tooltip is appended to the trigger. `<img>`, `<input>`
-     *   and `<br>` accept the append without error but never render it, leaving the tooltip
-     *   silently at zero size.
+     * - **Renders its children**, as the tooltip is appended to the trigger — unless
+     *   `hoistContainer` is given. `<img>`, `<input>` and `<br>` accept the append without error
+     *   but never render it, leaving the tooltip silently at zero size.
      * - **Is reachable**, if keyboard and screen reader users need the tooltip — usually
      *   `tabindex="0"` plus a role and accessible name, since `focus`/`blur` are bound to the
      *   trigger and `aria-describedby` is set on it.
@@ -40,6 +40,21 @@ export declare class VanillaTooltip {
      * `'bottom'` to match its `position="mouse"`, which places the tooltip below the cursor.
      */
     private placement;
+    /**
+     * Where to append the tooltip, instead of inside the trigger.
+     *
+     * Pass a container when anything between the trigger and the viewport is transformed. The
+     * browser resolves a top-layer popover's position against the viewport, while Popper — which
+     * reads `offsetParent`, and gets `null` for anything in the top layer — falls back to the
+     * nearest ancestor with a `transform`. Inside a wide image that ancestor is `.rich-media-item`,
+     * whose `translateX(-50%)` threw the tooltip off screen (EDITOR-8971). Appended to a container
+     * with no transform above it, the two measure from the same origin.
+     *
+     * Opt-in per caller: the tooltip leaves the trigger's subtree, so anything styling it through
+     * an ancestor stops matching — including `VANILLA_TOOLTIP_DEFAULT_CLASS`, whose rule is scoped
+     * under `.ProseMirror`. Pass `styles` for the look instead.
+     */
+    private hoistContainer?;
     private popperInstance;
     private listeners;
     private currentTimeoutId;
@@ -58,9 +73,9 @@ export declare class VanillaTooltip {
      * only element the browser honours `popovertarget` on. Anything else works, since this
      * class calls `showPopover()`/`hidePopover()` itself, but then make sure it:
      *
-     * - **Renders its children**, as the tooltip is appended to the trigger. `<img>`, `<input>`
-     *   and `<br>` accept the append without error but never render it, leaving the tooltip
-     *   silently at zero size.
+     * - **Renders its children**, as the tooltip is appended to the trigger — unless
+     *   `hoistContainer` is given. `<img>`, `<input>` and `<br>` accept the append without error
+     *   but never render it, leaving the tooltip silently at zero size.
      * - **Is reachable**, if keyboard and screen reader users need the tooltip — usually
      *   `tabindex="0"` plus a role and accessible name, since `focus`/`blur` are bound to the
      *   trigger and `aria-describedby` is set on it.
@@ -95,7 +110,27 @@ export declare class VanillaTooltip {
      * Defaults to `'top'`, matching the default `position` of "@atlaskit/tooltip". Use
      * `'bottom'` to match its `position="mouse"`, which places the tooltip below the cursor.
      */
-    placement?: Placement);
+    placement?: Placement, 
+    /**
+     * Where to append the tooltip, instead of inside the trigger.
+     *
+     * Pass a container when anything between the trigger and the viewport is transformed. The
+     * browser resolves a top-layer popover's position against the viewport, while Popper — which
+     * reads `offsetParent`, and gets `null` for anything in the top layer — falls back to the
+     * nearest ancestor with a `transform`. Inside a wide image that ancestor is `.rich-media-item`,
+     * whose `translateX(-50%)` threw the tooltip off screen (EDITOR-8971). Appended to a container
+     * with no transform above it, the two measure from the same origin.
+     *
+     * Opt-in per caller: the tooltip leaves the trigger's subtree, so anything styling it through
+     * an ancestor stops matching — including `VANILLA_TOOLTIP_DEFAULT_CLASS`, whose rule is scoped
+     * under `.ProseMirror`. Pass `styles` for the look instead.
+     */
+    hoistContainer?: HTMLElement | undefined);
+    /**
+     * The tooltip element, for callers that own its accessibility semantics — a hoisted tooltip is no
+     * longer reachable from the trigger.
+     */
+    get element(): HTMLSpanElement;
     /**
      * Closes the popover, tolerating it already being closed.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/editor-common",
-	"version": "122.2.1",
+	"version": "122.3.1",
 	"description": "A package that contains common classes and components for editor and renderer",
 	"publishConfig": {
 		"registry": "https://registry.npmjs.org/"
@@ -31,7 +31,7 @@
 		"@atlaskit/activity-provider": "^3.1.0",
 		"@atlaskit/adf-schema": "^57.4.0",
 		"@atlaskit/adf-utils": "^20.9.0",
-		"@atlaskit/afm-i18n-platform-editor-editor-common": "2.200.0",
+		"@atlaskit/afm-i18n-platform-editor-editor-common": "2.249.0",
 		"@atlaskit/analytics-listeners": "^11.3.0",
 		"@atlaskit/analytics-namespaced-context": "^8.2.0",
 		"@atlaskit/analytics-next": "^12.5.0",
@@ -50,7 +50,7 @@
 		"@atlaskit/editor-toolbar": "^2.6.0",
 		"@atlaskit/editor-toolbar-model": "^1.2.0",
 		"@atlaskit/editor-ui-control-model": "^2.9.0",
-		"@atlaskit/emoji": "^72.3.0",
+		"@atlaskit/emoji": "^72.4.0",
 		"@atlaskit/feature-gate-js-client": "^6.0.0",
 		"@atlaskit/icon": "^37.6.0",
 		"@atlaskit/link": "^5.1.0",
@@ -62,9 +62,9 @@
 		"@atlaskit/media-common": "^14.6.0",
 		"@atlaskit/media-file-preview": "^1.3.0",
 		"@atlaskit/media-picker": "^72.4.0",
-		"@atlaskit/media-ui": "^30.15.0",
+		"@atlaskit/media-ui": "^30.16.0",
 		"@atlaskit/media-viewer": "^54.8.0",
-		"@atlaskit/mention": "^29.0.0",
+		"@atlaskit/mention": "^29.1.0",
 		"@atlaskit/menu": "^10.2.0",
 		"@atlaskit/object": "^2.3.0",
 		"@atlaskit/onboarding": "^15.4.0",
@@ -81,10 +81,10 @@
 		"@atlaskit/smart-card": "^45.22.0",
 		"@atlaskit/smart-user-picker": "^11.8.0",
 		"@atlaskit/spinner": "^20.4.0",
-		"@atlaskit/task-decision": "^21.9.0",
+		"@atlaskit/task-decision": "^21.10.0",
 		"@atlaskit/teams-app-config": "^3.1.0",
 		"@atlaskit/textfield": "^10.2.0",
-		"@atlaskit/tmp-editor-statsig": "^189.0.0",
+		"@atlaskit/tmp-editor-statsig": "^191.0.0",
 		"@atlaskit/tokens": "^16.12.0",
 		"@atlaskit/tooltip": "^24.3.0",
 		"@atlaskit/width-detector": "^7.2.0",
@@ -152,10 +152,6 @@
 			"type": "boolean",
 			"referenceOnly": true
 		},
-		"platform_editor_blocks_patch_9": {
-			"type": "boolean",
-			"referenceOnly": true
-		},
 		"platform_editor_nested_mbe_frames": {
 			"type": "boolean"
 		},