@atlaskit/editor-common 133.7.1 → 134.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (143) hide show
  1. package/CHANGELOG.md +19 -0
  2. package/dist/cjs/insert/index.js +1 -0
  3. package/dist/cjs/monitoring/error.js +1 -1
  4. package/dist/cjs/quick-insert/QuickInsertContext.js +4 -0
  5. package/dist/cjs/quick-insert/QuickInsertMenuItem.js +4 -1
  6. package/dist/cjs/registered-menu/ActiveMenuItemKeyContext.js +11 -0
  7. package/dist/cjs/registered-menu/MeasuredRow.js +41 -0
  8. package/dist/cjs/registered-menu/RegisteredMenuContext.js +15 -0
  9. package/dist/cjs/registered-menu/RegisteredMenuList.js +224 -0
  10. package/dist/cjs/registered-menu/RegisteredMenuListItemRow.js +62 -0
  11. package/dist/cjs/registered-menu/RegisteredMenuSurfaceContext.js +12 -0
  12. package/dist/cjs/registered-menu/getRegisteredMenuRows.js +11 -0
  13. package/dist/cjs/registered-menu/types.js +5 -0
  14. package/dist/cjs/{quick-insert/use-menu-list-height.js → registered-menu/useMenuListHeight.js} +15 -11
  15. package/dist/cjs/{quick-insert/use-menu-popup-sizing.js → registered-menu/useMenuPopupSizing.js} +5 -1
  16. package/dist/cjs/registered-menu/useRegisteredMenu.js +133 -0
  17. package/dist/cjs/registered-menu/useRegisteredMenuSelection.js +53 -0
  18. package/dist/cjs/ui/DropList/index.js +1 -1
  19. package/dist/es2019/insert/index.js +3 -0
  20. package/dist/es2019/monitoring/error.js +1 -1
  21. package/dist/es2019/quick-insert/QuickInsertContext.js +4 -0
  22. package/dist/es2019/quick-insert/QuickInsertMenuItem.js +4 -1
  23. package/dist/es2019/registered-menu/ActiveMenuItemKeyContext.js +5 -0
  24. package/dist/es2019/registered-menu/MeasuredRow.js +32 -0
  25. package/dist/es2019/registered-menu/RegisteredMenuContext.js +9 -0
  26. package/dist/es2019/registered-menu/RegisteredMenuList.js +177 -0
  27. package/dist/es2019/registered-menu/RegisteredMenuListItemRow.js +47 -0
  28. package/dist/es2019/registered-menu/RegisteredMenuSurfaceContext.js +4 -0
  29. package/dist/es2019/registered-menu/getRegisteredMenuRows.js +1 -0
  30. package/dist/es2019/registered-menu/types.js +1 -0
  31. package/dist/es2019/{quick-insert/use-menu-list-height.js → registered-menu/useMenuListHeight.js} +14 -10
  32. package/dist/es2019/{quick-insert/use-menu-popup-sizing.js → registered-menu/useMenuPopupSizing.js} +5 -1
  33. package/dist/es2019/registered-menu/useRegisteredMenu.js +120 -0
  34. package/dist/es2019/registered-menu/useRegisteredMenuSelection.js +39 -0
  35. package/dist/es2019/ui/DropList/index.js +1 -1
  36. package/dist/esm/insert/index.js +3 -0
  37. package/dist/esm/monitoring/error.js +1 -1
  38. package/dist/esm/quick-insert/QuickInsertContext.js +4 -0
  39. package/dist/esm/quick-insert/QuickInsertMenuItem.js +4 -1
  40. package/dist/esm/registered-menu/ActiveMenuItemKeyContext.js +5 -0
  41. package/dist/esm/registered-menu/MeasuredRow.js +33 -0
  42. package/dist/esm/registered-menu/RegisteredMenuContext.js +9 -0
  43. package/dist/esm/registered-menu/RegisteredMenuList.js +215 -0
  44. package/dist/esm/registered-menu/RegisteredMenuListItemRow.js +54 -0
  45. package/dist/esm/registered-menu/RegisteredMenuSurfaceContext.js +6 -0
  46. package/dist/esm/registered-menu/getRegisteredMenuRows.js +4 -0
  47. package/dist/esm/registered-menu/types.js +1 -0
  48. package/dist/esm/{quick-insert/use-menu-list-height.js → registered-menu/useMenuListHeight.js} +15 -11
  49. package/dist/esm/{quick-insert/use-menu-popup-sizing.js → registered-menu/useMenuPopupSizing.js} +5 -1
  50. package/dist/esm/registered-menu/useRegisteredMenu.js +126 -0
  51. package/dist/esm/registered-menu/useRegisteredMenuSelection.js +46 -0
  52. package/dist/esm/ui/DropList/index.js +1 -1
  53. package/dist/types/analytics/types/ai-suggestions-events.d.ts +7 -0
  54. package/dist/types/insert/index.d.ts +5 -1
  55. package/dist/types/quick-insert/QuickInsertContext.d.ts +6 -5
  56. package/dist/types/quick-insert/QuickInsertMenuItem.d.ts +2 -2
  57. package/dist/types/quick-insert/quick-insert-rank.d.ts +1 -1
  58. package/dist/types/registered-menu/ActiveMenuItemKeyContext.d.ts +2 -0
  59. package/dist/types/registered-menu/MeasuredRow.d.ts +10 -0
  60. package/dist/types/registered-menu/RegisteredMenuContext.d.ts +4 -0
  61. package/dist/types/registered-menu/RegisteredMenuList.d.ts +31 -0
  62. package/dist/types/registered-menu/RegisteredMenuListItemRow.d.ts +28 -0
  63. package/dist/types/registered-menu/RegisteredMenuSurfaceContext.d.ts +7 -0
  64. package/dist/types/registered-menu/getRegisteredMenuRows.d.ts +4 -0
  65. package/dist/types/registered-menu/types.d.ts +55 -0
  66. package/dist/types/{quick-insert/use-menu-list-height.d.ts → registered-menu/useMenuListHeight.d.ts} +5 -1
  67. package/dist/types/{quick-insert/use-menu-popup-sizing.d.ts → registered-menu/useMenuPopupSizing.d.ts} +5 -1
  68. package/dist/types/registered-menu/useRegisteredMenu.d.ts +28 -0
  69. package/dist/types/registered-menu/useRegisteredMenuSelection.d.ts +16 -0
  70. package/dist/types/type-ahead/index.d.ts +0 -1
  71. package/dist/types/types/index.d.ts +1 -1
  72. package/dist/types/types/quick-insert.d.ts +1 -1
  73. package/dist/types/types/type-ahead.d.ts +9 -6
  74. package/package.json +9 -9
  75. package/registered-menu/context/package.json +10 -0
  76. package/registered-menu/item-rank/package.json +10 -0
  77. package/registered-menu/list/package.json +10 -0
  78. package/registered-menu/list-height/package.json +10 -0
  79. package/registered-menu/package.json +10 -0
  80. package/registered-menu/popup-sizing/package.json +10 -0
  81. package/registered-menu/rows/package.json +10 -0
  82. package/registered-menu/surface-context/package.json +10 -0
  83. package/registered-menu/use-registered-menu/package.json +10 -0
  84. package/dist/cjs/quick-insert/QuickInsertEmptyState.compiled.css +0 -11
  85. package/dist/cjs/quick-insert/QuickInsertEmptyState.js +0 -61
  86. package/dist/cjs/quick-insert/QuickInsertMenuRoot.js +0 -13
  87. package/dist/cjs/quick-insert/QuickInsertMenuSection.js +0 -23
  88. package/dist/cjs/quick-insert/QuickInsertSearchResultsSection.js +0 -19
  89. package/dist/cjs/quick-insert/assets/no-results.js +0 -36
  90. package/dist/cjs/quick-insert/get-quick-insert-menu-model.js +0 -234
  91. package/dist/cjs/quick-insert/getQuickInsertMenuRows.js +0 -12
  92. package/dist/cjs/quick-insert/registered-menu-model.js +0 -33
  93. package/dist/cjs/quick-insert/selectQuickInsertCategoryItems.js +0 -27
  94. package/dist/cjs/quick-insert/useQuickInsertSearchAnalytics.js +0 -100
  95. package/dist/cjs/type-ahead/TypeAheadSurfaceContext.js +0 -11
  96. package/dist/es2019/quick-insert/QuickInsertEmptyState.compiled.css +0 -11
  97. package/dist/es2019/quick-insert/QuickInsertEmptyState.js +0 -47
  98. package/dist/es2019/quick-insert/QuickInsertMenuRoot.js +0 -5
  99. package/dist/es2019/quick-insert/QuickInsertMenuSection.js +0 -15
  100. package/dist/es2019/quick-insert/QuickInsertSearchResultsSection.js +0 -14
  101. package/dist/es2019/quick-insert/assets/no-results.js +0 -30
  102. package/dist/es2019/quick-insert/get-quick-insert-menu-model.js +0 -174
  103. package/dist/es2019/quick-insert/getQuickInsertMenuRows.js +0 -4
  104. package/dist/es2019/quick-insert/registered-menu-model.js +0 -6
  105. package/dist/es2019/quick-insert/selectQuickInsertCategoryItems.js +0 -19
  106. package/dist/es2019/quick-insert/useQuickInsertSearchAnalytics.js +0 -91
  107. package/dist/es2019/type-ahead/TypeAheadSurfaceContext.js +0 -5
  108. package/dist/esm/quick-insert/QuickInsertEmptyState.compiled.css +0 -11
  109. package/dist/esm/quick-insert/QuickInsertEmptyState.js +0 -50
  110. package/dist/esm/quick-insert/QuickInsertMenuRoot.js +0 -6
  111. package/dist/esm/quick-insert/QuickInsertMenuSection.js +0 -16
  112. package/dist/esm/quick-insert/QuickInsertSearchResultsSection.js +0 -12
  113. package/dist/esm/quick-insert/assets/no-results.js +0 -29
  114. package/dist/esm/quick-insert/get-quick-insert-menu-model.js +0 -227
  115. package/dist/esm/quick-insert/getQuickInsertMenuRows.js +0 -5
  116. package/dist/esm/quick-insert/registered-menu-model.js +0 -6
  117. package/dist/esm/quick-insert/selectQuickInsertCategoryItems.js +0 -21
  118. package/dist/esm/quick-insert/useQuickInsertSearchAnalytics.js +0 -93
  119. package/dist/esm/type-ahead/TypeAheadSurfaceContext.js +0 -5
  120. package/dist/types/quick-insert/QuickInsertEmptyState.d.ts +0 -7
  121. package/dist/types/quick-insert/QuickInsertMenuRoot.d.ts +0 -2
  122. package/dist/types/quick-insert/QuickInsertMenuSection.d.ts +0 -4
  123. package/dist/types/quick-insert/QuickInsertSearchResultsSection.d.ts +0 -2
  124. package/dist/types/quick-insert/assets/no-results.d.ts +0 -7
  125. package/dist/types/quick-insert/get-quick-insert-menu-model.d.ts +0 -29
  126. package/dist/types/quick-insert/getQuickInsertMenuRows.d.ts +0 -3
  127. package/dist/types/quick-insert/registered-menu-model.d.ts +0 -6
  128. package/dist/types/quick-insert/selectQuickInsertCategoryItems.d.ts +0 -7
  129. package/dist/types/quick-insert/useQuickInsertSearchAnalytics.d.ts +0 -12
  130. package/dist/types/type-ahead/TypeAheadSurfaceContext.d.ts +0 -8
  131. package/quick-insert/empty-state/package.json +0 -10
  132. package/quick-insert/menu-root/package.json +0 -10
  133. package/quick-insert/menu-section/package.json +0 -10
  134. package/quick-insert/registered-menu-model/package.json +0 -10
  135. package/quick-insert/use-menu-list-height/package.json +0 -10
  136. package/quick-insert/use-menu-popup-sizing/package.json +0 -10
  137. package/quick-insert/use-search-analytics/package.json +0 -10
  138. package/type-ahead/item-rank/package.json +0 -10
  139. package/type-ahead-surface-context/package.json +0 -10
  140. /package/dist/cjs/{type-ahead → registered-menu}/item-rank.js +0 -0
  141. /package/dist/es2019/{type-ahead → registered-menu}/item-rank.js +0 -0
  142. /package/dist/esm/{type-ahead → registered-menu}/item-rank.js +0 -0
  143. /package/dist/types/{type-ahead → registered-menu}/item-rank.d.ts +0 -0
