@atlaskit/editor-plugin-block-menu 5.1.6 → 5.1.7

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @atlaskit/editor-plugin-block-menu
 
+## 5.1.7
+
+### Patch Changes
+
+- [`65ef204463ce4`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/65ef204463ce4) -
+  Add predicate param to expandBlockRange, add logic to cater for selection being broken in lists
+- Updated dependencies
+
 ## 5.1.6
 
 ### Patch Changes

package/dist/cjs/editor-commands/transform-node-utils/flattenListStep.js

@@ -5,39 +5,34 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.flattenListStep = void 0;
 var _model = require("@atlaskit/editor-prosemirror/model");
-var extractNestedLists = function extractNestedLists(node, listTypes, itemTypes) {
+var extractNestedLists = function extractNestedLists(node, listTypes, itemTypes, schema) {
   var items = [];
+  var paragraph = schema.nodes.paragraph;
   var _extract = function extract(currentNode) {
     currentNode.forEach(function (child) {
-      // list item -> take content without nested lists, then recurse into nested lists
       if (itemTypes.some(function (type) {
         return child.type === type;
       })) {
-        // Filter out nested list nodes from the list item's content
         var contentWithoutNestedLists = [];
         var nestedLists = [];
         child.forEach(function (grandChild) {
           if (listTypes.some(function (type) {
             return grandChild.type === type;
           })) {
-            // This is a nested list - collect it for later processing
             nestedLists.push(grandChild);
           } else {
-            // This is regular content (paragraph, etc.) - keep it
-            contentWithoutNestedLists.push(grandChild);
+            if (grandChild.isText) {
+              contentWithoutNestedLists.push(paragraph.createAndFill({}, grandChild));
+            } else {
+              contentWithoutNestedLists.push(grandChild);
+            }
           }
         });
-
-        // Add the list item with only its non-list content
         items.push(child.copy(_model.Fragment.from(contentWithoutNestedLists)));
-
-        // Now process nested lists to maintain document order
         nestedLists.forEach(function (nestedList) {
           _extract(nestedList);
         });
-      }
-      // lists -> keep operating
-      else if (listTypes.some(function (type) {
+      } else if (listTypes.some(function (type) {
         return child.type === type;
       })) {
         _extract(child);
@@ -53,24 +48,6 @@ var extractNestedLists = function extractNestedLists(node, listTypes, itemTypes)
  * to it's first ancestor list, maintaining document order.
  *
  * @example
- * Input:
- * - bulletList
- *   - listItem "A"
- *   - listItem "B"
- *     - bulletList
- *       - listItem "C"
- *       - listItem "D"
- *   - listItem "E"
- *
- * Output:
- * - bulletList
- *   - listItem "A"
- *   - listItem "B"
- *   - listItem "C"
- *   - listItem "D"
- *   - listItem "E"
- *
- * @example
  * Input (deeply nested):
  * - bulletList
  *   - listItem "1"
@@ -101,7 +78,7 @@ var flattenListStep = exports.flattenListStep = function flattenListStep(nodes,
     if (listTypes.some(function (type) {
       return node.type === type;
     })) {
-      return node.copy(_model.Fragment.from(extractNestedLists(node, listTypes, [context.schema.nodes.listItem, context.schema.nodes.taskItem])));
+      return node.copy(_model.Fragment.from(extractNestedLists(node, listTypes, [context.schema.nodes.listItem, context.schema.nodes.taskItem], context.schema)));
     }
     return node;
   });

package/dist/cjs/editor-commands/transform-node-utils/unwrapListStep.js

@@ -7,8 +7,23 @@ Object.defineProperty(exports, "__esModule", {
 exports.unwrapListStep = void 0;
 var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
 /**
- * Given an array of nodes, returns an array with the flattened children of any list nodes.
+ * Given an array of nodes, processes each list removing all parent list nodes and
+ * just returning their child contents.
+ *
+ * @example
+ * Input:
+ * - bulletList
+ *   - listItem "1"
+ *     - paragraph "1"
+ *   - listItem "2"
+ *     - paragraph "2"
+ *
+ * Output:
+ * - paragraph "1"
+ * - paragraph "2"
+ *
  * @param nodes
+ * @param context
  * @returns
  */
 var unwrapListStep = exports.unwrapListStep = function unwrapListStep(nodes, context) {

package/dist/cjs/editor-commands/transform-node-utils/utils.js

@@ -3,7 +3,8 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.getTargetNodeTypeNameInContext = exports.getSelectedNode = void 0;
+exports.getTargetNodeTypeNameInContext = exports.getSelectedNode = exports.expandSelectionToBlockRange = void 0;
+var _selection = require("@atlaskit/editor-common/selection");
 var _state = require("@atlaskit/editor-prosemirror/state");
 var _utils = require("@atlaskit/editor-prosemirror/utils");
 var _editorTables = require("@atlaskit/editor-tables");
@@ -54,4 +55,32 @@ var getTargetNodeTypeNameInContext = exports.getTargetNodeTypeNameInContext = fu
     return 'nestedExpand';
   }
   return nodeTypeName;
+};
+
+/**
+ * Use common expandToBlockRange function, but account for edge cases with lists.
+ *
+ * @param selection
+ * @param schema
+ * @returns
+ */
+var expandSelectionToBlockRange = exports.expandSelectionToBlockRange = function expandSelectionToBlockRange(selection, schema) {
+  var isListInSelection = (0, _utils.hasParentNode)(function (node) {
+    return node.type === schema.nodes.bulletList || node.type === schema.nodes.orderedList;
+  })(selection);
+  var _expandToBlockRange = (0, _selection.expandToBlockRange)(selection.$from, selection.$to, function (node) {
+      if (!isListInSelection) {
+        return true;
+      }
+      if (node.type === schema.nodes.bulletList || node.type === schema.nodes.orderedList) {
+        return true;
+      }
+      return false;
+    }),
+    $from = _expandToBlockRange.$from,
+    $to = _expandToBlockRange.$to;
+  return {
+    $from: $from,
+    $to: $to
+  };
 };

package/dist/cjs/editor-commands/transformNode.js

@@ -4,11 +4,11 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.transformNode = void 0;
-var _selection = require("@atlaskit/editor-common/selection");
 var _model = require("@atlaskit/editor-prosemirror/model");
 var _isNestedNode = require("../ui/utils/isNestedNode");
 var _transform = require("./transform-node-utils/transform");
-var _utils = require("./transforms/utils");
+var _utils = require("./transform-node-utils/utils");
+var _utils2 = require("./transforms/utils");
 var transformNode = exports.transformNode = function transformNode(api) {
   return (
     // eslint-disable-next-line no-unused-vars
@@ -20,13 +20,13 @@ var transformNode = exports.transformNode = function transformNode(api) {
         if (!preservedSelection) {
           return tr;
         }
-        var _expandToBlockRange = (0, _selection.expandToBlockRange)(preservedSelection.$from, preservedSelection.$to),
-          $from = _expandToBlockRange.$from,
-          $to = _expandToBlockRange.$to;
+        var _expandSelectionToBlo = (0, _utils.expandSelectionToBlockRange)(preservedSelection, tr.doc.type.schema),
+          $from = _expandSelectionToBlo.$from,
+          $to = _expandSelectionToBlo.$to;
         var isNested = (0, _isNestedNode.isNestedNode)(preservedSelection, '');
         var selectedParent = $from.parent;
         var fragment = _model.Fragment.empty;
-        var isList = (0, _utils.isListNode)(selectedParent);
+        var isList = (0, _utils2.isListNode)(selectedParent);
         var slice = tr.doc.slice(isList ? $from.pos - 1 : $from.pos, isList ? $to.pos + 1 : $to.pos);
         slice.content.forEach(function (node) {
           var outputNode = (0, _transform.getOutputNodes)({

package/dist/cjs/ui/utils/suggested-items-rank.js

@@ -0,0 +1,107 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getSuggestedItemsForNodeType = exports.getSortedSuggestedItems = exports.TRANSFORM_SUGGESTED_ITEMS_RANK = exports.BLOCK_MENU_NODE_TYPES = void 0;
+var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+var _blockMenu = require("@atlaskit/editor-common/block-menu");
+var _TRANSFORM_SUGGESTED_;
+/**
+ * Suggested transformations mapping for each block type.
+ * Based on the Block Menu Compatibility Matrix:
+ * https://hello.atlassian.net/wiki/spaces/egcuc/pages/5868774224/Block+Menu+Compatibility+Matrix#Suggested-for-each-block-type
+ *
+ * This mapping defines which transform items should appear in the TRANSFORM_SUGGESTED_MENU_SECTION
+ * for each block type, ranked by priority (lower rank = higher priority).
+ *
+ * Structure:
+ * {
+ *   [sourceNodeType]: {
+ *     [targetMenuItemKey]: rank
+ *   }
+ * }
+ */
+/**
+ * Node type keys that map to ProseMirror node types from the ADF schema.
+ * These values must match the NodeTypeName type.
+ *
+ * TypeScript will enforce that all values are valid NodeTypeName values.
+ * If a new node type is added, it must be added to NodeTypeName first.
+ *
+ * Reference: packages/editor/editor-plugin-block-menu/src/editor-commands/transform-node-utils/types.ts
+ *
+ * Note: 'heading' represents all heading levels (1-6) as a single node type.
+ * The specific level is determined by the node's `attrs.level` property at runtime.
+ *
+ * @example
+ * // Usage:
+ * const nodeType = BLOCK_MENU_NODE_TYPES.PARAGRAPH; // Type: "paragraph"
+ */
+var BLOCK_MENU_NODE_TYPES = exports.BLOCK_MENU_NODE_TYPES = {
+  PARAGRAPH: 'paragraph',
+  EXPAND: 'expand',
+  BLOCKQUOTE: 'blockquote',
+  LAYOUT_SECTION: 'layoutSection',
+  PANEL: 'panel',
+  CODE_BLOCK: 'codeBlock',
+  DECISION: 'decisionList',
+  BULLET_LIST: 'bulletList',
+  ORDERED_LIST: 'orderedList',
+  HEADING: 'heading',
+  TASK_LIST: 'taskList',
+  MEDIA_SINGLE: 'mediaSingle',
+  EXTENSION: 'extension',
+  BODIED_EXTENSION: 'bodiedExtension',
+  BLOCK_CARD: 'blockCard',
+  EMBED_CARD: 'embedCard',
+  TABLE: 'table'
+};
+
+/**
+ * Type for node type values extracted from BLOCK_MENU_NODE_TYPES
+ */
+
+/**
+ * Type for the suggested items rank mapping
+ */
+
+/**
+ * Mapping of source node types to suggested transformation menu items with their ranks.
+ * Lower rank number = higher priority in the suggested menu section.
+ */
+var TRANSFORM_SUGGESTED_ITEMS_RANK = exports.TRANSFORM_SUGGESTED_ITEMS_RANK = (_TRANSFORM_SUGGESTED_ = {}, (0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)(_TRANSFORM_SUGGESTED_, BLOCK_MENU_NODE_TYPES.PARAGRAPH, (0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)({}, _blockMenu.TRANSFORM_STRUCTURE_PANEL_MENU_ITEM.key, 100), _blockMenu.TRANSFORM_HEADINGS_H2_MENU_ITEM.key, 200), _blockMenu.TRANSFORM_HEADINGS_H3_MENU_ITEM.key, 300)), BLOCK_MENU_NODE_TYPES.EXPAND, (0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)({}, _blockMenu.TRANSFORM_STRUCTURE_PANEL_MENU_ITEM.key, 100), _blockMenu.TRANSFORM_STRUCTURE_LAYOUT_MENU_ITEM.key, 200), _blockMenu.TRANSFORM_STRUCTURE_PARAGRAPH_MENU_ITEM.key, 300)), BLOCK_MENU_NODE_TYPES.BLOCKQUOTE, (0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)({}, _blockMenu.TRANSFORM_STRUCTURE_PANEL_MENU_ITEM.key, 100), _blockMenu.TRANSFORM_STRUCTURE_PARAGRAPH_MENU_ITEM.key, 200), _blockMenu.TRANSFORM_STRUCTURE_LAYOUT_MENU_ITEM.key, 300)), BLOCK_MENU_NODE_TYPES.LAYOUT_SECTION, (0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)({}, _blockMenu.TRANSFORM_STRUCTURE_PANEL_MENU_ITEM.key, 100), _blockMenu.TRANSFORM_STRUCTURE_EXPAND_MENU_ITEM.key, 200), _blockMenu.TRANSFORM_HEADINGS_H2_MENU_ITEM.key, 300)), BLOCK_MENU_NODE_TYPES.PANEL, (0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)({}, _blockMenu.TRANSFORM_STRUCTURE_PARAGRAPH_MENU_ITEM.key, 100), _blockMenu.TRANSFORM_STRUCTURE_QUOTE_MENU_ITEM.key, 200), _blockMenu.TRANSFORM_STRUCTURE_CODE_BLOCK_MENU_ITEM.key, 300)), BLOCK_MENU_NODE_TYPES.CODE_BLOCK, (0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)({}, _blockMenu.TRANSFORM_STRUCTURE_EXPAND_MENU_ITEM.key, 100), _blockMenu.TRANSFORM_STRUCTURE_LAYOUT_MENU_ITEM.key, 200), _blockMenu.TRANSFORM_STRUCTURE_PANEL_MENU_ITEM.key, 300)), BLOCK_MENU_NODE_TYPES.DECISION, (0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)({}, _blockMenu.TRANSFORM_STRUCTURE_PANEL_MENU_ITEM.key, 100), _blockMenu.TRANSFORM_STRUCTURE_PARAGRAPH_MENU_ITEM.key, 200), _blockMenu.TRANSFORM_STRUCTURE_TASK_LIST_MENU_ITEM.key, 300)), BLOCK_MENU_NODE_TYPES.BULLET_LIST, (0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)({}, _blockMenu.TRANSFORM_STRUCTURE_NUMBERED_LIST_MENU_ITEM.key, 100), _blockMenu.TRANSFORM_STRUCTURE_QUOTE_MENU_ITEM.key, 200), _blockMenu.TRANSFORM_STRUCTURE_PARAGRAPH_MENU_ITEM.key, 300)), BLOCK_MENU_NODE_TYPES.ORDERED_LIST, (0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)({}, _blockMenu.TRANSFORM_STRUCTURE_BULLETED_LIST_MENU_ITEM.key, 100), _blockMenu.TRANSFORM_STRUCTURE_TASK_LIST_MENU_ITEM.key, 200), _blockMenu.TRANSFORM_STRUCTURE_PARAGRAPH_MENU_ITEM.key, 300)), BLOCK_MENU_NODE_TYPES.HEADING, (0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)({}, _blockMenu.TRANSFORM_STRUCTURE_PARAGRAPH_MENU_ITEM.key, 100), _blockMenu.TRANSFORM_HEADINGS_H2_MENU_ITEM.key, 200), _blockMenu.TRANSFORM_STRUCTURE_PANEL_MENU_ITEM.key, 300)), (0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)(_TRANSFORM_SUGGESTED_, BLOCK_MENU_NODE_TYPES.TASK_LIST, (0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)({}, _blockMenu.TRANSFORM_STRUCTURE_PARAGRAPH_MENU_ITEM.key, 100), _blockMenu.TRANSFORM_STRUCTURE_NUMBERED_LIST_MENU_ITEM.key, 200), _blockMenu.TRANSFORM_STRUCTURE_CODE_BLOCK_MENU_ITEM.key, 300)), BLOCK_MENU_NODE_TYPES.MEDIA_SINGLE, (0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)({}, _blockMenu.TRANSFORM_STRUCTURE_PANEL_MENU_ITEM.key, 100), _blockMenu.TRANSFORM_STRUCTURE_LAYOUT_MENU_ITEM.key, 200), _blockMenu.TRANSFORM_STRUCTURE_PARAGRAPH_MENU_ITEM.key, 300)), BLOCK_MENU_NODE_TYPES.EXTENSION, (0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)({}, _blockMenu.TRANSFORM_STRUCTURE_PANEL_MENU_ITEM.key, 100), _blockMenu.TRANSFORM_STRUCTURE_PARAGRAPH_MENU_ITEM.key, 200), _blockMenu.TRANSFORM_STRUCTURE_EXPAND_MENU_ITEM.key, 300)), BLOCK_MENU_NODE_TYPES.BODIED_EXTENSION, (0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)({}, _blockMenu.TRANSFORM_STRUCTURE_PANEL_MENU_ITEM.key, 100), _blockMenu.TRANSFORM_STRUCTURE_PARAGRAPH_MENU_ITEM.key, 200), _blockMenu.TRANSFORM_STRUCTURE_EXPAND_MENU_ITEM.key, 300)), BLOCK_MENU_NODE_TYPES.BLOCK_CARD, (0, _defineProperty2.default)((0, _defineProperty2.default)({}, _blockMenu.TRANSFORM_STRUCTURE_PANEL_MENU_ITEM.key, 100), _blockMenu.TRANSFORM_STRUCTURE_PARAGRAPH_MENU_ITEM.key, 200)), BLOCK_MENU_NODE_TYPES.EMBED_CARD, (0, _defineProperty2.default)((0, _defineProperty2.default)({}, _blockMenu.TRANSFORM_STRUCTURE_PANEL_MENU_ITEM.key, 100), _blockMenu.TRANSFORM_STRUCTURE_PARAGRAPH_MENU_ITEM.key, 200)), BLOCK_MENU_NODE_TYPES.TABLE, (0, _defineProperty2.default)((0, _defineProperty2.default)({}, _blockMenu.TRANSFORM_STRUCTURE_EXPAND_MENU_ITEM.key, 100), _blockMenu.TRANSFORM_STRUCTURE_LAYOUT_MENU_ITEM.key, 200)));
+
+/**
+ * Get suggested menu items for a given node type
+ * @param nodeType - The source node type (e.g., 'paragraph', 'heading')
+ * @returns Object mapping menu item keys to their ranks, or undefined if no suggestions
+ */
+var getSuggestedItemsForNodeType = exports.getSuggestedItemsForNodeType = function getSuggestedItemsForNodeType(nodeType) {
+  return TRANSFORM_SUGGESTED_ITEMS_RANK[nodeType];
+};
+
+/**
+ * Get sorted suggested menu item keys for a given node type
+ * @param nodeType - The source node type
+ * @returns Array of menu item keys sorted by rank (highest priority first)
+ */
+var getSortedSuggestedItems = exports.getSortedSuggestedItems = function getSortedSuggestedItems(nodeType) {
+  var suggestions = getSuggestedItemsForNodeType(nodeType);
+  if (!suggestions) {
+    return [];
+  }
+  return Object.entries(suggestions).sort(function (_ref, _ref2) {
+    var _ref3 = (0, _slicedToArray2.default)(_ref, 2),
+      rankA = _ref3[1];
+    var _ref4 = (0, _slicedToArray2.default)(_ref2, 2),
+      rankB = _ref4[1];
+    return rankA - rankB;
+  }).map(function (_ref5) {
+    var _ref6 = (0, _slicedToArray2.default)(_ref5, 1),
+      key = _ref6[0];
+    return key;
+  });
+};

