@backstage/plugin-catalog 1.33.1 → 1.34.0-next.1

package/CHANGELOG.md

@@ -1,10 +1,59 @@
 # @backstage/plugin-catalog
 
-## 1.33.1
+## 1.34.0-next.1
+
+### Minor Changes
+
+- 4d58894: Added support for group alias IDs and configurable content ordering on the entity page. Groups can now declare `aliases` so that content targeting an aliased group is included in the group. A new `defaultContentOrder` option (default `title`) controls how content items within each group are sorted, with support for both a page-level default and per-group overrides.
 
 ### Patch Changes
 
-- c1c8277: Fixed entity page tab groups not respecting the ordering from the `groups` configuration.
+- 07ba746: Fixed entity page tab groups not respecting the ordering from the `groups` configuration.
+- Updated dependencies
+  - @backstage/ui@0.13.0-next.1
+  - @backstage/catalog-client@1.14.0-next.1
+  - @backstage/plugin-catalog-react@2.1.0-next.1
+  - @backstage/plugin-scaffolder-common@2.0.0-next.1
+  - @backstage/catalog-model@1.7.6
+  - @backstage/core-compat-api@0.5.9-next.1
+  - @backstage/core-components@0.18.8-next.0
+  - @backstage/core-plugin-api@1.12.4-next.0
+  - @backstage/errors@1.2.7
+  - @backstage/frontend-plugin-api@0.14.2-next.0
+  - @backstage/integration-react@1.2.16-next.1
+  - @backstage/types@1.2.2
+  - @backstage/version-bridge@1.0.12
+  - @backstage/plugin-catalog-common@1.1.8
+  - @backstage/plugin-permission-react@0.4.41-next.0
+  - @backstage/plugin-search-common@1.2.22
+  - @backstage/plugin-search-react@1.10.5-next.0
+  - @backstage/plugin-techdocs-common@0.1.1
+  - @backstage/plugin-techdocs-react@1.3.9-next.0
+
+## 1.33.1-next.0
+
+### Patch Changes
+
+- Updated dependencies
+  - @backstage/ui@0.12.1-next.0
+  - @backstage/plugin-search-react@1.10.5-next.0
+  - @backstage/frontend-plugin-api@0.14.2-next.0
+  - @backstage/catalog-client@1.13.1-next.0
+  - @backstage/plugin-catalog-react@2.0.1-next.0
+  - @backstage/catalog-model@1.7.6
+  - @backstage/core-compat-api@0.5.9-next.0
+  - @backstage/core-components@0.18.8-next.0
+  - @backstage/core-plugin-api@1.12.4-next.0
+  - @backstage/errors@1.2.7
+  - @backstage/integration-react@1.2.16-next.0
+  - @backstage/types@1.2.2
+  - @backstage/version-bridge@1.0.12
+  - @backstage/plugin-catalog-common@1.1.8
+  - @backstage/plugin-permission-react@0.4.41-next.0
+  - @backstage/plugin-scaffolder-common@1.7.7-next.0
+  - @backstage/plugin-search-common@1.2.22
+  - @backstage/plugin-techdocs-common@0.1.1
+  - @backstage/plugin-techdocs-react@1.3.9-next.0
 
 ## 1.33.0
 

package/dist/alpha/components/EntityLayout/EntityLayout.esm.js

@@ -22,6 +22,7 @@ const EntityLayout = (props) => {
     NotFoundComponent,
     parentEntityRelations,
     groupDefinitions,
+    defaultContentOrder,
     showNavItemIcons
   } = props;
   const { kind } = useRouteRefParams(entityRouteRef);
@@ -67,6 +68,7 @@ const EntityLayout = (props) => {
       {
         routes,
         groupDefinitions,
+        defaultContentOrder,
         showIcons: showNavItemIcons
       }
     ),

