@atlaskit/editor-plugin-insert-block 8.4.4 → 8.5.0

package/dist/types/ui/ElementBrowser/InsertMenu.d.ts

@@ -4,11 +4,14 @@ import type { QuickInsertItem } from '@atlaskit/editor-common/provider-factory';
 import type { InsertMenuProps } from './types';
 export declare const DEFAULT_HEIGHT = 560;
 /**
- * Exported helper to allow testing of InsertMenu whiteboard pinning logic. NOTE: this is
+ * Exported helper to allow testing of InsertMenu pinning logic. NOTE: this is
    *not* the ideal way to approach this, quickinsert plugin provides a `getSuggestions`
    method that can be used to get suggestions -> once all experiments are cleaned up,
    they should be unified through `pluginInjectionApi?.quickInsert?.actions.getSuggestions`
+
+   `cc_fd_db_top_editor_toolbar` experiment adds new logic to sort elements by `priority`
+   this newer implementation matches how the "quick insert menu" sorts elements
  */
-export declare const filterForPinWhiteboards: (featuredItems: QuickInsertItem[], formatMessage: (msg: MessageDescriptor) => string) => QuickInsertItem[];
+export declare const sortPrioritizedElements: (featuredItems: QuickInsertItem[], formatMessage: (msg: MessageDescriptor) => string) => QuickInsertItem[];
 declare const InsertMenu: ({ editorView, dropdownItems, showElementBrowserLink, onInsert, toggleVisiblity, pluginInjectionApi, }: InsertMenuProps) => jsx.JSX.Element;
 export default InsertMenu;

package/dist/types-ts4.5/pm-plugins/experiences/toolbar-action-experiences.d.ts

@@ -0,0 +1,10 @@
+import { type DispatchAnalyticsEvent } from '@atlaskit/editor-common/analytics';
+import { SafePlugin } from '@atlaskit/editor-common/safe-plugin';
+type ToolbarActionExperienceOptions = {
+    dispatchAnalyticsEvent: DispatchAnalyticsEvent;
+    refs: {
+        popupsMountPoint?: HTMLElement;
+    };
+};
+export declare const getToolbarActionExperiencesPlugin: ({ refs, dispatchAnalyticsEvent, }: ToolbarActionExperienceOptions) => SafePlugin<any>;
+export {};

package/dist/types-ts4.5/pm-plugins/experiences/toolbar-experience-utils.d.ts

@@ -0,0 +1,57 @@
+import type { ExperienceCheck, ExperienceCheckCallback, ExperienceCheckResult } from '@atlaskit/editor-common/experiences';
+import type { EditorView } from '@atlaskit/editor-prosemirror/view';
+/**
+ * DOM marker selectors for node types inserted via toolbar actions.
+ * Matches outermost wrapper elements set synchronously by ReactNodeView
+ * (`{nodeTypeName}View-content-wrap`) or schema `toDOM` attributes.
+ */
+export declare const NODE_INSERT_MARKERS: {
+    readonly TABLE: ".tableView-content-wrap";
+    readonly LAYOUT: ".layoutSectionView-content-wrap";
+    readonly LAYOUT_COLUMN: ".layoutColumnView-content-wrap";
+    readonly TASK_LIST: "[data-node-type=\"actionList\"]";
+    readonly TASK_ITEM: ".taskItemView-content-wrap";
+};
+export declare const isToolbarButtonClick: (target: HTMLElement, testId: string) => boolean;
+/**
+ * ExperienceCheck that observes popup mount point and all its
+ * `[data-editor-popup]` children with `{ childList: true }` (no subtree).
+ *
+ * Detects when a popup containing the given nested element is added to the
+ * DOM — either as a new `[data-editor-popup]` direct child, or as content
+ * rendered inside an existing `[data-editor-popup]` wrapper.
+ */
+export declare const TYPEAHEAD_DECORATION_SELECTOR = "[data-type-ahead=\"typeaheadDecoration\"]";
+export declare const handleTypeAheadOpenDomMutation: ({ mutations, }: {
+    mutations: MutationRecord[];
+}) => ExperienceCheckResult | undefined;
+export declare class ExperienceCheckPopupMutation implements ExperienceCheck {
+    private nestedElementQuery;
+    private getTarget;
+    private getEditorDom;
+    private observers;
+    constructor(nestedElementQuery: string, getTarget: () => HTMLElement | undefined | null, getEditorDom: () => HTMLElement | undefined | null);
+    start(callback: ExperienceCheckCallback): void;
+    stop(): void;
+}
+/**
+ * Returns the narrow parent DOM element at the current selection, suitable
+ * for observing with `{ childList: true }` (no subtree).
+ *
+ * Uses the resolved position's depth to find the block node at the cursor
+ * via `nodeDOM`, then returns its `parentElement` — the container whose
+ * direct children change when content is inserted at this position.
+ *
+ * Falls back to `domAtPos` if `nodeDOM` is unavailable.
+ */
+export declare const getParentDOMAtSelection: (editorView?: EditorView) => HTMLElement | null;
+/**
+ * Evaluates DOM mutations to detect a node insert action.
+ *
+ * Uses two strategies:
+ * 1. Marker-based: checks `addedNodes` against known node insert selectors.
+ * 2. Structure-based: detects element add+remove (block-level replacement).
+ */
+export declare const handleEditorNodeInsertDomMutation: ({ mutations, }: {
+    mutations: MutationRecord[];
+}) => ExperienceCheckResult | undefined;

