chore: some other deprecations

Signed-off-by: blam <ben@blam.sh>

plugins/api-docs/src/alpha.tsx

@@ -18,12 +18,11 @@ import React from 'react';
 import Grid from '@material-ui/core/Grid';
 
 import {
-  createApiExtension,
+  ApiBlueprint,
+  NavItemBlueprint,
+  PageBlueprint,
   createApiFactory,
-  createNavItemExtension,
-  createPageExtension,
   createFrontendPlugin,
-  createSchemaFromZod,
 } from '@backstage/frontend-plugin-api';
 
 import {
@@ -31,10 +30,6 @@ import {
   convertLegacyRouteRef,
 } from '@backstage/core-compat-api';
 
-import {
-  createEntityCardExtension,
-  createEntityContentExtension,
-} from '@backstage/plugin-catalog-react/alpha';
 import {
   ApiEntity,
   parseEntityRef,
@@ -46,161 +41,190 @@ import { rootRoute, registerComponentRouteRef } from './routes';
 import { apiDocsConfigRef } from './config';
 import { AppIcon } from '@backstage/core-components';
 
-const apiDocsNavItem = createNavItemExtension({
-  title: 'APIs',
-  routeRef: convertLegacyRouteRef(rootRoute),
-  icon: () => compatWrapper(<AppIcon id="kind:api" />),
-});
+import {
+  EntityCardBlueprint,
+  EntityContentBlueprint,
+} from '@backstage/plugin-catalog-react/alpha';
 
-const apiDocsConfigApi = createApiExtension({
-  factory: createApiFactory({
-    api: apiDocsConfigRef,
-    deps: {},
-    factory: () => {
-      const definitionWidgets = defaultDefinitionWidgets();
-      return {
-        getApiDefinitionWidget: (apiEntity: ApiEntity) => {
-          return definitionWidgets.find(d => d.type === apiEntity.spec.type);
-        },
-      };
-    },
-  }),
-});
-
-const apiDocsExplorerPage = createPageExtension({
-  defaultPath: '/api-docs',
-  routeRef: convertLegacyRouteRef(rootRoute),
-  // Mapping DefaultApiExplorerPageProps to config
-  configSchema: createSchemaFromZod(z =>
-    z.object({
-      path: z.string().default('/api-docs'),
-      initiallySelectedFilter: z.enum(['owned', 'starred', 'all']).optional(),
-      // Ommiting columns and actions for now as their types are too complex to map to zod
-    }),
-  ),
-  loader: ({ config }) =>
-    import('./components/ApiExplorerPage').then(m =>
-      compatWrapper(
-        <m.ApiExplorerIndexPage
-          initiallySelectedFilter={config.initiallySelectedFilter}
-        />,
-      ),
-    ),
-});
-
-const apiDocsHasApisEntityCard = createEntityCardExtension({
-  name: 'has-apis',
-  // Ommiting configSchema for now
-  // We are skipping variants and columns are too complex to map to zod
-  // See: https://github.com/backstage/backstage/pull/22619#discussion_r1477333252
-  filter: entity => {
-    return (
-      entity.kind === 'Component' &&
-      entity.relations?.some(
-        ({ type, targetRef }) =>
-          type.toLocaleLowerCase('en-US') === RELATION_HAS_PART &&
-          parseEntityRef(targetRef).kind === 'API',
-      )!!
-    );
+const apiDocsNavItem = NavItemBlueprint.make({
+  params: {
+    title: 'APIs',
+    routeRef: convertLegacyRouteRef(rootRoute),
+    icon: () => compatWrapper(<AppIcon id="kind:api" />),
   },
-  loader: () =>
-    import('./components/ApisCards').then(m =>
-      compatWrapper(<m.HasApisCard />),
-    ),
 });
 
-const apiDocsDefinitionEntityCard = createEntityCardExtension({
+const apiDocsConfigApi = ApiBlueprint.make({
+  namespace: 'api-docs',
+  params: {
+    factory: createApiFactory({
+      api: apiDocsConfigRef,
+      deps: {},
+      factory: () => {
+        const definitionWidgets = defaultDefinitionWidgets();
+        return {
+          getApiDefinitionWidget: (apiEntity: ApiEntity) => {
+            return definitionWidgets.find(d => d.type === apiEntity.spec.type);
+          },
+        };
+      },
+    }),
+  },
+});
+
+const apiDocsExplorerPage = PageBlueprint.makeWithOverrides({
+  config: {
+    schema: {
+      // Ommiting columns and actions for now as their types are too complex to map to zod
+      initiallySelectedFilter: z =>
+        z.enum(['owned', 'starred', 'all']).optional(),
+    },
+  },
+  factory(originalFactory, { config }) {
+    return originalFactory({
+      defaultPath: '/api-docs',
+      routeRef: convertLegacyRouteRef(rootRoute),
+      loader: () =>
+        import('./components/ApiExplorerPage').then(m =>
+          compatWrapper(
+            <m.ApiExplorerIndexPage
+              initiallySelectedFilter={config.initiallySelectedFilter}
+            />,
+          ),
+        ),
+    });
+  },
+});
+
+const apiDocsHasApisEntityCard = EntityCardBlueprint.make({
+  name: 'has-apis',
+  params: {
+    // Ommiting configSchema for now
+    // We are skipping variants and columns are too complex to map to zod
+    // See: https://github.com/backstage/backstage/pull/22619#discussion_r1477333252
+    filter: entity => {
+      return (
+        entity.kind === 'Component' &&
+        entity.relations?.some(
+          ({ type, targetRef }) =>
+            type.toLocaleLowerCase('en-US') === RELATION_HAS_PART &&
+            parseEntityRef(targetRef).kind === 'API',
+        )!!
+      );
+    },
+    loader: () =>
+      import('./components/ApisCards').then(m =>
+        compatWrapper(<m.HasApisCard />),
+      ),
+  },
+});
+
+const apiDocsDefinitionEntityCard = EntityCardBlueprint.make({
   name: 'definition',
-  filter: 'kind:api',
-  loader: () =>
-    import('./components/ApiDefinitionCard').then(m =>
-      compatWrapper(<m.ApiDefinitionCard />),
-    ),
+  params: {
+    filter: 'kind:api',
+    loader: () =>
+      import('./components/ApiDefinitionCard').then(m =>
+        compatWrapper(<m.ApiDefinitionCard />),
+      ),
+  },
 });
 
-const apiDocsConsumedApisEntityCard = createEntityCardExtension({
+const apiDocsConsumedApisEntityCard = EntityCardBlueprint.make({
   name: 'consumed-apis',
-  // Ommiting configSchema for now
-  // We are skipping variants and columns are too complex to map to zod
-  // See: https://github.com/backstage/backstage/pull/22619#discussion_r1477333252
-  filter: 'kind:component',
-  loader: () =>
-    import('./components/ApisCards').then(m =>
-      compatWrapper(<m.ConsumedApisCard />),
-    ),
+  params: {
+    // Ommiting configSchema for now
+    // We are skipping variants and columns are too complex to map to zod
+    // See: https://github.com/backstage/backstage/pull/22619#discussion_r1477333252
+    filter: 'kind:component',
+    loader: () =>
+      import('./components/ApisCards').then(m =>
+        compatWrapper(<m.ConsumedApisCard />),
+      ),
+  },
 });
 
-const apiDocsProvidedApisEntityCard = createEntityCardExtension({
+const apiDocsProvidedApisEntityCard = EntityCardBlueprint.make({
   name: 'provided-apis',
-  // Ommiting configSchema for now
-  // We are skipping variants and columns are too complex to map to zod
-  // See: https://github.com/backstage/backstage/pull/22619#discussion_r1477333252
-  filter: 'kind:component',
-  loader: () =>
-    import('./components/ApisCards').then(m =>
-      compatWrapper(<m.ProvidedApisCard />),
-    ),
+  params: {
+    // Ommiting configSchema for now
+    // We are skipping variants and columns are too complex to map to zod
+    // See: https://github.com/backstage/backstage/pull/22619#discussion_r1477333252
+    filter: 'kind:component',
+    loader: () =>
+      import('./components/ApisCards').then(m =>
+        compatWrapper(<m.ProvidedApisCard />),
+      ),
+  },
 });
 
-const apiDocsConsumingComponentsEntityCard = createEntityCardExtension({
+const apiDocsConsumingComponentsEntityCard = EntityCardBlueprint.make({
   name: 'consuming-components',
-  // Ommiting configSchema for now
-  // We are skipping variants
-  // See: https://github.com/backstage/backstage/pull/22619#discussion_r1477333252
-  filter: 'kind:api',
-  loader: () =>
-    import('./components/ComponentsCards').then(m =>
-      compatWrapper(<m.ConsumingComponentsCard />),
-    ),
+  params: {
+    // Ommiting configSchema for now
+    // We are skipping variants
+    // See: https://github.com/backstage/backstage/pull/22619#discussion_r1477333252
+    filter: 'kind:api',
+    loader: () =>
+      import('./components/ComponentsCards').then(m =>
+        compatWrapper(<m.ConsumingComponentsCard />),
+      ),
+  },
 });
 
-const apiDocsProvidingComponentsEntityCard = createEntityCardExtension({
+const apiDocsProvidingComponentsEntityCard = EntityCardBlueprint.make({
   name: 'providing-components',
-  // Ommiting configSchema for now
-  // We are skipping variants
-  // See: https://github.com/backstage/backstage/pull/22619#discussion_r1477333252
-  filter: 'kind:api',
-  loader: () =>
-    import('./components/ComponentsCards').then(m =>
-      compatWrapper(<m.ProvidingComponentsCard />),
-    ),
+  params: {
+    // Ommiting configSchema for now
+    // We are skipping variants
+    // See: https://github.com/backstage/backstage/pull/22619#discussion_r1477333252
+    filter: 'kind:api',
+    loader: () =>
+      import('./components/ComponentsCards').then(m =>
+        compatWrapper(<m.ProvidingComponentsCard />),
+      ),
+  },
 });
 
-const apiDocsDefinitionEntityContent = createEntityContentExtension({
+const apiDocsDefinitionEntityContent = EntityContentBlueprint.make({
   name: 'definition',
-  defaultPath: '/defintion',
-  defaultTitle: 'Definition',
-  filter: 'kind:api',
-  loader: async () =>
-    import('./components/ApiDefinitionCard').then(m =>
-      compatWrapper(
-        <Grid container spacing={3}>
-          <Grid item xs={12}>
-            <m.ApiDefinitionCard />
-          </Grid>
-        </Grid>,
+  params: {
+    defaultPath: '/defintion',
+    defaultTitle: 'Definition',
+    filter: 'kind:api',
+    loader: async () =>
+      import('./components/ApiDefinitionCard').then(m =>
+        compatWrapper(
+          <Grid container spacing={3}>
+            <Grid item xs={12}>
+              <m.ApiDefinitionCard />
+            </Grid>
+          </Grid>,
+        ),
       ),
-    ),
+  },
 });
 
-const apiDocsApisEntityContent = createEntityContentExtension({
+const apiDocsApisEntityContent = EntityContentBlueprint.make({
   name: 'apis',
-  defaultPath: '/apis',
-  defaultTitle: 'APIs',
-  filter: 'kind:component',
-  loader: async () =>
-    import('./components/ApisCards').then(m =>
-      compatWrapper(
-        <Grid container spacing={3} alignItems="stretch">
-          <Grid item xs={12}>
-            <m.ProvidedApisCard />
-          </Grid>
-          <Grid item xs={12}>
-            <m.ConsumedApisCard />
-          </Grid>
-        </Grid>,
+  params: {
+    defaultPath: '/apis',
+    defaultTitle: 'APIs',
+    filter: 'kind:component',
+    loader: async () =>
+      import('./components/ApisCards').then(m =>
+        compatWrapper(
+          <Grid container spacing={3} alignItems="stretch">
+            <Grid item xs={12}>
+              <m.ProvidedApisCard />
+            </Grid>
+            <Grid item xs={12}>
+              <m.ConsumedApisCard />
+            </Grid>
+          </Grid>,
+        ),
       ),
-    ),
+  },
 });
 
 export default createFrontendPlugin({