@@ -0,0 +1,126 @@
1
+ import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
2
+ import { useCallback, useLayoutEffect, useMemo, useState } from 'react';
3
+ import { getComponentIdentity } from '@atlaskit/editor-ui-control-model/surface-renderer';
4
+ import { getRegisteredMenuRows } from './getRegisteredMenuRows';
5
+ import { useRegisteredMenuSelection } from './useRegisteredMenuSelection';
6
+ /**
7
+ * Connects menu rows to keyboard selection and tracks which item is active through
8
+ * keyboard, pointer and focus events. Selection controls navigation; activation lets
9
+ * the caller show item-specific feedback, such as a preview. A changed reset key
10
+ * starts navigation again and clears the active item.
11
+ */
12
+ export var useRegisteredMenu = function useRegisteredMenu(_ref) {
13
+ var model = _ref.model,
14
+ resetKey = _ref.resetKey;
15
+ var _useMemo = useMemo(function () {
16
+ var rows = getRegisteredMenuRows(model);
17
+ var selectableItems = [];
18
+ var selectableItemIdentities = [];
19
+ rows.forEach(function (row) {
20
+ if (row.type === 'menu-item') {
21
+ selectableItems.push(row);
22
+ selectableItemIdentities.push(getComponentIdentity(row));
23
+ }
24
+ });
25
+ // The footer participates in navigation but is rendered outside the scrolling rows.
26
+ if (model.footer) {
27
+ selectableItemIdentities.push(getComponentIdentity(model.footer));
28
+ }
29
+ return {
30
+ rows: rows,
31
+ selectableItems: selectableItems,
32
+ selectableItemIdentities: selectableItemIdentities
33
+ };
34
+ }, [model]),
35
+ rows = _useMemo.rows,
36
+ selectableItems = _useMemo.selectableItems,
37
+ selectableItemIdentities = _useMemo.selectableItemIdentities;
38
+ var selection = useRegisteredMenuSelection({
39
+ identities: selectableItemIdentities,
40
+ resetKey: resetKey
41
+ });
42
+ var selectedItemIndex = selection.selectedIndex,
43
+ select = selection.select;
44
+ var _useState = useState(),
45
+ _useState2 = _slicedToArray(_useState, 2),
46
+ activation = _useState2[0],
47
+ setItemActivation = _useState2[1];
48
+ var activeItemKey = (activation === null || activation === void 0 ? void 0 : activation.model) === model && activation.resetKey === resetKey ? activation.itemKey : undefined;
49
+ useLayoutEffect(function () {
50
+ setItemActivation(undefined);
51
+ }, [model, resetKey]);
52
+ var activateKeyboardItem = useCallback(function (index) {
53
+ var item = selectableItems[index];
54
+ setItemActivation(item ? {
55
+ itemKey: item.key,
56
+ model: model,
57
+ resetKey: resetKey,
58
+ source: 'keyboard'
59
+ } : undefined);
60
+ }, [model, resetKey, selectableItems]);
61
+ var selectNext = useCallback(function () {
62
+ activateKeyboardItem(selection.selectNext());
63
+ }, [selection.selectNext, activateKeyboardItem]);
64
+ var selectPrevious = useCallback(function () {
65
+ activateKeyboardItem(selection.selectPrevious());
66
+ }, [selection.selectPrevious, activateKeyboardItem]);
67
+ var onItemHover = useCallback(function (index, itemKey) {
68
+ select(index);
69
+ setItemActivation(function (current) {
70
+ if (itemKey && (current === null || current === void 0 ? void 0 : current.itemKey) === itemKey && current.model === model && current.resetKey === resetKey && current.source === 'pointer') {
71
+ return current;
72
+ }
73
+ return itemKey ? {
74
+ itemKey: itemKey,
75
+ model: model,
76
+ resetKey: resetKey,
77
+ source: 'pointer'
78
+ } : undefined;
79
+ });
80
+ }, [model, resetKey, select]);
81
+ var onItemFocus = useCallback(function (index, itemKey) {
82
+ select(index);
83
+ setItemActivation(function (current) {
84
+ if (itemKey && (current === null || current === void 0 ? void 0 : current.itemKey) === itemKey && current.model === model && current.resetKey === resetKey) {
85
+ return current;
86
+ }
87
+ return itemKey ? {
88
+ itemKey: itemKey,
89
+ model: model,
90
+ resetKey: resetKey,
91
+ source: 'keyboard'
92
+ } : undefined;
93
+ });
94
+ }, [model, resetKey, select]);
95
+ var onItemLeave = useCallback(function (itemKey) {
96
+ setItemActivation(function (current) {
97
+ return (current === null || current === void 0 ? void 0 : current.source) === 'pointer' && current.itemKey === itemKey ? undefined : current;
98
+ });
99
+ }, []);
100
+ var onItemBlur = useCallback(function (itemKey) {
101
+ setItemActivation(function (current) {
102
+ return (current === null || current === void 0 ? void 0 : current.itemKey) === itemKey ? undefined : current;
103
+ });
104
+ }, []);
105
+ var onItemVisibilityChange = useCallback(function (itemKey, isVisible) {
106
+ if (!isVisible) {
107
+ setItemActivation(function (current) {
108
+ return (current === null || current === void 0 ? void 0 : current.source) === 'pointer' && current.itemKey === itemKey ? undefined : current;
109
+ });
110
+ }
111
+ }, []);
112
+ return {
113
+ rows: rows,
114
+ selectableItems: selectableItems,
115
+ selectedItemIndex: selectedItemIndex,
116
+ select: select,
117
+ selectNext: selectNext,
118
+ selectPrevious: selectPrevious,
119
+ activeItemKey: activeItemKey,
120
+ onItemHover: onItemHover,
121
+ onItemFocus: onItemFocus,
122
+ onItemLeave: onItemLeave,
123
+ onItemBlur: onItemBlur,
124
+ onItemVisibilityChange: onItemVisibilityChange
125
+ };
126
+ };
@@ -0,0 +1,46 @@
1
+ import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
2
+ import { useCallback, useLayoutEffect, useMemo, useRef, useState } from 'react';
3
+ /**
4
+ * Resets keyboard selection when the ordered items or reset key changes.
5
+ * The caller chooses the key, for example a search term or the current category.
6
+ */
7
+ export var useRegisteredMenuSelection = function useRegisteredMenuSelection(_ref) {
8
+ var identities = _ref.identities,
9
+ resetKey = _ref.resetKey;
10
+ var _useState = useState(function () {
11
+ return identities.length > 0 ? 0 : -1;
12
+ }),
13
+ _useState2 = _slicedToArray(_useState, 2),
14
+ selectedIndex = _useState2[0],
15
+ setSelectedIndex = _useState2[1];
16
+ var selectedIndexRef = useRef(selectedIndex);
17
+ var identitySignature = useMemo(function () {
18
+ return JSON.stringify(identities);
19
+ }, [identities]);
20
+ var itemCount = identities.length;
21
+ var select = useCallback(function (index) {
22
+ selectedIndexRef.current = index;
23
+ setSelectedIndex(index);
24
+ }, []);
25
+ useLayoutEffect(function () {
26
+ select(itemCount > 0 ? 0 : -1);
27
+ }, [identitySignature, itemCount, resetKey, select]);
28
+ var selectNext = useCallback(function () {
29
+ var currentIndex = selectedIndexRef.current;
30
+ var nextIndex = itemCount === 0 ? -1 : currentIndex < 0 ? 0 : (currentIndex + 1) % itemCount;
31
+ select(nextIndex);
32
+ return nextIndex;
33
+ }, [itemCount, select]);
34
+ var selectPrevious = useCallback(function () {
35
+ var currentIndex = selectedIndexRef.current;
36
+ var previousIndex = itemCount === 0 ? -1 : currentIndex <= 0 ? itemCount - 1 : currentIndex - 1;
37
+ select(previousIndex);
38
+ return previousIndex;
39
+ }, [itemCount, select]);
40
+ return {
41
+ selectedIndex: selectedIndex,
42
+ select: select,
43
+ selectNext: selectNext,
44
+ selectPrevious: selectPrevious
45
+ };
46
+ };
@@ -20,7 +20,7 @@ import withAnalyticsContext from '@atlaskit/analytics-next/withAnalyticsContext'
20
20
  import withAnalyticsEvents from '@atlaskit/analytics-next/withAnalyticsEvents';
