@wordpress/block-editor/src/utils/order-inserter-block-items.js

Generic block editor.

/** @typedef {import('../store/selectors').WPEditorInserterItem} WPEditorInserterItem */

/**
 * Helper function to order inserter block items according to a provided array of prioritized blocks.
 *
 * @param {WPEditorInserterItem[]} items    The array of editor inserter block items to be sorted.
 * @param {string[]}               priority The array of block names to be prioritized.
 * @return {WPEditorInserterItem[]} The sorted array of editor inserter block items.
 */
export const orderInserterBlockItems = ( items, priority ) => {
	if ( ! priority ) {
		return items;
	}

	items.sort( ( { id: aName }, { id: bName } ) => {
		// Sort block items according to `priority`.
		let aIndex = priority.indexOf( aName );
		let bIndex = priority.indexOf( bName );
		// All other block items should come after that.
		if ( aIndex < 0 ) {
			aIndex = priority.length;
		}
		if ( bIndex < 0 ) {
			bIndex = priority.length;
		}
		return aIndex - bIndex;
	} );

	return items;
};