@atlaskit/editor-plugin-quick-insert 29.0.4 → 30.0.0

package/dist/esm/ui/registered-menu/get-quick-insert-menu-model.js

@@ -0,0 +1,230 @@
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+import _toConsumableArray from "@babel/runtime/helpers/toConsumableArray";
+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; }
+function _createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = _unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t.return || t.return(); } finally { if (u) throw o; } } }; }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
+import { ASK_ROVO_MENU_ITEM, MENU, SEARCH_RESULTS_SECTION } from '@atlaskit/editor-common/quick-insert/keys';
+import { applyRegisteredItemRanks } from '@atlaskit/editor-common/registered-menu/item-rank';
+import { isMenuFooterSectionKey } from '@atlaskit/editor-common/type-ahead-is-menu-footer-section-key';
+import { isSectionOverflowItemKey } from '@atlaskit/editor-common/type-ahead-is-section-overflow-item-key';
+import { getComponentIdentity, resolveSurface, willComponentRender } from '@atlaskit/editor-ui-control-model/surface-renderer';
+import { QuickInsertSearchResultsSection } from './QuickInsertSearchResultsSection';
+var SEARCH_TOP_MATCH_LIMIT = 5;
+var SEARCH_RESULTS_HEADING = {
+  key: SEARCH_RESULTS_SECTION.key,
+  type: SEARCH_RESULTS_SECTION.type,
+  component: QuickInsertSearchResultsSection,
+  parents: [{
+    key: MENU.key,
+    type: MENU.type,
+    rank: 0
+  }]
+};
+var getParentRank = function getParentRank(component, parentKey) {
+  var _component$parents$fi, _component$parents;
+  return (_component$parents$fi = (_component$parents = component.parents) === null || _component$parents === void 0 || (_component$parents = _component$parents.find(function (parent) {
+    return parent.key === parentKey;
+  })) === null || _component$parents === void 0 ? void 0 : _component$parents.rank) !== null && _component$parents$fi !== void 0 ? _component$parents$fi : Number.MAX_SAFE_INTEGER;
+};
+var compareMatchedItems = function compareMatchedItems(a, b) {
+  return a.sectionRank - b.sectionRank || a.score - b.score || a.itemRank - b.itemRank || a.sourceIndex - b.sourceIndex || a.identity.localeCompare(b.identity);
+};
+var compareSearchResults = function compareSearchResults(a, b) {
+  return a.score - b.score || a.sectionRank - b.sectionRank || a.itemRank - b.itemRank || a.sourceIndex - b.sourceIndex || a.identity.localeCompare(b.identity);
+};
+var getSearchResults = function getSearchResults(matches) {
+  var topMatches = Array.from(matches).sort(compareSearchResults).slice(0, SEARCH_TOP_MATCH_LIMIT);
+  var topMatchIdentities = new Set(topMatches.map(function (_ref) {
+    var identity = _ref.identity;
+    return identity;
+  }));
+  var tailMatches = matches.filter(function (_ref2) {
+    var identity = _ref2.identity;
+    return !topMatchIdentities.has(identity);
+  });
+  return [].concat(_toConsumableArray(topMatches), _toConsumableArray(tailMatches)).map(function (_ref3) {
+    var item = _ref3.item;
+    return item;
+  });
+};
+var getRenderedMenuItems = function getRenderedMenuItems(section, childrenMap, surfaceContext) {
+  var _childrenMap$get;
+  return ((_childrenMap$get = childrenMap.get(getComponentIdentity(section))) !== null && _childrenMap$get !== void 0 ? _childrenMap$get : []).filter(function (child) {
+    return child.type === 'menu-item' && willComponentRender(child, childrenMap, surfaceContext);
+  });
+};
+var buildBrowseSections = function buildBrowseSections(_ref4) {
+  var childrenMap = _ref4.childrenMap,
+    contentSections = _ref4.contentSections,
+    selectCategoryItems = _ref4.selectCategoryItems,
+    surfaceContext = _ref4.surfaceContext;
+  var sections = [];
+  var _iterator = _createForOfIteratorHelper(contentSections),
+    _step;
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var section = _step.value;
+      var children = getRenderedMenuItems(section, childrenMap, surfaceContext);
+      var overflowItems = children.filter(function (child) {
+        return isSectionOverflowItemKey(child.key);
+      });
+      var viewMoreItem = overflowItems[overflowItems.length - 1];
+      var items = children.filter(function (child) {
+        return !isSectionOverflowItemKey(child.key);
+      });
+      if (items.length === 0) {
+        continue;
+      }
+      var selectedItems = viewMoreItem !== undefined && selectCategoryItems !== undefined ? selectCategoryItems(items) : items;
+      if (selectedItems.length < items.length && viewMoreItem !== undefined) {
+        sections.push([section].concat(_toConsumableArray(selectedItems), [viewMoreItem]));
+      } else {
+        sections.push([section].concat(_toConsumableArray(selectedItems)));
+      }
+    }
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+  return {
+    fallbackItems: [],
+    sections: sections
+  };
+};
+var buildSearchSections = function buildSearchSections(_ref5) {
+  var childrenMap = _ref5.childrenMap,
+    components = _ref5.components,
+    contentSections = _ref5.contentSections,
+    formatMessage = _ref5.formatMessage,
+    query = _ref5.query,
+    root = _ref5.root,
+    surfaceContext = _ref5.surfaceContext;
+  var matches = new Map();
+  var sourceIndexByComponent = new Map(components.map(function (component, index) {
+    return [component, index];
+  }));
+  var _iterator2 = _createForOfIteratorHelper(contentSections),
+    _step2;
+  try {
+    for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+      var section = _step2.value;
+      var _iterator3 = _createForOfIteratorHelper(getRenderedMenuItems(section, childrenMap, surfaceContext)),
+        _step3;
+      try {
+        for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
+          var _item$match, _match$score, _sourceIndexByCompone;
+          var item = _step3.value;
+          if (isSectionOverflowItemKey(item.key)) {
+            continue;
+          }
+          var match = (_item$match = item.match) === null || _item$match === void 0 ? void 0 : _item$match.call(item, {
+            formatMessage: formatMessage,
+            query: query
+          });
+          if (item.match && match === null) {
+            continue;
+          }
+          var candidate = {
+            identity: "".concat(item.type, ":").concat(item.key),
+            item: item,
+            itemRank: getParentRank(item, section.key),
+            score: Math.min(1, Math.max(0, (_match$score = match === null || match === void 0 ? void 0 : match.score) !== null && _match$score !== void 0 ? _match$score : 0)),
+            sourceIndex: (_sourceIndexByCompone = sourceIndexByComponent.get(item)) !== null && _sourceIndexByCompone !== void 0 ? _sourceIndexByCompone : Number.MAX_SAFE_INTEGER,
+            sectionRank: getParentRank(section, root.key)
+          };
+          var existing = matches.get(candidate.identity);
+          if (!existing || compareMatchedItems(candidate, existing) < 0) {
+            matches.set(candidate.identity, candidate);
+          }
+        }
+      } catch (err) {
+        _iterator3.e(err);
+      } finally {
+        _iterator3.f();
+      }
+    }
+  } catch (err) {
+    _iterator2.e(err);
+  } finally {
+    _iterator2.f();
+  }
+  var uniqueMatches = Array.from(matches.values()).sort(compareMatchedItems);
+  var searchResults = getSearchResults(uniqueMatches);
+  if (searchResults.length > 0) {
+    return {
+      fallbackItems: [],
+      sections: [[SEARCH_RESULTS_HEADING].concat(_toConsumableArray(searchResults))]
+    };
+  }
+  var fallbackItem = contentSections.flatMap(function (section) {
+    var _childrenMap$get2;
+    return (_childrenMap$get2 = childrenMap.get(getComponentIdentity(section))) !== null && _childrenMap$get2 !== void 0 ? _childrenMap$get2 : [];
+  }).find(function (component) {
+    return component.type === ASK_ROVO_MENU_ITEM.type && component.key === ASK_ROVO_MENU_ITEM.key && willComponentRender(component, childrenMap, surfaceContext);
+  });
+  return {
+    fallbackItems: fallbackItem ? [fallbackItem] : [],
+    sections: []
+  };
+};
+
+/**
+ * Builds the registered quick-insert menu model. An empty query browses every
+ * category; a non-empty query returns ranked matches. The footer is shared by both.
+ */
+export var getQuickInsertMenuModel = function getQuickInsertMenuModel(_ref6) {
+  var components = _ref6.components,
+    formatMessage = _ref6.formatMessage,
+    getItemRank = _ref6.getItemRank,
+    query = _ref6.query,
+    rootComponent = _ref6.rootComponent,
+    selectCategoryItems = _ref6.selectCategoryItems,
+    surfaceContext = _ref6.surfaceContext;
+  var rankedComponents = applyRegisteredItemRanks(components, getItemRank);
+  var _resolveSurface = resolveSurface(rankedComponents, rootComponent),
+    childrenMap = _resolveSurface.childrenMap,
+    root = _resolveSurface.root,
+    _resolveSurface$topLe = _resolveSurface.topLevelChildren,
+    topLevelChildren = _resolveSurface$topLe === void 0 ? [] : _resolveSurface$topLe;
+  if (!root || !willComponentRender(root, childrenMap, surfaceContext)) {
+    return {
+      fallbackItems: [],
+      footer: undefined,
+      root: undefined,
+      sections: []
+    };
+  }
+  var renderedSections = topLevelChildren.filter(function (section) {
+    return section.type === 'menu-section' && willComponentRender(section, childrenMap, surfaceContext);
+  });
+  var footerSection = renderedSections.find(function (_ref7) {
+    var key = _ref7.key;
+    return isMenuFooterSectionKey(key);
+  });
+  var contentSections = renderedSections.filter(function (_ref8) {
+    var key = _ref8.key;
+    return !isMenuFooterSectionKey(key);
+  });
+  var content = query === '' ? buildBrowseSections({
+    childrenMap: childrenMap,
+    contentSections: contentSections,
+    selectCategoryItems: selectCategoryItems,
+    surfaceContext: surfaceContext
+  }) : buildSearchSections({
+    childrenMap: childrenMap,
+    components: rankedComponents,
+    contentSections: contentSections,
+    formatMessage: formatMessage,
+    query: query,
+    root: root,
+    surfaceContext: surfaceContext
+  });
+  var footer = footerSection ? getRenderedMenuItems(footerSection, childrenMap, surfaceContext)[0] : undefined;
+  return _objectSpread(_objectSpread({}, content), {}, {
+    footer: footer,
+    root: root
+  });
+};