21
21
  import Layer from '../Layer';
22
22
  var packageName = "@atlaskit/editor-common";
23
- var packageVersion = "133.7.0";
23
+ var packageVersion = "133.7.2";
24
24
  var halfFocusRing = 1;
25
25
  var dropOffset = '0, 8';
26
26
  // Ignored via go/ees005
@@ -52,6 +52,7 @@ type TimeSinceGenerationAttribute = {
52
52
  type RegenerationSuggestionDetails = SuggestionRemixAttributes & TimeSinceGenerationAttribute & {
53
53
  actionKind: string;
54
54
  outcome?: AiSuggestionsRegenerationOutcome;
55
+ singleInstrumentationId?: string;
55
56
  suggestionId: string;
56
57
  suggestionType?: string;
57
58
  };
@@ -62,6 +63,7 @@ type RegenerationCommonAttributes = {
62
63
  trigger: AiSuggestionsRegenerationTrigger;
63
64
  };
64
65
  type NoDiffSuggestionAEP = OperationalAEP<ACTION.NO_DIFF_FOUND, ACTION_SUBJECT.AI_SUGGESTIONS, undefined, {
66
+ singleInstrumentationId?: string;
65
67
  suggestionType?: string;
66
68
  toolCalls: {
67
69
  localIds: string[];
@@ -106,6 +108,7 @@ type SuggestionLifecycleAttributes = SuggestionRemixAttributes & TimeSinceGenera
106
108
  agentId?: string;
107
109
  hasSources: boolean;
108
110
  interactionPoint: AiSuggestionInteractionPoint;
111
+ singleInstrumentationId?: string;
109
112
  suggestionId: string;
110
113
  suggestionType?: string;
111
114
  };
@@ -116,6 +119,7 @@ type AcceptSuggestionAEP = TrackAEP<ACTION.ACCEPTED, ACTION_SUBJECT.AI_SUGGESTIO
116
119
  }, undefined>;
117
120
  type UndoAcceptedSuggestionAEP = TrackAEP<ACTION.UNDO_PERFORMED, ACTION_SUBJECT.AI_SUGGESTIONS, undefined, TimeSinceGenerationAttribute & {
118
121
  actionKind: string;
122
+ singleInstrumentationId?: string;
119
123
  suggestionId: string;
120
124
  suggestionType?: string;
121
125
  }, undefined>;
@@ -141,6 +145,7 @@ type RightRailViewedAEP = TrackAEP<ACTION.RIGHT_RAIL_VIEWED, ACTION_SUBJECT.AI_S
141
145
  suggestionDetails: Array<SuggestionRemixAttributes & TimeSinceGenerationAttribute & {
142
146
  actionKind: string;
143
147
  affectedBlocks: number;
148
+ singleInstrumentationId?: string;
144
149
  suggestionType?: string;
145
150
  }>;
146
151
  }, undefined>;