package/dist/alpha/components/EntityLayout/EntityLayout.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"EntityLayout.esm.js","sources":["../../../../src/alpha/components/EntityLayout/EntityLayout.tsx"],"sourcesContent":["/*\n * Copyright 2020 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { ComponentProps, ReactNode, ReactElement } from 'react';\n\nimport Alert from '@material-ui/lab/Alert';\n\nimport {\n  attachComponentData,\n  useElementFilter,\n  useRouteRefParams,\n} from '@backstage/core-plugin-api';\nimport { useTranslationRef } from '@backstage/core-plugin-api/alpha';\nimport {\n  Content,\n  Link,\n  Page,\n  Progress,\n  WarningPanel,\n} from '@backstage/core-components';\nimport { Entity } from '@backstage/catalog-model';\nimport {\n  entityRouteRef,\n  useAsyncEntity,\n} from '@backstage/plugin-catalog-react';\n\nimport { catalogTranslationRef } from '../../translation';\nimport { EntityHeader } from '../EntityHeader';\nimport { EntityTabs } from '../EntityTabs';\nimport { EntityContentGroupDefinitions } from '@backstage/plugin-catalog-react/alpha';\n\nexport type EntityLayoutRouteProps = {\n  path: string;\n  title: string;\n  group?: string;\n  icon?: string | ReactElement;\n  children: JSX.Element;\n  if?: (entity: Entity) => boolean;\n};\n\nconst dataKey = 'plugin.catalog.entityLayoutRoute';\nconst Route: (props: EntityLayoutRouteProps) => null = () => null;\nattachComponentData(Route, dataKey, true);\nattachComponentData(Route, 'core.gatherMountPoints', true); // This causes all mount points that are discovered within this route to use the path of the route itself\n\n/** @public */\nexport interface EntityLayoutProps {\n  UNSTABLE_contextMenuOptions?: ComponentProps<\n    typeof EntityHeader\n  >['UNSTABLE_contextMenuOptions'];\n  UNSTABLE_extraContextMenuItems?: ComponentProps<\n    typeof EntityHeader\n  >['UNSTABLE_extraContextMenuItems'];\n  contextMenuItems?: ComponentProps<typeof EntityHeader>['contextMenuItems'];\n  children?: ReactNode;\n  header?: JSX.Element;\n  NotFoundComponent?: ReactNode;\n  /**\n   * An array of relation types used to determine the parent entities in the hierarchy.\n   * These relations are prioritized in the order provided, allowing for flexible\n   * navigation through entity relationships.\n   *\n   * For example, use relation types like `[\"partOf\", \"memberOf\", \"ownedBy\"]` to define how the entity is related to\n   * its parents in the Entity Catalog.\n   *\n   * It adds breadcrumbs in the Entity page to enhance user navigation and context awareness.\n   */\n  parentEntityRelations?: string[];\n  groupDefinitions: EntityContentGroupDefinitions;\n  showNavItemIcons?: boolean;\n}\n\n/**\n * EntityLayout is a compound component, which allows you to define a layout for\n * entities using a sub-navigation mechanism.\n *\n * Consists of two parts: EntityLayout and EntityLayout.Route\n *\n * @example\n * ```jsx\n * <EntityLayout>\n *   <EntityLayout.Route path=\"/example\" title=\"Example tab\">\n *     <div>This is rendered under /example/anything-here route</div>\n *   </EntityLayout.Route>\n * </EntityLayout>\n * ```\n *\n * @public\n */\nexport const EntityLayout = (props: EntityLayoutProps) => {\n  const {\n    UNSTABLE_extraContextMenuItems,\n    UNSTABLE_contextMenuOptions,\n    contextMenuItems,\n    children,\n    header,\n    NotFoundComponent,\n    parentEntityRelations,\n    groupDefinitions,\n    showNavItemIcons,\n  } = props;\n  const { kind } = useRouteRefParams(entityRouteRef);\n  const { entity, loading, error } = useAsyncEntity();\n\n  const routes = useElementFilter(\n    children,\n    elements =>\n      elements\n        .selectByComponentData({\n          key: dataKey,\n          withStrictError:\n            'Child of EntityLayout must be an EntityLayout.Route',\n        })\n        .getElements<EntityLayoutRouteProps>() // all nodes, element data, maintain structure or not?\n        .flatMap(({ props: elementProps }) => {\n          if (!entity) {\n            return [];\n          }\n          if (elementProps.if && !elementProps.if(entity)) {\n            return [];\n          }\n          return [\n            {\n              path: elementProps.path,\n              title: elementProps.title,\n              group: elementProps.group,\n              children: elementProps.children,\n              icon: elementProps.icon,\n            },\n          ];\n        }),\n    [entity],\n  );\n\n  const { t } = useTranslationRef(catalogTranslationRef);\n\n  return (\n    <Page themeId={entity?.spec?.type?.toString() ?? 'home'}>\n      {header ?? (\n        <EntityHeader\n          parentEntityRelations={parentEntityRelations}\n          UNSTABLE_contextMenuOptions={UNSTABLE_contextMenuOptions}\n          UNSTABLE_extraContextMenuItems={UNSTABLE_extraContextMenuItems}\n          contextMenuItems={contextMenuItems}\n        />\n      )}\n\n      {loading && <Progress />}\n\n      {entity && (\n        <EntityTabs\n          routes={routes}\n          groupDefinitions={groupDefinitions}\n          showIcons={showNavItemIcons}\n        />\n      )}\n\n      {error && (\n        <Content>\n          <Alert severity=\"error\">{error.toString()}</Alert>\n        </Content>\n      )}\n\n      {!loading && !error && !entity && (\n        <Content>\n          {NotFoundComponent ? (\n            NotFoundComponent\n          ) : (\n            <WarningPanel title={t('entityLabels.warningPanelTitle')}>\n              {t('entityPage.notFoundMessage', {\n                kind,\n                link: (\n                  <Link to=\"https://backstage.io/docs/features/software-catalog/references\">\n                    {t('entityPage.notFoundLinkText')}\n                  </Link>\n                ),\n              })}\n            </WarningPanel>\n          )}\n        </Content>\n      )}\n    </Page>\n  );\n};\n\nEntityLayout.Route = Route;\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"EntityLayout.esm.js","sources":["../../../../src/alpha/components/EntityLayout/EntityLayout.tsx"],"sourcesContent":["/*\n * Copyright 2020 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { ComponentProps, ReactNode, ReactElement } from 'react';\n\nimport Alert from '@material-ui/lab/Alert';\n\nimport {\n  attachComponentData,\n  useElementFilter,\n  useRouteRefParams,\n} from '@backstage/core-plugin-api';\nimport { useTranslationRef } from '@backstage/core-plugin-api/alpha';\nimport {\n  Content,\n  Link,\n  Page,\n  Progress,\n  WarningPanel,\n} from '@backstage/core-components';\nimport { Entity } from '@backstage/catalog-model';\nimport {\n  entityRouteRef,\n  useAsyncEntity,\n} from '@backstage/plugin-catalog-react';\n\nimport { catalogTranslationRef } from '../../translation';\nimport { EntityHeader } from '../EntityHeader';\nimport { EntityTabs } from '../EntityTabs';\nimport { EntityContentGroupDefinitions } from '@backstage/plugin-catalog-react/alpha';\n\nexport type EntityLayoutRouteProps = {\n  path: string;\n  title: string;\n  group?: string;\n  icon?: string | ReactElement;\n  children: JSX.Element;\n  if?: (entity: Entity) => boolean;\n};\n\nconst dataKey = 'plugin.catalog.entityLayoutRoute';\nconst Route: (props: EntityLayoutRouteProps) => null = () => null;\nattachComponentData(Route, dataKey, true);\nattachComponentData(Route, 'core.gatherMountPoints', true); // This causes all mount points that are discovered within this route to use the path of the route itself\n\n/** @public */\nexport interface EntityLayoutProps {\n  UNSTABLE_contextMenuOptions?: ComponentProps<\n    typeof EntityHeader\n  >['UNSTABLE_contextMenuOptions'];\n  UNSTABLE_extraContextMenuItems?: ComponentProps<\n    typeof EntityHeader\n  >['UNSTABLE_extraContextMenuItems'];\n  contextMenuItems?: ComponentProps<typeof EntityHeader>['contextMenuItems'];\n  children?: ReactNode;\n  header?: JSX.Element;\n  NotFoundComponent?: ReactNode;\n  /**\n   * An array of relation types used to determine the parent entities in the hierarchy.\n   * These relations are prioritized in the order provided, allowing for flexible\n   * navigation through entity relationships.\n   *\n   * For example, use relation types like `[\"partOf\", \"memberOf\", \"ownedBy\"]` to define how the entity is related to\n   * its parents in the Entity Catalog.\n   *\n   * It adds breadcrumbs in the Entity page to enhance user navigation and context awareness.\n   */\n  parentEntityRelations?: string[];\n  groupDefinitions: EntityContentGroupDefinitions;\n  defaultContentOrder?: 'title' | 'natural';\n  showNavItemIcons?: boolean;\n}\n\n/**\n * EntityLayout is a compound component, which allows you to define a layout for\n * entities using a sub-navigation mechanism.\n *\n * Consists of two parts: EntityLayout and EntityLayout.Route\n *\n * @example\n * ```jsx\n * <EntityLayout>\n *   <EntityLayout.Route path=\"/example\" title=\"Example tab\">\n *     <div>This is rendered under /example/anything-here route</div>\n *   </EntityLayout.Route>\n * </EntityLayout>\n * ```\n *\n * @public\n */\nexport const EntityLayout = (props: EntityLayoutProps) => {\n  const {\n    UNSTABLE_extraContextMenuItems,\n    UNSTABLE_contextMenuOptions,\n    contextMenuItems,\n    children,\n    header,\n    NotFoundComponent,\n    parentEntityRelations,\n    groupDefinitions,\n    defaultContentOrder,\n    showNavItemIcons,\n  } = props;\n  const { kind } = useRouteRefParams(entityRouteRef);\n  const { entity, loading, error } = useAsyncEntity();\n\n  const routes = useElementFilter(\n    children,\n    elements =>\n      elements\n        .selectByComponentData({\n          key: dataKey,\n          withStrictError:\n            'Child of EntityLayout must be an EntityLayout.Route',\n        })\n        .getElements<EntityLayoutRouteProps>() // all nodes, element data, maintain structure or not?\n        .flatMap(({ props: elementProps }) => {\n          if (!entity) {\n            return [];\n          }\n          if (elementProps.if && !elementProps.if(entity)) {\n            return [];\n          }\n          return [\n            {\n              path: elementProps.path,\n              title: elementProps.title,\n              group: elementProps.group,\n              children: elementProps.children,\n              icon: elementProps.icon,\n            },\n          ];\n        }),\n    [entity],\n  );\n\n  const { t } = useTranslationRef(catalogTranslationRef);\n\n  return (\n    <Page themeId={entity?.spec?.type?.toString() ?? 'home'}>\n      {header ?? (\n        <EntityHeader\n          parentEntityRelations={parentEntityRelations}\n          UNSTABLE_contextMenuOptions={UNSTABLE_contextMenuOptions}\n          UNSTABLE_extraContextMenuItems={UNSTABLE_extraContextMenuItems}\n          contextMenuItems={contextMenuItems}\n        />\n      )}\n\n      {loading && <Progress />}\n\n      {entity && (\n        <EntityTabs\n          routes={routes}\n          groupDefinitions={groupDefinitions}\n          defaultContentOrder={defaultContentOrder}\n          showIcons={showNavItemIcons}\n        />\n      )}\n\n      {error && (\n        <Content>\n          <Alert severity=\"error\">{error.toString()}</Alert>\n        </Content>\n      )}\n\n      {!loading && !error && !entity && (\n        <Content>\n          {NotFoundComponent ? (\n            NotFoundComponent\n          ) : (\n            <WarningPanel title={t('entityLabels.warningPanelTitle')}>\n              {t('entityPage.notFoundMessage', {\n                kind,\n                link: (\n                  <Link to=\"https://backstage.io/docs/features/software-catalog/references\">\n                    {t('entityPage.notFoundLinkText')}\n                  </Link>\n                ),\n              })}\n            </WarningPanel>\n          )}\n        </Content>\n      )}\n    </Page>\n  );\n};\n\nEntityLayout.Route = Route;\n"],"names":[],"mappings":"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"}

package/dist/alpha/components/EntityTabs/EntityTabs.esm.js

@@ -32,7 +32,7 @@ function useSelectedSubRoute(subRoutes) {
   };
 }
 function EntityTabs(props) {
-  const { routes, groupDefinitions, showIcons } = props;
+  const { routes, groupDefinitions, defaultContentOrder, showIcons } = props;
   const { index, route, element } = useSelectedSubRoute(routes);
   const tabs = useMemo(
     () => routes.map((t) => {
@@ -57,7 +57,8 @@ function EntityTabs(props) {
         tabs,
         selectedIndex: index,
         showIcons,
-        groupDefinitions
+        groupDefinitions,
+        defaultContentOrder
       }
     ),
     /* @__PURE__ */ jsxs(EntityTabsPanel, { children: [

package/dist/alpha/components/EntityTabs/EntityTabs.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"EntityTabs.esm.js","sources":["../../../../src/alpha/components/EntityTabs/EntityTabs.tsx"],"sourcesContent":["/*\n * Copyright 2020 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nimport { ReactElement, useMemo } from 'react';\nimport { Helmet } from 'react-helmet';\nimport { matchRoutes, useParams, useRoutes } from 'react-router-dom';\nimport { EntityTabsPanel } from './EntityTabsPanel';\nimport { EntityTabsList } from './EntityTabsList';\nimport { EntityContentGroupDefinitions } from '@backstage/plugin-catalog-react/alpha';\n\ntype SubRoute = {\n  group?: string;\n  path: string;\n  title: string;\n  icon?: string | ReactElement;\n  children: JSX.Element;\n};\n\nexport function useSelectedSubRoute(subRoutes: SubRoute[]): {\n  index: number;\n  route?: SubRoute;\n  element?: JSX.Element;\n} {\n  const params = useParams();\n\n  const routes = subRoutes.map(({ path, children }) => ({\n    caseSensitive: false,\n    path: `${path}/*`,\n    element: children,\n  }));\n\n  // TODO: remove once react-router updated\n  const sortedRoutes = routes.sort((a, b) =>\n    // remove \"/*\" symbols from path end before comparing\n    b.path.replace(/\\/\\*$/, '').localeCompare(a.path.replace(/\\/\\*$/, '')),\n  );\n\n  const element = useRoutes(sortedRoutes) ?? subRoutes[0]?.children;\n\n  // TODO(Rugvip): Once we only support v6 stable we can always prefix\n  // This avoids having a double / prefix for react-router v6 beta, which in turn breaks\n  // the tab highlighting when using relative paths for the tabs.\n  let currentRoute = params['*'] ?? '';\n  if (!currentRoute.startsWith('/')) {\n    currentRoute = `/${currentRoute}`;\n  }\n\n  const [matchedRoute] = matchRoutes(sortedRoutes, currentRoute) ?? [];\n  const foundIndex = matchedRoute\n    ? subRoutes.findIndex(t => `${t.path}/*` === matchedRoute.route.path)\n    : 0;\n\n  return {\n    index: foundIndex === -1 ? 0 : foundIndex,\n    element,\n    route: subRoutes[foundIndex] ?? subRoutes[0],\n  };\n}\n\ntype EntityTabsProps = {\n  routes: SubRoute[];\n  groupDefinitions: EntityContentGroupDefinitions;\n  showIcons?: boolean;\n};\n\nexport function EntityTabs(props: EntityTabsProps) {\n  const { routes, groupDefinitions, showIcons } = props;\n\n  const { index, route, element } = useSelectedSubRoute(routes);\n\n  const tabs = useMemo(\n    () =>\n      routes.map(t => {\n        const { path, title, group, icon } = t;\n        let to = path;\n        // Remove trailing /*\n        to = to.replace(/\\/\\*$/, '');\n        // And remove leading / for relative navigation\n        to = to.replace(/^\\//, '');\n        return {\n          group,\n          id: path,\n          path: to,\n          label: title,\n          icon,\n        };\n      }),\n    [routes],\n  );\n\n  return (\n    <>\n      <EntityTabsList\n        tabs={tabs}\n        selectedIndex={index}\n        showIcons={showIcons}\n        groupDefinitions={groupDefinitions}\n      />\n      <EntityTabsPanel>\n        <Helmet title={route?.title} />\n        {element}\n      </EntityTabsPanel>\n    </>\n  );\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"EntityTabs.esm.js","sources":["../../../../src/alpha/components/EntityTabs/EntityTabs.tsx"],"sourcesContent":["/*\n * Copyright 2020 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nimport { ReactElement, useMemo } from 'react';\nimport { Helmet } from 'react-helmet';\nimport { matchRoutes, useParams, useRoutes } from 'react-router-dom';\nimport { EntityTabsPanel } from './EntityTabsPanel';\nimport { EntityTabsList } from './EntityTabsList';\nimport { EntityContentGroupDefinitions } from '@backstage/plugin-catalog-react/alpha';\n\ntype SubRoute = {\n  group?: string;\n  path: string;\n  title: string;\n  icon?: string | ReactElement;\n  children: JSX.Element;\n};\n\nexport function useSelectedSubRoute(subRoutes: SubRoute[]): {\n  index: number;\n  route?: SubRoute;\n  element?: JSX.Element;\n} {\n  const params = useParams();\n\n  const routes = subRoutes.map(({ path, children }) => ({\n    caseSensitive: false,\n    path: `${path}/*`,\n    element: children,\n  }));\n\n  // TODO: remove once react-router updated\n  const sortedRoutes = routes.sort((a, b) =>\n    // remove \"/*\" symbols from path end before comparing\n    b.path.replace(/\\/\\*$/, '').localeCompare(a.path.replace(/\\/\\*$/, '')),\n  );\n\n  const element = useRoutes(sortedRoutes) ?? subRoutes[0]?.children;\n\n  // TODO(Rugvip): Once we only support v6 stable we can always prefix\n  // This avoids having a double / prefix for react-router v6 beta, which in turn breaks\n  // the tab highlighting when using relative paths for the tabs.\n  let currentRoute = params['*'] ?? '';\n  if (!currentRoute.startsWith('/')) {\n    currentRoute = `/${currentRoute}`;\n  }\n\n  const [matchedRoute] = matchRoutes(sortedRoutes, currentRoute) ?? [];\n  const foundIndex = matchedRoute\n    ? subRoutes.findIndex(t => `${t.path}/*` === matchedRoute.route.path)\n    : 0;\n\n  return {\n    index: foundIndex === -1 ? 0 : foundIndex,\n    element,\n    route: subRoutes[foundIndex] ?? subRoutes[0],\n  };\n}\n\ntype EntityTabsProps = {\n  routes: SubRoute[];\n  groupDefinitions: EntityContentGroupDefinitions;\n  defaultContentOrder?: 'title' | 'natural';\n  showIcons?: boolean;\n};\n\nexport function EntityTabs(props: EntityTabsProps) {\n  const { routes, groupDefinitions, defaultContentOrder, showIcons } = props;\n\n  const { index, route, element } = useSelectedSubRoute(routes);\n\n  const tabs = useMemo(\n    () =>\n      routes.map(t => {\n        const { path, title, group, icon } = t;\n        let to = path;\n        // Remove trailing /*\n        to = to.replace(/\\/\\*$/, '');\n        // And remove leading / for relative navigation\n        to = to.replace(/^\\//, '');\n        return {\n          group,\n          id: path,\n          path: to,\n          label: title,\n          icon,\n        };\n      }),\n    [routes],\n  );\n\n  return (\n    <>\n      <EntityTabsList\n        tabs={tabs}\n        selectedIndex={index}\n        showIcons={showIcons}\n        groupDefinitions={groupDefinitions}\n        defaultContentOrder={defaultContentOrder}\n      />\n      <EntityTabsPanel>\n        <Helmet title={route?.title} />\n        {element}\n      </EntityTabsPanel>\n    </>\n  );\n}\n"],"names":[],"mappings":"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"}

package/dist/alpha/components/EntityTabs/EntityTabsList.esm.js

@@ -34,14 +34,43 @@ const useStyles = makeStyles(
   }),
   { name: "BackstageHeaderTabs" }
 );
+function resolveGroupId(tabGroup, groupDefinitions, aliasToGroup) {
+  if (!tabGroup) {
+    return void 0;
+  }
+  if (groupDefinitions[tabGroup]) {
+    return tabGroup;
+  }
+  return aliasToGroup[tabGroup];
+}
 function EntityTabsList(props) {
   const styles = useStyles();
   const { t } = useTranslationRef(catalogTranslationRef);
-  const { tabs: items, selectedIndex = 0, showIcons, groupDefinitions } = props;
+  const {
+    tabs: items,
+    selectedIndex = 0,
+    showIcons,
+    groupDefinitions,
+    defaultContentOrder = "title"
+  } = props;
+  const aliasToGroup = useMemo(
+    () => Object.entries(groupDefinitions).reduce((map, [groupId, def]) => {
+      for (const alias of def.aliases ?? []) {
+        map[alias] = groupId;
+      }
+      return map;
+    }, {}),
+    [groupDefinitions]
+  );
   const groups = useMemo(() => {
     const byKey = items.reduce((result, tab) => {
-      const group = tab.group ? groupDefinitions[tab.group] : void 0;
-      const groupOrId = group && tab.group ? tab.group : tab.id;
+      const resolvedGroupId = resolveGroupId(
+        tab.group,
+        groupDefinitions,
+        aliasToGroup
+      );
+      const group = resolvedGroupId ? groupDefinitions[resolvedGroupId] : void 0;
+      const groupOrId = group && resolvedGroupId ? resolvedGroupId : tab.id;
       result[groupOrId] = result[groupOrId] ?? {
         group,
         items: []
@@ -50,7 +79,7 @@ function EntityTabsList(props) {
       return result;
     }, {});
     const groupOrder = Object.keys(groupDefinitions);
-    return Object.entries(byKey).sort(([a], [b]) => {
+    const sorted = Object.entries(byKey).sort(([a], [b]) => {
       const ai = groupOrder.indexOf(a);
       const bi = groupOrder.indexOf(b);
       if (ai !== -1 && bi !== -1) {
@@ -64,8 +93,25 @@ function EntityTabsList(props) {
       }
       return 0;
     });
-  }, [items, groupDefinitions]);
+    for (const [id, tabGroup] of sorted) {
+      const groupDef = groupDefinitions[id];
+      if (groupDef) {
+        const order = groupDef.contentOrder ?? defaultContentOrder;
+        if (order === "title") {
+          tabGroup.items.sort(
+            (a, b) => a.label.localeCompare(b.label, void 0, { sensitivity: "base" })
+          );
+        }
+      }
+    }
+    return sorted;
+  }, [items, groupDefinitions, aliasToGroup, defaultContentOrder]);
   const selectedItem = items[selectedIndex];
+  const selectedGroup = resolveGroupId(
+    selectedItem?.group,
+    groupDefinitions,
+    aliasToGroup
+  );
   return /* @__PURE__ */ jsx(Box, { className: styles.tabsWrapper, children: /* @__PURE__ */ jsx(
     Tabs,
     {
@@ -75,7 +121,7 @@ function EntityTabsList(props) {
       variant: "scrollable",
       scrollButtons: "auto",
       "aria-label": t("entityTabs.tabsAriaLabel"),
-      value: selectedItem?.group ?? selectedItem?.id,
+      value: selectedGroup ?? selectedItem?.id,
       children: groups.map(([id, tabGroup]) => /* @__PURE__ */ jsx(
         EntityTabsGroup,
         {

package/dist/alpha/components/EntityTabs/EntityTabsList.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"EntityTabsList.esm.js","sources":["../../../../src/alpha/components/EntityTabs/EntityTabsList.tsx"],"sourcesContent":["/*\n * Copyright 2025 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { ReactElement, useMemo } from 'react';\nimport Box from '@material-ui/core/Box';\nimport Tabs from '@material-ui/core/Tabs';\nimport { makeStyles } from '@material-ui/core/styles';\nimport { useTranslationRef } from '@backstage/core-plugin-api/alpha';\nimport { EntityContentGroupDefinitions } from '@backstage/plugin-catalog-react/alpha';\n\nimport { EntityTabsGroup } from './EntityTabsGroup';\nimport { catalogTranslationRef } from '../../translation';\n\n/** @public */\nexport type HeaderTabsClassKey =\n  | 'tabsWrapper'\n  | 'defaultTab'\n  | 'selected'\n  | 'tabRoot';\n\nconst useStyles = makeStyles(\n  theme => ({\n    tabsWrapper: {\n      gridArea: 'pageSubheader',\n      backgroundColor: theme.palette.background.paper,\n      paddingLeft: theme.spacing(3),\n      minWidth: 0,\n    },\n    defaultTab: {\n      ...theme.typography.caption,\n      padding: theme.spacing(3, 3),\n      textTransform: 'uppercase',\n      fontWeight: theme.typography.fontWeightBold,\n      color: theme.palette.text.secondary,\n    },\n    selected: {\n      color: theme.palette.text.primary,\n    },\n    tabRoot: {\n      '&:hover': {\n        backgroundColor: theme.palette.background.default,\n        color: theme.palette.text.primary,\n      },\n    },\n  }),\n  { name: 'BackstageHeaderTabs' },\n);\n\ntype Tab = {\n  id: string;\n  label: string;\n  path: string;\n  group?: string;\n  icon?: string | ReactElement;\n};\n\ntype TabGroup = {\n  group?: {\n    title: string;\n    icon?: string | ReactElement;\n  };\n  items: Array<Omit<Tab, 'group'>>;\n};\n\ntype EntityTabsListProps = {\n  tabs: Tab[];\n  groupDefinitions: EntityContentGroupDefinitions;\n  showIcons?: boolean;\n  selectedIndex?: number;\n};\n\nexport function EntityTabsList(props: EntityTabsListProps) {\n  const styles = useStyles();\n  const { t } = useTranslationRef(catalogTranslationRef);\n\n  const { tabs: items, selectedIndex = 0, showIcons, groupDefinitions } = props;\n\n  const groups = useMemo(() => {\n    const byKey = items.reduce((result, tab) => {\n      const group = tab.group ? groupDefinitions[tab.group] : undefined;\n      const groupOrId = group && tab.group ? tab.group : tab.id;\n      result[groupOrId] = result[groupOrId] ?? {\n        group,\n        items: [],\n      };\n      result[groupOrId].items.push(tab);\n      return result;\n    }, {} as Record<string, TabGroup>);\n\n    const groupOrder = Object.keys(groupDefinitions);\n    return Object.entries(byKey).sort(([a], [b]) => {\n      const ai = groupOrder.indexOf(a);\n      const bi = groupOrder.indexOf(b);\n      if (ai !== -1 && bi !== -1) {\n        return ai - bi;\n      }\n      if (ai !== -1) {\n        return -1;\n      }\n      if (bi !== -1) {\n        return 1;\n      }\n      return 0;\n    });\n  }, [items, groupDefinitions]);\n\n  const selectedItem = items[selectedIndex];\n  return (\n    <Box className={styles.tabsWrapper}>\n      <Tabs\n        selectionFollowsFocus\n        indicatorColor=\"primary\"\n        textColor=\"inherit\"\n        variant=\"scrollable\"\n        scrollButtons=\"auto\"\n        aria-label={t('entityTabs.tabsAriaLabel')}\n        value={selectedItem?.group ?? selectedItem?.id}\n      >\n        {groups.map(([id, tabGroup]) => (\n          <EntityTabsGroup\n            data-testid={`header-tab-${id}`}\n            className={styles.defaultTab}\n            classes={{ selected: styles.selected, root: styles.tabRoot }}\n            key={id}\n            label={tabGroup.group?.title}\n            icon={tabGroup.group?.icon}\n            value={id}\n            items={tabGroup.items}\n            highlightedButton={selectedItem?.id}\n            showIcons={showIcons}\n          />\n        ))}\n      </Tabs>\n    </Box>\n  );\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"EntityTabsList.esm.js","sources":["../../../../src/alpha/components/EntityTabs/EntityTabsList.tsx"],"sourcesContent":["/*\n * Copyright 2025 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { ReactElement, useMemo } from 'react';\nimport Box from '@material-ui/core/Box';\nimport Tabs from '@material-ui/core/Tabs';\nimport { makeStyles } from '@material-ui/core/styles';\nimport { useTranslationRef } from '@backstage/core-plugin-api/alpha';\nimport { EntityContentGroupDefinitions } from '@backstage/plugin-catalog-react/alpha';\n\nimport { EntityTabsGroup } from './EntityTabsGroup';\nimport { catalogTranslationRef } from '../../translation';\n\n/** @public */\nexport type HeaderTabsClassKey =\n  | 'tabsWrapper'\n  | 'defaultTab'\n  | 'selected'\n  | 'tabRoot';\n\nconst useStyles = makeStyles(\n  theme => ({\n    tabsWrapper: {\n      gridArea: 'pageSubheader',\n      backgroundColor: theme.palette.background.paper,\n      paddingLeft: theme.spacing(3),\n      minWidth: 0,\n    },\n    defaultTab: {\n      ...theme.typography.caption,\n      padding: theme.spacing(3, 3),\n      textTransform: 'uppercase',\n      fontWeight: theme.typography.fontWeightBold,\n      color: theme.palette.text.secondary,\n    },\n    selected: {\n      color: theme.palette.text.primary,\n    },\n    tabRoot: {\n      '&:hover': {\n        backgroundColor: theme.palette.background.default,\n        color: theme.palette.text.primary,\n      },\n    },\n  }),\n  { name: 'BackstageHeaderTabs' },\n);\n\ntype Tab = {\n  id: string;\n  label: string;\n  path: string;\n  group?: string;\n  icon?: string | ReactElement;\n};\n\ntype TabGroup = {\n  group?: {\n    title: string;\n    icon?: string | ReactElement;\n  };\n  items: Array<Omit<Tab, 'group'>>;\n};\n\ntype EntityTabsListProps = {\n  tabs: Tab[];\n  groupDefinitions: EntityContentGroupDefinitions;\n  defaultContentOrder?: 'title' | 'natural';\n  showIcons?: boolean;\n  selectedIndex?: number;\n};\n\nfunction resolveGroupId(\n  tabGroup: string | undefined,\n  groupDefinitions: EntityContentGroupDefinitions,\n  aliasToGroup: Record<string, string>,\n): string | undefined {\n  if (!tabGroup) {\n    return undefined;\n  }\n  if (groupDefinitions[tabGroup]) {\n    return tabGroup;\n  }\n  return aliasToGroup[tabGroup];\n}\n\nexport function EntityTabsList(props: EntityTabsListProps) {\n  const styles = useStyles();\n  const { t } = useTranslationRef(catalogTranslationRef);\n\n  const {\n    tabs: items,\n    selectedIndex = 0,\n    showIcons,\n    groupDefinitions,\n    defaultContentOrder = 'title',\n  } = props;\n\n  const aliasToGroup = useMemo(\n    () =>\n      Object.entries(groupDefinitions).reduce((map, [groupId, def]) => {\n        for (const alias of def.aliases ?? []) {\n          map[alias] = groupId;\n        }\n        return map;\n      }, {} as Record<string, string>),\n    [groupDefinitions],\n  );\n\n  const groups = useMemo(() => {\n    const byKey = items.reduce((result, tab) => {\n      const resolvedGroupId = resolveGroupId(\n        tab.group,\n        groupDefinitions,\n        aliasToGroup,\n      );\n      const group = resolvedGroupId\n        ? groupDefinitions[resolvedGroupId]\n        : undefined;\n      const groupOrId = group && resolvedGroupId ? resolvedGroupId : tab.id;\n      result[groupOrId] = result[groupOrId] ?? {\n        group,\n        items: [],\n      };\n      result[groupOrId].items.push(tab);\n      return result;\n    }, {} as Record<string, TabGroup>);\n\n    const groupOrder = Object.keys(groupDefinitions);\n    const sorted = Object.entries(byKey).sort(([a], [b]) => {\n      const ai = groupOrder.indexOf(a);\n      const bi = groupOrder.indexOf(b);\n      if (ai !== -1 && bi !== -1) {\n        return ai - bi;\n      }\n      if (ai !== -1) {\n        return -1;\n      }\n      if (bi !== -1) {\n        return 1;\n      }\n      return 0;\n    });\n\n    for (const [id, tabGroup] of sorted) {\n      const groupDef = groupDefinitions[id];\n      if (groupDef) {\n        const order = groupDef.contentOrder ?? defaultContentOrder;\n        if (order === 'title') {\n          tabGroup.items.sort((a, b) =>\n            a.label.localeCompare(b.label, undefined, { sensitivity: 'base' }),\n          );\n        }\n      }\n    }\n\n    return sorted;\n  }, [items, groupDefinitions, aliasToGroup, defaultContentOrder]);\n\n  const selectedItem = items[selectedIndex];\n  const selectedGroup = resolveGroupId(\n    selectedItem?.group,\n    groupDefinitions,\n    aliasToGroup,\n  );\n  return (\n    <Box className={styles.tabsWrapper}>\n      <Tabs\n        selectionFollowsFocus\n        indicatorColor=\"primary\"\n        textColor=\"inherit\"\n        variant=\"scrollable\"\n        scrollButtons=\"auto\"\n        aria-label={t('entityTabs.tabsAriaLabel')}\n        value={selectedGroup ?? selectedItem?.id}\n      >\n        {groups.map(([id, tabGroup]) => (\n          <EntityTabsGroup\n            data-testid={`header-tab-${id}`}\n            className={styles.defaultTab}\n            classes={{ selected: styles.selected, root: styles.tabRoot }}\n            key={id}\n            label={tabGroup.group?.title}\n            icon={tabGroup.group?.icon}\n            value={id}\n            items={tabGroup.items}\n            highlightedButton={selectedItem?.id}\n            showIcons={showIcons}\n          />\n        ))}\n      </Tabs>\n    </Box>\n  );\n}\n"],"names":[],"mappings":"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"}

package/dist/alpha/pages.esm.js

@@ -75,10 +75,13 @@ const catalogEntityPage = PageBlueprint.makeWithOverrides({
           z.string(),
           z.object({
             title: z.string(),
-            icon: z.string().optional()
+            icon: z.string().optional(),
+            aliases: z.array(z.string()).optional(),
+            contentOrder: z.enum(["title", "natural"]).optional()
           })
         )
       ).optional(),
+      defaultContentOrder: (z) => z.enum(["title", "natural"]).optional().default("title"),
       showNavItemIcons: (z) => z.boolean().optional().default(false)
     }
   },
@@ -125,6 +128,7 @@ const catalogEntityPage = PageBlueprint.makeWithOverrides({
               header,
               contextMenuItems: filteredMenuItems,
               groupDefinitions,
+              defaultContentOrder: config.defaultContentOrder,
               showNavItemIcons: config.showNavItemIcons,
               children: inputs.contents.map((output) => /* @__PURE__ */ jsx(
                 EntityLayout.Route,

package/dist/alpha/pages.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"pages.esm.js","sources":["../../src/alpha/pages.tsx"],"sourcesContent":["/*\n * Copyright 2023 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { convertLegacyRouteRef } from '@backstage/core-compat-api';\nimport {\n  coreExtensionData,\n  createExtensionInput,\n  PageBlueprint,\n} from '@backstage/frontend-plugin-api';\nimport {\n  AsyncEntityProvider,\n  entityRouteRef,\n} from '@backstage/plugin-catalog-react';\nimport {\n  defaultEntityContentGroupDefinitions,\n  EntityContentBlueprint,\n  EntityContextMenuItemBlueprint,\n  EntityHeaderBlueprint,\n  EntityContentGroupDefinitions,\n} from '@backstage/plugin-catalog-react/alpha';\nimport CategoryIcon from '@material-ui/icons/Category';\nimport { rootRouteRef } from '../routes';\nimport { useEntityFromUrl } from '../components/CatalogEntityPage/useEntityFromUrl';\nimport { buildFilterFn } from './filter/FilterWrapper';\n\nexport const catalogPage = PageBlueprint.makeWithOverrides({\n  inputs: {\n    filters: createExtensionInput([coreExtensionData.reactElement]),\n  },\n  config: {\n    schema: {\n      pagination: z =>\n        z\n          .union([\n            z.boolean(),\n            z.object({\n              mode: z.enum(['cursor', 'offset']),\n              limit: z.number().optional(),\n              offset: z.number().optional(),\n            }),\n          ])\n          .default(true),\n    },\n  },\n  factory(originalFactory, { inputs, config }) {\n    return originalFactory({\n      path: '/catalog',\n      routeRef: rootRouteRef,\n      icon: <CategoryIcon />,\n      title: 'Catalog',\n      loader: async () => {\n        const { BaseCatalogPage } = await import('../components/CatalogPage');\n        const filters = inputs.filters.map(filter =>\n          filter.get(coreExtensionData.reactElement),\n        );\n        return (\n          <BaseCatalogPage\n            filters={<>{filters}</>}\n            pagination={config.pagination}\n          />\n        );\n      },\n    });\n  },\n});\n\nexport const catalogEntityPage = PageBlueprint.makeWithOverrides({\n  name: 'entity',\n  inputs: {\n    headers: createExtensionInput([\n      EntityHeaderBlueprint.dataRefs.element.optional(),\n      EntityHeaderBlueprint.dataRefs.filterFunction.optional(),\n    ]),\n    contents: createExtensionInput([\n      coreExtensionData.reactElement,\n      coreExtensionData.routePath,\n      coreExtensionData.routeRef.optional(),\n      EntityContentBlueprint.dataRefs.title,\n      EntityContentBlueprint.dataRefs.filterFunction.optional(),\n      EntityContentBlueprint.dataRefs.filterExpression.optional(),\n      EntityContentBlueprint.dataRefs.group.optional(),\n      EntityContentBlueprint.dataRefs.icon.optional(),\n    ]),\n    contextMenuItems: createExtensionInput([\n      coreExtensionData.reactElement,\n      EntityContextMenuItemBlueprint.dataRefs.filterFunction.optional(),\n    ]),\n  },\n  config: {\n    schema: {\n      groups: z =>\n        z\n          .array(\n            z.record(\n              z.string(),\n              z.object({\n                title: z.string(),\n                icon: z.string().optional(),\n              }),\n            ),\n          )\n          .optional(),\n      showNavItemIcons: z => z.boolean().optional().default(false),\n    },\n  },\n  factory(originalFactory, { config, inputs }) {\n    return originalFactory({\n      path: '/catalog/:namespace/:kind/:name',\n      title: 'Catalog Entity',\n      // NOTE: The `convertLegacyRouteRef` call here ensures that this route ref\n      // is mutated to support the new frontend system. Removing this conversion\n      // is a potentially breaking change since this is a singleton and the\n      // route refs from `core-plugin-api` used to not support the new format.\n      // This shouldn't be removed until we completely deprecate the\n      // `core-compat-api` package.\n      routeRef: convertLegacyRouteRef(entityRouteRef), // READ THE ABOVE\n      loader: async () => {\n        const { EntityLayout } = await import('./components/EntityLayout');\n\n        const menuItems = inputs.contextMenuItems.map(item => ({\n          element: item.get(coreExtensionData.reactElement),\n          filter:\n            item.get(EntityContextMenuItemBlueprint.dataRefs.filterFunction) ??\n            (() => true),\n        }));\n\n        // Get available headers, sorted by if they have a filter function or not.\n        // TODO(blam): we should really have priority or some specificity here which can be used to sort the headers.\n        // That can be done with embedding the priority in the dataRef alongside the filter function.\n        const headers = inputs.headers\n          .map(header => ({\n            element: header.get(EntityHeaderBlueprint.dataRefs.element),\n            filter: header.get(EntityHeaderBlueprint.dataRefs.filterFunction),\n          }))\n          .sort((a, b) => {\n            if (a.filter && !b.filter) return -1;\n            if (!a.filter && b.filter) return 1;\n            return 0;\n          });\n\n        const groupDefinitions =\n          config.groups?.reduce(\n            (rest, group) => ({ ...rest, ...group }),\n            {} as EntityContentGroupDefinitions,\n          ) ?? defaultEntityContentGroupDefinitions;\n\n        const Component = () => {\n          const entityFromUrl = useEntityFromUrl();\n          const { entity } = entityFromUrl;\n          const filteredMenuItems = entity\n            ? menuItems.filter(i => i.filter(entity)).map(i => i.element)\n            : [];\n\n          const header = headers.find(\n            h => !h.filter || h.filter(entity!),\n          )?.element;\n\n          return (\n            <AsyncEntityProvider {...entityFromUrl}>\n              <EntityLayout\n                header={header}\n                contextMenuItems={filteredMenuItems}\n                groupDefinitions={groupDefinitions}\n                showNavItemIcons={config.showNavItemIcons}\n              >\n                {inputs.contents.map(output => (\n                  <EntityLayout.Route\n                    group={output.get(EntityContentBlueprint.dataRefs.group)}\n                    key={output.get(coreExtensionData.routePath)}\n                    path={output.get(coreExtensionData.routePath)}\n                    title={output.get(EntityContentBlueprint.dataRefs.title)}\n                    icon={output.get(EntityContentBlueprint.dataRefs.icon)}\n                    if={buildFilterFn(\n                      output.get(\n                        EntityContentBlueprint.dataRefs.filterFunction,\n                      ),\n                      output.get(\n                        EntityContentBlueprint.dataRefs.filterExpression,\n                      ),\n                    )}\n                  >\n                    {output.get(coreExtensionData.reactElement)}\n                  </EntityLayout.Route>\n                ))}\n              </EntityLayout>\n            </AsyncEntityProvider>\n          );\n        };\n\n        return <Component />;\n      },\n    });\n  },\n});\n\nexport default [catalogPage, catalogEntityPage];\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"pages.esm.js","sources":["../../src/alpha/pages.tsx"],"sourcesContent":["/*\n * Copyright 2023 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { convertLegacyRouteRef } from '@backstage/core-compat-api';\nimport {\n  coreExtensionData,\n  createExtensionInput,\n  PageBlueprint,\n} from '@backstage/frontend-plugin-api';\nimport {\n  AsyncEntityProvider,\n  entityRouteRef,\n} from '@backstage/plugin-catalog-react';\nimport {\n  defaultEntityContentGroupDefinitions,\n  EntityContentBlueprint,\n  EntityContextMenuItemBlueprint,\n  EntityHeaderBlueprint,\n  EntityContentGroupDefinitions,\n} from '@backstage/plugin-catalog-react/alpha';\nimport CategoryIcon from '@material-ui/icons/Category';\nimport { rootRouteRef } from '../routes';\nimport { useEntityFromUrl } from '../components/CatalogEntityPage/useEntityFromUrl';\nimport { buildFilterFn } from './filter/FilterWrapper';\n\nexport const catalogPage = PageBlueprint.makeWithOverrides({\n  inputs: {\n    filters: createExtensionInput([coreExtensionData.reactElement]),\n  },\n  config: {\n    schema: {\n      pagination: z =>\n        z\n          .union([\n            z.boolean(),\n            z.object({\n              mode: z.enum(['cursor', 'offset']),\n              limit: z.number().optional(),\n              offset: z.number().optional(),\n            }),\n          ])\n          .default(true),\n    },\n  },\n  factory(originalFactory, { inputs, config }) {\n    return originalFactory({\n      path: '/catalog',\n      routeRef: rootRouteRef,\n      icon: <CategoryIcon />,\n      title: 'Catalog',\n      loader: async () => {\n        const { BaseCatalogPage } = await import('../components/CatalogPage');\n        const filters = inputs.filters.map(filter =>\n          filter.get(coreExtensionData.reactElement),\n        );\n        return (\n          <BaseCatalogPage\n            filters={<>{filters}</>}\n            pagination={config.pagination}\n          />\n        );\n      },\n    });\n  },\n});\n\nexport const catalogEntityPage = PageBlueprint.makeWithOverrides({\n  name: 'entity',\n  inputs: {\n    headers: createExtensionInput([\n      EntityHeaderBlueprint.dataRefs.element.optional(),\n      EntityHeaderBlueprint.dataRefs.filterFunction.optional(),\n    ]),\n    contents: createExtensionInput([\n      coreExtensionData.reactElement,\n      coreExtensionData.routePath,\n      coreExtensionData.routeRef.optional(),\n      EntityContentBlueprint.dataRefs.title,\n      EntityContentBlueprint.dataRefs.filterFunction.optional(),\n      EntityContentBlueprint.dataRefs.filterExpression.optional(),\n      EntityContentBlueprint.dataRefs.group.optional(),\n      EntityContentBlueprint.dataRefs.icon.optional(),\n    ]),\n    contextMenuItems: createExtensionInput([\n      coreExtensionData.reactElement,\n      EntityContextMenuItemBlueprint.dataRefs.filterFunction.optional(),\n    ]),\n  },\n  config: {\n    schema: {\n      groups: z =>\n        z\n          .array(\n            z.record(\n              z.string(),\n              z.object({\n                title: z.string(),\n                icon: z.string().optional(),\n                aliases: z.array(z.string()).optional(),\n                contentOrder: z.enum(['title', 'natural']).optional(),\n              }),\n            ),\n          )\n          .optional(),\n      defaultContentOrder: z =>\n        z.enum(['title', 'natural']).optional().default('title'),\n      showNavItemIcons: z => z.boolean().optional().default(false),\n    },\n  },\n  factory(originalFactory, { config, inputs }) {\n    return originalFactory({\n      path: '/catalog/:namespace/:kind/:name',\n      title: 'Catalog Entity',\n      // NOTE: The `convertLegacyRouteRef` call here ensures that this route ref\n      // is mutated to support the new frontend system. Removing this conversion\n      // is a potentially breaking change since this is a singleton and the\n      // route refs from `core-plugin-api` used to not support the new format.\n      // This shouldn't be removed until we completely deprecate the\n      // `core-compat-api` package.\n      routeRef: convertLegacyRouteRef(entityRouteRef), // READ THE ABOVE\n      loader: async () => {\n        const { EntityLayout } = await import('./components/EntityLayout');\n\n        const menuItems = inputs.contextMenuItems.map(item => ({\n          element: item.get(coreExtensionData.reactElement),\n          filter:\n            item.get(EntityContextMenuItemBlueprint.dataRefs.filterFunction) ??\n            (() => true),\n        }));\n\n        // Get available headers, sorted by if they have a filter function or not.\n        // TODO(blam): we should really have priority or some specificity here which can be used to sort the headers.\n        // That can be done with embedding the priority in the dataRef alongside the filter function.\n        const headers = inputs.headers\n          .map(header => ({\n            element: header.get(EntityHeaderBlueprint.dataRefs.element),\n            filter: header.get(EntityHeaderBlueprint.dataRefs.filterFunction),\n          }))\n          .sort((a, b) => {\n            if (a.filter && !b.filter) return -1;\n            if (!a.filter && b.filter) return 1;\n            return 0;\n          });\n\n        const groupDefinitions =\n          config.groups?.reduce(\n            (rest, group) => ({ ...rest, ...group }),\n            {} as EntityContentGroupDefinitions,\n          ) ?? defaultEntityContentGroupDefinitions;\n\n        const Component = () => {\n          const entityFromUrl = useEntityFromUrl();\n          const { entity } = entityFromUrl;\n          const filteredMenuItems = entity\n            ? menuItems.filter(i => i.filter(entity)).map(i => i.element)\n            : [];\n\n          const header = headers.find(\n            h => !h.filter || h.filter(entity!),\n          )?.element;\n\n          return (\n            <AsyncEntityProvider {...entityFromUrl}>\n              <EntityLayout\n                header={header}\n                contextMenuItems={filteredMenuItems}\n                groupDefinitions={groupDefinitions}\n                defaultContentOrder={config.defaultContentOrder}\n                showNavItemIcons={config.showNavItemIcons}\n              >\n                {inputs.contents.map(output => (\n                  <EntityLayout.Route\n                    group={output.get(EntityContentBlueprint.dataRefs.group)}\n                    key={output.get(coreExtensionData.routePath)}\n                    path={output.get(coreExtensionData.routePath)}\n                    title={output.get(EntityContentBlueprint.dataRefs.title)}\n                    icon={output.get(EntityContentBlueprint.dataRefs.icon)}\n                    if={buildFilterFn(\n                      output.get(\n                        EntityContentBlueprint.dataRefs.filterFunction,\n                      ),\n                      output.get(\n                        EntityContentBlueprint.dataRefs.filterExpression,\n                      ),\n                    )}\n                  >\n                    {output.get(coreExtensionData.reactElement)}\n                  </EntityLayout.Route>\n                ))}\n              </EntityLayout>\n            </AsyncEntityProvider>\n          );\n        };\n\n        return <Component />;\n      },\n    });\n  },\n});\n\nexport default [catalogPage, catalogEntityPage];\n"],"names":[],"mappings":"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"}

package/dist/alpha.d.ts

@@ -625,7 +625,10 @@ declare const _default: _backstage_frontend_plugin_api.OverridableFrontendPlugin
             groups: Record<string, {
                 title: string;
                 icon?: string | undefined;
+                aliases?: string[] | undefined;
+                contentOrder?: "title" | "natural" | undefined;
             }>[] | undefined;
+            defaultContentOrder: "title" | "natural";
             showNavItemIcons: boolean;
             path: string | undefined;
             title: string | undefined;
@@ -634,7 +637,10 @@ declare const _default: _backstage_frontend_plugin_api.OverridableFrontendPlugin
             groups?: Record<string, {
                 title: string;
                 icon?: string | undefined;
+                aliases?: string[] | undefined;
+                contentOrder?: "title" | "natural" | undefined;
             }>[] | undefined;
+            defaultContentOrder?: "title" | "natural" | undefined;
             showNavItemIcons?: boolean | undefined;
             title?: string | undefined;
             path?: string | undefined;

package/dist/package.json.esm.js

@@ -1,5 +1,5 @@
 var name = "@backstage/plugin-catalog";
-var version = "1.33.1";
+var version = "1.34.0-next.1";
 var description = "The Backstage plugin for browsing the Backstage catalog";
 var backstage = {
 	role: "frontend-plugin",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backstage/plugin-catalog",
-  "version": "1.33.1",
+  "version": "1.34.0-next.1",
   "description": "The Backstage plugin for browsing the Backstage catalog",
   "backstage": {
     "role": "frontend-plugin",
@@ -70,25 +70,25 @@
     "test": "backstage-cli package test"
   },
   "dependencies": {
-    "@backstage/catalog-client": "^1.13.0",
-    "@backstage/catalog-model": "^1.7.6",
-    "@backstage/core-compat-api": "^0.5.8",
-    "@backstage/core-components": "^0.18.7",
-    "@backstage/core-plugin-api": "^1.12.3",
-    "@backstage/errors": "^1.2.7",
-    "@backstage/frontend-plugin-api": "^0.14.1",
-    "@backstage/integration-react": "^1.2.15",
-    "@backstage/plugin-catalog-common": "^1.1.8",
-    "@backstage/plugin-catalog-react": "^2.0.0",
-    "@backstage/plugin-permission-react": "^0.4.40",
-    "@backstage/plugin-scaffolder-common": "^1.7.6",
-    "@backstage/plugin-search-common": "^1.2.22",
-    "@backstage/plugin-search-react": "^1.10.4",
-    "@backstage/plugin-techdocs-common": "^0.1.1",
-    "@backstage/plugin-techdocs-react": "^1.3.8",
-    "@backstage/types": "^1.2.2",
-    "@backstage/ui": "^0.12.0",
-    "@backstage/version-bridge": "^1.0.12",
+    "@backstage/catalog-client": "1.14.0-next.1",
+    "@backstage/catalog-model": "1.7.6",
+    "@backstage/core-compat-api": "0.5.9-next.1",
+    "@backstage/core-components": "0.18.8-next.0",
+    "@backstage/core-plugin-api": "1.12.4-next.0",
+    "@backstage/errors": "1.2.7",
+    "@backstage/frontend-plugin-api": "0.14.2-next.0",
+    "@backstage/integration-react": "1.2.16-next.1",
+    "@backstage/plugin-catalog-common": "1.1.8",
+    "@backstage/plugin-catalog-react": "2.1.0-next.1",
+    "@backstage/plugin-permission-react": "0.4.41-next.0",
+    "@backstage/plugin-scaffolder-common": "2.0.0-next.1",
+    "@backstage/plugin-search-common": "1.2.22",
+    "@backstage/plugin-search-react": "1.10.5-next.0",
+    "@backstage/plugin-techdocs-common": "0.1.1",
+    "@backstage/plugin-techdocs-react": "1.3.9-next.0",
+    "@backstage/types": "1.2.2",
+    "@backstage/ui": "0.13.0-next.1",
+    "@backstage/version-bridge": "1.0.12",
     "@material-ui/core": "^4.12.2",
     "@material-ui/icons": "^4.9.1",
     "@material-ui/lab": "4.0.0-alpha.61",
@@ -103,12 +103,12 @@
     "zen-observable": "^0.10.0"
   },
   "devDependencies": {
-    "@backstage/cli": "^0.35.4",
-    "@backstage/core-app-api": "^1.19.5",
-    "@backstage/dev-utils": "^1.1.20",
-    "@backstage/frontend-test-utils": "^0.5.0",
-    "@backstage/plugin-permission-common": "^0.9.6",
-    "@backstage/test-utils": "^1.7.15",
+    "@backstage/cli": "0.36.0-next.1",
+    "@backstage/core-app-api": "1.19.6-next.0",
+    "@backstage/dev-utils": "1.1.21-next.1",
+    "@backstage/frontend-test-utils": "0.5.1-next.1",
+    "@backstage/plugin-permission-common": "0.9.6",
+    "@backstage/test-utils": "1.7.16-next.0",
     "@testing-library/dom": "^10.0.0",
     "@testing-library/jest-dom": "^6.0.0",
     "@testing-library/react": "^16.0.0",