[Chrome] Expose api to to set custom component for project left nav

[sebelga]

In this PR I've exposed a new api from the Chrome service to set a custom React component for the side navigation.
Calling this API does not have any effect if Kibana is not started in "project" ChromeStyle.

Api

chrome.project.setSideNavComponent(/* component */);

Example

// my_nav.tsx
import React, { type FC } from 'react';
import type { SideNavComponent } from '@kbn/core-chrome-browser';

// SideNavComponent will receive in its props Chrome service state (the current active route, the navTree...) 
export const MyNav: SideNavComponent = (props) => {
  return <div>Custom navigation...</div>;
};

-------------------

// serverless plugin.ts (public)
import { MyNav } from './my_nav';
...

public start(core: CoreStart) {
  core.chrome.project.setSideNavComponent(MyNav);
  return {};
}

[tsullivan]

I like the idea of exposing setNavigation and setNavigationComponent. Consumers must call setNavigation with a configuration that defines the nav tree, and other settings for parts of the chrome that deal with navigation info: breadcrumbs, recent items, global search. Calling setNavigationComponent is optional - if consumers don't set that, we will render the SharedUX component.

[elasticmachine]

Pinging @elastic/appex-sharedux (Team:SharedUX)

[sebelga]

Thanks for the review @Dosant and @tsullivan !

I addressed your feedback, can you have another look?

@tsullivan : This first PR is really only to unblock teams that need to set custom react component for the serveless project left navigation. In future PR I will improve the interface for the navigation config and add everything that the @kbn/shared-ux-chrome-navigation requires.

[Dosant]

👍

[kibana-ci]

💚 Build Succeeded

• Buildkite Build
• Commit: 2bc6366

Metrics [docs]

Module Count

Fewer modules leads to a faster build time

id	before	after	diff
core	423	426	+3

Public APIs missing comments

Total count of every public API that lacks a comment. Target amount is 0. Run node scripts/build_api_docs --plugin [yourplugin] --stats comments for more detailed information.

id	before	after	diff
@kbn/core-chrome-browser	47	58	+11

Page load bundle

Size of the bundles that are downloaded on every page load. Target size is below 100kb

id	before	after	diff
core	362.3KB	363.5KB	+1.1KB

Unknown metric groups

API count

id	before	after	diff
@kbn/core-chrome-browser	124	136	+12

ESLint disabled line counts

id	before	after	diff
@kbn/core-chrome-browser	0	1	+1
enterpriseSearch	19	21	+2
securitySolution	398	401	+3
total			+6

Total ESLint disabled count

id	before	after	diff
@kbn/core-chrome-browser	0	1	+1
enterpriseSearch	20	22	+2
securitySolution	478	481	+3
total			+6

History

• 💔 Build #124789 failed 53b30ca
• 💔 Build #124762 failed 322c0dd
• 💔 Build #124355 failed 92ca6cf30dacb88f8adc5e549341e40a5f258649

To update your PR or re-run it, just comment with:
@elasticmachine merge upstream

cc @sebelga

[tsullivan]

LGTM