Remove NavItemBlueprint in favor of page-based nav discovery

Drop the deprecated NavItemBlueprint from the public API and migrate core
plugins to set title and icon on PageBlueprint instead. AppNav keeps
backward compatibility for legacy nav-item extensions via an internal
core.nav-item.target data ref.

Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
Co-authored-by: Cursor <cursoragent@cursor.com>

plugins/devtools/report-alpha.api.md

@@ -10,7 +10,6 @@ import { ConfigurableExtensionDataRef } from '@backstage/frontend-plugin-api';
 import { ExtensionBlueprintParams } from '@backstage/frontend-plugin-api';
 import { ExtensionDataRef } from '@backstage/frontend-plugin-api';
 import { ExtensionInput } from '@backstage/frontend-plugin-api';
-import { IconComponent } from '@backstage/frontend-plugin-api';
 import { IconElement } from '@backstage/frontend-plugin-api';
 import { JSX as JSX_2 } from 'react';
 import { OverridableExtensionDefinition } from '@backstage/frontend-plugin-api';
@@ -40,31 +39,6 @@ const _default: OverridableFrontendPlugin<
         params: ApiFactory<TApi, TImpl, TDeps>,
       ) => ExtensionBlueprintParams<AnyApiFactory>;
     }>;
-    'nav-item:devtools': OverridableExtensionDefinition<{
-      kind: 'nav-item';
-      name: undefined;
-      config: {
-        title: string | undefined;
-      };
-      configInput: {
-        title?: string | undefined;
-      };
-      output: ExtensionDataRef<
-        {
-          title: string;
-          icon: IconComponent;
-          routeRef: RouteRef_2<undefined>;
-        },
-        'core.nav-item.target',
-        {}
-      >;
-      inputs: {};
-      params: {
-        title: string;
-        icon: IconComponent;
-        routeRef: RouteRef_2<undefined>;
-      };
-    }>;
     'page:devtools': OverridableExtensionDefinition<{
       config: {
         path: string | undefined;

plugins/devtools/src/alpha/plugin.tsx

@@ -21,7 +21,6 @@ import {
   fetchApiRef,
   ApiBlueprint,
   PageBlueprint,
-  NavItemBlueprint,
   SubPageBlueprint,
 } from '@backstage/frontend-plugin-api';
 
@@ -72,6 +71,7 @@ export const devToolsPage = PageBlueprint.makeWithOverrides({
         path: '/devtools',
         routeRef: rootRouteRef,
         title: 'DevTools',
+        icon: <BuildIcon fontSize="inherit" />,
       },
       {
         inputs: {
@@ -133,15 +133,6 @@ export const devToolsScheduledTasksPage = SubPageBlueprint.make({
   },
 });
 
-/** @alpha */
-export const devToolsNavItem = NavItemBlueprint.make({
-  params: {
-    title: 'DevTools',
-    routeRef: rootRouteRef,
-    icon: BuildIcon,
-  },
-});
-
 /** @alpha */
 export default createFrontendPlugin({
   pluginId: 'devtools',
@@ -157,6 +148,5 @@ export default createFrontendPlugin({
     devToolsInfoPage,
     devToolsConfigPage,
     devToolsScheduledTasksPage,
-    devToolsNavItem,
   ],
 });