package/dist/esm/ui/registered-menu/getQuickInsertMenuItemId.js

@@ -0,0 +1,3 @@
+export var getQuickInsertMenuItemId = function getQuickInsertMenuItemId(listId, itemIndex) {
+  return "".concat(listId, "-").concat(itemIndex);
+};

package/dist/esm/ui/registered-menu/selectQuickInsertCategoryItems.js

@@ -0,0 +1,21 @@
+import { quickInsertProviderMenuItemKey } from '@atlaskit/editor-common/quick-insert/get-provider-menu-item-key';
+var DEFAULT_ITEM_LIMIT = 30;
+var ECOSYSTEM_ITEM_LIMIT = 10;
+var isEcosystemQuickInsertItem = function isEcosystemQuickInsertItem(item) {
+  return quickInsertProviderMenuItemKey.isEcosystem(item.key);
+};
+
+/**
+ * Keeps the initial native and ecosystem results while ensuring ecosystem registrations
+ * remain discoverable beyond the default category item limit.
+ */
+export var selectQuickInsertCategoryItems = function selectQuickInsertCategoryItems(items) {
+  var ecosystemItemCount = 0;
+  return items.filter(function (item, index) {
+    var isEcosystemItem = isEcosystemQuickInsertItem(item);
+    if (isEcosystemItem) {
+      ecosystemItemCount++;
+    }
+    return index < DEFAULT_ITEM_LIMIT || isEcosystemItem && ecosystemItemCount <= ECOSYSTEM_ITEM_LIMIT;
+  });
+};

