Components: Introduce support custom suggestions filter for the FormTokenField component

[retrofox]

What?

This PR adds a few new properties to the FormTokenField component to enable more complex implementations. For instance, select/unselect a suggestion from the suggestions list:

Screen.Recording.2024-05-15.at.14.13.49.mov

Why?

To be able to create more complex components based on it.

How?

Adding a few new properties:

	/**
	 * Use this prop to filter the suggestions list.
	 * It receives the list of suggestions and the current input value.
	 * It should return a filtered list of suggestions.
	 */
	__filterSuggestions?: ( suggestions: string[], value: string ) => string[];

	/**
	 * Callback to be called when a suggestion is clicked.
	 */
	__onSuggestionClick?: (
		suggestion: string,
		isSuggestionTaken: boolean
	) => void;

	/**
	 * If true, the suggestion item will be focused when the suggestions list is opened.
	 */
	__forceSuggestionFocus?: boolean;

Testing Instructions

Tes by suing the storybook story

Testing Instructions for Keyboard

Screenshots or screencast

[github-actions]

Flaky tests detected in dfff7b2.
Some tests passed with failed attempts. The failures may not be related to this commit but are still reported for visibility. See the documentation for more information.

🔍 Workflow run URL: https://github.com/WordPress/gutenberg/actions/runs/9096406713
📝 Reported issues:

• [Flaky Test] Redirection after template creation #60678 in /test/e2e/specs/site-editor/site-editor-url-navigation.spec.js

[github-actions]

Warning: Type of PR label mismatch

To merge this PR, it requires exactly 1 label indicating the type of PR. Other labels are optional and not being checked here.

• Type-related labels to choose from: [Type] Automated Testing, [Type] Breaking Change, [Type] Bug, [Type] Build Tooling, [Type] Code Quality, [Type] Copy, [Type] Developer Documentation, [Type] Enhancement, [Type] Experimental, [Type] Feature, [Type] New API, [Type] Task, [Type] Technical Prototype, [Type] Performance, [Type] Project Management, [Type] Regression, [Type] Security, [Type] WP Core Ticket, Backport from WordPress Core.
• Labels found: .

Read more about Type labels in Gutenberg. Don't worry if you don't have the required permissions to add labels; the PR reviewer should be able to help with the task.