@atlaskit/editor-common 114.16.0 → 114.18.0

package/dist/es2019/ui/MediaSingle/styled.js

@@ -10,7 +10,6 @@ import React from 'react';
 import { css, jsx } from '@emotion/react';
 import { akEditorDefaultLayoutWidth, akEditorFullPageMaxWidth, akEditorFullWidthLayoutWidth } from '@atlaskit/editor-shared-styles';
 import { fg } from '@atlaskit/platform-feature-flags';
-import { expValEquals } from '@atlaskit/tmp-editor-statsig/exp-val-equals';
 import { nonWrappedLayouts } from '../../utils';
 import { calcBreakoutWidth, calcWideWidth } from '../../utils/breakout';
 function float(layout) {
@@ -117,16 +116,6 @@ export function calcResizedWidth(layout, width, containerWidth = 0
       return `${width}px`;
   }
 }
-function calcMaxWidth(layout, containerWidth) {
-  switch (layout) {
-    case 'wide':
-      return calcWideWidth(containerWidth);
-    case 'full-width':
-      return calcBreakoutWidth(layout, containerWidth);
-    default:
-      return '100%';
-  }
-}
 function calcMargin(layout) {
   switch (layout) {
     case 'wrap-right':
@@ -209,7 +198,6 @@ export const MediaSingleDimensionHelper = ({
   isInRenderer = false
 }) => {
   const calculatedWidth = roundToClosestEvenPxValue(isExtendedResizeExperienceOn ? `${mediaSingleWidth || width}px` : mediaSingleWidth ? calcResizedWidth(layout, width || 0, containerWidth) : calcLegacyWidth(layout, width || 0, containerWidth, fullWidthMode, isResized, isInsideOfInlineExtension));
-  const calculatedMaxWidth = roundToClosestEvenPxValue(isExtendedResizeExperienceOn ? `${containerWidth}px` : calcMaxWidth(layout, containerWidth));
   const cssMaxWidth = isExtendedResizeExperienceOn ? 'var(--ak-editor-max-container-width)' : calcMaxCssForPercentageTypeMedia(layout);
 
   // jest warning: JSDOM version (22) doesn't support the new @container CSS rule
@@ -242,7 +230,7 @@ export const MediaSingleDimensionHelper = ({
     '@container ak-renderer-wrapper (min-width: 1px)': {
       maxWidth: '100cqw'
     }
-  }) : expValEquals('platform_editor_media_vc_fixes', 'isEnabled', true) ? `max-width: ${cssMaxWidth};` : `max-width: ${calculatedMaxWidth};`}
+  }) : `max-width: ${cssMaxWidth};`}
 
 		${isExtendedResizeExperienceOn && `&[class*='is-resizing'] {
     .new-file-experience-wrapper {

package/dist/esm/extensibility/extensionNodeView.js

@@ -15,6 +15,66 @@ import { isSSR } from '../core-utils';
 import ReactNodeView from '../react-node-view';
 import { Extension } from './Extension';
 import { ExtensionNodeWrapper } from './ExtensionNodeWrapper';
+/**
+ * Allowlists of extension keys + layout
+ * Currently, only toc with default layout allows to skip React render.
+ * Extensions NOT in this list always follow the normal React render path.
+ */
+var ssrHydrationExtensionAllowlist = ['toc'];
+var ssrHydrationLayoutAllowlist = ['default'];
+var isSSRHydrationEligible = function isSSRHydrationEligible(node) {
+  var _node$attrs;
+  if (node.type.name !== 'extension') {
+    return false;
+  }
+  var _ref = (_node$attrs = node.attrs) !== null && _node$attrs !== void 0 ? _node$attrs : {},
+    extensionKey = _ref.extensionKey,
+    layout = _ref.layout;
+  if (!ssrHydrationExtensionAllowlist.includes(extensionKey)) {
+    return false;
+  }
+  // Treat a missing layout attr as `default` (the schema default).
+  var effectiveLayout = layout !== null && layout !== void 0 ? layout : 'default';
+  return ssrHydrationLayoutAllowlist.includes(effectiveLayout);
+};
+
+/**
+ * Per-(EditorView, extensionKey + localId) record of which extension identities
+ * have already had their initial-hydration init pass. SSR DOM reuse is only valid
+ * the very first time an ExtensionNode init runs for a given identity in a given
+ * editor — that is the only moment a real SSR-rendered element for that identity
+ * can exist in the editor DOM.
+ *
+ * After the first init, any element matching the SSR selector is the previous
+ * node view's React-rendered domRef that ProseMirror has not yet detached (e.g.
+ * during DnD / layout resize, where ProseMirror constructs the new node view
+ * BEFORE destroying the old one). Reusing it as if it were SSR DOM causes the
+ * new node view to skip React rendering and leaves the extension invisible
+ * (EDITOR-6613).
+ */
+var consumedHydrationIdentitiesByEditor = new WeakMap();
+var _getHydrationIdentityKey = function getHydrationIdentityKey(extensionKey, localId) {
+  if (typeof extensionKey !== 'string' || typeof localId !== 'string') {
+    return null;
+  }
+  if (extensionKey === '' || localId === '') {
+    return null;
+  }
+  return "".concat(extensionKey, "::").concat(localId);
+};
+var hasHydrationIdentityBeenConsumed = function hasHydrationIdentityBeenConsumed(view, identityKey) {
+  var consumed = consumedHydrationIdentitiesByEditor.get(view);
+  return consumed ? consumed.has(identityKey) : false;
+};
+var markHydrationIdentityAsConsumed = function markHydrationIdentityAsConsumed(view, identityKey) {
+  var consumed = consumedHydrationIdentitiesByEditor.get(view);
+  if (!consumed) {
+    consumed = new Set();
+    consumedHydrationIdentitiesByEditor.set(view, consumed);
+  }
+  consumed.add(identityKey);
+};
+
 // getInlineNodeViewProducer is a new api to use instead of ReactNodeView
 // when creating inline node views, however, it is difficult to test the impact
 // on selections when migrating inlineExtension to use the new api.
@@ -28,16 +88,8 @@ export var ExtensionNode = /*#__PURE__*/function (_ReactNodeView) {
       args[_key] = arguments[_key];
     }
     _this = _callSuper(this, ExtensionNode, [].concat(args));
-    /**
-     * Track whether we found and are reusing SSR'd DOM.
-     * When true, we skip React Portal rendering on first init to preserve SSR content.
-     */
+    /** True between SSR DOM adoption in `createDomRef` and the SSR→React handoff in `update`. */
     _defineProperty(_this, "didReuseSsrDom", false);
-    /**
-     * Track whether this is the first init call.
-     * SSR content preservation only happens on the very first init.
-     */
-    _defineProperty(_this, "isFirstInit", true);
     return _this;
   }
   _inherits(ExtensionNode, _ReactNodeView);
@@ -51,14 +103,32 @@ export var ExtensionNode = /*#__PURE__*/function (_ReactNodeView) {
       return this.node.type.isAtom || mutation.type !== 'selection' && mutation.attributeName !== 'data-layout';
     }
 
+    /** See {@link consumedHydrationIdentitiesByEditor}. Null when attrs are missing → SSR reuse skipped. */
+  }, {
+    key: "getHydrationIdentityKey",
+    value: function getHydrationIdentityKey() {
+      var _this$node$attrs, _this$node$attrs2;
+      return _getHydrationIdentityKey((_this$node$attrs = this.node.attrs) === null || _this$node$attrs === void 0 ? void 0 : _this$node$attrs.extensionKey, (_this$node$attrs2 = this.node.attrs) === null || _this$node$attrs2 === void 0 ? void 0 : _this$node$attrs2.localId);
+    }
+
+    /** True only for the first ExtensionNode of this identity in this editor. See {@link consumedHydrationIdentitiesByEditor}. */
+  }, {
+    key: "isInInitialHydrationWindow",
+    value: function isInInitialHydrationWindow() {
+      var identityKey = this.getHydrationIdentityKey();
+      if (identityKey === null) {
+        return false;
+      }
+      return !hasHydrationIdentityBeenConsumed(this.view, identityKey);
+    }
+
     // Reserve height by setting a minimum height for the extension node view element
   }, {
     key: "createDomRef",
     value: function createDomRef() {
       if (!fg('confluence_connect_macro_preset_height')) {
-        // Try to reuse SSR'd DOM node on first init only
-        // This preserves SSR content and avoids TTVC mutations during hydration
-        if (!isSSR() && this.isFirstInit && this.node.type.name === 'extension' && this.node.attrs.extensionKey === 'toc' && expValEquals('platform_editor_hydration_skip_react_portal', 'isEnabled', true)) {
+        // SSR DOM reuse — see {@link consumedHydrationIdentitiesByEditor}.
+        if (!isSSR() && isSSRHydrationEligible(this.node) && this.isInInitialHydrationWindow() && expValEquals('platform_editor_hydration_skip_react_portal', 'isEnabled', true)) {
           var ssrElement = this.findSSRElement();
           if (ssrElement) {
             this.didReuseSsrDom = true;
@@ -113,22 +183,22 @@ export var ExtensionNode = /*#__PURE__*/function (_ReactNodeView) {
       return null;
     }
 
-    /**
-     * Override init() to skip React Portal rendering on first init if we're reusing SSR'd DOM.
-     * This preserves the SSR content without React unnecessarily re-rendering it.
-     */
+    /** Skip React Portal render on first init when reusing SSR DOM. See {@link consumedHydrationIdentitiesByEditor}. */
   }, {
     key: "init",
     value: function init() {
       if (!expValEquals('platform_editor_hydration_skip_react_portal', 'isEnabled', true)) {
         _superPropGet(ExtensionNode, "init", this, 3)([]);
       } else {
-        if (!isSSR() && this.node.type.name === 'extension' && this.node.attrs.extensionKey === 'toc') {
+        var isEligibleForSsrReuse = !isSSR() && isSSRHydrationEligible(this.node);
+        if (isEligibleForSsrReuse && this.isInInitialHydrationWindow()) {
           var ssrElement = this.findSSRElement();
           var shouldSkipInitRender = ssrElement !== null;
           _superPropGet(ExtensionNode, "init", this, 3)([shouldSkipInitRender]);
-          if (shouldSkipInitRender) {
-            this.isFirstInit = false;
+          var identityKey = this.getHydrationIdentityKey();
+          if (identityKey !== null) {
+            // Close the hydration window — see {@link consumedHydrationIdentitiesByEditor}.
+            markHydrationIdentityAsConsumed(this.view, identityKey);
           }
         } else {
           _superPropGet(ExtensionNode, "init", this, 3)([]);
@@ -210,9 +280,8 @@ export var ExtensionNode = /*#__PURE__*/function (_ReactNodeView) {
     key: "render",
     value: function render(props, forwardRef) {
       var _props$extensionNodeV;
-      // If we reused SSR'd DOM on first init, don't render React Portal
-      // The SSR content is already perfect and doesn't need re-rendering
-      if (this.didReuseSsrDom && this.isFirstInit) {
+      // While sitting on SSR DOM, skip the React portal — see {@link didReuseSsrDom}.
+      if (this.didReuseSsrDom) {
         return null;
       }
       return /*#__PURE__*/React.createElement(ExtensionNodeWrapper, {

package/dist/esm/messages/markdown-mode.js

@@ -17,18 +17,18 @@ export var markdownModeMessages = defineMessages({
   },
   source: {
     id: 'fabric.editor.markdownMode.viewToggle.source',
-    defaultMessage: 'Markdown source',
-    description: 'Tooltip and accessible label for the toggle button that switches the editor into raw markdown source view.'
+    defaultMessage: 'Syntax editor',
+    description: 'Tooltip and accessible label for the toggle button that switches the editor into raw markdown source (syntax) view.'
   },
   wysiwyg: {
     id: 'fabric.editor.markdownMode.viewToggle.wysiwyg',
-    defaultMessage: 'WYSIWYG',
+    defaultMessage: 'WYSIWYG editor',
     description: 'Tooltip and accessible label for the toggle button that switches the editor into the WYSIWYG markdown editing view (the default).'
   },
   preview: {
     id: 'fabric.editor.markdownMode.viewToggle.preview',
-    defaultMessage: 'Preview',
-    description: 'Tooltip and accessible label for the toggle button that switches the editor into a read-only rendered markdown preview.'
+    defaultMessage: 'Split view (coming soon)',
+    description: 'Tooltip and accessible label for the toggle button that will switch the editor into a split view. This feature is not yet available.'
   },
   sourceAriaLabel: {
     id: 'fabric.editor.markdownMode.sourceView.ariaLabel',

package/dist/esm/messages/media-insert.js

@@ -62,7 +62,7 @@ export var mediaInsertMessages = defineMessages({
   },
   generateTabTitle: {
     id: 'fabric.editor.media.insert.generateTabTitle',
-    defaultMessage: 'Generate with AI',
+    defaultMessage: 'Create',
     description: 'Title of the navigation tab that allows users to generate an image through AI'
   },
   mediaPickerPopupAriaLabel: {

package/dist/esm/messages/mentions.js

@@ -34,5 +34,10 @@ export var mentionMessages = defineMessages({
     id: 'fabric.editor.inviteItem.sendInvite',
     defaultMessage: 'Send request to invite teammate',
     description: 'By line text for send request to invite teammate option shown in mentions.'
+  },
+  inviteButton: {
+    id: 'fabric.editor.inviteItem.inviteButton',
+    defaultMessage: 'Invite',
+    description: 'Label for the invite button shown in the mention typeahead invite item.'
   }
 });

package/dist/esm/monitoring/error.js

@@ -10,7 +10,7 @@ import { isFedRamp } from './environment';
 import { normaliseSentryBreadcrumbs, SERIALIZABLE_ATTRIBUTES } from './normalise-sentry-breadcrumbs';
 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 = "114.15.0";
+var packageVersion = "114.17.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';
 import Layer from '../Layer';
 var packageName = "@atlaskit/editor-common";
-var packageVersion = "114.15.0";
+var packageVersion = "114.17.0";
 var halfFocusRing = 1;
 var dropOffset = '0, 8';
 var fadeIn = keyframes({

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

@@ -43,6 +43,11 @@ export var messages = defineMessages({
     id: 'fabric.editor.expandAriaLabel',
     defaultMessage: 'Give this expand a title',
     description: 'aria label for an expand node title input field'
+  },
+  expandBodyAriaLabel: {
+    id: 'fabric.editor.expandBodyAriaLabel',
+    defaultMessage: 'Expand body content',
+    description: 'Aria label for the body content of an expand node'
   }
 });
 export var ExpandIconWrapper = function ExpandIconWrapper(_ref) {

package/dist/esm/ui/MediaSingle/grid.js

@@ -1,5 +1,4 @@
 import { akEditorBreakoutPadding, breakoutWideScaleRatio } from '@atlaskit/editor-shared-styles';
-import { expValEquals } from '@atlaskit/tmp-editor-statsig/exp-val-equals';
 import { MEDIA_SINGLE_GUTTER_SIZE } from '../../media-single/constants';
 var validWidthModes = ['center', 'wrap-left', 'wrap-right', 'align-start', 'align-end'];
 export var layoutSupportsWidth = function layoutSupportsWidth(layout) {
@@ -55,10 +54,7 @@ export var calcMediaPxWidth = function calcMediaPxWidth(opts) {
         }
         return calculatedPctWidth;
       }
-      if (expValEquals('platform_editor_media_vc_fixes', 'isEnabled', true)) {
-        return calculatedPctWidth;
-      }
-      return Math.min(calculatedPctWidth, origWidth);
+      return calculatedPctWidth;
     }
     if (calculatedResizedPctWidth) {
       return calculatedResizedPctWidth;
@@ -72,11 +68,7 @@ export var calcMediaPxWidth = function calcMediaPxWidth(opts) {
   } else if (layout && wrappedLayouts.indexOf(layout) !== -1) {
     // when layout is wrap-left, wrap-right, align-start, align-end
     // but no pctWidth is defined
-    if (expValEquals('platform_editor_media_vc_fixes', 'isEnabled', true)) {
-      return Math.min(calcPxFromPct(0.5, lineLength || width), origWidth);
-    }
-    var halfLineLength = Math.ceil((lineLength || width) / 2);
-    return origWidth <= halfLineLength ? origWidth : halfLineLength;
+    return Math.min(calcPxFromPct(0.5, lineLength || width), origWidth);
   }
   return origWidth;
 };

package/dist/esm/ui/MediaSingle/styled.js

@@ -14,7 +14,6 @@ import React from 'react';
 import { css, jsx } from '@emotion/react';
 import { akEditorDefaultLayoutWidth, akEditorFullPageMaxWidth, akEditorFullWidthLayoutWidth } from '@atlaskit/editor-shared-styles';
 import { fg } from '@atlaskit/platform-feature-flags';
-import { expValEquals } from '@atlaskit/tmp-editor-statsig/exp-val-equals';
 import { nonWrappedLayouts } from '../../utils';
 import { calcBreakoutWidth, calcWideWidth } from '../../utils/breakout';
 function float(layout) {
@@ -127,16 +126,6 @@ export function calcResizedWidth(layout, width) {
       return "".concat(width, "px");
   }
 }
-function calcMaxWidth(layout, containerWidth) {
-  switch (layout) {
-    case 'wide':
-      return calcWideWidth(containerWidth);
-    case 'full-width':
-      return calcBreakoutWidth(layout, containerWidth);
-    default:
-      return '100%';
-  }
-}
 function calcMargin(layout) {
   switch (layout) {
     case 'wrap-right':
@@ -221,7 +210,6 @@ export var MediaSingleDimensionHelper = function MediaSingleDimensionHelper(_ref
     _ref$isInRenderer = _ref.isInRenderer,
     isInRenderer = _ref$isInRenderer === void 0 ? false : _ref$isInRenderer;
   var calculatedWidth = roundToClosestEvenPxValue(isExtendedResizeExperienceOn ? "".concat(mediaSingleWidth || width, "px") : mediaSingleWidth ? calcResizedWidth(layout, width || 0, containerWidth) : calcLegacyWidth(layout, width || 0, containerWidth, fullWidthMode, isResized, isInsideOfInlineExtension));
-  var calculatedMaxWidth = roundToClosestEvenPxValue(isExtendedResizeExperienceOn ? "".concat(containerWidth, "px") : calcMaxWidth(layout, containerWidth));
   var cssMaxWidth = isExtendedResizeExperienceOn ? 'var(--ak-editor-max-container-width)' : calcMaxCssForPercentageTypeMedia(layout);
 
   // jest warning: JSDOM version (22) doesn't support the new @container CSS rule
@@ -237,7 +225,7 @@ export var MediaSingleDimensionHelper = function MediaSingleDimensionHelper(_ref
     '@container ak-renderer-wrapper (min-width: 1px)': {
       maxWidth: '100cqw'
     }
-  }) : expValEquals('platform_editor_media_vc_fixes', 'isEnabled', true) ? "max-width: ".concat(cssMaxWidth, ";") : "max-width: ".concat(calculatedMaxWidth, ";"), isExtendedResizeExperienceOn && "&[class*='is-resizing'] {\n    .new-file-experience-wrapper {\n      box-shadow: none !important;\n    }\n\n    ".concat(!isNestedNode && nonWrappedLayouts.includes(layout) && "margin-left: 50%;\n      transform: translateX(-50%);", "\n  }"), float(layout), calcMargin(layout), isNestedNode ? /* Make nested node appear responsive when resizing table cell */"max-width: 100%;" : nonWrappedLayouts.includes(layout) && "margin-left: 50%;\n        transform: translateX(-50%);", isImageAligned(layout));
+  }) : "max-width: ".concat(cssMaxWidth, ";"), isExtendedResizeExperienceOn && "&[class*='is-resizing'] {\n    .new-file-experience-wrapper {\n      box-shadow: none !important;\n    }\n\n    ".concat(!isNestedNode && nonWrappedLayouts.includes(layout) && "margin-left: 50%;\n      transform: translateX(-50%);", "\n  }"), float(layout), calcMargin(layout), isNestedNode ? /* Make nested node appear responsive when resizing table cell */"max-width: 100%;" : nonWrappedLayouts.includes(layout) && "margin-left: 50%;\n        transform: translateX(-50%);", isImageAligned(layout));
 };
 var RenderFallbackContainer = function RenderFallbackContainer(_ref2) {
   var hasFallbackContainer = _ref2.hasFallbackContainer,

package/dist/types/extensibility/extensionNodeView.d.ts

@@ -25,20 +25,16 @@ interface ReactExtensionNodeProps {
     showUpdatedLivePages1PBodiedExtensionUI?: (node: ADFEntity) => boolean;
 }
 export declare class ExtensionNode<AdditionalParams = unknown> extends ReactNodeView<ReactExtensionNodeProps & AdditionalParams> {
-    /**
-     * Track whether we found and are reusing SSR'd DOM.
-     * When true, we skip React Portal rendering on first init to preserve SSR content.
-     */
+    /** True between SSR DOM adoption in `createDomRef` and the SSR→React handoff in `update`. */
     private didReuseSsrDom;
-    /**
-     * Track whether this is the first init call.
-     * SSR content preservation only happens on the very first init.
-     */
-    private isFirstInit;
     ignoreMutation(mutation: MutationRecord | {
         target: Node;
         type: 'selection';
     }): boolean;
+    /** See {@link consumedHydrationIdentitiesByEditor}. Null when attrs are missing → SSR reuse skipped. */
+    private getHydrationIdentityKey;
+    /** True only for the first ExtensionNode of this identity in this editor. See {@link consumedHydrationIdentitiesByEditor}. */
+    private isInInitialHydrationWindow;
     createDomRef(): HTMLElement;
     /**
      * Cache for SSR element lookup to avoid repeated DOM queries.
@@ -53,10 +49,7 @@ export declare class ExtensionNode<AdditionalParams = unknown> extends ReactNode
      * @returns The SSR'd element if found, otherwise null
      */
     private findSSRElement;
-    /**
-     * Override init() to skip React Portal rendering on first init if we're reusing SSR'd DOM.
-     * This preserves the SSR content without React unnecessarily re-rendering it.
-     */
+    /** Skip React Portal render on first init when reusing SSR DOM. See {@link consumedHydrationIdentitiesByEditor}. */
     init(): this;
     update(node: PmNode, decorations: ReadonlyArray<Decoration>, _innerDecorations?: DecorationSource, validUpdate?: (currentNode: PmNode, newNode: PmNode) => boolean): boolean;
     /**

package/dist/types/messages/mentions.d.ts

@@ -1,37 +1,42 @@
 export declare const mentionMessages: {
+    inviteButton: {
+        defaultMessage: string;
+        description: string;
+        id: string;
+    };
     inviteItemTitle: {
+        defaultMessage: string;
+        description: string;
         id: string;
+    };
+    inviteTeammateInvalidEmail: {
         defaultMessage: string;
         description: string;
+        id: string;
     };
     mentionsAddLabel: {
-        id: string;
         defaultMessage: string;
         description: string;
+        id: string;
     };
     mentionsIconLabel: {
-        id: string;
         defaultMessage: string;
         description: string;
+        id: string;
     };
     mentionsNodeLabel: {
-        id: string;
         defaultMessage: string;
         description: string;
-    };
-    unknownLabel: {
         id: string;
-        defaultMessage: string;
-        description: string;
     };
-    inviteTeammateInvalidEmail: {
-        id: string;
+    sendInvite: {
         defaultMessage: string;
         description: string;
-    };
-    sendInvite: {
         id: string;
+    };
+    unknownLabel: {
         defaultMessage: string;
         description: string;
+        id: string;
     };
 };

package/dist/types/ui/Expand/index.d.ts

@@ -2,35 +2,40 @@ import React from 'react';
 import { jsx } from '@emotion/react';
 import type { SerializedStyles } from '@emotion/react';
 export declare const messages: {
-    loading: {
-        id: string;
+    collapseNode: {
         defaultMessage: string;
         description: string;
+        id: string;
     };
-    collapseNode: {
+    expandArialabel: {
+        defaultMessage: string;
+        description: string;
         id: string;
+    };
+    expandBodyAriaLabel: {
         defaultMessage: string;
         description: string;
+        id: string;
     };
     expandDefaultTitle: {
-        id: string;
         defaultMessage: string;
         description: string;
+        id: string;
     };
     expandNode: {
-        id: string;
         defaultMessage: string;
         description: string;
+        id: string;
     };
     expandPlaceholderText: {
-        id: string;
         defaultMessage: string;
         description: string;
-    };
-    expandArialabel: {
         id: string;
+    };
+    loading: {
         defaultMessage: string;
         description: string;
+        id: string;
     };
 };
 export declare const ExpandIconWrapper: ({ children, expanded, }: React.HTMLAttributes<HTMLDivElement> & {

package/dist/types-ts4.5/extensibility/extensionNodeView.d.ts

@@ -25,20 +25,16 @@ interface ReactExtensionNodeProps {
     showUpdatedLivePages1PBodiedExtensionUI?: (node: ADFEntity) => boolean;
 }
 export declare class ExtensionNode<AdditionalParams = unknown> extends ReactNodeView<ReactExtensionNodeProps & AdditionalParams> {
-    /**
-     * Track whether we found and are reusing SSR'd DOM.
-     * When true, we skip React Portal rendering on first init to preserve SSR content.
-     */
+    /** True between SSR DOM adoption in `createDomRef` and the SSR→React handoff in `update`. */
     private didReuseSsrDom;
-    /**
-     * Track whether this is the first init call.
-     * SSR content preservation only happens on the very first init.
-     */
-    private isFirstInit;
     ignoreMutation(mutation: MutationRecord | {
         target: Node;
         type: 'selection';
     }): boolean;
+    /** See {@link consumedHydrationIdentitiesByEditor}. Null when attrs are missing → SSR reuse skipped. */
+    private getHydrationIdentityKey;
+    /** True only for the first ExtensionNode of this identity in this editor. See {@link consumedHydrationIdentitiesByEditor}. */
+    private isInInitialHydrationWindow;
     createDomRef(): HTMLElement;
     /**
      * Cache for SSR element lookup to avoid repeated DOM queries.
@@ -53,10 +49,7 @@ export declare class ExtensionNode<AdditionalParams = unknown> extends ReactNode
      * @returns The SSR'd element if found, otherwise null
      */
     private findSSRElement;
-    /**
-     * Override init() to skip React Portal rendering on first init if we're reusing SSR'd DOM.
-     * This preserves the SSR content without React unnecessarily re-rendering it.
-     */
+    /** Skip React Portal render on first init when reusing SSR DOM. See {@link consumedHydrationIdentitiesByEditor}. */
     init(): this;
     update(node: PmNode, decorations: ReadonlyArray<Decoration>, _innerDecorations?: DecorationSource, validUpdate?: (currentNode: PmNode, newNode: PmNode) => boolean): boolean;
     /**

package/dist/types-ts4.5/messages/mentions.d.ts

@@ -1,37 +1,42 @@
 export declare const mentionMessages: {
+    inviteButton: {
+        defaultMessage: string;
+        description: string;
+        id: string;
+    };
     inviteItemTitle: {
+        defaultMessage: string;
+        description: string;
         id: string;
+    };
+    inviteTeammateInvalidEmail: {
         defaultMessage: string;
         description: string;
+        id: string;
     };
     mentionsAddLabel: {
-        id: string;
         defaultMessage: string;
         description: string;
+        id: string;
     };
     mentionsIconLabel: {
-        id: string;
         defaultMessage: string;
         description: string;
+        id: string;
     };
     mentionsNodeLabel: {
-        id: string;
         defaultMessage: string;
         description: string;
-    };
-    unknownLabel: {
         id: string;
-        defaultMessage: string;
-        description: string;
     };
-    inviteTeammateInvalidEmail: {
-        id: string;
+    sendInvite: {
         defaultMessage: string;
         description: string;
-    };
-    sendInvite: {
         id: string;
+    };
+    unknownLabel: {
         defaultMessage: string;
         description: string;
+        id: string;
     };
 };

package/dist/types-ts4.5/ui/Expand/index.d.ts

@@ -2,35 +2,40 @@ import React from 'react';
 import { jsx } from '@emotion/react';
 import type { SerializedStyles } from '@emotion/react';
 export declare const messages: {
-    loading: {
-        id: string;
+    collapseNode: {
         defaultMessage: string;
         description: string;
+        id: string;
     };
-    collapseNode: {
+    expandArialabel: {
+        defaultMessage: string;
+        description: string;
         id: string;
+    };
+    expandBodyAriaLabel: {
         defaultMessage: string;
         description: string;
+        id: string;
     };
     expandDefaultTitle: {
-        id: string;
         defaultMessage: string;
         description: string;
+        id: string;
     };
     expandNode: {
-        id: string;
         defaultMessage: string;
         description: string;
+        id: string;
     };
     expandPlaceholderText: {
-        id: string;
         defaultMessage: string;
         description: string;
-    };
-    expandArialabel: {
         id: string;
+    };
+    loading: {
         defaultMessage: string;
         description: string;
+        id: string;
     };
 };
 export declare const ExpandIconWrapper: ({ children, expanded, }: React.HTMLAttributes<HTMLDivElement> & {