package/dist/esm/ui/registered-menu/useQuickInsertSearchAnalytics.js

@@ -0,0 +1,93 @@
+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 { useCallback, useEffect, useRef } from 'react';
+import { ACTION, ACTION_SUBJECT, EVENT_TYPE } from '@atlaskit/editor-common/analytics/types/enums';
+var SEARCH_DEBOUNCE_MS = 1000;
+export var useQuickInsertSearchAnalytics = function useQuickInsertSearchAnalytics(_ref) {
+  var query = _ref.query,
+    resultCount = _ref.resultCount,
+    surface = _ref.surface,
+    category = _ref.category,
+    _ref$isOpen = _ref.isOpen,
+    isOpen = _ref$isOpen === void 0 ? true : _ref$isOpen,
+    fireAnalyticsEvent = _ref.fireAnalyticsEvent;
+  var latestOptions = useRef({
+    query: query,
+    resultCount: resultCount,
+    surface: surface,
+    category: category,
+    fireAnalyticsEvent: fireAnalyticsEvent
+  });
+  latestOptions.current = {
+    query: query,
+    resultCount: resultCount,
+    surface: surface,
+    category: category,
+    fireAnalyticsEvent: fireAnalyticsEvent
+  };
+  var pendingSearch = useRef(null);
+  var effectVersion = useRef(0);
+  var flush = useCallback(function () {
+    var pending = pendingSearch.current;
+    if (!pending) {
+      return;
+    }
+    clearTimeout(pending.timer);
+    pendingSearch.current = null;
+    var current = latestOptions.current;
+    if (current.query.trim() !== pending.query || !current.fireAnalyticsEvent) {
+      return;
+    }
+    var attributes = _objectSpread(_objectSpread({}, current.surface === 'element-browser' && current.category !== undefined ? {
+      category: current.category
+    } : {}), {}, {
+      isEmpty: current.resultCount === 0,
+      queryLength: current.query.trim().length,
+      resultCount: current.resultCount,
+      surface: current.surface
+    });
+    var payload = {
+      action: ACTION.SEARCHED,
+      actionSubject: ACTION_SUBJECT.QUICK_INSERT,
+      eventType: EVENT_TYPE.TRACK,
+      attributes: attributes
+    };
+    current.fireAnalyticsEvent(payload);
+  }, []);
+  useEffect(function () {
+    var currentVersion = ++effectVersion.current;
+    if (!isOpen) {
+      flush();
+      return;
+    }
+    var trimmedQuery = query.trim();
+    if (!trimmedQuery) {
+      if (pendingSearch.current) {
+        clearTimeout(pendingSearch.current.timer);
+        pendingSearch.current = null;
+      }
+      return;
+    }
+    if (pendingSearch.current) {
+      clearTimeout(pendingSearch.current.timer);
+    }
+    var timer = setTimeout(flush, SEARCH_DEBOUNCE_MS);
+    pendingSearch.current = {
+      query: trimmedQuery,
+      timer: timer
+    };
+    return function () {
+      if (pendingSearch.current) {
+        clearTimeout(pendingSearch.current.timer);
+      }
+      Promise.resolve().then(function () {
+        // oxlint-disable-next-line react-hooks/exhaustive-deps -- The live effect version distinguishes dependency cleanup from a real unmount.
+        if (effectVersion.current === currentVersion) {
+          flush();
+        }
+      });
+    };
+  }, [query, surface, category, isOpen, flush]);
+  return flush;
+};

