@atlaskit/editor-plugin-type-ahead 11.0.1 → 11.1.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @atlaskit/editor-plugin-type-ahead
 
+## 11.1.0
+
+### Minor Changes
+
+- [`3bb54917f1df6`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/3bb54917f1df6) -
+  Add a gated API for updating mention typeahead section metadata.
+
+### Patch Changes
+
+- Updated dependencies
+
 ## 11.0.1
 
 ### Patch Changes

package/dist/cjs/pm-plugins/actions.js

@@ -14,5 +14,6 @@ var ACTIONS = exports.ACTIONS = /*#__PURE__*/function (ACTIONS) {
   ACTIONS["UPDATE_LIST_ERROR"] = "UPDATE_LIST_ERROR";
   ACTIONS["CLEAR_LIST_ERROR"] = "CLEAR_LIST_ERROR";
   ACTIONS["UPDATE_SELECTED_INDEX"] = "UPDATE_SELECTED_INDEX";
+  ACTIONS["UPDATE_SECTION_TITLE"] = "UPDATE_SECTION_TITLE";
   return ACTIONS;
 }({});

package/dist/cjs/pm-plugins/commands/update-section-title.js

@@ -0,0 +1,38 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.updateSectionTitle = void 0;
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+var _expVal = require("@atlaskit/tmp-editor-statsig/expVal");
+var _actions = require("../actions");
+var _key = require("../key");
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { (0, _defineProperty2.default)(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+var updateSectionTitle = exports.updateSectionTitle = function updateSectionTitle(_ref) {
+  var id = _ref.id,
+    title = _ref.title,
+    showTitleWhenOnlySection = _ref.showTitleWhenOnlySection;
+  return function (state, dispatch) {
+    if (!(0, _expVal.expVal)('platform_editor_agent_mentions', 'isEnabled', false) || !dispatch) {
+      return false;
+    }
+    var tr = state.tr;
+    var update = _objectSpread({
+      title: title
+    }, showTitleWhenOnlySection !== undefined ? {
+      showTitleWhenOnlySection: showTitleWhenOnlySection
+    } : {});
+    tr.setMeta(_key.pluginKey, {
+      action: _actions.ACTIONS.UPDATE_SECTION_TITLE,
+      params: {
+        id: id,
+        update: update
+      }
+    });
+    dispatch(tr);
+    return true;
+  };
+};

package/dist/cjs/pm-plugins/main.js

@@ -67,6 +67,7 @@ function createPlugin(_ref) {
           decorationSet: _view.DecorationSet.empty,
           decorationElement: null,
           items: [],
+          sectionTitleUpdates: {},
           sections: [],
           errorInfo: null,
           selectedIndex: -1,

package/dist/cjs/pm-plugins/reducer.js

@@ -11,6 +11,7 @@ var _analytics = require("@atlaskit/editor-common/analytics");
 var _view = require("@atlaskit/editor-prosemirror/view");
 var _insm = require("@atlaskit/insm");
 var _expValEquals = require("@atlaskit/tmp-editor-statsig/exp-val-equals");
+var _expVal = require("@atlaskit/tmp-editor-statsig/expVal");
 var _actions = require("./actions");
 var _key = require("./key");
 var _utils = require("./utils");
@@ -32,6 +33,21 @@ var shouldForceClose = function shouldForceClose(step) {
   var isUndoingDeletionRawQuery = step.isUndoingStep() && step.stage === _steps.InsertTypeAheadStages.DELETING_RAW_QUERY;
   return isInsertingItem || isUndoingDeletionRawQuery;
 };
+var applySectionTitleUpdates = function applySectionTitleUpdates(_ref) {
+  var sections = _ref.sections,
+    sectionTitleUpdates = _ref.sectionTitleUpdates;
+  if (!(0, _expVal.expVal)('platform_editor_agent_mentions', 'isEnabled', false)) {
+    return sections;
+  }
+  var updatedSections = sections.map(function (section) {
+    var update = sectionTitleUpdates[section.id];
+    if (!update) {
+      return section;
+    }
+    return _objectSpread(_objectSpread({}, section), update);
+  });
+  return updatedSections;
+};
 var createFindHandler = function createFindHandler(typeAheadHandlers) {
   return function (step) {
     if (!(step instanceof _steps.InsertTypeAheadStep)) {
@@ -43,18 +59,18 @@ var createFindHandler = function createFindHandler(typeAheadHandlers) {
     return handler || null;
   };
 };
-var createReducer = exports.createReducer = function createReducer(_ref) {
-  var typeAheadHandlers = _ref.typeAheadHandlers,
-    removeDecorations = _ref.removeDecorations,
-    createDecorations = _ref.createDecorations;
+var createReducer = exports.createReducer = function createReducer(_ref2) {
+  var typeAheadHandlers = _ref2.typeAheadHandlers,
+    removeDecorations = _ref2.removeDecorations,
+    createDecorations = _ref2.createDecorations;
   var findHandler = createFindHandler(typeAheadHandlers);
-  var openMenu = function openMenu(currentPluginState, _ref2) {
-    var tr = _ref2.tr,
-      triggerHandler = _ref2.triggerHandler,
-      inputMethod = _ref2.inputMethod,
-      reopenQuery = _ref2.reopenQuery,
-      selectedIndex = _ref2.selectedIndex,
-      removePrefixTriggerOnCancel = _ref2.removePrefixTriggerOnCancel;
+  var openMenu = function openMenu(currentPluginState, _ref3) {
+    var tr = _ref3.tr,
+      triggerHandler = _ref3.triggerHandler,
+      inputMethod = _ref3.inputMethod,
+      reopenQuery = _ref3.reopenQuery,
+      selectedIndex = _ref3.selectedIndex,
+      removePrefixTriggerOnCancel = _ref3.removePrefixTriggerOnCancel;
     removeDecorations(currentPluginState.decorationSet);
     var _createDecorations = createDecorations(tr, {
         triggerHandler: triggerHandler,
@@ -76,6 +92,7 @@ var createReducer = exports.createReducer = function createReducer(_ref) {
       inputMethod: inputMethod,
       selectedIndex: typeof selectedIndex === 'number' ? selectedIndex : -1,
       items: [],
+      sectionTitleUpdates: {},
       sections: [],
       query: reopenQuery || '',
       removePrefixTriggerOnCancel: removePrefixTriggerOnCancel
@@ -96,6 +113,7 @@ var createReducer = exports.createReducer = function createReducer(_ref) {
       triggerHandler: undefined,
       items: [],
       sections: [],
+      sectionTitleUpdates: {},
       removePrefixTriggerOnCancel: undefined
     });
   };
@@ -116,9 +134,9 @@ var createReducer = exports.createReducer = function createReducer(_ref) {
     } else if (shouldForceClose(typeAheadStepOverride)) {
       return closeMenu(currentPluginState);
     }
-    var _ref3 = meta || {},
-      action = _ref3.action,
-      params = _ref3.params;
+    var _ref4 = meta || {},
+      action = _ref4.action,
+      params = _ref4.params;
     var shouldOpenMenu = action === _actions.ACTIONS.OPEN_TYPEAHEAD_AT_CURSOR && (0, _utils.isTypeAheadHandler)(params === null || params === void 0 ? void 0 : params.triggerHandler);
     var selectionChanged = tr.selectionSet && (tr.isGeneric || Boolean(tr.getMeta('pointer')));
     var shouldCloseMenu = [_actions.ACTIONS.CLOSE_TYPE_AHEAD, _actions.ACTIONS.INSERT_ITEM].includes(action) || selectionChanged;
@@ -126,6 +144,7 @@ var createReducer = exports.createReducer = function createReducer(_ref) {
     var shouldUpdateListItems = action === _actions.ACTIONS.UPDATE_LIST_ITEMS;
     var shouldUpdateListError = action === _actions.ACTIONS.UPDATE_LIST_ERROR;
     var shouldUpdateSelectedIndex = action === _actions.ACTIONS.UPDATE_SELECTED_INDEX;
+    var shouldUpdateSectionTitleState = action === _actions.ACTIONS.UPDATE_SECTION_TITLE;
     var shouldClearListError = action === _actions.ACTIONS.CLEAR_LIST_ERROR;
     if (shouldOpenMenu) {
       return openMenu(currentPluginState, {
@@ -156,9 +175,26 @@ var createReducer = exports.createReducer = function createReducer(_ref) {
       var selectedIndex = currentPluginState.selectedIndex;
       return _objectSpread(_objectSpread({}, currentPluginState), {}, {
         items: items,
-        sections: sections,
+        sections: applySectionTitleUpdates({
+          sections: sections,
+          sectionTitleUpdates: currentPluginState.sectionTitleUpdates
+        }),
         selectedIndex: Math.max(selectedIndex >= items.length ? items.length - 1 : selectedIndex, -1)
       });
+    } else if (shouldUpdateSectionTitleState) {
+      if (!(0, _expVal.expVal)('platform_editor_agent_mentions', 'isEnabled', false)) {
+        return currentPluginState;
+      }
+      var id = params.id,
+        update = params.update;
+      var sectionTitleUpdates = _objectSpread(_objectSpread({}, currentPluginState.sectionTitleUpdates), {}, (0, _defineProperty2.default)({}, id, _objectSpread(_objectSpread({}, currentPluginState.sectionTitleUpdates[id]), update)));
+      return _objectSpread(_objectSpread({}, currentPluginState), {}, {
+        sectionTitleUpdates: sectionTitleUpdates,
+        sections: applySectionTitleUpdates({
+          sections: currentPluginState.sections,
+          sectionTitleUpdates: sectionTitleUpdates
+        })
+      });
     } else if (shouldUpdateSelectedIndex) {
       return _objectSpread(_objectSpread({}, currentPluginState), {}, {
         selectedIndex: params.selectedIndex

package/dist/cjs/typeAheadPlugin.js

@@ -15,6 +15,7 @@ var _platformFeatureFlags = require("@atlaskit/platform-feature-flags");
 var _closeTypeAhead = require("./pm-plugins/commands/close-type-ahead");
 var _insertTypeAheadItem = require("./pm-plugins/commands/insert-type-ahead-item");
 var _openTypeaheadAtCursor = require("./pm-plugins/commands/open-typeahead-at-cursor");
+var _updateSectionTitle = require("./pm-plugins/commands/update-section-title");
 var _inputRules = require("./pm-plugins/input-rules");
 var _insertItemPlugin = require("./pm-plugins/insert-item-plugin");
 var _key = require("./pm-plugins/key");
@@ -111,6 +112,15 @@ var createFindHandlerByTrigger = function createFindHandlerByTrigger(editorViewR
     return (0, _utils.findHandler)(trigger, view.state);
   };
 };
+var createUpdateSectionTitle = function createUpdateSectionTitle(editorViewRef) {
+  return function (props) {
+    if (!editorViewRef.current) {
+      return false;
+    }
+    var view = editorViewRef.current;
+    return (0, _updateSectionTitle.updateSectionTitle)(props)(view.state, view.dispatch);
+  };
+};
 var createCloseTypeAhead = function createCloseTypeAhead(editorViewRef) {
   return function (options) {
     if (!editorViewRef.current) {
@@ -253,7 +263,8 @@ var typeAheadPlugin = exports.typeAheadPlugin = function typeAheadPlugin(_ref) {
       openAtTransaction: createOpenAtTransaction(api === null || api === void 0 || (_api$analytics2 = api.analytics) === null || _api$analytics2 === void 0 ? void 0 : _api$analytics2.actions),
       findHandlerByTrigger: createFindHandlerByTrigger(editorViewRef),
       insert: createInsertTypeAheadItem(editorViewRef),
-      close: createCloseTypeAhead(editorViewRef)
+      close: createCloseTypeAhead(editorViewRef),
+      updateSectionTitle: createUpdateSectionTitle(editorViewRef)
     },
     contentComponent: function contentComponent(_ref4) {
       var editorView = _ref4.editorView,

package/dist/cjs/ui/TypeAheadList.js

@@ -5,7 +5,7 @@ var _typeof = require("@babel/runtime/helpers/typeof");
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.TypeAheadList = void 0;
+exports.buildTypeAheadRows = exports.TypeAheadList = void 0;
 var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
 var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
 var _react = _interopRequireWildcard(require("react"));
@@ -44,7 +44,7 @@ var list = (0, _react2.css)({
     padding: "var(--ds-space-100, 8px)".concat(" ", "var(--ds-space-150, 12px)")
   }
 });
-var buildTypeAheadRows = function buildTypeAheadRows(_ref) {
+var buildTypeAheadRows = exports.buildTypeAheadRows = function buildTypeAheadRows(_ref) {
   var itemsLength = _ref.itemsLength,
     sections = _ref.sections;
   if (sections.length === 0) {
@@ -149,12 +149,12 @@ var TypeAheadListComponent = /*#__PURE__*/_react.default.memo(function (_ref3) {
     });
     return rowIndexByItemIndex;
   }, [listRows]);
+  var selectedItemRowIndex = selectedIndex >= 0 ? (_itemRowIndexByItemIn = itemRowIndexByItemIndex.get(selectedIndex)) !== null && _itemRowIndexByItemIn !== void 0 ? _itemRowIndexByItemIn : -1 : -1;
   var populatedSectionCount = (0, _react.useMemo)(function () {
     return listRows.filter(function (row) {
       return row.type === 'section';
     }).length;
   }, [listRows]);
-  var selectedItemRowIndex = selectedIndex >= 0 ? (_itemRowIndexByItemIn = itemRowIndexByItemIndex.get(selectedIndex)) !== null && _itemRowIndexByItemIn !== void 0 ? _itemRowIndexByItemIn : -1 : -1;
   var onItemsRendered = (0, _react.useCallback)(function (props) {
     lastVisibleIndexes.current = props;
   }, []);
@@ -370,6 +370,7 @@ var TypeAheadListComponent = /*#__PURE__*/_react.default.memo(function (_ref3) {
     if (!currentRow) {
       return null;
     }
+    var shouldHideSingleSectionTitle = currentRow.type === 'section' && populatedSectionCount === 1 && !currentRow.section.showTitleWhenOnlySection;
     return (0, _react2.jsx)(_CellMeasurer.CellMeasurer, {
       key: key,
       cache: cache,
@@ -391,7 +392,10 @@ var TypeAheadListComponent = /*#__PURE__*/_react.default.memo(function (_ref3) {
         onMouseMove: function onMouseMove(e) {
           return _onMouseMove(e, currentRow);
         }
-      }, currentRow.type === 'section' ? populatedSectionCount === 1 ? null : (0, _react2.jsx)(_compiled.Box, {
+      }, currentRow.type === 'section' ?
+      // Preserve the existing collapsed-title behaviour for single-section results unless
+      // the gated section title API explicitly asks for the title to remain visible.
+      shouldHideSingleSectionTitle ? null : (0, _react2.jsx)(_compiled.Box, {
         paddingInline: "space.150",
         paddingBlock: "space.050"
       }, (0, _react2.jsx)(_compiled.Text, {

package/dist/es2019/pm-plugins/actions.js

@@ -8,5 +8,6 @@ export let ACTIONS = /*#__PURE__*/function (ACTIONS) {
   ACTIONS["UPDATE_LIST_ERROR"] = "UPDATE_LIST_ERROR";
   ACTIONS["CLEAR_LIST_ERROR"] = "CLEAR_LIST_ERROR";
   ACTIONS["UPDATE_SELECTED_INDEX"] = "UPDATE_SELECTED_INDEX";
+  ACTIONS["UPDATE_SECTION_TITLE"] = "UPDATE_SECTION_TITLE";
   return ACTIONS;
 }({});

package/dist/es2019/pm-plugins/commands/update-section-title.js

@@ -0,0 +1,30 @@
+import { expVal } from '@atlaskit/tmp-editor-statsig/expVal';
+import { ACTIONS } from '../actions';
+import { pluginKey as typeAheadPluginKey } from '../key';
+export const updateSectionTitle = ({
+  id,
+  title,
+  showTitleWhenOnlySection
+}) => {
+  return (state, dispatch) => {
+    if (!expVal('platform_editor_agent_mentions', 'isEnabled', false) || !dispatch) {
+      return false;
+    }
+    const tr = state.tr;
+    const update = {
+      title,
+      ...(showTitleWhenOnlySection !== undefined ? {
+        showTitleWhenOnlySection
+      } : {})
+    };
+    tr.setMeta(typeAheadPluginKey, {
+      action: ACTIONS.UPDATE_SECTION_TITLE,
+      params: {
+        id,
+        update
+      }
+    });
+    dispatch(tr);
+    return true;
+  };
+};

package/dist/es2019/pm-plugins/main.js

@@ -61,6 +61,7 @@ export function createPlugin({
           decorationSet: DecorationSet.empty,
           decorationElement: null,
           items: [],
+          sectionTitleUpdates: {},
           sections: [],
           errorInfo: null,
           selectedIndex: -1,

package/dist/es2019/pm-plugins/reducer.js

@@ -3,6 +3,7 @@ import { INPUT_METHOD } from '@atlaskit/editor-common/analytics';
 import { DecorationSet } from '@atlaskit/editor-prosemirror/view';
 import { insm } from '@atlaskit/insm';
 import { expValEquals } from '@atlaskit/tmp-editor-statsig/exp-val-equals';
+import { expVal } from '@atlaskit/tmp-editor-statsig/expVal';
 import { ACTIONS } from './actions';
 import { pluginKey } from './key';
 import { isTypeAheadHandler } from './utils';
@@ -22,6 +23,25 @@ const shouldForceClose = step => {
   const isUndoingDeletionRawQuery = step.isUndoingStep() && step.stage === InsertTypeAheadStages.DELETING_RAW_QUERY;
   return isInsertingItem || isUndoingDeletionRawQuery;
 };
+const applySectionTitleUpdates = ({
+  sections,
+  sectionTitleUpdates
+}) => {
+  if (!expVal('platform_editor_agent_mentions', 'isEnabled', false)) {
+    return sections;
+  }
+  const updatedSections = sections.map(section => {
+    const update = sectionTitleUpdates[section.id];
+    if (!update) {
+      return section;
+    }
+    return {
+      ...section,
+      ...update
+    };
+  });
+  return updatedSections;
+};
 const createFindHandler = typeAheadHandlers => step => {
   if (!(step instanceof InsertTypeAheadStep)) {
     return null;
@@ -66,6 +86,7 @@ export const createReducer = ({
       inputMethod,
       selectedIndex: typeof selectedIndex === 'number' ? selectedIndex : -1,
       items: [],
+      sectionTitleUpdates: {},
       sections: [],
       query: reopenQuery || '',
       removePrefixTriggerOnCancel
@@ -87,6 +108,7 @@ export const createReducer = ({
       triggerHandler: undefined,
       items: [],
       sections: [],
+      sectionTitleUpdates: {},
       removePrefixTriggerOnCancel: undefined
     };
   };
@@ -118,6 +140,7 @@ export const createReducer = ({
     const shouldUpdateListItems = action === ACTIONS.UPDATE_LIST_ITEMS;
     const shouldUpdateListError = action === ACTIONS.UPDATE_LIST_ERROR;
     const shouldUpdateSelectedIndex = action === ACTIONS.UPDATE_SELECTED_INDEX;
+    const shouldUpdateSectionTitleState = action === ACTIONS.UPDATE_SECTION_TITLE;
     const shouldClearListError = action === ACTIONS.CLEAR_LIST_ERROR;
     if (shouldOpenMenu) {
       return openMenu(currentPluginState, {
@@ -156,9 +179,35 @@ export const createReducer = ({
       return {
         ...currentPluginState,
         items,
-        sections,
+        sections: applySectionTitleUpdates({
+          sections,
+          sectionTitleUpdates: currentPluginState.sectionTitleUpdates
+        }),
         selectedIndex: Math.max(selectedIndex >= items.length ? items.length - 1 : selectedIndex, -1)
       };
+    } else if (shouldUpdateSectionTitleState) {
+      if (!expVal('platform_editor_agent_mentions', 'isEnabled', false)) {
+        return currentPluginState;
+      }
+      const {
+        id,
+        update
+      } = params;
+      const sectionTitleUpdates = {
+        ...currentPluginState.sectionTitleUpdates,
+        [id]: {
+          ...currentPluginState.sectionTitleUpdates[id],
+          ...update
+        }
+      };
+      return {
+        ...currentPluginState,
+        sectionTitleUpdates,
+        sections: applySectionTitleUpdates({
+          sections: currentPluginState.sections,
+          sectionTitleUpdates
+        })
+      };
     } else if (shouldUpdateSelectedIndex) {
       return {
         ...currentPluginState,

package/dist/es2019/typeAheadPlugin.js

@@ -16,6 +16,7 @@ import { fg } from '@atlaskit/platform-feature-flags';
 import { closeTypeAhead } from './pm-plugins/commands/close-type-ahead';
 import { insertTypeAheadItem } from './pm-plugins/commands/insert-type-ahead-item';
 import { openTypeAheadAtCursor } from './pm-plugins/commands/open-typeahead-at-cursor';
+import { updateSectionTitle } from './pm-plugins/commands/update-section-title';
 import { inputRulePlugin } from './pm-plugins/input-rules';
 import { createPlugin as createInsertItemPlugin } from './pm-plugins/insert-item-plugin';
 import { pluginKey as typeAheadPluginKey } from './pm-plugins/key';
@@ -105,6 +106,15 @@ const createFindHandlerByTrigger = editorViewRef => trigger => {
   } = editorViewRef;
   return findHandler(trigger, view.state);
 };
+const createUpdateSectionTitle = editorViewRef => props => {
+  if (!editorViewRef.current) {
+    return false;
+  }
+  const {
+    current: view
+  } = editorViewRef;
+  return updateSectionTitle(props)(view.state, view.dispatch);
+};
 const createCloseTypeAhead = editorViewRef => options => {
   if (!editorViewRef.current) {
     return false;
@@ -247,7 +257,8 @@ export const typeAheadPlugin = ({
       openAtTransaction: createOpenAtTransaction(api === null || api === void 0 ? void 0 : (_api$analytics2 = api.analytics) === null || _api$analytics2 === void 0 ? void 0 : _api$analytics2.actions),
       findHandlerByTrigger: createFindHandlerByTrigger(editorViewRef),
       insert: createInsertTypeAheadItem(editorViewRef),
-      close: createCloseTypeAhead(editorViewRef)
+      close: createCloseTypeAhead(editorViewRef),
+      updateSectionTitle: createUpdateSectionTitle(editorViewRef)
     },
     contentComponent({
       editorView,

package/dist/es2019/ui/TypeAheadList.js

@@ -33,7 +33,7 @@ const list = css({
     padding: `${"var(--ds-space-100, 8px)"} ${"var(--ds-space-150, 12px)"}`
   }
 });
-const buildTypeAheadRows = ({
+export const buildTypeAheadRows = ({
   itemsLength,
   sections
 }) => {
@@ -127,8 +127,8 @@ const TypeAheadListComponent = /*#__PURE__*/React.memo(({
     });
     return rowIndexByItemIndex;
   }, [listRows]);
-  const populatedSectionCount = useMemo(() => listRows.filter(row => row.type === 'section').length, [listRows]);
   const selectedItemRowIndex = selectedIndex >= 0 ? (_itemRowIndexByItemIn = itemRowIndexByItemIndex.get(selectedIndex)) !== null && _itemRowIndexByItemIn !== void 0 ? _itemRowIndexByItemIn : -1 : -1;
+  const populatedSectionCount = useMemo(() => listRows.filter(row => row.type === 'section').length, [listRows]);
   const onItemsRendered = useCallback(props => {
     lastVisibleIndexes.current = props;
   }, []);
@@ -341,6 +341,7 @@ const TypeAheadListComponent = /*#__PURE__*/React.memo(({
     if (!currentRow) {
       return null;
     }
+    const shouldHideSingleSectionTitle = currentRow.type === 'section' && populatedSectionCount === 1 && !currentRow.section.showTitleWhenOnlySection;
     return jsx(CellMeasurer, {
       key: key,
       cache: cache,
@@ -360,7 +361,10 @@ const TypeAheadListComponent = /*#__PURE__*/React.memo(({
       // eslint-disable-next-line @atlassian/perf-linting/no-unstable-inline-props -- Ignored via go/ees017 (to be fixed)
       ,
       onMouseMove: e => onMouseMove(e, currentRow)
-    }, currentRow.type === 'section' ? populatedSectionCount === 1 ? null : jsx(Box, {
+    }, currentRow.type === 'section' ?
+    // Preserve the existing collapsed-title behaviour for single-section results unless
+    // the gated section title API explicitly asks for the title to remain visible.
+    shouldHideSingleSectionTitle ? null : jsx(Box, {
       paddingInline: "space.150",
       paddingBlock: "space.050"
     }, jsx(Text, {

package/dist/esm/pm-plugins/actions.js

@@ -8,5 +8,6 @@ export var ACTIONS = /*#__PURE__*/function (ACTIONS) {
   ACTIONS["UPDATE_LIST_ERROR"] = "UPDATE_LIST_ERROR";
   ACTIONS["CLEAR_LIST_ERROR"] = "CLEAR_LIST_ERROR";
   ACTIONS["UPDATE_SELECTED_INDEX"] = "UPDATE_SELECTED_INDEX";
+  ACTIONS["UPDATE_SECTION_TITLE"] = "UPDATE_SECTION_TITLE";
   return ACTIONS;
 }({});

package/dist/esm/pm-plugins/commands/update-section-title.js

@@ -0,0 +1,31 @@
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+import { expVal } from '@atlaskit/tmp-editor-statsig/expVal';
+import { ACTIONS } from '../actions';
+import { pluginKey as typeAheadPluginKey } from '../key';
+export var updateSectionTitle = function updateSectionTitle(_ref) {
+  var id = _ref.id,
+    title = _ref.title,
+    showTitleWhenOnlySection = _ref.showTitleWhenOnlySection;
+  return function (state, dispatch) {
+    if (!expVal('platform_editor_agent_mentions', 'isEnabled', false) || !dispatch) {
+      return false;
+    }
+    var tr = state.tr;
+    var update = _objectSpread({
+      title: title
+    }, showTitleWhenOnlySection !== undefined ? {
+      showTitleWhenOnlySection: showTitleWhenOnlySection
+    } : {});
+    tr.setMeta(typeAheadPluginKey, {
+      action: ACTIONS.UPDATE_SECTION_TITLE,
+      params: {
+        id: id,
+        update: update
+      }
+    });
+    dispatch(tr);
+    return true;
+  };
+};

package/dist/esm/pm-plugins/main.js

@@ -61,6 +61,7 @@ export function createPlugin(_ref) {
           decorationSet: DecorationSet.empty,
           decorationElement: null,
           items: [],
+          sectionTitleUpdates: {},
           sections: [],
           errorInfo: null,
           selectedIndex: -1,

package/dist/esm/pm-plugins/reducer.js

@@ -6,6 +6,7 @@ import { INPUT_METHOD } from '@atlaskit/editor-common/analytics';
 import { DecorationSet } from '@atlaskit/editor-prosemirror/view';
 import { insm } from '@atlaskit/insm';
 import { expValEquals } from '@atlaskit/tmp-editor-statsig/exp-val-equals';
+import { expVal } from '@atlaskit/tmp-editor-statsig/expVal';
 import { ACTIONS } from './actions';
 import { pluginKey } from './key';
 import { isTypeAheadHandler } from './utils';
@@ -25,6 +26,21 @@ var shouldForceClose = function shouldForceClose(step) {
   var isUndoingDeletionRawQuery = step.isUndoingStep() && step.stage === InsertTypeAheadStages.DELETING_RAW_QUERY;
   return isInsertingItem || isUndoingDeletionRawQuery;
 };
+var applySectionTitleUpdates = function applySectionTitleUpdates(_ref) {
+  var sections = _ref.sections,
+    sectionTitleUpdates = _ref.sectionTitleUpdates;
+  if (!expVal('platform_editor_agent_mentions', 'isEnabled', false)) {
+    return sections;
+  }
+  var updatedSections = sections.map(function (section) {
+    var update = sectionTitleUpdates[section.id];
+    if (!update) {
+      return section;
+    }
+    return _objectSpread(_objectSpread({}, section), update);
+  });
+  return updatedSections;
+};
 var createFindHandler = function createFindHandler(typeAheadHandlers) {
   return function (step) {
     if (!(step instanceof InsertTypeAheadStep)) {
@@ -36,18 +52,18 @@ var createFindHandler = function createFindHandler(typeAheadHandlers) {
     return handler || null;
   };
 };
-export var createReducer = function createReducer(_ref) {
-  var typeAheadHandlers = _ref.typeAheadHandlers,
-    removeDecorations = _ref.removeDecorations,
-    createDecorations = _ref.createDecorations;
+export var createReducer = function createReducer(_ref2) {
+  var typeAheadHandlers = _ref2.typeAheadHandlers,
+    removeDecorations = _ref2.removeDecorations,
+    createDecorations = _ref2.createDecorations;
   var findHandler = createFindHandler(typeAheadHandlers);
-  var openMenu = function openMenu(currentPluginState, _ref2) {
-    var tr = _ref2.tr,
-      triggerHandler = _ref2.triggerHandler,
-      inputMethod = _ref2.inputMethod,
-      reopenQuery = _ref2.reopenQuery,
-      selectedIndex = _ref2.selectedIndex,
-      removePrefixTriggerOnCancel = _ref2.removePrefixTriggerOnCancel;
+  var openMenu = function openMenu(currentPluginState, _ref3) {
+    var tr = _ref3.tr,
+      triggerHandler = _ref3.triggerHandler,
+      inputMethod = _ref3.inputMethod,
+      reopenQuery = _ref3.reopenQuery,
+      selectedIndex = _ref3.selectedIndex,
+      removePrefixTriggerOnCancel = _ref3.removePrefixTriggerOnCancel;
     removeDecorations(currentPluginState.decorationSet);
     var _createDecorations = createDecorations(tr, {
         triggerHandler: triggerHandler,
@@ -69,6 +85,7 @@ export var createReducer = function createReducer(_ref) {
       inputMethod: inputMethod,
       selectedIndex: typeof selectedIndex === 'number' ? selectedIndex : -1,
       items: [],
+      sectionTitleUpdates: {},
       sections: [],
       query: reopenQuery || '',
       removePrefixTriggerOnCancel: removePrefixTriggerOnCancel
@@ -89,6 +106,7 @@ export var createReducer = function createReducer(_ref) {
       triggerHandler: undefined,
       items: [],
       sections: [],
+      sectionTitleUpdates: {},
       removePrefixTriggerOnCancel: undefined
     });
   };
@@ -109,9 +127,9 @@ export var createReducer = function createReducer(_ref) {
     } else if (shouldForceClose(typeAheadStepOverride)) {
       return closeMenu(currentPluginState);
     }
-    var _ref3 = meta || {},
-      action = _ref3.action,
-      params = _ref3.params;
+    var _ref4 = meta || {},
+      action = _ref4.action,
+      params = _ref4.params;
     var shouldOpenMenu = action === ACTIONS.OPEN_TYPEAHEAD_AT_CURSOR && isTypeAheadHandler(params === null || params === void 0 ? void 0 : params.triggerHandler);
     var selectionChanged = tr.selectionSet && (tr.isGeneric || Boolean(tr.getMeta('pointer')));
     var shouldCloseMenu = [ACTIONS.CLOSE_TYPE_AHEAD, ACTIONS.INSERT_ITEM].includes(action) || selectionChanged;
@@ -119,6 +137,7 @@ export var createReducer = function createReducer(_ref) {
     var shouldUpdateListItems = action === ACTIONS.UPDATE_LIST_ITEMS;
     var shouldUpdateListError = action === ACTIONS.UPDATE_LIST_ERROR;
     var shouldUpdateSelectedIndex = action === ACTIONS.UPDATE_SELECTED_INDEX;
+    var shouldUpdateSectionTitleState = action === ACTIONS.UPDATE_SECTION_TITLE;
     var shouldClearListError = action === ACTIONS.CLEAR_LIST_ERROR;
     if (shouldOpenMenu) {
       return openMenu(currentPluginState, {
@@ -149,9 +168,26 @@ export var createReducer = function createReducer(_ref) {
       var selectedIndex = currentPluginState.selectedIndex;
       return _objectSpread(_objectSpread({}, currentPluginState), {}, {
         items: items,
-        sections: sections,
+        sections: applySectionTitleUpdates({
+          sections: sections,
+          sectionTitleUpdates: currentPluginState.sectionTitleUpdates
+        }),
         selectedIndex: Math.max(selectedIndex >= items.length ? items.length - 1 : selectedIndex, -1)
       });
+    } else if (shouldUpdateSectionTitleState) {
+      if (!expVal('platform_editor_agent_mentions', 'isEnabled', false)) {
+        return currentPluginState;
+      }
+      var id = params.id,
+        update = params.update;
+      var sectionTitleUpdates = _objectSpread(_objectSpread({}, currentPluginState.sectionTitleUpdates), {}, _defineProperty({}, id, _objectSpread(_objectSpread({}, currentPluginState.sectionTitleUpdates[id]), update)));
+      return _objectSpread(_objectSpread({}, currentPluginState), {}, {
+        sectionTitleUpdates: sectionTitleUpdates,
+        sections: applySectionTitleUpdates({
+          sections: currentPluginState.sections,
+          sectionTitleUpdates: sectionTitleUpdates
+        })
+      });
     } else if (shouldUpdateSelectedIndex) {
       return _objectSpread(_objectSpread({}, currentPluginState), {}, {
         selectedIndex: params.selectedIndex

package/dist/esm/typeAheadPlugin.js

@@ -16,6 +16,7 @@ import { fg } from '@atlaskit/platform-feature-flags';
 import { closeTypeAhead } from './pm-plugins/commands/close-type-ahead';
 import { insertTypeAheadItem } from './pm-plugins/commands/insert-type-ahead-item';
 import { openTypeAheadAtCursor } from './pm-plugins/commands/open-typeahead-at-cursor';
+import { updateSectionTitle } from './pm-plugins/commands/update-section-title';
 import { inputRulePlugin } from './pm-plugins/input-rules';
 import { createPlugin as createInsertItemPlugin } from './pm-plugins/insert-item-plugin';
 import { pluginKey as typeAheadPluginKey } from './pm-plugins/key';
@@ -103,6 +104,15 @@ var createFindHandlerByTrigger = function createFindHandlerByTrigger(editorViewR
     return findHandler(trigger, view.state);
   };
 };
+var createUpdateSectionTitle = function createUpdateSectionTitle(editorViewRef) {
+  return function (props) {
+    if (!editorViewRef.current) {
+      return false;
+    }
+    var view = editorViewRef.current;
+    return updateSectionTitle(props)(view.state, view.dispatch);
+  };
+};
 var createCloseTypeAhead = function createCloseTypeAhead(editorViewRef) {
   return function (options) {
     if (!editorViewRef.current) {
@@ -245,7 +255,8 @@ export var typeAheadPlugin = function typeAheadPlugin(_ref) {
       openAtTransaction: createOpenAtTransaction(api === null || api === void 0 || (_api$analytics2 = api.analytics) === null || _api$analytics2 === void 0 ? void 0 : _api$analytics2.actions),
       findHandlerByTrigger: createFindHandlerByTrigger(editorViewRef),
       insert: createInsertTypeAheadItem(editorViewRef),
-      close: createCloseTypeAhead(editorViewRef)
+      close: createCloseTypeAhead(editorViewRef),
+      updateSectionTitle: createUpdateSectionTitle(editorViewRef)
     },
     contentComponent: function contentComponent(_ref4) {
       var editorView = _ref4.editorView,

package/dist/esm/ui/TypeAheadList.js

@@ -35,7 +35,7 @@ var list = css({
     padding: "var(--ds-space-100, 8px)".concat(" ", "var(--ds-space-150, 12px)")
   }
 });
-var buildTypeAheadRows = function buildTypeAheadRows(_ref) {
+export var buildTypeAheadRows = function buildTypeAheadRows(_ref) {
   var itemsLength = _ref.itemsLength,
     sections = _ref.sections;
   if (sections.length === 0) {
@@ -140,12 +140,12 @@ var TypeAheadListComponent = /*#__PURE__*/React.memo(function (_ref3) {
     });
     return rowIndexByItemIndex;
   }, [listRows]);
+  var selectedItemRowIndex = selectedIndex >= 0 ? (_itemRowIndexByItemIn = itemRowIndexByItemIndex.get(selectedIndex)) !== null && _itemRowIndexByItemIn !== void 0 ? _itemRowIndexByItemIn : -1 : -1;
   var populatedSectionCount = useMemo(function () {
     return listRows.filter(function (row) {
       return row.type === 'section';
     }).length;
   }, [listRows]);
-  var selectedItemRowIndex = selectedIndex >= 0 ? (_itemRowIndexByItemIn = itemRowIndexByItemIndex.get(selectedIndex)) !== null && _itemRowIndexByItemIn !== void 0 ? _itemRowIndexByItemIn : -1 : -1;
   var onItemsRendered = useCallback(function (props) {
     lastVisibleIndexes.current = props;
   }, []);
@@ -361,6 +361,7 @@ var TypeAheadListComponent = /*#__PURE__*/React.memo(function (_ref3) {
     if (!currentRow) {
       return null;
     }
+    var shouldHideSingleSectionTitle = currentRow.type === 'section' && populatedSectionCount === 1 && !currentRow.section.showTitleWhenOnlySection;
     return jsx(CellMeasurer, {
       key: key,
       cache: cache,
@@ -382,7 +383,10 @@ var TypeAheadListComponent = /*#__PURE__*/React.memo(function (_ref3) {
         onMouseMove: function onMouseMove(e) {
           return _onMouseMove(e, currentRow);
         }
-      }, currentRow.type === 'section' ? populatedSectionCount === 1 ? null : jsx(Box, {
+      }, currentRow.type === 'section' ?
+      // Preserve the existing collapsed-title behaviour for single-section results unless
+      // the gated section title API explicitly asks for the title to remain visible.
+      shouldHideSingleSectionTitle ? null : jsx(Box, {
         paddingInline: "space.150",
         paddingBlock: "space.050"
       }, jsx(Text, {

package/dist/types/pm-plugins/actions.d.ts

@@ -7,5 +7,6 @@ export declare enum ACTIONS {
     UPDATE_LIST_ITEMS = "UPDATE_LIST_ITEMS",
     UPDATE_LIST_ERROR = "UPDATE_LIST_ERROR",
     CLEAR_LIST_ERROR = "CLEAR_LIST_ERROR",
-    UPDATE_SELECTED_INDEX = "UPDATE_SELECTED_INDEX"
+    UPDATE_SELECTED_INDEX = "UPDATE_SELECTED_INDEX",
+    UPDATE_SECTION_TITLE = "UPDATE_SECTION_TITLE"
 }

package/dist/types/pm-plugins/commands/update-section-title.d.ts

@@ -0,0 +1,2 @@
+import type { Command, TypeAheadSectionTitleUpdate } from '@atlaskit/editor-common/types';
+export declare const updateSectionTitle: ({ id, title, showTitleWhenOnlySection }: TypeAheadSectionTitleUpdate) => Command;

package/dist/types/typeAheadPluginType.d.ts

@@ -1,5 +1,5 @@
 import type { SelectItemMode } from '@atlaskit/editor-common/type-ahead';
-import type { Command, NextEditorPlugin, OptionalPlugin, TypeAheadHandler, TypeAheadItem } from '@atlaskit/editor-common/types';
+import type { Command, NextEditorPlugin, OptionalPlugin, TypeAheadHandler, TypeAheadItem, TypeAheadSectionTitleUpdate } from '@atlaskit/editor-common/types';
 import type { AnalyticsPlugin } from '@atlaskit/editor-plugin-analytics';
 import type { ConnectivityPlugin } from '@atlaskit/editor-plugin-connectivity';
 import type { ContextPanelPlugin } from '@atlaskit/editor-plugin-context-panel';
@@ -31,6 +31,13 @@ export type TypeAheadPlugin = NextEditorPlugin<'typeAhead', {
         isOpen: (editorState: EditorState) => boolean;
         open: (props: OpenTypeAheadProps) => boolean;
         openAtTransaction: (props: OpenTypeAheadProps) => (tr: Transaction) => boolean;
+        /**
+         * Updates the display title for an existing typeahead section in the current typeahead session.
+         *
+         * The optional `showTitleWhenOnlySection` flag keeps the title visible when this section is
+         * the only populated section. It does not render titles for empty sections.
+         */
+        updateSectionTitle?: (props: TypeAheadSectionTitleUpdate) => boolean;
     };
     dependencies: [
         OptionalPlugin<AnalyticsPlugin>,

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

@@ -24,6 +24,7 @@ export interface TypeAheadStatsMobileModifier extends TypeAheadStatsSerializable
     closeTime: () => void;
     resetTime: () => void;
 }
+export type TypeAheadSectionTitleUpdateState = Pick<TypeAheadResolvedSection, 'showTitleWhenOnlySection' | 'title'>;
 export type TypeAheadPluginState = {
     decorationElement: HTMLElement | null;
     decorationSet: DecorationSet;
@@ -36,6 +37,7 @@ export type TypeAheadPluginState = {
      */
     removePrefixTriggerOnCancel?: boolean;
     sections: Array<TypeAheadResolvedSection>;
+    sectionTitleUpdates: Record<string, TypeAheadSectionTitleUpdateState>;
     selectedIndex: number;
     stats: TypeAheadStatsSerializable | null;
     triggerHandler?: TypeAheadHandler;
@@ -44,6 +46,11 @@ export type TypeAheadPluginState = {
 export type TypeAheadResolvedSection = {
     endIndex: number;
     id: string;
+    /**
+     * Keeps this section's title visible when it is the only section with matching items.
+     * Does not render the title for an empty section.
+     */
+    showTitleWhenOnlySection?: boolean;
     startIndex: number;
     title: string;
 };

package/dist/types/ui/TypeAheadList.d.ts

@@ -10,6 +10,17 @@ import type { EditorView } from '@atlaskit/editor-prosemirror/view';
 import type { InputMethodType } from '../pm-plugins/analytics';
 import type { TypeAheadPlugin } from '../typeAheadPluginType';
 import type { TypeAheadHandler, TypeAheadResolvedSection } from '../types';
+type TypeAheadRowEntry = {
+    section: TypeAheadResolvedSection;
+    type: 'section';
+} | {
+    itemIndex: number;
+    type: 'item';
+};
+export declare const buildTypeAheadRows: ({ itemsLength, sections, }: {
+    itemsLength: number;
+    sections: Array<TypeAheadResolvedSection>;
+}) => Array<TypeAheadRowEntry>;
 export declare const TypeAheadList: React.FC<WithIntlProps<{
     api: ExtractInjectionAPI<TypeAheadPlugin> | undefined;
     decorationElement: HTMLElement;
@@ -41,3 +52,4 @@ export declare const TypeAheadList: React.FC<WithIntlProps<{
         triggerHandler?: TypeAheadHandler;
     } & WrappedComponentProps>;
 };
+export {};

package/dist/types/ui/hooks/build-sectioned-result.d.ts

@@ -2,9 +2,9 @@ import type { IntlShape } from 'react-intl';
 import type { TypeAheadHandler, TypeAheadItem } from '@atlaskit/editor-common/types';
 import type { TypeAheadResolvedSection } from '../../types';
 export declare const buildSectionedResult: ({ items, triggerHandler, intl, }: {
+    intl: IntlShape | null;
     items: Array<TypeAheadItem>;
     triggerHandler: TypeAheadHandler;
-    intl: IntlShape | null;
 }) => {
     items: Array<TypeAheadItem>;
     sections: Array<TypeAheadResolvedSection>;

package/dist/types-ts4.5/pm-plugins/actions.d.ts

@@ -7,5 +7,6 @@ export declare enum ACTIONS {
     UPDATE_LIST_ITEMS = "UPDATE_LIST_ITEMS",
     UPDATE_LIST_ERROR = "UPDATE_LIST_ERROR",
     CLEAR_LIST_ERROR = "CLEAR_LIST_ERROR",
-    UPDATE_SELECTED_INDEX = "UPDATE_SELECTED_INDEX"
+    UPDATE_SELECTED_INDEX = "UPDATE_SELECTED_INDEX",
+    UPDATE_SECTION_TITLE = "UPDATE_SECTION_TITLE"
 }

package/dist/types-ts4.5/pm-plugins/commands/update-section-title.d.ts

@@ -0,0 +1,2 @@
+import type { Command, TypeAheadSectionTitleUpdate } from '@atlaskit/editor-common/types';
+export declare const updateSectionTitle: ({ id, title, showTitleWhenOnlySection }: TypeAheadSectionTitleUpdate) => Command;

package/dist/types-ts4.5/typeAheadPluginType.d.ts

@@ -1,5 +1,5 @@
 import type { SelectItemMode } from '@atlaskit/editor-common/type-ahead';
-import type { Command, NextEditorPlugin, OptionalPlugin, TypeAheadHandler, TypeAheadItem } from '@atlaskit/editor-common/types';
+import type { Command, NextEditorPlugin, OptionalPlugin, TypeAheadHandler, TypeAheadItem, TypeAheadSectionTitleUpdate } from '@atlaskit/editor-common/types';
 import type { AnalyticsPlugin } from '@atlaskit/editor-plugin-analytics';
 import type { ConnectivityPlugin } from '@atlaskit/editor-plugin-connectivity';
 import type { ContextPanelPlugin } from '@atlaskit/editor-plugin-context-panel';
@@ -31,6 +31,13 @@ export type TypeAheadPlugin = NextEditorPlugin<'typeAhead', {
         isOpen: (editorState: EditorState) => boolean;
         open: (props: OpenTypeAheadProps) => boolean;
         openAtTransaction: (props: OpenTypeAheadProps) => (tr: Transaction) => boolean;
+        /**
+         * Updates the display title for an existing typeahead section in the current typeahead session.
+         *
+         * The optional `showTitleWhenOnlySection` flag keeps the title visible when this section is
+         * the only populated section. It does not render titles for empty sections.
+         */
+        updateSectionTitle?: (props: TypeAheadSectionTitleUpdate) => boolean;
     };
     dependencies: [
         OptionalPlugin<AnalyticsPlugin>,

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

@@ -24,6 +24,7 @@ export interface TypeAheadStatsMobileModifier extends TypeAheadStatsSerializable
     closeTime: () => void;
     resetTime: () => void;
 }
+export type TypeAheadSectionTitleUpdateState = Pick<TypeAheadResolvedSection, 'showTitleWhenOnlySection' | 'title'>;
 export type TypeAheadPluginState = {
     decorationElement: HTMLElement | null;
     decorationSet: DecorationSet;
@@ -36,6 +37,7 @@ export type TypeAheadPluginState = {
      */
     removePrefixTriggerOnCancel?: boolean;
     sections: Array<TypeAheadResolvedSection>;
+    sectionTitleUpdates: Record<string, TypeAheadSectionTitleUpdateState>;
     selectedIndex: number;
     stats: TypeAheadStatsSerializable | null;
     triggerHandler?: TypeAheadHandler;
@@ -44,6 +46,11 @@ export type TypeAheadPluginState = {
 export type TypeAheadResolvedSection = {
     endIndex: number;
     id: string;
+    /**
+     * Keeps this section's title visible when it is the only section with matching items.
+     * Does not render the title for an empty section.
+     */
+    showTitleWhenOnlySection?: boolean;
     startIndex: number;
     title: string;
 };

package/dist/types-ts4.5/ui/TypeAheadList.d.ts

@@ -10,6 +10,17 @@ import type { EditorView } from '@atlaskit/editor-prosemirror/view';
 import type { InputMethodType } from '../pm-plugins/analytics';
 import type { TypeAheadPlugin } from '../typeAheadPluginType';
 import type { TypeAheadHandler, TypeAheadResolvedSection } from '../types';
+type TypeAheadRowEntry = {
+    section: TypeAheadResolvedSection;
+    type: 'section';
+} | {
+    itemIndex: number;
+    type: 'item';
+};
+export declare const buildTypeAheadRows: ({ itemsLength, sections, }: {
+    itemsLength: number;
+    sections: Array<TypeAheadResolvedSection>;
+}) => Array<TypeAheadRowEntry>;
 export declare const TypeAheadList: React.FC<WithIntlProps<{
     api: ExtractInjectionAPI<TypeAheadPlugin> | undefined;
     decorationElement: HTMLElement;
@@ -41,3 +52,4 @@ export declare const TypeAheadList: React.FC<WithIntlProps<{
         triggerHandler?: TypeAheadHandler;
     } & WrappedComponentProps>;
 };
+export {};

package/dist/types-ts4.5/ui/hooks/build-sectioned-result.d.ts

@@ -2,9 +2,9 @@ import type { IntlShape } from 'react-intl';
 import type { TypeAheadHandler, TypeAheadItem } from '@atlaskit/editor-common/types';
 import type { TypeAheadResolvedSection } from '../../types';
 export declare const buildSectionedResult: ({ items, triggerHandler, intl, }: {
+    intl: IntlShape | null;
     items: Array<TypeAheadItem>;
     triggerHandler: TypeAheadHandler;
-    intl: IntlShape | null;
 }) => {
     items: Array<TypeAheadItem>;
     sections: Array<TypeAheadResolvedSection>;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/editor-plugin-type-ahead",
-	"version": "11.0.1",
+	"version": "11.1.0",
 	"description": "Type-ahead plugin for @atlaskit/editor-core",
 	"author": "Atlassian Pty Ltd",
 	"license": "Apache-2.0",
@@ -56,7 +56,7 @@
 		"w3c-keyname": "^2.1.8"
 	},
 	"peerDependencies": {
-		"@atlaskit/editor-common": "^115.2.0",
+		"@atlaskit/editor-common": "^115.3.0",
 		"react": "^18.2.0",
 		"react-dom": "^18.2.0",
 		"react-intl": "^5.25.1 || ^6.0.0 || ^7.0.0"