package/dist/types-ts4.5/ui/ElementBrowser/InsertMenu.d.ts

@@ -4,11 +4,14 @@ import type { QuickInsertItem } from '@atlaskit/editor-common/provider-factory';
 import type { InsertMenuProps } from './types';
 export declare const DEFAULT_HEIGHT = 560;
 /**
- * Exported helper to allow testing of InsertMenu whiteboard pinning logic. NOTE: this is
+ * Exported helper to allow testing of InsertMenu pinning logic. NOTE: this is
    *not* the ideal way to approach this, quickinsert plugin provides a `getSuggestions`
    method that can be used to get suggestions -> once all experiments are cleaned up,
    they should be unified through `pluginInjectionApi?.quickInsert?.actions.getSuggestions`
+
+   `cc_fd_db_top_editor_toolbar` experiment adds new logic to sort elements by `priority`
+   this newer implementation matches how the "quick insert menu" sorts elements
  */
-export declare const filterForPinWhiteboards: (featuredItems: QuickInsertItem[], formatMessage: (msg: MessageDescriptor) => string) => QuickInsertItem[];
+export declare const sortPrioritizedElements: (featuredItems: QuickInsertItem[], formatMessage: (msg: MessageDescriptor) => string) => QuickInsertItem[];
 declare const InsertMenu: ({ editorView, dropdownItems, showElementBrowserLink, onInsert, toggleVisiblity, pluginInjectionApi, }: InsertMenuProps) => jsx.JSX.Element;
 export default InsertMenu;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/editor-plugin-insert-block",
-	"version": "8.4.4",
+	"version": "8.5.0",
 	"description": "Insert block plugin for @atlaskit/editor-core",
 	"author": "Atlassian Pty Ltd",
 	"license": "Apache-2.0",
@@ -29,6 +29,7 @@
 	],
 	"atlaskit:src": "src/index.ts",
 	"dependencies": {
+		"@atlaskit/browser-apis": "^0.0.1",
 		"@atlaskit/editor-plugin-analytics": "^7.0.0",
 		"@atlaskit/editor-plugin-block-type": "^11.2.0",
 		"@atlaskit/editor-plugin-code-block": "^9.0.0",
@@ -64,7 +65,7 @@
 		"@atlaskit/icon-lab": "^5.15.0",
 		"@atlaskit/platform-feature-flags": "^1.1.0",
 		"@atlaskit/theme": "^21.0.0",
-		"@atlaskit/tmp-editor-statsig": "^23.0.0",
+		"@atlaskit/tmp-editor-statsig": "^23.1.0",
 		"@atlaskit/tokens": "^11.0.0",
 		"@babel/runtime": "^7.0.0",
 		"@emotion/react": "^11.7.1",
@@ -131,6 +132,9 @@
 		},
 		"platform_editor_media_insert_check": {
 			"type": "boolean"
+		},
+		"platform_editor_experience_tracking_toolbar_button": {
+			"type": "boolean"
 		}
 	}
 }