[Lens] allow embeddable client to customize legend filter actions

[drewdaemon]

Describe the feature:
As of #145708, embeddable consumers can supply custom legend actions. However, the default filtering actions are always present and there is no way to customize their behavior (defined in code).

Describe a specific use case for the feature:

The security team uses a custom query bar that doesn't integrate automatically with the default filtering behavior: #168199

[elasticmachine]

Pinging @elastic/kibana-visualizations (Team:Visualizations)

[drewdaemon]

Adjusting impact to "high" because this is currently blocking an 8.11 bugfix for the security team (#168199).

[drewdaemon]

Technical plan

• Add a new optional property shouldShowLegendAction to the Lens embeddable base input interface

  // This callback is called before displaying any legend actions in an XY chart
  // to check if they should be shown
  shouldShowLegendAction?: (id: string) => boolean;

• Pass this to the expression renderer (example)
• Add shouldShowLegendAction to the expression renderer handlers (interface, implementation)
• Add it as a parameter for the XY renderer (example)
• Add it as a prop to the XY component (example)
• Pass it to to getLegendAction
• Add it as a prop to LegendActionPopover
• Remove any action from the list for which shouldShowLegendAction returns false (including the default filter actions)

[angorayc]

Follow up issue: #171284

One more suggestion for Drew about the long term plan to clean up the actions :
Please consider registering Lens default actions to ui actions and talk to ui-actions team about a request to add an new api, for example, replaceExistingAction to src/plugins/ui_actions/public/service/ui_actions_service.ts
In this case, consumers who need custom actions could use that api to replace the default actions with their custom actions. Thanks so much for the help!

[drewdaemon]

@angorayc added this capability in #170127.

#169983 tracks a full inventory and improved design of how we allow consumers to customize visualization interactions.