package/dist/es2019/editor-commands/transform-node-utils/flattenListStep.js

@@ -1,33 +1,28 @@
 import { Fragment } from '@atlaskit/editor-prosemirror/model';
-const extractNestedLists = (node, listTypes, itemTypes) => {
+const extractNestedLists = (node, listTypes, itemTypes, schema) => {
   const items = [];
+  const paragraph = schema.nodes.paragraph;
   const extract = currentNode => {
     currentNode.forEach(child => {
-      // list item -> take content without nested lists, then recurse into nested lists
       if (itemTypes.some(type => child.type === type)) {
-        // Filter out nested list nodes from the list item's content
         const contentWithoutNestedLists = [];
         const nestedLists = [];
         child.forEach(grandChild => {
           if (listTypes.some(type => grandChild.type === type)) {
-            // This is a nested list - collect it for later processing
             nestedLists.push(grandChild);
           } else {
-            // This is regular content (paragraph, etc.) - keep it
-            contentWithoutNestedLists.push(grandChild);
+            if (grandChild.isText) {
+              contentWithoutNestedLists.push(paragraph.createAndFill({}, grandChild));
+            } else {
+              contentWithoutNestedLists.push(grandChild);
+            }
           }
         });
-
-        // Add the list item with only its non-list content
         items.push(child.copy(Fragment.from(contentWithoutNestedLists)));
-
-        // Now process nested lists to maintain document order
         nestedLists.forEach(nestedList => {
           extract(nestedList);
         });
-      }
-      // lists -> keep operating
-      else if (listTypes.some(type => child.type === type)) {
+      } else if (listTypes.some(type => child.type === type)) {
         extract(child);
       }
     });
@@ -41,24 +36,6 @@ const extractNestedLists = (node, listTypes, itemTypes) => {
  * to it's first ancestor list, maintaining document order.
  *
  * @example
- * Input:
- * - bulletList
- *   - listItem "A"
- *   - listItem "B"
- *     - bulletList
- *       - listItem "C"
- *       - listItem "D"
- *   - listItem "E"
- *
- * Output:
- * - bulletList
- *   - listItem "A"
- *   - listItem "B"
- *   - listItem "C"
- *   - listItem "D"
- *   - listItem "E"
- *
- * @example
  * Input (deeply nested):
  * - bulletList
  *   - listItem "1"
@@ -87,7 +64,7 @@ export const flattenListStep = (nodes, context) => {
   const listTypes = [context.schema.nodes.bulletList, context.schema.nodes.orderedList, context.schema.nodes.taskList];
   return nodes.map(node => {
     if (listTypes.some(type => node.type === type)) {
-      return node.copy(Fragment.from(extractNestedLists(node, listTypes, [context.schema.nodes.listItem, context.schema.nodes.taskItem])));
+      return node.copy(Fragment.from(extractNestedLists(node, listTypes, [context.schema.nodes.listItem, context.schema.nodes.taskItem], context.schema)));
     }
     return node;
   });

package/dist/es2019/editor-commands/transform-node-utils/unwrapListStep.js

@@ -1,6 +1,21 @@
 /**
- * Given an array of nodes, returns an array with the flattened children of any list nodes.
+ * Given an array of nodes, processes each list removing all parent list nodes and
+ * just returning their child contents.
+ *
+ * @example
+ * Input:
+ * - bulletList
+ *   - listItem "1"
+ *     - paragraph "1"
+ *   - listItem "2"
+ *     - paragraph "2"
+ *
+ * Output:
+ * - paragraph "1"
+ * - paragraph "2"
+ *
  * @param nodes
+ * @param context
  * @returns
  */
 export const unwrapListStep = (nodes, context) => {

package/dist/es2019/editor-commands/transform-node-utils/utils.js

@@ -1,5 +1,6 @@
+import { expandToBlockRange } from '@atlaskit/editor-common/selection';
 import { NodeSelection, TextSelection } from '@atlaskit/editor-prosemirror/state';
-import { findParentNodeOfType } from '@atlaskit/editor-prosemirror/utils';
+import { findParentNodeOfType, hasParentNode } from '@atlaskit/editor-prosemirror/utils';
 import { CellSelection } from '@atlaskit/editor-tables';
 export const getSelectedNode = selection => {
   if (selection instanceof NodeSelection) {
@@ -49,4 +50,31 @@ export const getTargetNodeTypeNameInContext = (nodeTypeName, isNested) => {
     return 'nestedExpand';
   }
   return nodeTypeName;
+};
+
+/**
+ * Use common expandToBlockRange function, but account for edge cases with lists.
+ *
+ * @param selection
+ * @param schema
+ * @returns
+ */
+export const expandSelectionToBlockRange = (selection, schema) => {
+  const isListInSelection = hasParentNode(node => node.type === schema.nodes.bulletList || node.type === schema.nodes.orderedList)(selection);
+  const {
+    $from,
+    $to
+  } = expandToBlockRange(selection.$from, selection.$to, node => {
+    if (!isListInSelection) {
+      return true;
+    }
+    if (node.type === schema.nodes.bulletList || node.type === schema.nodes.orderedList) {
+      return true;
+    }
+    return false;
+  });
+  return {
+    $from,
+    $to
+  };
 };

package/dist/es2019/editor-commands/transformNode.js

@@ -1,7 +1,7 @@
-import { expandToBlockRange } from '@atlaskit/editor-common/selection';
 import { Fragment } from '@atlaskit/editor-prosemirror/model';
 import { isNestedNode } from '../ui/utils/isNestedNode';
 import { getOutputNodes } from './transform-node-utils/transform';
+import { expandSelectionToBlockRange } from './transform-node-utils/utils';
 import { isListNode } from './transforms/utils';
 export const transformNode = api =>
 // eslint-disable-next-line no-unused-vars
@@ -17,7 +17,7 @@ export const transformNode = api =>
     const {
       $from,
       $to
-    } = expandToBlockRange(preservedSelection.$from, preservedSelection.$to);
+    } = expandSelectionToBlockRange(preservedSelection, tr.doc.type.schema);
     const isNested = isNestedNode(preservedSelection, '');
     const selectedParent = $from.parent;
     let fragment = Fragment.empty;

package/dist/es2019/ui/utils/suggested-items-rank.js

@@ -0,0 +1,223 @@
+/**
+ * Suggested transformations mapping for each block type.
+ * Based on the Block Menu Compatibility Matrix:
+ * https://hello.atlassian.net/wiki/spaces/egcuc/pages/5868774224/Block+Menu+Compatibility+Matrix#Suggested-for-each-block-type
+ *
+ * This mapping defines which transform items should appear in the TRANSFORM_SUGGESTED_MENU_SECTION
+ * for each block type, ranked by priority (lower rank = higher priority).
+ *
+ * Structure:
+ * {
+ *   [sourceNodeType]: {
+ *     [targetMenuItemKey]: rank
+ *   }
+ * }
+ */
+
+import { TRANSFORM_STRUCTURE_PANEL_MENU_ITEM, TRANSFORM_STRUCTURE_EXPAND_MENU_ITEM, TRANSFORM_STRUCTURE_LAYOUT_MENU_ITEM, TRANSFORM_STRUCTURE_QUOTE_MENU_ITEM, TRANSFORM_STRUCTURE_CODE_BLOCK_MENU_ITEM, TRANSFORM_STRUCTURE_BULLETED_LIST_MENU_ITEM, TRANSFORM_STRUCTURE_NUMBERED_LIST_MENU_ITEM, TRANSFORM_STRUCTURE_TASK_LIST_MENU_ITEM, TRANSFORM_HEADINGS_H2_MENU_ITEM, TRANSFORM_HEADINGS_H3_MENU_ITEM, TRANSFORM_STRUCTURE_PARAGRAPH_MENU_ITEM } from '@atlaskit/editor-common/block-menu';
+/**
+ * Node type keys that map to ProseMirror node types from the ADF schema.
+ * These values must match the NodeTypeName type.
+ *
+ * TypeScript will enforce that all values are valid NodeTypeName values.
+ * If a new node type is added, it must be added to NodeTypeName first.
+ *
+ * Reference: packages/editor/editor-plugin-block-menu/src/editor-commands/transform-node-utils/types.ts
+ *
+ * Note: 'heading' represents all heading levels (1-6) as a single node type.
+ * The specific level is determined by the node's `attrs.level` property at runtime.
+ *
+ * @example
+ * // Usage:
+ * const nodeType = BLOCK_MENU_NODE_TYPES.PARAGRAPH; // Type: "paragraph"
+ */
+export const BLOCK_MENU_NODE_TYPES = {
+  PARAGRAPH: 'paragraph',
+  EXPAND: 'expand',
+  BLOCKQUOTE: 'blockquote',
+  LAYOUT_SECTION: 'layoutSection',
+  PANEL: 'panel',
+  CODE_BLOCK: 'codeBlock',
+  DECISION: 'decisionList',
+  BULLET_LIST: 'bulletList',
+  ORDERED_LIST: 'orderedList',
+  HEADING: 'heading',
+  TASK_LIST: 'taskList',
+  MEDIA_SINGLE: 'mediaSingle',
+  EXTENSION: 'extension',
+  BODIED_EXTENSION: 'bodiedExtension',
+  BLOCK_CARD: 'blockCard',
+  EMBED_CARD: 'embedCard',
+  TABLE: 'table'
+};
+
+/**
+ * Type for node type values extracted from BLOCK_MENU_NODE_TYPES
+ */
+
+/**
+ * Type for the suggested items rank mapping
+ */
+
+/**
+ * Mapping of source node types to suggested transformation menu items with their ranks.
+ * Lower rank number = higher priority in the suggested menu section.
+ */
+export const TRANSFORM_SUGGESTED_ITEMS_RANK = {
+  // Paragraph suggestions
+  [BLOCK_MENU_NODE_TYPES.PARAGRAPH]: {
+    [TRANSFORM_STRUCTURE_PANEL_MENU_ITEM.key]: 100,
+    // Turn into Panel
+    [TRANSFORM_HEADINGS_H2_MENU_ITEM.key]: 200,
+    // Turn into Heading 2
+    [TRANSFORM_HEADINGS_H3_MENU_ITEM.key]: 300 // Turn into Heading 3
+  },
+  // Expand suggestions
+  [BLOCK_MENU_NODE_TYPES.EXPAND]: {
+    [TRANSFORM_STRUCTURE_PANEL_MENU_ITEM.key]: 100,
+    // Turn into Panel (wrap content)
+    [TRANSFORM_STRUCTURE_LAYOUT_MENU_ITEM.key]: 200,
+    // Turn into Layout
+    [TRANSFORM_STRUCTURE_PARAGRAPH_MENU_ITEM.key]: 300 // Turn into Paragraph
+  },
+  // Quote block (blockquote) suggestions
+  [BLOCK_MENU_NODE_TYPES.BLOCKQUOTE]: {
+    [TRANSFORM_STRUCTURE_PANEL_MENU_ITEM.key]: 100,
+    // Turn into Panel
+    [TRANSFORM_STRUCTURE_PARAGRAPH_MENU_ITEM.key]: 200,
+    // Turn into Paragraph
+    [TRANSFORM_STRUCTURE_LAYOUT_MENU_ITEM.key]: 300 // Turn into Layout
+  },
+  // Layout suggestions
+  [BLOCK_MENU_NODE_TYPES.LAYOUT_SECTION]: {
+    [TRANSFORM_STRUCTURE_PANEL_MENU_ITEM.key]: 100,
+    // Wrap layout in panel
+    [TRANSFORM_STRUCTURE_EXPAND_MENU_ITEM.key]: 200,
+    // Make layout collapsible
+    [TRANSFORM_HEADINGS_H2_MENU_ITEM.key]: 300 // doesn't meet compatibility matrix, needs to be updated
+  },
+  // Panel suggestions
+  [BLOCK_MENU_NODE_TYPES.PANEL]: {
+    [TRANSFORM_STRUCTURE_PARAGRAPH_MENU_ITEM.key]: 100,
+    // Turn into Paragraph
+    [TRANSFORM_STRUCTURE_QUOTE_MENU_ITEM.key]: 200,
+    // Turn into Blockquote
+    [TRANSFORM_STRUCTURE_CODE_BLOCK_MENU_ITEM.key]: 300 // Turn into Code Block
+  },
+  // Code block suggestions
+  [BLOCK_MENU_NODE_TYPES.CODE_BLOCK]: {
+    [TRANSFORM_STRUCTURE_EXPAND_MENU_ITEM.key]: 100,
+    // Turn into Expand
+    [TRANSFORM_STRUCTURE_LAYOUT_MENU_ITEM.key]: 200,
+    // Turn into Layout
+    [TRANSFORM_STRUCTURE_PANEL_MENU_ITEM.key]: 300 // Turn into Panel
+  },
+  // Decision suggestions
+  [BLOCK_MENU_NODE_TYPES.DECISION]: {
+    [TRANSFORM_STRUCTURE_PANEL_MENU_ITEM.key]: 100,
+    // Wrap in Panel (Decision style)
+    [TRANSFORM_STRUCTURE_PARAGRAPH_MENU_ITEM.key]: 200,
+    // Turn into Paragraph
+    [TRANSFORM_STRUCTURE_TASK_LIST_MENU_ITEM.key]: 300 // Convert to Task List
+  },
+  // Bulleted list suggestions
+  [BLOCK_MENU_NODE_TYPES.BULLET_LIST]: {
+    [TRANSFORM_STRUCTURE_NUMBERED_LIST_MENU_ITEM.key]: 100,
+    // Turn into Numbered list
+    [TRANSFORM_STRUCTURE_QUOTE_MENU_ITEM.key]: 200,
+    // Turn into Blockquote
+    [TRANSFORM_STRUCTURE_PARAGRAPH_MENU_ITEM.key]: 300 // Turn into Paragraph
+  },
+  // Numbered list (ordered list) suggestions
+  [BLOCK_MENU_NODE_TYPES.ORDERED_LIST]: {
+    [TRANSFORM_STRUCTURE_BULLETED_LIST_MENU_ITEM.key]: 100,
+    // Turn into Bulleted list
+    [TRANSFORM_STRUCTURE_TASK_LIST_MENU_ITEM.key]: 200,
+    // Turn into Task List
+    [TRANSFORM_STRUCTURE_PARAGRAPH_MENU_ITEM.key]: 300 // Turn into Paragraph
+  },
+  // Heading suggestions
+  // Note: For headings, the specific heading level would need to be determined at runtime
+  // This provides a general mapping, but actual implementation should consider current heading level
+  [BLOCK_MENU_NODE_TYPES.HEADING]: {
+    [TRANSFORM_STRUCTURE_PARAGRAPH_MENU_ITEM.key]: 100,
+    // Turn into Paragraph
+    [TRANSFORM_HEADINGS_H2_MENU_ITEM.key]: 200,
+    // Turn into Heading 2
+    [TRANSFORM_STRUCTURE_PANEL_MENU_ITEM.key]: 300 // Wrap in Panel
+  },
+  // Task list suggestions
+  [BLOCK_MENU_NODE_TYPES.TASK_LIST]: {
+    [TRANSFORM_STRUCTURE_PARAGRAPH_MENU_ITEM.key]: 100,
+    // Turn into Paragraph
+    [TRANSFORM_STRUCTURE_NUMBERED_LIST_MENU_ITEM.key]: 200,
+    // Turn into Ordered list
+    [TRANSFORM_STRUCTURE_CODE_BLOCK_MENU_ITEM.key]: 300 // Turn into Code Block (for technical TODOs)
+  },
+  // Media (mediaSingle) suggestions
+  [BLOCK_MENU_NODE_TYPES.MEDIA_SINGLE]: {
+    [TRANSFORM_STRUCTURE_PANEL_MENU_ITEM.key]: 100,
+    // Wrap in Panel
+    [TRANSFORM_STRUCTURE_LAYOUT_MENU_ITEM.key]: 200,
+    // Place into Layout
+    [TRANSFORM_STRUCTURE_PARAGRAPH_MENU_ITEM.key]: 300 // doesn't meet compatibility matrix, needs to be updated
+  },
+  // Extension (app/macro) suggestions
+  [BLOCK_MENU_NODE_TYPES.EXTENSION]: {
+    [TRANSFORM_STRUCTURE_PANEL_MENU_ITEM.key]: 100,
+    // Wrap in Panel
+    [TRANSFORM_STRUCTURE_PARAGRAPH_MENU_ITEM.key]: 200,
+    // doesn't meet compatibility matrix, needs to be updated
+    [TRANSFORM_STRUCTURE_EXPAND_MENU_ITEM.key]: 300 // Collapse in Expand
+  },
+  // Bodied Extension suggestions (same as Extension)
+  [BLOCK_MENU_NODE_TYPES.BODIED_EXTENSION]: {
+    [TRANSFORM_STRUCTURE_PANEL_MENU_ITEM.key]: 100,
+    // Wrap in Panel
+    [TRANSFORM_STRUCTURE_PARAGRAPH_MENU_ITEM.key]: 200,
+    // doesn't meet compatibility matrix, needs to be updated
+    [TRANSFORM_STRUCTURE_EXPAND_MENU_ITEM.key]: 300 // Collapse in Expand
+  },
+  // Smart link Card suggestions
+  [BLOCK_MENU_NODE_TYPES.BLOCK_CARD]: {
+    // Note: Smart link card conversion would be rank 100 (demote to card)
+    [TRANSFORM_STRUCTURE_PANEL_MENU_ITEM.key]: 100,
+    // Wrap in Panel
+    [TRANSFORM_STRUCTURE_PARAGRAPH_MENU_ITEM.key]: 200 // doesn't meet compatibility matrix, needs to be updated
+  },
+  // Smart link Embed suggestions
+  [BLOCK_MENU_NODE_TYPES.EMBED_CARD]: {
+    // Note: Smart link embed conversion would be rank 100 (promote to embed)
+    [TRANSFORM_STRUCTURE_PANEL_MENU_ITEM.key]: 100,
+    // Wrap in Panel
+    [TRANSFORM_STRUCTURE_PARAGRAPH_MENU_ITEM.key]: 200 // doesn't meet compatibility matrix, needs to be updated
+  },
+  // Table suggestions
+  [BLOCK_MENU_NODE_TYPES.TABLE]: {
+    [TRANSFORM_STRUCTURE_EXPAND_MENU_ITEM.key]: 100,
+    // Turn into Expand
+    [TRANSFORM_STRUCTURE_LAYOUT_MENU_ITEM.key]: 200 // Turn into Layout
+  }
+};
+
+/**
+ * Get suggested menu items for a given node type
+ * @param nodeType - The source node type (e.g., 'paragraph', 'heading')
+ * @returns Object mapping menu item keys to their ranks, or undefined if no suggestions
+ */
+export const getSuggestedItemsForNodeType = nodeType => {
+  return TRANSFORM_SUGGESTED_ITEMS_RANK[nodeType];
+};
+
+/**
+ * Get sorted suggested menu item keys for a given node type
+ * @param nodeType - The source node type
+ * @returns Array of menu item keys sorted by rank (highest priority first)
+ */
+export const getSortedSuggestedItems = nodeType => {
+  const suggestions = getSuggestedItemsForNodeType(nodeType);
+  if (!suggestions) {
+    return [];
+  }
+  return Object.entries(suggestions).sort(([, rankA], [, rankB]) => rankA - rankB).map(([key]) => key);
+};

package/dist/esm/editor-commands/transform-node-utils/flattenListStep.js

@@ -1,37 +1,32 @@
 import { Fragment } from '@atlaskit/editor-prosemirror/model';
-var extractNestedLists = function extractNestedLists(node, listTypes, itemTypes) {
+var extractNestedLists = function extractNestedLists(node, listTypes, itemTypes, schema) {
   var items = [];
+  var paragraph = schema.nodes.paragraph;
   var _extract = function extract(currentNode) {
     currentNode.forEach(function (child) {
-      // list item -> take content without nested lists, then recurse into nested lists
       if (itemTypes.some(function (type) {
         return child.type === type;
       })) {
-        // Filter out nested list nodes from the list item's content
         var contentWithoutNestedLists = [];
         var nestedLists = [];
         child.forEach(function (grandChild) {
           if (listTypes.some(function (type) {
             return grandChild.type === type;
           })) {
-            // This is a nested list - collect it for later processing
             nestedLists.push(grandChild);
           } else {
-            // This is regular content (paragraph, etc.) - keep it
-            contentWithoutNestedLists.push(grandChild);
+            if (grandChild.isText) {
+              contentWithoutNestedLists.push(paragraph.createAndFill({}, grandChild));
+            } else {
+              contentWithoutNestedLists.push(grandChild);
+            }
           }
         });
-
-        // Add the list item with only its non-list content
         items.push(child.copy(Fragment.from(contentWithoutNestedLists)));
-
-        // Now process nested lists to maintain document order
         nestedLists.forEach(function (nestedList) {
           _extract(nestedList);
         });
-      }
-      // lists -> keep operating
-      else if (listTypes.some(function (type) {
+      } else if (listTypes.some(function (type) {
         return child.type === type;
       })) {
         _extract(child);
@@ -47,24 +42,6 @@ var extractNestedLists = function extractNestedLists(node, listTypes, itemTypes)
  * to it's first ancestor list, maintaining document order.
  *
  * @example
- * Input:
- * - bulletList
- *   - listItem "A"
- *   - listItem "B"
- *     - bulletList
- *       - listItem "C"
- *       - listItem "D"
- *   - listItem "E"
- *
- * Output:
- * - bulletList
- *   - listItem "A"
- *   - listItem "B"
- *   - listItem "C"
- *   - listItem "D"
- *   - listItem "E"
- *
- * @example
  * Input (deeply nested):
  * - bulletList
  *   - listItem "1"
@@ -95,7 +72,7 @@ export var flattenListStep = function flattenListStep(nodes, context) {
     if (listTypes.some(function (type) {
       return node.type === type;
     })) {
-      return node.copy(Fragment.from(extractNestedLists(node, listTypes, [context.schema.nodes.listItem, context.schema.nodes.taskItem])));
+      return node.copy(Fragment.from(extractNestedLists(node, listTypes, [context.schema.nodes.listItem, context.schema.nodes.taskItem], context.schema)));
     }
     return node;
   });

package/dist/esm/editor-commands/transform-node-utils/unwrapListStep.js

@@ -1,7 +1,22 @@
 import _toConsumableArray from "@babel/runtime/helpers/toConsumableArray";
 /**
- * Given an array of nodes, returns an array with the flattened children of any list nodes.
+ * Given an array of nodes, processes each list removing all parent list nodes and
+ * just returning their child contents.
+ *
+ * @example
+ * Input:
+ * - bulletList
+ *   - listItem "1"
+ *     - paragraph "1"
+ *   - listItem "2"
+ *     - paragraph "2"
+ *
+ * Output:
+ * - paragraph "1"
+ * - paragraph "2"
+ *
  * @param nodes
+ * @param context
  * @returns
  */
 export var unwrapListStep = function unwrapListStep(nodes, context) {

package/dist/esm/editor-commands/transform-node-utils/utils.js

@@ -1,5 +1,6 @@
+import { expandToBlockRange } from '@atlaskit/editor-common/selection';
 import { NodeSelection, TextSelection } from '@atlaskit/editor-prosemirror/state';
-import { findParentNodeOfType } from '@atlaskit/editor-prosemirror/utils';
+import { findParentNodeOfType, hasParentNode } from '@atlaskit/editor-prosemirror/utils';
 import { CellSelection } from '@atlaskit/editor-tables';
 export var getSelectedNode = function getSelectedNode(selection) {
   if (selection instanceof NodeSelection) {
@@ -48,4 +49,32 @@ export var getTargetNodeTypeNameInContext = function getTargetNodeTypeNameInCont
     return 'nestedExpand';
   }
   return nodeTypeName;
+};
+
+/**
+ * Use common expandToBlockRange function, but account for edge cases with lists.
+ *
+ * @param selection
+ * @param schema
+ * @returns
+ */
+export var expandSelectionToBlockRange = function expandSelectionToBlockRange(selection, schema) {
+  var isListInSelection = hasParentNode(function (node) {
+    return node.type === schema.nodes.bulletList || node.type === schema.nodes.orderedList;
+  })(selection);
+  var _expandToBlockRange = expandToBlockRange(selection.$from, selection.$to, function (node) {
+      if (!isListInSelection) {
+        return true;
+      }
+      if (node.type === schema.nodes.bulletList || node.type === schema.nodes.orderedList) {
+        return true;
+      }
+      return false;
+    }),
+    $from = _expandToBlockRange.$from,
+    $to = _expandToBlockRange.$to;
+  return {
+    $from: $from,
+    $to: $to
+  };
 };

package/dist/esm/editor-commands/transformNode.js

@@ -1,7 +1,7 @@
-import { expandToBlockRange } from '@atlaskit/editor-common/selection';
 import { Fragment } from '@atlaskit/editor-prosemirror/model';
 import { isNestedNode } from '../ui/utils/isNestedNode';
 import { getOutputNodes } from './transform-node-utils/transform';
+import { expandSelectionToBlockRange } from './transform-node-utils/utils';
 import { isListNode } from './transforms/utils';
 export var transformNode = function transformNode(api) {
   return (
@@ -14,9 +14,9 @@ export var transformNode = function transformNode(api) {
         if (!preservedSelection) {
           return tr;
         }
-        var _expandToBlockRange = expandToBlockRange(preservedSelection.$from, preservedSelection.$to),
-          $from = _expandToBlockRange.$from,
-          $to = _expandToBlockRange.$to;
+        var _expandSelectionToBlo = expandSelectionToBlockRange(preservedSelection, tr.doc.type.schema),
+          $from = _expandSelectionToBlo.$from,
+          $to = _expandSelectionToBlo.$to;
         var isNested = isNestedNode(preservedSelection, '');
         var selectedParent = $from.parent;
         var fragment = Fragment.empty;

package/dist/esm/ui/utils/suggested-items-rank.js

@@ -0,0 +1,101 @@
+import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+var _TRANSFORM_SUGGESTED_;
+/**
+ * Suggested transformations mapping for each block type.
+ * Based on the Block Menu Compatibility Matrix:
+ * https://hello.atlassian.net/wiki/spaces/egcuc/pages/5868774224/Block+Menu+Compatibility+Matrix#Suggested-for-each-block-type
+ *
+ * This mapping defines which transform items should appear in the TRANSFORM_SUGGESTED_MENU_SECTION
+ * for each block type, ranked by priority (lower rank = higher priority).
+ *
+ * Structure:
+ * {
+ *   [sourceNodeType]: {
+ *     [targetMenuItemKey]: rank
+ *   }
+ * }
+ */
+
+import { TRANSFORM_STRUCTURE_PANEL_MENU_ITEM, TRANSFORM_STRUCTURE_EXPAND_MENU_ITEM, TRANSFORM_STRUCTURE_LAYOUT_MENU_ITEM, TRANSFORM_STRUCTURE_QUOTE_MENU_ITEM, TRANSFORM_STRUCTURE_CODE_BLOCK_MENU_ITEM, TRANSFORM_STRUCTURE_BULLETED_LIST_MENU_ITEM, TRANSFORM_STRUCTURE_NUMBERED_LIST_MENU_ITEM, TRANSFORM_STRUCTURE_TASK_LIST_MENU_ITEM, TRANSFORM_HEADINGS_H2_MENU_ITEM, TRANSFORM_HEADINGS_H3_MENU_ITEM, TRANSFORM_STRUCTURE_PARAGRAPH_MENU_ITEM } from '@atlaskit/editor-common/block-menu';
+/**
+ * Node type keys that map to ProseMirror node types from the ADF schema.
+ * These values must match the NodeTypeName type.
+ *
+ * TypeScript will enforce that all values are valid NodeTypeName values.
+ * If a new node type is added, it must be added to NodeTypeName first.
+ *
+ * Reference: packages/editor/editor-plugin-block-menu/src/editor-commands/transform-node-utils/types.ts
+ *
+ * Note: 'heading' represents all heading levels (1-6) as a single node type.
+ * The specific level is determined by the node's `attrs.level` property at runtime.
+ *
+ * @example
+ * // Usage:
+ * const nodeType = BLOCK_MENU_NODE_TYPES.PARAGRAPH; // Type: "paragraph"
+ */
+export var BLOCK_MENU_NODE_TYPES = {
+  PARAGRAPH: 'paragraph',
+  EXPAND: 'expand',
+  BLOCKQUOTE: 'blockquote',
+  LAYOUT_SECTION: 'layoutSection',
+  PANEL: 'panel',
+  CODE_BLOCK: 'codeBlock',
+  DECISION: 'decisionList',
+  BULLET_LIST: 'bulletList',
+  ORDERED_LIST: 'orderedList',
+  HEADING: 'heading',
+  TASK_LIST: 'taskList',
+  MEDIA_SINGLE: 'mediaSingle',
+  EXTENSION: 'extension',
+  BODIED_EXTENSION: 'bodiedExtension',
+  BLOCK_CARD: 'blockCard',
+  EMBED_CARD: 'embedCard',
+  TABLE: 'table'
+};
+
+/**
+ * Type for node type values extracted from BLOCK_MENU_NODE_TYPES
+ */
+
+/**
+ * Type for the suggested items rank mapping
+ */
+
+/**
+ * Mapping of source node types to suggested transformation menu items with their ranks.
+ * Lower rank number = higher priority in the suggested menu section.
+ */
+export var TRANSFORM_SUGGESTED_ITEMS_RANK = (_TRANSFORM_SUGGESTED_ = {}, _defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_TRANSFORM_SUGGESTED_, BLOCK_MENU_NODE_TYPES.PARAGRAPH, _defineProperty(_defineProperty(_defineProperty({}, TRANSFORM_STRUCTURE_PANEL_MENU_ITEM.key, 100), TRANSFORM_HEADINGS_H2_MENU_ITEM.key, 200), TRANSFORM_HEADINGS_H3_MENU_ITEM.key, 300)), BLOCK_MENU_NODE_TYPES.EXPAND, _defineProperty(_defineProperty(_defineProperty({}, TRANSFORM_STRUCTURE_PANEL_MENU_ITEM.key, 100), TRANSFORM_STRUCTURE_LAYOUT_MENU_ITEM.key, 200), TRANSFORM_STRUCTURE_PARAGRAPH_MENU_ITEM.key, 300)), BLOCK_MENU_NODE_TYPES.BLOCKQUOTE, _defineProperty(_defineProperty(_defineProperty({}, TRANSFORM_STRUCTURE_PANEL_MENU_ITEM.key, 100), TRANSFORM_STRUCTURE_PARAGRAPH_MENU_ITEM.key, 200), TRANSFORM_STRUCTURE_LAYOUT_MENU_ITEM.key, 300)), BLOCK_MENU_NODE_TYPES.LAYOUT_SECTION, _defineProperty(_defineProperty(_defineProperty({}, TRANSFORM_STRUCTURE_PANEL_MENU_ITEM.key, 100), TRANSFORM_STRUCTURE_EXPAND_MENU_ITEM.key, 200), TRANSFORM_HEADINGS_H2_MENU_ITEM.key, 300)), BLOCK_MENU_NODE_TYPES.PANEL, _defineProperty(_defineProperty(_defineProperty({}, TRANSFORM_STRUCTURE_PARAGRAPH_MENU_ITEM.key, 100), TRANSFORM_STRUCTURE_QUOTE_MENU_ITEM.key, 200), TRANSFORM_STRUCTURE_CODE_BLOCK_MENU_ITEM.key, 300)), BLOCK_MENU_NODE_TYPES.CODE_BLOCK, _defineProperty(_defineProperty(_defineProperty({}, TRANSFORM_STRUCTURE_EXPAND_MENU_ITEM.key, 100), TRANSFORM_STRUCTURE_LAYOUT_MENU_ITEM.key, 200), TRANSFORM_STRUCTURE_PANEL_MENU_ITEM.key, 300)), BLOCK_MENU_NODE_TYPES.DECISION, _defineProperty(_defineProperty(_defineProperty({}, TRANSFORM_STRUCTURE_PANEL_MENU_ITEM.key, 100), TRANSFORM_STRUCTURE_PARAGRAPH_MENU_ITEM.key, 200), TRANSFORM_STRUCTURE_TASK_LIST_MENU_ITEM.key, 300)), BLOCK_MENU_NODE_TYPES.BULLET_LIST, _defineProperty(_defineProperty(_defineProperty({}, TRANSFORM_STRUCTURE_NUMBERED_LIST_MENU_ITEM.key, 100), TRANSFORM_STRUCTURE_QUOTE_MENU_ITEM.key, 200), TRANSFORM_STRUCTURE_PARAGRAPH_MENU_ITEM.key, 300)), BLOCK_MENU_NODE_TYPES.ORDERED_LIST, _defineProperty(_defineProperty(_defineProperty({}, TRANSFORM_STRUCTURE_BULLETED_LIST_MENU_ITEM.key, 100), TRANSFORM_STRUCTURE_TASK_LIST_MENU_ITEM.key, 200), TRANSFORM_STRUCTURE_PARAGRAPH_MENU_ITEM.key, 300)), BLOCK_MENU_NODE_TYPES.HEADING, _defineProperty(_defineProperty(_defineProperty({}, TRANSFORM_STRUCTURE_PARAGRAPH_MENU_ITEM.key, 100), TRANSFORM_HEADINGS_H2_MENU_ITEM.key, 200), TRANSFORM_STRUCTURE_PANEL_MENU_ITEM.key, 300)), _defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_TRANSFORM_SUGGESTED_, BLOCK_MENU_NODE_TYPES.TASK_LIST, _defineProperty(_defineProperty(_defineProperty({}, TRANSFORM_STRUCTURE_PARAGRAPH_MENU_ITEM.key, 100), TRANSFORM_STRUCTURE_NUMBERED_LIST_MENU_ITEM.key, 200), TRANSFORM_STRUCTURE_CODE_BLOCK_MENU_ITEM.key, 300)), BLOCK_MENU_NODE_TYPES.MEDIA_SINGLE, _defineProperty(_defineProperty(_defineProperty({}, TRANSFORM_STRUCTURE_PANEL_MENU_ITEM.key, 100), TRANSFORM_STRUCTURE_LAYOUT_MENU_ITEM.key, 200), TRANSFORM_STRUCTURE_PARAGRAPH_MENU_ITEM.key, 300)), BLOCK_MENU_NODE_TYPES.EXTENSION, _defineProperty(_defineProperty(_defineProperty({}, TRANSFORM_STRUCTURE_PANEL_MENU_ITEM.key, 100), TRANSFORM_STRUCTURE_PARAGRAPH_MENU_ITEM.key, 200), TRANSFORM_STRUCTURE_EXPAND_MENU_ITEM.key, 300)), BLOCK_MENU_NODE_TYPES.BODIED_EXTENSION, _defineProperty(_defineProperty(_defineProperty({}, TRANSFORM_STRUCTURE_PANEL_MENU_ITEM.key, 100), TRANSFORM_STRUCTURE_PARAGRAPH_MENU_ITEM.key, 200), TRANSFORM_STRUCTURE_EXPAND_MENU_ITEM.key, 300)), BLOCK_MENU_NODE_TYPES.BLOCK_CARD, _defineProperty(_defineProperty({}, TRANSFORM_STRUCTURE_PANEL_MENU_ITEM.key, 100), TRANSFORM_STRUCTURE_PARAGRAPH_MENU_ITEM.key, 200)), BLOCK_MENU_NODE_TYPES.EMBED_CARD, _defineProperty(_defineProperty({}, TRANSFORM_STRUCTURE_PANEL_MENU_ITEM.key, 100), TRANSFORM_STRUCTURE_PARAGRAPH_MENU_ITEM.key, 200)), BLOCK_MENU_NODE_TYPES.TABLE, _defineProperty(_defineProperty({}, TRANSFORM_STRUCTURE_EXPAND_MENU_ITEM.key, 100), TRANSFORM_STRUCTURE_LAYOUT_MENU_ITEM.key, 200)));
+
+/**
+ * Get suggested menu items for a given node type
+ * @param nodeType - The source node type (e.g., 'paragraph', 'heading')
+ * @returns Object mapping menu item keys to their ranks, or undefined if no suggestions
+ */
+export var getSuggestedItemsForNodeType = function getSuggestedItemsForNodeType(nodeType) {
+  return TRANSFORM_SUGGESTED_ITEMS_RANK[nodeType];
+};
+
+/**
+ * Get sorted suggested menu item keys for a given node type
+ * @param nodeType - The source node type
+ * @returns Array of menu item keys sorted by rank (highest priority first)
+ */
+export var getSortedSuggestedItems = function getSortedSuggestedItems(nodeType) {
+  var suggestions = getSuggestedItemsForNodeType(nodeType);
+  if (!suggestions) {
+    return [];
+  }
+  return Object.entries(suggestions).sort(function (_ref, _ref2) {
+    var _ref3 = _slicedToArray(_ref, 2),
+      rankA = _ref3[1];
+    var _ref4 = _slicedToArray(_ref2, 2),
+      rankB = _ref4[1];
+    return rankA - rankB;
+  }).map(function (_ref5) {
+    var _ref6 = _slicedToArray(_ref5, 1),
+      key = _ref6[0];
+    return key;
+  });
+};