package/dist/types/quickInsertPluginType.d.ts

@@ -1,7 +1,7 @@
 import type { INPUT_METHOD } from '@atlaskit/editor-common/analytics/types/enums';
 import type { QuickInsertItem } from '@atlaskit/editor-common/provider-factory/quick-insert-provider';
 import type { IsRecommendedItem } from '@atlaskit/editor-common/quick-insert/is-recommended-item';
-import type { RegisteredItemRankResolver } from '@atlaskit/editor-common/type-ahead/item-rank';
+import type { RegisteredItemRankResolver } from '@atlaskit/editor-common/registered-menu/item-rank';
 import type { Command } from '@atlaskit/editor-common/types/command';
 import type { EditorCommand } from '@atlaskit/editor-common/types/editor-command';
 import type { NextEditorPlugin, OptionalPlugin } from '@atlaskit/editor-common/types/next-editor-plugin';

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

@@ -1,8 +1,8 @@
 import React from 'react';
-import type { RegisterMenuItem, SurfaceContext } from '@atlaskit/editor-ui-control-model/types';
-type Props = Record<string, unknown> & {
+import type { CommonComponentProps, RegisterMenuItem, SurfaceContext } from '@atlaskit/editor-ui-control-model/types';
+type Props = CommonComponentProps & {
     getSnapshot: (surfaceContext?: SurfaceContext) => RegisterMenuItem[];
     index: number;
 };
-export declare const QuickInsertRecommendedSlot: ({ index, getSnapshot, ...props }: Props) => React.ReactNode;
+export declare const QuickInsertRecommendedSlot: ({ children, parents, surfaceContext, index, getSnapshot, }: Props) => React.ReactNode;
 export {};

package/dist/types/ui/RegistryElementBrowser/RegistryElementBrowserSearchResults.d.ts

@@ -6,6 +6,7 @@ import React from 'react';
 import type { QuickInsertSelectionHandler } from '@atlaskit/editor-common/quick-insert/context';
 import type { EmptyStateHandler } from '@atlaskit/editor-common/types/empty-state-handler';
 import type { EditorView } from '@atlaskit/editor-prosemirror/view';
+import type { SurfaceContext } from '@atlaskit/editor-ui-control-model/types';
 import type { RegistryElementBrowserItem } from './model';
 type Props = {
     editorView: EditorView;
@@ -20,13 +21,15 @@ type Props = {
     resultsId: string;
     section?: string;
     selectedKey?: string;
+    surfaceContext: SurfaceContext;
 };
-declare const RegistryElementBrowserItem: ({ editorView, isOffline, isSelected, item, onSelect, }: {
+declare const RegistryElementBrowserItem: ({ editorView, isOffline, isSelected, item, onSelect, surfaceContext, }: {
     editorView: EditorView;
     isOffline: boolean;
     isSelected: boolean;
     item: RegistryElementBrowserItem;
     onSelect: (key: string, handler: QuickInsertSelectionHandler) => void;
+    surfaceContext: SurfaceContext;
 }) => React.JSX.Element | null;
-export declare const RegistryElementBrowserSearchResults: ({ editorView, emptyStateHandler, fallbackItems, isLoading, isOffline, items, query, resultsId, section, selectedKey, onKeyDown, onSelect, }: Props) => React.JSX.Element;
+export declare const RegistryElementBrowserSearchResults: ({ editorView, emptyStateHandler, fallbackItems, isLoading, isOffline, items, query, resultsId, section, selectedKey, surfaceContext, onKeyDown, onSelect, }: Props) => React.JSX.Element;
 export {};

package/dist/types/ui/RegistryElementBrowser/model.d.ts

@@ -1,4 +1,4 @@
-import type { MenuItemMatchContext, RegisterComponent, RegisterMenuItem } from '@atlaskit/editor-ui-control-model/types';
+import type { MenuItemMatchContext, RegisterComponent, RegisterMenuItem, SurfaceContext } from '@atlaskit/editor-ui-control-model/types';
 export type RegistryElementBrowserSection = {
     key: string;
     rank: number;
@@ -18,11 +18,12 @@ export type RegistryElementBrowserModel = {
  * Builds the Element Browser's view of the resolved Quick Insert registry.
  * The caller provides only components rooted at the Quick Insert menu surface.
  */
-export declare const createRegistryElementBrowserModel: (components: RegisterComponent[], { footerKey, overflowKeys, recommendedSectionKey, rootKey, }: {
+export declare const createRegistryElementBrowserModel: (components: RegisterComponent[], { footerKey, overflowKeys, recommendedSectionKey, rootKey, surfaceContext, }: {
     footerKey: string;
     overflowKeys: Set<string>;
     recommendedSectionKey: string;
     rootKey: string;
+    surfaceContext?: SurfaceContext;
 }) => RegistryElementBrowserModel;
 export declare const getInitialRegistryElementBrowserSection: (model: RegistryElementBrowserModel, requestedSection?: string) => string | undefined;
 export declare const getRegistryElementBrowserItems: ({ formatMessage, model, query, section, }: {

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

@@ -1,12 +1,18 @@
+import type { EditorAnalyticsAPI } from '@atlaskit/editor-common/analytics/api';
 import type { IsRecommendedItem } from '@atlaskit/editor-common/quick-insert/is-recommended-item';
+import type { RegisteredItemRankResolver } from '@atlaskit/editor-common/registered-menu/item-rank';
+import type { EmptyStateHandler } from '@atlaskit/editor-common/types/empty-state-handler';
 import type { ExtractInjectionAPI } from '@atlaskit/editor-common/types/next-editor-plugin';
-import type { CommonComponentProps, RegisterComponent } from '@atlaskit/editor-ui-control-model/types';
+import type { RegisterComponent } from '@atlaskit/editor-ui-control-model/types';
 import type { QuickInsertPlugin } from '../quickInsertPluginType';
 type Params = {
     api: ExtractInjectionAPI<QuickInsertPlugin> | undefined;
+    emptyStateHandler?: EmptyStateHandler;
+    fireAnalyticsEvent?: EditorAnalyticsAPI['fireAnalyticsEvent'];
+    getItemRank?: RegisteredItemRankResolver;
     includeElementBrowserItems: boolean;
     isRecommendedItem?: IsRecommendedItem;
     maxRecommendedItems?: number;
 };
-export declare const getQuickInsertComponents: <TProps extends CommonComponentProps = CommonComponentProps>({ api, includeElementBrowserItems, isRecommendedItem, maxRecommendedItems, }: Params) => RegisterComponent<TProps>[];
+export declare const getQuickInsertComponents: ({ api, includeElementBrowserItems, isRecommendedItem, maxRecommendedItems, getItemRank, emptyStateHandler, fireAnalyticsEvent, }: Params) => RegisterComponent[];
 export {};

package/dist/types/ui/registered-menu/QuickInsertEmptyState.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+type Props = {
+    mode: 'inline' | 'full';
+    spacing?: 'compact' | 'spacious';
+};
+export declare const QuickInsertEmptyState: ({ mode, spacing, }: Props) => React.JSX.Element;
+export {};

package/dist/types/ui/registered-menu/QuickInsertMenuRoot.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+import type { EditorAnalyticsAPI } from '@atlaskit/editor-common/analytics/api';
+import type { RegisteredItemRankResolver } from '@atlaskit/editor-common/registered-menu/item-rank';
+import type { EmptyStateHandler } from '@atlaskit/editor-common/types/empty-state-handler';
+type Props = {
+    emptyStateHandler?: EmptyStateHandler;
+    fireAnalyticsEvent?: EditorAnalyticsAPI['fireAnalyticsEvent'];
+    getItemRank?: RegisteredItemRankResolver;
+};
+declare const QuickInsertMenuRoot: ({ emptyStateHandler, fireAnalyticsEvent, getItemRank, }: React.PropsWithChildren<Props>) => React.JSX.Element | null;
+export default QuickInsertMenuRoot;

package/dist/types/ui/registered-menu/QuickInsertMenuSection.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+export declare const QuickInsertMenuSection: ({ children, title, }: React.PropsWithChildren<{
+    title: string;
+}>) => React.JSX.Element;

package/dist/types/ui/registered-menu/QuickInsertSearchResultsSection.d.ts

@@ -0,0 +1,2 @@
+import React from 'react';
+export declare const QuickInsertSearchResultsSection: ({ children, }: React.PropsWithChildren) => React.JSX.Element;

package/dist/types/ui/registered-menu/RegisteredQuickInsertMenuItem.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+import type { RegisteredMenuItemProps } from '@atlaskit/editor-common/registered-menu';
+export declare const RegisteredQuickInsertMenuItem: ({ id, isSelected, isActive, registration, }: RegisteredMenuItemProps) => React.JSX.Element;

package/dist/types/ui/registered-menu/ToolbarQuickInsertMenu.d.ts

@@ -0,0 +1,28 @@
+import React from 'react';
+import type { RegisteredMenuModel, RegisteredMenuItemProps } from '@atlaskit/editor-common/registered-menu';
+import type { EmptyStateHandler } from '@atlaskit/editor-common/types/empty-state-handler';
+import type { RegisterMenuItem, RegisterMenuSection } from '@atlaskit/editor-ui-control-model/types';
+type Props = {
+    activePreviewItemKey?: string;
+    emptyStateHandler?: EmptyStateHandler;
+    Item: React.ComponentType<RegisteredMenuItemProps>;
+    itemCount: number;
+    listId: string;
+    listLabel: string;
+    maxHeight: number;
+    model: RegisteredMenuModel;
+    onItemBlur: (key: string) => void;
+    onItemFocus: (index: number, key?: string) => void;
+    onItemHover: (index: number, key?: string) => void;
+    onItemLeave: (key: string) => void;
+    onItemVisibilityChange: (key: string, isVisible: boolean) => void;
+    onRenderedItemsChange: (range: {
+        startIndex: number;
+        stopIndex: number;
+    }) => void;
+    query: string;
+    rows: Array<RegisterMenuItem | RegisterMenuSection>;
+    selectedItemIndex: number;
+};
+export declare const ToolbarQuickInsertMenu: ({ Item, model, emptyStateHandler, listLabel, activePreviewItemKey, itemCount, listId, maxHeight, rows, onItemBlur, onItemFocus, onItemHover, onItemLeave, onItemVisibilityChange, onRenderedItemsChange, query, selectedItemIndex, }: Props) => React.JSX.Element | null;
+export {};

package/dist/types/ui/registered-menu/TypeAheadQuickInsertMenu.d.ts

@@ -0,0 +1,27 @@
+import React from 'react';
+import type { RegisteredMenuItemProps, RegisteredMenuModel } from '@atlaskit/editor-common/registered-menu';
+import type { RegisterMenuItem, RegisterMenuSection } from '@atlaskit/editor-ui-control-model/types';
+type Props = {
+    activeItemKey?: string;
+    hasScrollPadding?: boolean;
+    Item: React.ComponentType<RegisteredMenuItemProps>;
+    itemCount: number;
+    listId: string;
+    listLabel: string;
+    maxHeight: number;
+    model: RegisteredMenuModel;
+    onItemBlur: (itemKey: string) => void;
+    onItemFocus: (itemIndex: number, itemKey?: string) => void;
+    onItemHover: (itemIndex: number, itemKey?: string) => void;
+    onItemLeave: (itemKey: string) => void;
+    onItemVisibilityChange: (itemKey: string, isVisible: boolean) => void;
+    onRenderedItemsChange: (range: {
+        startIndex: number;
+        stopIndex: number;
+    }) => void;
+    query?: string;
+    rows: Array<RegisterMenuItem | RegisterMenuSection>;
+    selectedItemIndex: number;
+};
+export declare const TypeAheadQuickInsertMenu: ({ Item, rows, activeItemKey, itemCount, listId, listLabel, maxHeight, model, onItemFocus, onItemBlur, onItemHover, onItemLeave, onItemVisibilityChange, onRenderedItemsChange, query, selectedItemIndex, hasScrollPadding, }: Props) => React.JSX.Element | null;
+export {};

package/dist/types/ui/registered-menu/assets/no-results.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+type Props = {
+    height: number;
+    width: number;
+};
+export default function NoResultsIllustration({ height, width }: Props): React.JSX.Element;
+export {};

package/dist/types/ui/registered-menu/get-quick-insert-menu-model.d.ts

@@ -0,0 +1,19 @@
+import type { IntlShape } from 'react-intl';
+import type { RegisteredMenuModel } from '@atlaskit/editor-common/registered-menu';
+import { type RegisteredItemRankResolver } from '@atlaskit/editor-common/registered-menu/item-rank';
+import type { SurfaceIdentifier } from '@atlaskit/editor-ui-control-model/surface-renderer/types';
+import type { RegisterComponent, SurfaceContext } from '@atlaskit/editor-ui-control-model/types';
+import type { QuickInsertCategoryItemSelectionPolicy } from './selectQuickInsertCategoryItems';
+/**
+ * Builds the registered quick-insert menu model. An empty query browses every
+ * category; a non-empty query returns ranked matches. The footer is shared by both.
+ */
+export declare const getQuickInsertMenuModel: ({ components, formatMessage, getItemRank, query, rootComponent, selectCategoryItems, surfaceContext, }: {
+    components: RegisterComponent[];
+    formatMessage: IntlShape['formatMessage'];
+    getItemRank?: RegisteredItemRankResolver;
+    query: string;
+    rootComponent: SurfaceIdentifier;
+    selectCategoryItems?: QuickInsertCategoryItemSelectionPolicy;
+    surfaceContext?: SurfaceContext;
+}) => RegisteredMenuModel;

package/dist/types/ui/registered-menu/getQuickInsertMenuItemId.d.ts

@@ -0,0 +1 @@
+export declare const getQuickInsertMenuItemId: (listId: string, itemIndex: number) => string;

package/dist/types/ui/registered-menu/selectQuickInsertCategoryItems.d.ts

@@ -0,0 +1,7 @@
+import type { RegisterMenuItem } from '@atlaskit/editor-ui-control-model/types';
+export type QuickInsertCategoryItemSelectionPolicy = (items: RegisterMenuItem[]) => RegisterMenuItem[];
+/**
+ * Keeps the initial native and ecosystem results while ensuring ecosystem registrations
+ * remain discoverable beyond the default category item limit.
+ */
+export declare const selectQuickInsertCategoryItems: QuickInsertCategoryItemSelectionPolicy;

package/dist/types/ui/registered-menu/useQuickInsertSearchAnalytics.d.ts

@@ -0,0 +1,12 @@
+import type { EditorAnalyticsAPI } from '@atlaskit/editor-common/analytics/api';
+import type { QuickInsertSearchSurface } from '@atlaskit/editor-common/analytics/types/quick-insert-events';
+type Options = {
+    category?: string;
+    fireAnalyticsEvent?: EditorAnalyticsAPI['fireAnalyticsEvent'];
+    isOpen?: boolean;
+    query: string;
+    resultCount: number;
+    surface: QuickInsertSearchSurface;
+};
+export declare const useQuickInsertSearchAnalytics: ({ query, resultCount, surface, category, isOpen, fireAnalyticsEvent, }: Options) => (() => void);
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/editor-plugin-quick-insert",
-	"version": "29.0.4",
+	"version": "30.0.0",
 	"description": "Quick insert plugin for @atlaskit/editor-core",
 	"author": "Atlassian Pty Ltd",
 	"license": "Apache-2.0",
@@ -29,31 +29,34 @@
 		"@atlaskit/button": "^25.6.0",
 		"@atlaskit/css": "^1.1.0",
 		"@atlaskit/docs": "^12.3.0",
-		"@atlaskit/editor-plugin-analytics": "^29.0.0",
-		"@atlaskit/editor-plugin-connectivity": "^29.0.0",
-		"@atlaskit/editor-plugin-editor-viewmode": "^31.0.0",
-		"@atlaskit/editor-plugin-metrics": "^30.0.0",
-		"@atlaskit/editor-plugin-type-ahead": "^30.0.0",
-		"@atlaskit/editor-plugin-ui-control-registry": "^23.0.0",
+		"@atlaskit/editor-plugin-analytics": "^30.0.0",
+		"@atlaskit/editor-plugin-connectivity": "^30.0.0",
+		"@atlaskit/editor-plugin-editor-viewmode": "^32.0.0",
+		"@atlaskit/editor-plugin-metrics": "^31.0.0",
+		"@atlaskit/editor-plugin-type-ahead": "^31.0.0",
+		"@atlaskit/editor-plugin-ui-control-registry": "^24.0.0",
 		"@atlaskit/editor-prosemirror": "^9.0.0",
+		"@atlaskit/editor-shared-styles": "^4.6.0",
 		"@atlaskit/editor-tables": "^3.2.0",
 		"@atlaskit/editor-ui-control-model": "^2.10.0",
 		"@atlaskit/heading": "^8.0.0",
 		"@atlaskit/icon": "^38.0.0",
+		"@atlaskit/menu": "^11.0.0",
 		"@atlaskit/modal-dialog": "^17.1.0",
 		"@atlaskit/platform-feature-experiments": "^0.3.0",
 		"@atlaskit/platform-feature-flags": "^2.2.0",
 		"@atlaskit/primitives": "^22.6.0",
 		"@atlaskit/textfield": "^10.2.0",
-		"@atlaskit/tmp-editor-statsig": "^246.0.0",
-		"@atlaskit/tokens": "^20.7.0",
+		"@atlaskit/tmp-editor-statsig": "^246.1.0",
+		"@atlaskit/tokens": "^20.8.0",
 		"@atlaskit/tooltip": "^24.4.0",
 		"@babel/runtime": "^7.0.0",
 		"@compiled/react": "^1.0.2",
-		"@emotion/react": "^11.7.1"
+		"@emotion/react": "^11.7.1",
+		"react-loosely-lazy": "^1.0.0"
 	},
 	"peerDependencies": {
-		"@atlaskit/editor-common": "^133.6.0",
+		"@atlaskit/editor-common": "^134.0.0",
 		"react": "^18.2.0 || ^19.2.0",
 		"react-dom": "^18.2.0 || ^19.2.0",
 		"react-intl": "^5.25.1 || ^6.0.0 || ^7.0.0"