feat(frontend-plugin-api): add titleRouteRef to PageBlueprint

Add `titleRouteRef` to `PageLayoutProps` so the plugin header title
links back to the plugin root. `PageBlueprint` resolves it from
`plugin.routes.root` with fallback to `params.routeRef`.

- PageLayout swap resolves the title link via a conditional child
  component that calls `useRouteRef` only when a route ref exists
- Header actions get stable React keys via `cloneElement`

Signed-off-by: Johan Persson <johanopersson@gmail.com>

packages/app/e2e-tests/HomePage.test.ts

@@ -43,7 +43,9 @@ test('Should render the home page', async ({ page }) => {
   await enterButton.click();
 
   // Wait for sign-in to complete
-  await expect(page.getByRole('link', { name: 'Catalog' })).toBeVisible();
+  await expect(
+    page.getByRole('navigation').getByRole('link', { name: 'Catalog' }),
+  ).toBeVisible();
 
   await page.goto('/home');
   // The home page should render with the custom homepage grid

packages/app/e2e-tests/SearchPage.test.ts

@@ -24,7 +24,9 @@ test('the results are rendered as expected', async ({ page }) => {
   await enterButton.click();
 
   // Wait for sign-in to complete before navigating
-  await expect(page.getByRole('link', { name: 'Catalog' })).toBeVisible();
+  await expect(
+    page.getByRole('navigation').getByRole('link', { name: 'Catalog' }),
+  ).toBeVisible();
 
   // Set up route interception BEFORE navigating to the search page
   await page.route(`**/api/search/query?term=*`, async route => {

packages/app/e2e-tests/app.test.ts

@@ -24,6 +24,8 @@ test('App should render the welcome page', async ({ page }) => {
   await enterButton.click();
 
   // Verify the sidebar navigation is visible after sign-in
-  await expect(page.getByRole('link', { name: 'Catalog' })).toBeVisible();
+  await expect(
+    page.getByRole('navigation').getByRole('link', { name: 'Catalog' }),
+  ).toBeVisible();
   await expect(page.getByRole('link', { name: 'APIs' })).toBeVisible();
 });