package/dist/types/editor-commands/transform-node-utils/flattenListStep.d.ts

@@ -4,24 +4,6 @@ import type { TransformStep } from './types';
  * to it's first ancestor list, maintaining document order.
  *
  * @example
- * Input:
- * - bulletList
- *   - listItem "A"
- *   - listItem "B"
- *     - bulletList
- *       - listItem "C"
- *       - listItem "D"
- *   - listItem "E"
- *
- * Output:
- * - bulletList
- *   - listItem "A"
- *   - listItem "B"
- *   - listItem "C"
- *   - listItem "D"
- *   - listItem "E"
- *
- * @example
  * Input (deeply nested):
  * - bulletList
  *   - listItem "1"

package/dist/types/editor-commands/transform-node-utils/unwrapListStep.d.ts

@@ -1,7 +1,22 @@
 import type { TransformStep } from './types';
 /**
- * Given an array of nodes, returns an array with the flattened children of any list nodes.
+ * Given an array of nodes, processes each list removing all parent list nodes and
+ * just returning their child contents.
+ *
+ * @example
+ * Input:
+ * - bulletList
+ *   - listItem "1"
+ *     - paragraph "1"
+ *   - listItem "2"
+ *     - paragraph "2"
+ *
+ * Output:
+ * - paragraph "1"
+ * - paragraph "2"
+ *
  * @param nodes
+ * @param context
  * @returns
  */
 export declare const unwrapListStep: TransformStep;