@@ -152,6 +157,7 @@ type ViewSuggestionReasoningAEP = TrackAEP<ACTION.REASONING_VIEWED, ACTION_SUBJE
152
157
  hasSources: boolean;
153
158
  interactionPoint: AiSuggestionInteractionPoint;
154
159
  reasoningCharacterCount: number;
160
+ singleInstrumentationId?: string;
155
161
  suggestionId: string;
156
162
  suggestionType?: string;
157
163
  }, undefined>;
@@ -164,6 +170,7 @@ type SuggestionsGeneratedAEP = TrackAEP<ACTION.GENERATED, ACTION_SUBJECT.AI_SUGG
164
170
  affectedBlocks: number;
165
171
  agentId?: string;
166
172
  hasSources: boolean;
173
+ singleInstrumentationId?: string;
167
174
  suggestionId: string;
168
175
  suggestionType?: string;
169
176
  }>;
@@ -1,6 +1,10 @@
1
1
  import type { NodeType } from '@atlaskit/editor-prosemirror/model';
2
2
  import { Fragment, Node } from '@atlaskit/editor-prosemirror/model';
3
3
  import type { EditorState, Transaction } from '@atlaskit/editor-prosemirror/state';
4
+ /** Builds an insertion transaction using the editor state and position supplied by the host. */
5
+ export type InsertContentCallback = (content?: Node | object | string | Fragment, options?: {
6
+ selectInlineNode?: boolean;
7
+ }) => Transaction;
4
8
  export type InsertableContent = Node | Fragment;