package/dist/types/editor-commands/transform-node-utils/utils.d.ts

@@ -1,5 +1,17 @@
+import type { Schema } from '@atlaskit/editor-prosemirror/model';
 import type { Selection } from '@atlaskit/editor-prosemirror/state';
 import { type ContentNodeWithPos } from '@atlaskit/editor-prosemirror/utils';
 import type { NodeTypeName } from './types';
 export declare const getSelectedNode: (selection: Selection) => ContentNodeWithPos | undefined;
 export declare const getTargetNodeTypeNameInContext: (nodeTypeName: NodeTypeName | null, isNested?: boolean) => NodeTypeName | null;
+/**
+ * Use common expandToBlockRange function, but account for edge cases with lists.
+ *
+ * @param selection
+ * @param schema
+ * @returns
+ */
+export declare const expandSelectionToBlockRange: (selection: Selection, schema: Schema) => {
+    $from: import("prosemirror-model").ResolvedPos;
+    $to: import("prosemirror-model").ResolvedPos;
+};

package/dist/types/ui/utils/suggested-items-rank.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Suggested transformations mapping for each block type.
+ * Based on the Block Menu Compatibility Matrix:
+ * https://hello.atlassian.net/wiki/spaces/egcuc/pages/5868774224/Block+Menu+Compatibility+Matrix#Suggested-for-each-block-type
+ *
+ * This mapping defines which transform items should appear in the TRANSFORM_SUGGESTED_MENU_SECTION
+ * for each block type, ranked by priority (lower rank = higher priority).
+ *
+ * Structure:
+ * {
+ *   [sourceNodeType]: {
+ *     [targetMenuItemKey]: rank
+ *   }
+ * }
+ */
+/**
+ * Node type keys that map to ProseMirror node types from the ADF schema.
+ * These values must match the NodeTypeName type.
+ *
+ * TypeScript will enforce that all values are valid NodeTypeName values.
+ * If a new node type is added, it must be added to NodeTypeName first.
+ *
+ * Reference: packages/editor/editor-plugin-block-menu/src/editor-commands/transform-node-utils/types.ts
+ *
+ * Note: 'heading' represents all heading levels (1-6) as a single node type.
+ * The specific level is determined by the node's `attrs.level` property at runtime.
+ *
+ * @example
+ * // Usage:
+ * const nodeType = BLOCK_MENU_NODE_TYPES.PARAGRAPH; // Type: "paragraph"
+ */
+export declare const BLOCK_MENU_NODE_TYPES: {
+    readonly PARAGRAPH: "paragraph";
+    readonly EXPAND: "expand";
+    readonly BLOCKQUOTE: "blockquote";
+    readonly LAYOUT_SECTION: "layoutSection";
+    readonly PANEL: "panel";
+    readonly CODE_BLOCK: "codeBlock";
+    readonly DECISION: "decisionList";
+    readonly BULLET_LIST: "bulletList";
+    readonly ORDERED_LIST: "orderedList";
+    readonly HEADING: "heading";
+    readonly TASK_LIST: "taskList";
+    readonly MEDIA_SINGLE: "mediaSingle";
+    readonly EXTENSION: "extension";
+    readonly BODIED_EXTENSION: "bodiedExtension";
+    readonly BLOCK_CARD: "blockCard";
+    readonly EMBED_CARD: "embedCard";
+    readonly TABLE: "table";
+};
+/**
+ * Type for node type values extracted from BLOCK_MENU_NODE_TYPES
+ */
+export type BlockMenuNodeType = (typeof BLOCK_MENU_NODE_TYPES)[keyof typeof BLOCK_MENU_NODE_TYPES];
+/**
+ * Type for the suggested items rank mapping
+ */
+export type SuggestedItemsRankMap = {
+    [nodeType: string]: {
+        [menuItemKey: string]: number;
+    };
+};
+/**
+ * Mapping of source node types to suggested transformation menu items with their ranks.
+ * Lower rank number = higher priority in the suggested menu section.
+ */
+export declare const TRANSFORM_SUGGESTED_ITEMS_RANK: SuggestedItemsRankMap;
+/**
+ * Get suggested menu items for a given node type
+ * @param nodeType - The source node type (e.g., 'paragraph', 'heading')
+ * @returns Object mapping menu item keys to their ranks, or undefined if no suggestions
+ */
+export declare const getSuggestedItemsForNodeType: (nodeType: string) => {
+    [menuItemKey: string]: number;
+} | undefined;
+/**
+ * Get sorted suggested menu item keys for a given node type
+ * @param nodeType - The source node type
+ * @returns Array of menu item keys sorted by rank (highest priority first)
+ */
+export declare const getSortedSuggestedItems: (nodeType: string) => string[];

package/dist/types-ts4.5/editor-commands/transform-node-utils/flattenListStep.d.ts

@@ -4,24 +4,6 @@ import type { TransformStep } from './types';
  * to it's first ancestor list, maintaining document order.
  *
  * @example
- * Input:
- * - bulletList
- *   - listItem "A"
- *   - listItem "B"
- *     - bulletList
- *       - listItem "C"
- *       - listItem "D"
- *   - listItem "E"
- *
- * Output:
- * - bulletList
- *   - listItem "A"
- *   - listItem "B"
- *   - listItem "C"
- *   - listItem "D"
- *   - listItem "E"
- *
- * @example
  * Input (deeply nested):
  * - bulletList
  *   - listItem "1"

package/dist/types-ts4.5/editor-commands/transform-node-utils/unwrapListStep.d.ts

@@ -1,7 +1,22 @@
 import type { TransformStep } from './types';
 /**
- * Given an array of nodes, returns an array with the flattened children of any list nodes.
+ * Given an array of nodes, processes each list removing all parent list nodes and
+ * just returning their child contents.
+ *
+ * @example
+ * Input:
+ * - bulletList
+ *   - listItem "1"
+ *     - paragraph "1"
+ *   - listItem "2"
+ *     - paragraph "2"
+ *
+ * Output:
+ * - paragraph "1"
+ * - paragraph "2"
+ *
  * @param nodes
+ * @param context
  * @returns
  */
 export declare const unwrapListStep: TransformStep;