5
9
  export declare enum LookDirection {
6
10
  Before = "before",
@@ -11,7 +15,7 @@ export declare const safeInsert: (content: InsertableContent, position?: number)
11
15
  /**
12
16
  * Method extracted from typeahead plugin to be shared with the element browser on handling element insertion.
13
17
  */
14
- export declare const insertSelectedItem: (maybeNode?: Node | Object | string | Fragment, opts?: {
18
+ export declare const insertSelectedItem: (maybeNode?: Node | object | string | Fragment, opts?: {
15
19
  selectInlineNode?: boolean;
16
20
  }) => (state: EditorState, tr: Transaction, start: number) => Transaction;
17
21
  /**
@@ -3,13 +3,12 @@ import type { Transaction } from '@atlaskit/editor-prosemirror/state';
3
3
  import type { EditorView } from '@atlaskit/editor-prosemirror/view';
4
4
  import type { SurfaceContext } from '@atlaskit/editor-ui-control-model/types';
5
5
  import type { INPUT_METHOD } from '../analytics';
6
- import type { TypeAheadInsert } from '../types';
6
+ import type { InsertContentCallback } from '../insert';
7
7
  export type QuickInsertSelectionHandler = (context: {
8
- insert: TypeAheadInsert;
8
+ insert: InsertContentCallback;
9
9
  source: INPUT_METHOD.ELEMENT_BROWSER | INPUT_METHOD.INSERT_MENU | INPUT_METHOD.QUICK_INSERT | INPUT_METHOD.TOOLBAR;
10
10
  }) => Transaction | false | void;
11
11
  export type QuickInsertContextValue = {
12
- activePreviewItemKey?: string;
13
12
  editorView: EditorView;
14
13
  isOffline: boolean;
15
14
  item?: {
@@ -18,10 +17,12 @@ export type QuickInsertContextValue = {
18
17
  isPreviewActive?: boolean;
19
18
  isSelected: boolean;
20
19
  };
21
- menuOpenId?: symbol;
22
20
  popupsMountPoint?: HTMLElement;
23
21
  select: (selectionHandler: QuickInsertSelectionHandler) => void;
24
- surface: 'typeahead' | 'toolbar' | 'element-browser';
25
22
  surfaceContext?: SurfaceContext;
26
23
  };
24
+ /**
25
+ * Gives Quick Insert items access to the editor and the function for selecting a command.
26
+ * The menu supplies shared values; each item adds its selected and preview state.
27
+ */
27
28
  export declare const QuickInsertContext: Context<QuickInsertContextValue | null>;
@@ -2,11 +2,11 @@ import React from 'react';
2
2
  import type { Transaction } from '@atlaskit/editor-prosemirror/state';
3
3
  import type { EditorView } from '@atlaskit/editor-prosemirror/view';
4
4
  import type { INPUT_METHOD } from '../analytics';
5
- import type { TypeAheadInsert } from '../types';
5
+ import type { InsertContentCallback } from '../insert';
6
6
  import type { QuickInsertPreview } from './preview';
7
7
  export type OnSelectContext = {
8
8
  editorView: EditorView;
9
- insert: TypeAheadInsert;
9
+ insert: InsertContentCallback;
10
10
  source: INPUT_METHOD.ELEMENT_BROWSER | INPUT_METHOD.INSERT_MENU | INPUT_METHOD.QUICK_INSERT | INPUT_METHOD.TOOLBAR;
11
11
  };
12
12
  export type QuickInsertMenuItemProps = {
@@ -1,3 +1,3 @@
1
- import type { RegisteredItemRankResolver } from '../type-ahead/item-rank';
1
+ import type { RegisteredItemRankResolver } from '../registered-menu/item-rank';
2
2
  /** Recommendations and navigation controls retain their policy-defined order. */
3
3
  export declare const createQuickInsertRankResolver: (getItemRank?: RegisteredItemRankResolver) => RegisteredItemRankResolver | undefined;
@@ -0,0 +1,2 @@
1
+ import type { Context } from 'react';
2
+ export declare const ActiveMenuItemKeyContext: Context<string | undefined>;
@@ -0,0 +1,10 @@
1
+ import React from 'react';
2
+ export declare const MeasuredRow: ({ children, isScrolling, isVisible, measure, onMeasured, paddingBlockStart, paddingBlockEnd, }: {
3
+ children: React.ReactNode;
4
+ isScrolling?: boolean;
5
+ isVisible: boolean;
6
+ measure: () => void;
7
+ onMeasured: () => void;
8
+ paddingBlockEnd?: 'space.100';
9
+ paddingBlockStart?: 'space.100';
10
+ }) => React.JSX.Element;
@@ -0,0 +1,4 @@
1
+ import { type Context } from 'react';
2
+ import type { RegisteredMenuContextValue } from './types';
3
+ export declare const RegisteredMenuContext: Context<RegisteredMenuContextValue | null>;
4
+ export declare const useRegisteredMenuContext: () => RegisteredMenuContextValue;
@@ -0,0 +1,31 @@
1
+ import React from 'react';
2
+ import type { RegisterMenuItem, RegisterMenuSection } from '@atlaskit/editor-ui-control-model/types';
3
+ import type { RegisteredMenuListItemIdParams } from './RegisteredMenuListItemRow';
4
+ import type { RegisteredMenuItemProps } from './types';
5
+ export type RegisteredMenuListProps = {
6
+ activeItemKey?: string;
7
+ containerRole?: 'presentation';
8
+ getItemId: (params: RegisteredMenuListItemIdParams) => string;
9
+ hasScrollPadding?: boolean;
10
+ Item: React.ComponentType<RegisteredMenuItemProps>;
11
+ lastRowPadding?: 'none' | 'space.100';
12
+ maxHeight: number;
13
+ omitAriaReadonly?: boolean;
14
+ onItemBlur: (itemKey: string) => void;
15
+ onItemFocus: (itemIndex: number, itemKey?: string) => void;
16
+ onItemHover: (itemIndex: number, itemKey?: string) => void;
17
+ onItemLeave: (itemKey: string) => void;
18
+ onItemVisibilityChange: (itemKey: string, isVisible: boolean) => void;
19
+ onRenderedItemsChange?: (range: {
20
+ startIndex: number;
21
+ stopIndex: number;
22
+ }) => void;
23
+ role?: 'presentation' | 'group';
24
+ rows: Array<RegisterMenuItem | RegisterMenuSection>;
25
+ scrollResetKey?: string | number | symbol;
26
+ scrollTo?: 'selected' | 'top-on-reset';
27
+ selectedItemIndex: number;
28
+ tabIndex?: number | null;
29
+ width: number;
30
+ };
31
+ export declare const RegisteredMenuList: ({ rows, Item, selectedItemIndex, activeItemKey, maxHeight, width, getItemId, onItemHover, onItemFocus, onItemLeave, onItemBlur, onItemVisibilityChange, onRenderedItemsChange, scrollResetKey, role, containerRole, tabIndex, omitAriaReadonly, hasScrollPadding, lastRowPadding, scrollTo, }: RegisteredMenuListProps) => React.JSX.Element | null;
@@ -0,0 +1,28 @@
1
+ import React from 'react';
2
+ import type { RegisterMenuItem } from '@atlaskit/editor-ui-control-model/types';
3
+ import type { RegisteredMenuItemProps } from './types';
4
+ export type RegisteredMenuListItemIdParams = {
5
+ itemIndex: number;
6
+ rowIndex: number;
7
+ };
8
+ export type RegisteredMenuListItemRowProps = {
9
+ getItemId: (params: RegisteredMenuListItemIdParams) => string;
10
+ isVisible: boolean;
11
+ Item: React.ComponentType<RegisteredMenuItemProps>;
12
+ itemIndex: number;
13
+ onItemBlur: (itemKey: string) => void;
14
+ onItemFocus: (itemIndex: number, itemKey?: string) => void;
15
+ onItemHover: (itemIndex: number, itemKey?: string) => void;
16
+ onItemLeave: (itemKey: string) => void;
17
+ onItemVisibilityChange: (itemKey: string, isVisible: boolean) => void;
18
+ registration: RegisterMenuItem;
19
+ rowIndex: number;
20
+ selectedItemIndex: number;
21
+ };
22
+ /**
23
+ * Connects a rendered item to the list's active state and interaction callbacks.
24
+ * The list may reuse this row while scrolling, so context keeps its active styling
25
+ * current. The wrapper handles events without requiring registered components to
26
+ * forward them, and keeps the item active when focus moves between its children.
27
+ */
28
+ export declare const RegisteredMenuListItemRow: ({ Item, getItemId, itemIndex, isVisible, onItemBlur, onItemFocus, onItemHover, onItemLeave, onItemVisibilityChange, registration, rowIndex, selectedItemIndex, }: RegisteredMenuListItemRowProps) => React.JSX.Element;
@@ -0,0 +1,7 @@
1
+ import { type ContextToken, type SurfaceContext } from '@atlaskit/editor-ui-control-model/types';
2
+ export type RegisteredMenuSurfaceContext = {
3
+ readonly menuOpenId: symbol;
4
+ readonly surface: 'typeahead' | 'toolbar' | 'element-browser';
5
+ };
6
+ export declare const REGISTERED_MENU_SURFACE_CONTEXT: ContextToken<RegisteredMenuSurfaceContext>;
7
+ export declare const createRegisteredMenuSurfaceContext: (value: RegisteredMenuSurfaceContext) => SurfaceContext;
@@ -0,0 +1,4 @@
1
+ import type { RegisterMenuItem, RegisterMenuSection } from '@atlaskit/editor-ui-control-model/types';
2
+ import type { RegisteredMenuModel } from './types';
3
+ export type RegisteredMenuRow = RegisterMenuItem | RegisterMenuSection;
4
+ export declare const getRegisteredMenuRows: (model: RegisteredMenuModel) => RegisteredMenuRow[];
@@ -0,0 +1,55 @@
1
+ import type { Transaction } from '@atlaskit/editor-prosemirror/state';
2
+ import type { EditorView } from '@atlaskit/editor-prosemirror/view';
3
+ import type { SurfaceIdentifier } from '@atlaskit/editor-ui-control-model/surface-renderer/types';
4
+ import type { RegisterComponent, RegisterMenuItem, RegisterMenuSection, SurfaceContext } from '@atlaskit/editor-ui-control-model/types';
5
+ import type { InsertContentCallback } from '../insert';
6
+ import type { RegisteredItemRankResolver } from './item-rank';
7
+ export type RegisteredMenuSection = [RegisterMenuSection, ...RegisterMenuItem[]];
8
+ export type RegisteredMenuModel = {
9
+ fallbackItems: RegisterMenuItem[];
10
+ footer: RegisterMenuItem | undefined;
11
+ root: RegisterComponent | undefined;
12
+ sections: RegisteredMenuSection[];
13
+ };
14
+ export type RegisteredMenuItemProps = {
15
+ id: string;
16
+ isActive: boolean;
17
+ isSelected: boolean;
18
+ registration: RegisterMenuItem;
19
+ };
20
+ /**
21
+ * A menu exposes its navigation and accessibility state so the host can connect
22
+ * the element that has focus. The menu does not need to know whether that element is an input.
23
+ */
24
+ export type RegisteredMenuInteraction = {
25
+ activeDescendantId?: string;
26
+ /** Includes any interactive portals owned by this menu. */
27
+ containsTarget: (target: Node) => boolean;
28
+ expanded: boolean;
29
+ label: string;
30
+ listId: string;
31
+ onClose?: () => void;
32
+ /** Return true when handled so the controlling input can suppress its default behavior. */
33
+ onKeyDown: (event: KeyboardEvent) => boolean;
34
+ optionCount: number;
35
+ selectNext: () => void;
36
+ selectPrevious: () => void;
37
+ };
38
+ export type RegisteredMenuSelection = (insert: InsertContentCallback) => Transaction | false | void;
39
+ /** Editor and session values supplied by the host to the registered menu root. */
40
+ export type RegisteredMenuContextValue = {
41
+ components: RegisterComponent[];
42
+ editorView: EditorView;
43
+ getItemRank?: RegisteredItemRankResolver;
44
+ isOffline: boolean;
45
+ maxHeight?: number;
46
+ menuOpenId: symbol;
47
+ onClose: () => void;
48
+ /** Mount point for auxiliary portals such as item previews. The host owns the menu popup. */
49
+ portalMountPoint?: HTMLElement;
50
+ registerInteraction: (interaction: RegisteredMenuInteraction) => () => void;
51
+ query?: string;
52
+ rootComponent: SurfaceIdentifier;
53
+ select?: (selection: RegisteredMenuSelection) => void;
54
+ surfaceContext: SurfaceContext;
55
+ };
@@ -1,5 +1,9 @@
1
1
  import type { CellMeasurerCache } from 'react-virtualized/dist/commonjs/CellMeasurer';
2
- /** Keep the list viewport in sync with measured rows, including short search results. */
2
+ /**
3
+ * Fits the scrolling viewport to the total row height, so short menus do not leave
4
+ * empty space below their items. Rows can change height after rendering. Height
5
+ * updates wait for the next frame so all row measurements are included.
6
+ */
3
7
  export declare function useMenuListHeight(cache: CellMeasurerCache, rowCount: number, rowKeySignature: string): {
4
8
  height: number;
5
9
  updateHeight: () => void;
@@ -6,6 +6,10 @@ type Options = {
6
6
  scrollableElement?: HTMLElement;
7
7
  target?: HTMLElement | null;
8
8
  };
9
- /** Constrain menu height to the available space; Popup chooses placement. */
9
+ /**
10
+ * Limits menu height to the space around its anchor as the page scrolls or resizes.
11
+ * It allows room above or below the anchor because Popup can choose either side.
12
+ * This hook controls height only; Popup still positions the menu.
13
+ */
10
14
  export declare function useMenuPopupSizing({ target, boundariesElement, scrollableElement, maxHeight, offset, isOpen, }: Options): number;
11
15
  export {};
@@ -0,0 +1,28 @@
1
+ import type { RegisterMenuItem, RegisterMenuSection } from '@atlaskit/editor-ui-control-model/types';
2
+ import type { RegisteredMenuModel } from './types';
3
+ type Options = {
4
+ model: RegisteredMenuModel;
5
+ resetKey?: string | number | symbol;
6
+ };
7
+ export type RegisteredMenuState = {
8
+ activeItemKey?: string;
9
+ onItemBlur: (itemKey: string) => void;
10
+ onItemFocus: (index: number, itemKey?: string) => void;
11
+ onItemHover: (index: number, itemKey?: string) => void;
12
+ onItemLeave: (itemKey: string) => void;
13
+ onItemVisibilityChange: (itemKey: string, isVisible: boolean) => void;
14
+ rows: Array<RegisterMenuItem | RegisterMenuSection>;
15
+ select: (index: number) => void;
16
+ selectableItems: RegisterMenuItem[];
17
+ selectedItemIndex: number;
18
+ selectNext: () => void;
19
+ selectPrevious: () => void;
20
+ };
21
+ /**
22
+ * Connects menu rows to keyboard selection and tracks which item is active through
23
+ * keyboard, pointer and focus events. Selection controls navigation; activation lets
24
+ * the caller show item-specific feedback, such as a preview. A changed reset key
25
+ * starts navigation again and clears the active item.
26
+ */
27
+ export declare const useRegisteredMenu: ({ model, resetKey }: Options) => RegisteredMenuState;
28
+ export {};
@@ -0,0 +1,16 @@
1
+ type Options = {
2
+ identities: readonly string[];
3
+ resetKey?: string | number | symbol;
4
+ };
5
+ type RegisteredMenuSelectionState = {
6
+ select: (index: number) => void;
7
+ selectedIndex: number;
8
+ selectNext: () => number;
9
+ selectPrevious: () => number;
10
+ };
11
+ /**
12
+ * Resets keyboard selection when the ordered items or reset key changes.
13
+ * The caller chooses the key, for example a search term or the current category.
14
+ */
15
+ export declare const useRegisteredMenuSelection: ({ identities, resetKey, }: Options) => RegisteredMenuSelectionState;
16
+ export {};
@@ -10,4 +10,3 @@ export declare enum SelectItemMode {
10
10
  SELECTED = "selected"
11
11
  }
12
12
  export { typeAheadListMessages } from './messages';
13
- export type { TypeAheadSurfaceContext } from './TypeAheadSurfaceContext';
@@ -7,7 +7,7 @@ export { AnnotationUpdateEmitter, AnnotationUpdateEvent } from './annotation/emi
7
7
  export type { AnnotationState, AnnotationUpdateEventPayloads, OnAnnotationClickPayload, } from './annotation/emitter';
8
8
  export type { AnnotationProviders, InlineCommentSelectionComponentProps, InlineCommentHoverComponentProps, InlineCommentViewComponentProps, InlineCommentAnnotationProvider, AnnotationByMatches, AnnotationActionResult, } from './annotation';
9
9
  export type { ContextUpdateHandler, EditorActionsOptions, ReplaceRawValue, GetResolvedEditorStateReason, } from './editor-actions';
10
- export type { TypeAheadStats, TypeAheadItemRenderProps, TypeAheadInsert, TypeAheadSelectItem, TypeAheadItem, TypeAheadForceSelect, TypeAheadHandler, TypeAheadSection, TypeAheadSectionTitleUpdate, } from './type-ahead';
10
+ export type { TypeAheadStats, TypeAheadItemRenderProps, TypeAheadSelectItem, TypeAheadItem, TypeAheadForceSelect, TypeAheadHandler, TypeAheadSection, TypeAheadSectionTitleUpdate, } from './type-ahead';
11
11
  export type { CommandDispatch, Command, HigherOrderCommand, Predicate } from './command';
12
12
  export type { FeatureFlags, FeatureFlagKey, GetEditorFeatureFlags } from './feature-flags';
13
13
  export type { Browsers, Range, DisableSpellcheckByBrowser } from './supported-browsers';
@@ -1,7 +1,7 @@
1
1
  import type Fuse from 'fuse.js';
2
2
  import type { IntlShape } from 'react-intl';
3
3
  import type { QuickInsertItem, QuickInsertProvider } from '../provider-factory';
4
- import type { RegisteredItemRankResolver } from '../type-ahead/item-rank';
4
+ import type { RegisteredItemRankResolver } from '../registered-menu/item-rank';
5
5
  import type { EmptyStateHandler } from './empty-state-handler';
6
6
  export type QuickInsertOptions = boolean | {
7
7
  disableDefaultItems?: boolean;
@@ -1,10 +1,10 @@
1
1
  import type { ReactElement, ReactNode } from 'react';
2
2
  import type { IntlShape } from 'react-intl';
3
- import type { Fragment, Node as PMNode } from '@atlaskit/editor-prosemirror/model';
4
3
  import type { EditorState, Transaction } from '@atlaskit/editor-prosemirror/state';
5
4
  import type { TypeAheadPayload } from '../analytics/types/type-ahead';
5
+ import type { InsertContentCallback } from '../insert';
6
+ import type { RegisteredItemRankResolver } from '../registered-menu/item-rank';
6
7
  import type { SelectItemMode, TypeAheadAvailableNodes } from '../type-ahead';
7
- import type { RegisteredItemRankResolver } from '../type-ahead/item-rank';
8
8
  import type { EditorCommand } from '../types';
9
9
  type TypeAheadForceSelectProps = {
10
10
  editorState: EditorState;
@@ -24,10 +24,7 @@ export type TypeAheadItemRenderProps = {
24
24
  onClick: () => void;
25
25
  onHover: () => void;
26
26
  };
27
- export type TypeAheadInsert = (node?: PMNode | object | string | Fragment, opts?: {
28
- selectInlineNode?: boolean;
29
- }) => Transaction;
30
- export type TypeAheadSelectItem = (state: EditorState, item: TypeAheadItem, insert: TypeAheadInsert, meta: {
27
+ export type TypeAheadSelectItem = (state: EditorState, item: TypeAheadItem, insert: InsertContentCallback, meta: {
31
28
  mode: SelectItemMode;
32
29
  query: string;
33
30
  sourceListItem: Array<TypeAheadItem>;
@@ -145,6 +142,12 @@ export type TypeAheadHandler = {
145
142
  onInvokeAnalytics?: TypeAheadPayload;
146
143
  /** Handler executes logic when TypeAhead opens */
147
144
  onOpen?: (editorState: EditorState) => void;
145
+ /**
146
+ * Registry key for a custom menu root. The root must call registerInteraction
147
+ * from RegisteredMenuContext so the host can show the popup and connect keyboard navigation.
148
+ * The same context supplies the current query and selection action.
149
+ */
150
+ registeredMenuKey?: string;
148
151
  /** Handler returns a transaction which inserts the TypeAheadItem into the doc */
149
152
  selectItem: TypeAheadSelectItem;
150
153
  /**