package/dist/types-ts4.5/editor-commands/transform-node-utils/utils.d.ts

@@ -1,5 +1,17 @@
+import type { Schema } from '@atlaskit/editor-prosemirror/model';
 import type { Selection } from '@atlaskit/editor-prosemirror/state';
 import { type ContentNodeWithPos } from '@atlaskit/editor-prosemirror/utils';
 import type { NodeTypeName } from './types';
 export declare const getSelectedNode: (selection: Selection) => ContentNodeWithPos | undefined;
 export declare const getTargetNodeTypeNameInContext: (nodeTypeName: NodeTypeName | null, isNested?: boolean) => NodeTypeName | null;
+/**
+ * Use common expandToBlockRange function, but account for edge cases with lists.
+ *
+ * @param selection
+ * @param schema
+ * @returns
+ */
+export declare const expandSelectionToBlockRange: (selection: Selection, schema: Schema) => {
+    $from: import("prosemirror-model").ResolvedPos;
+    $to: import("prosemirror-model").ResolvedPos;
+};

package/dist/types-ts4.5/ui/utils/suggested-items-rank.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Suggested transformations mapping for each block type.
+ * Based on the Block Menu Compatibility Matrix:
+ * https://hello.atlassian.net/wiki/spaces/egcuc/pages/5868774224/Block+Menu+Compatibility+Matrix#Suggested-for-each-block-type
+ *
+ * This mapping defines which transform items should appear in the TRANSFORM_SUGGESTED_MENU_SECTION
+ * for each block type, ranked by priority (lower rank = higher priority).
+ *
+ * Structure:
+ * {
+ *   [sourceNodeType]: {
+ *     [targetMenuItemKey]: rank
+ *   }
+ * }
+ */
+/**
+ * Node type keys that map to ProseMirror node types from the ADF schema.
+ * These values must match the NodeTypeName type.
+ *
+ * TypeScript will enforce that all values are valid NodeTypeName values.
+ * If a new node type is added, it must be added to NodeTypeName first.
+ *
+ * Reference: packages/editor/editor-plugin-block-menu/src/editor-commands/transform-node-utils/types.ts
+ *
+ * Note: 'heading' represents all heading levels (1-6) as a single node type.
+ * The specific level is determined by the node's `attrs.level` property at runtime.
+ *
+ * @example
+ * // Usage:
+ * const nodeType = BLOCK_MENU_NODE_TYPES.PARAGRAPH; // Type: "paragraph"
+ */
+export declare const BLOCK_MENU_NODE_TYPES: {
+    readonly PARAGRAPH: "paragraph";
+    readonly EXPAND: "expand";
+    readonly BLOCKQUOTE: "blockquote";
+    readonly LAYOUT_SECTION: "layoutSection";
+    readonly PANEL: "panel";
+    readonly CODE_BLOCK: "codeBlock";
+    readonly DECISION: "decisionList";
+    readonly BULLET_LIST: "bulletList";
+    readonly ORDERED_LIST: "orderedList";
+    readonly HEADING: "heading";
+    readonly TASK_LIST: "taskList";
+    readonly MEDIA_SINGLE: "mediaSingle";
+    readonly EXTENSION: "extension";
+    readonly BODIED_EXTENSION: "bodiedExtension";
+    readonly BLOCK_CARD: "blockCard";
+    readonly EMBED_CARD: "embedCard";
+    readonly TABLE: "table";
+};
+/**
+ * Type for node type values extracted from BLOCK_MENU_NODE_TYPES
+ */
+export type BlockMenuNodeType = (typeof BLOCK_MENU_NODE_TYPES)[keyof typeof BLOCK_MENU_NODE_TYPES];
+/**
+ * Type for the suggested items rank mapping
+ */
+export type SuggestedItemsRankMap = {
+    [nodeType: string]: {
+        [menuItemKey: string]: number;
+    };
+};
+/**
+ * Mapping of source node types to suggested transformation menu items with their ranks.
+ * Lower rank number = higher priority in the suggested menu section.
+ */
+export declare const TRANSFORM_SUGGESTED_ITEMS_RANK: SuggestedItemsRankMap;
+/**
+ * Get suggested menu items for a given node type
+ * @param nodeType - The source node type (e.g., 'paragraph', 'heading')
+ * @returns Object mapping menu item keys to their ranks, or undefined if no suggestions
+ */
+export declare const getSuggestedItemsForNodeType: (nodeType: string) => {
+    [menuItemKey: string]: number;
+} | undefined;
+/**
+ * Get sorted suggested menu item keys for a given node type
+ * @param nodeType - The source node type
+ * @returns Array of menu item keys sorted by rank (highest priority first)
+ */
+export declare const getSortedSuggestedItems: (nodeType: string) => string[];

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/editor-plugin-block-menu",
-	"version": "5.1.6",
+	"version": "5.1.7",
 	"description": "BlockMenu plugin for @atlaskit/editor-core",
 	"author": "Atlassian Pty Ltd",
 	"license": "Apache-2.0",
@@ -31,7 +31,7 @@
 		"@atlaskit/css": "^0.17.0",
 		"@atlaskit/dropdown-menu": "^16.3.0",
 		"@atlaskit/editor-plugin-analytics": "^6.2.0",
-		"@atlaskit/editor-plugin-block-controls": "^7.12.0",
+		"@atlaskit/editor-plugin-block-controls": "^7.13.0",
 		"@atlaskit/editor-plugin-decorations": "^6.1.0",
 		"@atlaskit/editor-plugin-selection": "^6.1.0",
 		"@atlaskit/editor-plugin-user-intent": "^4.0.0",
@@ -49,7 +49,7 @@
 		"@babel/runtime": "^7.0.0"
 	},
 	"peerDependencies": {
-		"@atlaskit/editor-common": "^110.38.0",
+		"@atlaskit/editor-common": "^110.39.0",
 		"react": "^18.2.0",
 		"react-intl-next": "npm:react-intl@^5.18.1"
 	},