@backstage/plugin-catalog 0.8.0 → 0.10.0-next.0

package/CHANGELOG.md

@@ -1,5 +1,78 @@
 # @backstage/plugin-catalog
 
+## 0.10.0-next.0
+
+### Minor Changes
+
+- 51856359bf: **BREAKING**: Removed the `AboutCard` component which has been replaced by `EntityAboutCard`.
+- 5ea9509e6a: **BREAKING**: Removed `CatalogResultListItemProps` and `CatalogResultListItem`, replaced by `CatalogSearchResultListItemProps` and `CatalogSearchResultListItem`.
+
+### Patch Changes
+
+- 251688a75e: Updated `CatalogKindHeader` to respond to external changes to query parameters in the URL, such as two sidebar links that apply different catalog filters.
+- 9844d4d2bd: Removed usage of removed hook.
+- 3e54f6c436: Use `@backstage/plugin-search-common` package instead of `@backstage/search-common`.
+- Updated dependencies
+  - @backstage/plugin-catalog-react@0.9.0-next.0
+  - @backstage/core-components@0.9.1-next.0
+  - @backstage/catalog-model@0.13.0-next.0
+  - @backstage/plugin-catalog-common@0.2.2-next.0
+  - @backstage/plugin-search-common@0.3.1-next.0
+  - @backstage/catalog-client@0.9.0-next.0
+  - @backstage/integration-react@0.1.25-next.0
+
+## 0.9.1
+
+### Patch Changes
+
+- 899f196af5: Use `getEntityByRef` instead of `getEntityByName` in the catalog client
+- f41a293231: - **DEPRECATION**: Deprecated `formatEntityRefTitle` in favor of the new `humanizeEntityRef` method instead. Please migrate to using the new method instead.
+- f590d1681b: Removed usage of deprecated favorite utility methods.
+- 44403296e7: Added the following deprecations to the `catalog-react` package:
+
+  - **DEPRECATION**: `useEntity` will now warn if the entity has not yet been loaded, and will soon throw errors instead. If you're using the default implementation of `EntityLayout` and `EntitySwitch` then these components will ensure that there is an entity loaded before rendering children. If you're implementing your own `EntityLayout` or `EntitySwitch` or something that operates outside or adjacent to them, then use `useAsyncEntity`.
+
+  - **DEPRECATION**: the `loading`, `error` and `refresh` properties that are returned from `useEntity` have been deprecated, and are available on `useAsyncEntity` instead.
+
+- da79aac2a6: - Replaced usage of the deprecated and now removed `rootRoute` and `catalogRouteRef`s from the `catalog-react` package
+- 36aa63022b: Use `CompoundEntityRef` instead of `EntityName`, and `getCompoundEntityRef` instead of `getEntityName`, from `@backstage/catalog-model`.
+- 8f0e8e039b: Removed usage of deprecated `getEntityMetadataViewUrl` and `getEntityMetadataEditUrl` helpers.
+- Updated dependencies
+  - @backstage/catalog-model@0.12.0
+  - @backstage/catalog-client@0.8.0
+  - @backstage/core-components@0.9.0
+  - @backstage/plugin-catalog-react@0.8.0
+  - @backstage/plugin-catalog-common@0.2.0
+  - @backstage/core-plugin-api@0.8.0
+  - @backstage/search-common@0.3.0
+  - @backstage/integration-react@0.1.24
+
+## 0.9.0
+
+### Minor Changes
+
+- e7b9c3d713: Removed `columnFactories`, which was accidentally exported on the previous release.
+- 2262fe19c9: **BREAKING**: Removed support for passing in an explicit `entity` prop to entity page extensions, which has been deprecated for a long time. This is only a breaking change at the TypeScript level, as this property was already ignored.
+- 3c4376e5e7: **BREAKING**: Removed the old `plugin` export, use `catalogPlugin` instead.
+
+### Patch Changes
+
+- 2d339b5f2c: Internalize deprecated `useEntityFromUrl` hook
+- a686702dbe: Renamed `CatalogResultListItem` to `CatalogSearchResultListItem` along with its prop type, leaving the old names in place as a deprecations.
+- 852d5ff758: Added `EntitySwitchProps` type for `EntitySwitch`.
+- a8331830f1: Remove use of deprecated `useEntityKinds` hook.
+- 6e1cbc12a6: Updated according to the new `getEntityFacets` catalog API method
+- b776ce5aab: Replaced use of deprecated `useEntityListProvider` hook with `useEntityList`.
+- 3334ad47d4: Removed usage of `EntityContext`.
+- 919cf2f836: Minor updates to match the new `targetRef` field of relations, and to stop consuming the `target` field
+- Updated dependencies
+  - @backstage/core-components@0.8.10
+  - @backstage/plugin-catalog-react@0.7.0
+  - @backstage/catalog-model@0.11.0
+  - @backstage/catalog-client@0.7.2
+  - @backstage/core-plugin-api@0.7.0
+  - @backstage/integration-react@0.1.23
+
 ## 0.8.0
 
 ### Minor Changes

package/dist/esm/{index-5c367aca.esm.js → index-142ea58f.esm.js}

@@ -3,24 +3,27 @@ import { useOutlet } from 'react-router';
 import { PageWithHeader, Content, ContentHeader, CreateButton, SupportButton } from '@backstage/core-components';
 import { useApi, configApiRef, useRouteRef } from '@backstage/core-plugin-api';
 import { EntityListProvider, EntityTypePicker, UserListPicker, EntityOwnerPicker, EntityLifecyclePicker, EntityTagPicker } from '@backstage/plugin-catalog-react';
-import { c as createComponentRouteRef, C as CatalogKindHeader, F as FilteredEntityLayout, a as FilterContainer, E as EntityListContainer, b as CatalogTable } from './index-de01f9dd.esm.js';
+import { c as createComponentRouteRef, C as CatalogKindHeader, F as FilteredEntityLayout, a as FilterContainer, E as EntityListContainer, b as CatalogTable } from './index-24c3e4e1.esm.js';
+import 'zen-observable';
 import '@backstage/catalog-model';
+import 'lodash';
 import '@backstage/integration-react';
 import '@material-ui/core';
 import '@material-ui/icons/Cached';
 import '@material-ui/icons/Description';
 import '@material-ui/icons/Edit';
+import 'react-use/lib/useAsync';
 import '@material-ui/icons/OpenInNew';
-import 'lodash';
-import '@material-ui/lab';
+import '@material-ui/icons/StarBorder';
 import '@material-ui/core/styles';
+import '@material-ui/icons/Star';
+import '@material-ui/lab';
 import '@material-ui/icons/Cancel';
 import '@material-ui/icons/BugReport';
 import '@material-ui/icons/MoreVert';
 import '@backstage/plugin-catalog-common';
 import '@backstage/errors';
 import '@backstage/catalog-client';
-import 'react-use/lib/useAsync';
 import '@material-ui/icons/FilterList';
 
 function DefaultCatalogPage(props) {
@@ -52,4 +55,4 @@ function CatalogPage(props) {
 }
 
 export { CatalogPage, DefaultCatalogPage };
-//# sourceMappingURL=index-5c367aca.esm.js.map
+//# sourceMappingURL=index-142ea58f.esm.js.map

package/dist/esm/{index-5c367aca.esm.js.map → index-142ea58f.esm.js.map}

@@ -1 +1 @@
-{"version":3,"file":"index-5c367aca.esm.js","sources":["../../src/components/CatalogPage/DefaultCatalogPage.tsx","../../src/components/CatalogPage/CatalogPage.tsx"],"sourcesContent":["/*\n * Copyright 2021 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 {\n  Content,\n  ContentHeader,\n  CreateButton,\n  PageWithHeader,\n  SupportButton,\n  TableColumn,\n  TableProps,\n} from '@backstage/core-components';\nimport { configApiRef, useApi, useRouteRef } from '@backstage/core-plugin-api';\nimport {\n  EntityLifecyclePicker,\n  EntityListProvider,\n  EntityOwnerPicker,\n  EntityTagPicker,\n  EntityTypePicker,\n  UserListFilterKind,\n  UserListPicker,\n} from '@backstage/plugin-catalog-react';\nimport React from 'react';\nimport { createComponentRouteRef } from '../../routes';\nimport { CatalogTable, CatalogTableRow } from '../CatalogTable';\nimport {\n  FilteredEntityLayout,\n  EntityListContainer,\n  FilterContainer,\n} from '../FilteredEntityLayout';\nimport { CatalogKindHeader } from '../CatalogKindHeader';\n\n/**\n * Props for root catalog pages.\n *\n * @public\n */\nexport interface DefaultCatalogPageProps {\n  initiallySelectedFilter?: UserListFilterKind;\n  columns?: TableColumn<CatalogTableRow>[];\n  actions?: TableProps<CatalogTableRow>['actions'];\n}\n\nexport function DefaultCatalogPage(props: DefaultCatalogPageProps) {\n  const { columns, actions, initiallySelectedFilter = 'owned' } = props;\n  const orgName =\n    useApi(configApiRef).getOptionalString('organization.name') ?? 'Backstage';\n  const createComponentLink = useRouteRef(createComponentRouteRef);\n\n  return (\n    <PageWithHeader title={`${orgName} Catalog`} themeId=\"home\">\n      <EntityListProvider>\n        <Content>\n          <ContentHeader titleComponent={<CatalogKindHeader />}>\n            <CreateButton\n              title=\"Create Component\"\n              to={createComponentLink && createComponentLink()}\n            />\n            <SupportButton>All your software catalog entities</SupportButton>\n          </ContentHeader>\n          <FilteredEntityLayout>\n            <FilterContainer>\n              <EntityTypePicker />\n              <UserListPicker initialFilter={initiallySelectedFilter} />\n              <EntityOwnerPicker />\n              <EntityLifecyclePicker />\n              <EntityTagPicker />\n            </FilterContainer>\n            <EntityListContainer>\n              <CatalogTable columns={columns} actions={actions} />\n            </EntityListContainer>\n          </FilteredEntityLayout>\n        </Content>\n      </EntityListProvider>\n    </PageWithHeader>\n  );\n}\n","/*\n * Copyright 2021 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 React from 'react';\nimport { useOutlet } from 'react-router';\nimport {\n  DefaultCatalogPage,\n  DefaultCatalogPageProps,\n} from './DefaultCatalogPage';\n\nexport function CatalogPage(props: DefaultCatalogPageProps) {\n  const outlet = useOutlet();\n\n  return outlet || <DefaultCatalogPage {...props} />;\n}\n"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;4BAwDmC,OAAgC;AAxDnE;AAyDE,QAAM,EAAE,SAAS,SAAS,0BAA0B,YAAY;AAChE,QAAM,UACJ,aAAO,cAAc,kBAAkB,yBAAvC,YAA+D;AACjE,QAAM,sBAAsB,YAAY;AAExC,6CACG,gBAAD;AAAA,IAAgB,OAAO,GAAG;AAAA,IAAmB,SAAQ;AAAA,yCAClD,oBAAD,0CACG,SAAD,0CACG,eAAD;AAAA,IAAe,oDAAiB,mBAAD;AAAA,yCAC5B,cAAD;AAAA,IACE,OAAM;AAAA,IACN,IAAI,uBAAuB;AAAA,0CAE5B,eAAD,MAAe,4EAEhB,sBAAD,0CACG,iBAAD,0CACG,kBAAD,2CACC,gBAAD;AAAA,IAAgB,eAAe;AAAA,0CAC9B,mBAAD,2CACC,uBAAD,2CACC,iBAAD,4CAED,qBAAD,0CACG,cAAD;AAAA,IAAc;AAAA,IAAkB;AAAA;AAAA;;qBC3DlB,OAAgC;AAC1D,QAAM,SAAS;AAEf,SAAO,8CAAW,oBAAD;AAAA,OAAwB;AAAA;AAAA;;;;"}
+{"version":3,"file":"index-142ea58f.esm.js","sources":["../../src/components/CatalogPage/DefaultCatalogPage.tsx","../../src/components/CatalogPage/CatalogPage.tsx"],"sourcesContent":["/*\n * Copyright 2021 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 {\n  Content,\n  ContentHeader,\n  CreateButton,\n  PageWithHeader,\n  SupportButton,\n  TableColumn,\n  TableProps,\n} from '@backstage/core-components';\nimport { configApiRef, useApi, useRouteRef } from '@backstage/core-plugin-api';\nimport {\n  EntityLifecyclePicker,\n  EntityListProvider,\n  EntityOwnerPicker,\n  EntityTagPicker,\n  EntityTypePicker,\n  UserListFilterKind,\n  UserListPicker,\n} from '@backstage/plugin-catalog-react';\nimport React from 'react';\nimport { createComponentRouteRef } from '../../routes';\nimport { CatalogTable, CatalogTableRow } from '../CatalogTable';\nimport {\n  FilteredEntityLayout,\n  EntityListContainer,\n  FilterContainer,\n} from '../FilteredEntityLayout';\nimport { CatalogKindHeader } from '../CatalogKindHeader';\n\n/**\n * Props for root catalog pages.\n *\n * @public\n */\nexport interface DefaultCatalogPageProps {\n  initiallySelectedFilter?: UserListFilterKind;\n  columns?: TableColumn<CatalogTableRow>[];\n  actions?: TableProps<CatalogTableRow>['actions'];\n}\n\nexport function DefaultCatalogPage(props: DefaultCatalogPageProps) {\n  const { columns, actions, initiallySelectedFilter = 'owned' } = props;\n  const orgName =\n    useApi(configApiRef).getOptionalString('organization.name') ?? 'Backstage';\n  const createComponentLink = useRouteRef(createComponentRouteRef);\n\n  return (\n    <PageWithHeader title={`${orgName} Catalog`} themeId=\"home\">\n      <EntityListProvider>\n        <Content>\n          <ContentHeader titleComponent={<CatalogKindHeader />}>\n            <CreateButton\n              title=\"Create Component\"\n              to={createComponentLink && createComponentLink()}\n            />\n            <SupportButton>All your software catalog entities</SupportButton>\n          </ContentHeader>\n          <FilteredEntityLayout>\n            <FilterContainer>\n              <EntityTypePicker />\n              <UserListPicker initialFilter={initiallySelectedFilter} />\n              <EntityOwnerPicker />\n              <EntityLifecyclePicker />\n              <EntityTagPicker />\n            </FilterContainer>\n            <EntityListContainer>\n              <CatalogTable columns={columns} actions={actions} />\n            </EntityListContainer>\n          </FilteredEntityLayout>\n        </Content>\n      </EntityListProvider>\n    </PageWithHeader>\n  );\n}\n","/*\n * Copyright 2021 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 React from 'react';\nimport { useOutlet } from 'react-router';\nimport {\n  DefaultCatalogPage,\n  DefaultCatalogPageProps,\n} from './DefaultCatalogPage';\n\nexport function CatalogPage(props: DefaultCatalogPageProps) {\n  const outlet = useOutlet();\n\n  return outlet || <DefaultCatalogPage {...props} />;\n}\n"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;4BAwDmC,OAAgC;AAxDnE;AAyDE,QAAM,EAAE,SAAS,SAAS,0BAA0B,YAAY;AAChE,QAAM,UACJ,aAAO,cAAc,kBAAkB,yBAAvC,YAA+D;AACjE,QAAM,sBAAsB,YAAY;AAExC,6CACG,gBAAD;AAAA,IAAgB,OAAO,GAAG;AAAA,IAAmB,SAAQ;AAAA,yCAClD,oBAAD,0CACG,SAAD,0CACG,eAAD;AAAA,IAAe,oDAAiB,mBAAD;AAAA,yCAC5B,cAAD;AAAA,IACE,OAAM;AAAA,IACN,IAAI,uBAAuB;AAAA,0CAE5B,eAAD,MAAe,4EAEhB,sBAAD,0CACG,iBAAD,0CACG,kBAAD,2CACC,gBAAD;AAAA,IAAgB,eAAe;AAAA,0CAC9B,mBAAD,2CACC,uBAAD,2CACC,iBAAD,4CAED,qBAAD,0CACG,cAAD;AAAA,IAAc;AAAA,IAAkB;AAAA;AAAA;;qBC3DlB,OAAgC;AAC1D,QAAM,SAAS;AAEf,SAAO,8CAAW,oBAAD;AAAA,OAAwB;AAAA;AAAA;;;;"}

package/dist/esm/{index-36e4660a.esm.js → index-19e9c476.esm.js}

@@ -1,5 +1,7 @@
-export { A as AboutCard, d as AboutContent, e as AboutField } from './index-de01f9dd.esm.js';
+export { A as AboutCard, d as AboutContent, e as AboutField } from './index-24c3e4e1.esm.js';
+import 'zen-observable';
 import '@backstage/catalog-model';
+import 'lodash';
 import '@backstage/core-components';
 import '@backstage/core-plugin-api';
 import '@backstage/integration-react';
@@ -9,17 +11,18 @@ import '@material-ui/icons/Cached';
 import '@material-ui/icons/Description';
 import '@material-ui/icons/Edit';
 import 'react';
+import 'react-use/lib/useAsync';
 import '@material-ui/icons/OpenInNew';
-import 'lodash';
+import '@material-ui/icons/StarBorder';
+import '@material-ui/core/styles';
+import '@material-ui/icons/Star';
 import '@material-ui/lab';
 import 'react-router';
-import '@material-ui/core/styles';
 import '@material-ui/icons/Cancel';
 import '@material-ui/icons/BugReport';
 import '@material-ui/icons/MoreVert';
 import '@backstage/plugin-catalog-common';
 import '@backstage/errors';
 import '@backstage/catalog-client';
-import 'react-use/lib/useAsync';
 import '@material-ui/icons/FilterList';
-//# sourceMappingURL=index-36e4660a.esm.js.map
+//# sourceMappingURL=index-19e9c476.esm.js.map

package/dist/esm/index-19e9c476.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-19e9c476.esm.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/esm/{index-de01f9dd.esm.js → index-24c3e4e1.esm.js}

@@ -1,27 +1,86 @@
-import { RELATION_PART_OF, RELATION_OWNED_BY, DEFAULT_NAMESPACE, ANNOTATION_LOCATION, stringifyEntityRef } from '@backstage/catalog-model';
+import ObservableImpl from 'zen-observable';
+import { stringifyEntityRef, RELATION_PART_OF, RELATION_OWNED_BY, ANNOTATION_EDIT_URL, DEFAULT_NAMESPACE, ANNOTATION_LOCATION, ANNOTATION_VIEW_URL } from '@backstage/catalog-model';
+import { isArray, isString, capitalize as capitalize$1 } from 'lodash';
 import { Link, HeaderIconLinkRow, OverflowTooltip, WarningPanel, CodeSnippet, Table, Page, Header, Progress, RoutedTabs, Content, HeaderLabel, ResponseErrorPanel } from '@backstage/core-components';
-import { createExternalRouteRef, useElementFilter, useApi, alertApiRef, useRouteRef, attachComponentData, useApiHolder, createPlugin, createApiFactory, discoveryApiRef, fetchApiRef, storageApiRef, createRoutableExtension, createComponentExtension } from '@backstage/core-plugin-api';
+import { createExternalRouteRef, createRouteRef, useElementFilter, useApi, alertApiRef, useRouteRef, attachComponentData, useRouteRefParams, useApiHolder, createPlugin, createApiFactory, discoveryApiRef, fetchApiRef, storageApiRef, createRoutableExtension, createComponentExtension } from '@backstage/core-plugin-api';
 import { scmIntegrationsApiRef, ScmIntegrationIcon } from '@backstage/integration-react';
-import { getEntityRelations, EntityRefLinks, useEntity, catalogApiRef, getEntitySourceLocation, getEntityMetadataEditUrl, useEntityKinds, useEntityListProvider, EntityKindFilter, formatEntityRefTitle, EntityRefLink, useStarredEntities, getEntityMetadataViewUrl, favoriteEntityIcon, favoriteEntityTooltip, useEntityPermission, useEntityCompoundName, EntityContext, UnregisterEntityDialog, InspectEntityDialog, FavoriteEntity, catalogRouteRef, starredEntitiesApiRef, DefaultStarredEntitiesApi, entityRouteRef } from '@backstage/plugin-catalog-react';
+import { getEntityRelations, EntityRefLinks, useEntity, catalogApiRef, getEntitySourceLocation, useEntityList, EntityKindFilter, humanizeEntityRef, EntityRefLink, useStarredEntities, useEntityPermission, entityRouteRef, useAsyncEntity, UnregisterEntityDialog, InspectEntityDialog, FavoriteEntity, starredEntitiesApiRef } from '@backstage/plugin-catalog-react';
 import { makeStyles, Typography, Grid, Chip, Card, CardHeader, IconButton, Divider, CardContent, createStyles, capitalize, Select, InputBase, MenuItem, ListItem, ListItemText, Box, ListItemIcon, Popover, MenuList, Dialog, DialogTitle, DialogActions, Button, useMediaQuery, useTheme, Drawer } from '@material-ui/core';
 import CachedIcon from '@material-ui/icons/Cached';
 import DocsIcon from '@material-ui/icons/Description';
 import EditIcon from '@material-ui/icons/Edit';
-import React, { useCallback, useState, useEffect, useMemo, useContext } from 'react';
+import React, { useCallback, useMemo, useState, useEffect } from 'react';
+import useAsync from 'react-use/lib/useAsync';
 import OpenInNew from '@material-ui/icons/OpenInNew';
-import { capitalize as capitalize$1 } from 'lodash';
+import StarBorder from '@material-ui/icons/StarBorder';
+import { withStyles, makeStyles as makeStyles$1 } from '@material-ui/core/styles';
+import Star from '@material-ui/icons/Star';
 import { Alert } from '@material-ui/lab';
 import { useLocation, useNavigate } from 'react-router';
-import { makeStyles as makeStyles$1 } from '@material-ui/core/styles';
 import CancelIcon from '@material-ui/icons/Cancel';
 import BugReportIcon from '@material-ui/icons/BugReport';
 import MoreVert from '@material-ui/icons/MoreVert';
 import { catalogEntityDeletePermission } from '@backstage/plugin-catalog-common';
 import { assertError } from '@backstage/errors';
 import { ENTITY_STATUS_CATALOG_PROCESSING_TYPE, CatalogClient } from '@backstage/catalog-client';
-import useAsync from 'react-use/lib/useAsync';
 import FilterListIcon from '@material-ui/icons/FilterList';
 
+async function performMigrationToTheNewBucket({
+  storageApi
+}) {
+  var _a;
+  const source = storageApi.forBucket("settings");
+  const target = storageApi.forBucket("starredEntities");
+  const oldStarredEntities = source.snapshot("starredEntities").value;
+  if (!isArray(oldStarredEntities)) {
+    return;
+  }
+  const targetEntities = new Set((_a = target.snapshot("entityRefs").value) != null ? _a : []);
+  oldStarredEntities.filter(isString).map((old) => old.split(":")).filter((split) => split.length === 4 && split[0] === "entity").map(([_, kind, namespace, name]) => stringifyEntityRef({ kind, namespace, name })).forEach((e) => targetEntities.add(e));
+  await target.set("entityRefs", Array.from(targetEntities));
+  await source.remove("starredEntities");
+}
+
+class DefaultStarredEntitiesApi {
+  constructor(opts) {
+    this.subscribers = /* @__PURE__ */ new Set();
+    this.observable = new ObservableImpl((subscriber) => {
+      subscriber.next(new Set(this.starredEntities));
+      this.subscribers.add(subscriber);
+      return () => {
+        this.subscribers.delete(subscriber);
+      };
+    });
+    var _a;
+    performMigrationToTheNewBucket(opts).then();
+    this.settingsStore = opts.storageApi.forBucket("starredEntities");
+    this.starredEntities = new Set((_a = this.settingsStore.snapshot("entityRefs").value) != null ? _a : []);
+    this.settingsStore.observe$("entityRefs").subscribe({
+      next: (next) => {
+        var _a2;
+        this.starredEntities = new Set((_a2 = next.value) != null ? _a2 : []);
+        this.notifyChanges();
+      }
+    });
+  }
+  async toggleStarred(entityRef) {
+    if (this.starredEntities.has(entityRef)) {
+      this.starredEntities.delete(entityRef);
+    } else {
+      this.starredEntities.add(entityRef);
+    }
+    await this.settingsStore.set("entityRefs", Array.from(this.starredEntities));
+  }
+  starredEntitie$() {
+    return this.observable;
+  }
+  notifyChanges() {
+    for (const subscription of this.subscribers) {
+      subscription.next(new Set(this.starredEntities));
+    }
+  }
+}
+
 const createComponentRouteRef = createExternalRouteRef({
   id: "create-component",
   optional: true
@@ -31,6 +90,9 @@ const viewTechDocRouteRef = createExternalRouteRef({
   optional: true,
   params: ["namespace", "kind", "name"]
 });
+const rootRouteRef = createRouteRef({
+  id: "catalog"
+});
 
 const useStyles$5 = makeStyles((theme) => ({
   value: {
@@ -168,7 +230,7 @@ const useStyles$3 = makeStyles({
   }
 });
 function AboutCard(props) {
-  var _a, _b;
+  var _a, _b, _c;
   const { variant } = props;
   const classes = useStyles$3();
   const { entity } = useEntity();
@@ -177,7 +239,7 @@ function AboutCard(props) {
   const alertApi = useApi(alertApiRef);
   const viewTechdocLink = useRouteRef(viewTechDocRouteRef);
   const entitySourceLocation = getEntitySourceLocation(entity, scmIntegrationsApi);
-  const entityMetadataEditUrl = getEntityMetadataEditUrl(entity);
+  const entityMetadataEditUrl = (_a = entity.metadata.annotations) == null ? void 0 : _a[ANNOTATION_EDIT_URL];
   const viewInSource = {
     label: "View Source",
     disabled: !entitySourceLocation,
@@ -188,7 +250,7 @@ function AboutCard(props) {
   };
   const viewInTechDocs = {
     label: "View TechDocs",
-    disabled: !((_a = entity.metadata.annotations) == null ? void 0 : _a["backstage.io/techdocs-ref"]) || !viewTechdocLink,
+    disabled: !((_b = entity.metadata.annotations) == null ? void 0 : _b["backstage.io/techdocs-ref"]) || !viewTechdocLink,
     icon: /* @__PURE__ */ React.createElement(DocsIcon, null),
     href: viewTechdocLink && viewTechdocLink({
       namespace: entity.metadata.namespace || DEFAULT_NAMESPACE,
@@ -208,7 +270,7 @@ function AboutCard(props) {
   } else if (variant === "fullHeight") {
     cardContentClass = classes.fullHeightCardContent;
   }
-  const entityLocation = (_b = entity.metadata.annotations) == null ? void 0 : _b[ANNOTATION_LOCATION];
+  const entityLocation = (_c = entity.metadata.annotations) == null ? void 0 : _c[ANNOTATION_LOCATION];
   const allowRefresh = (entityLocation == null ? void 0 : entityLocation.startsWith("url:")) || (entityLocation == null ? void 0 : entityLocation.startsWith("file:"));
   const refreshEntity = useCallback(async () => {
     await catalogApi.refreshEntity(stringifyEntityRef(entity));
@@ -245,18 +307,32 @@ const useStyles$2 = makeStyles((theme) => createStyles({
   }
 }));
 function CatalogKindHeader(props) {
-  var _a;
   const { initialFilter = "component" } = props;
   const classes = useStyles$2();
-  const { kinds: allKinds = [] } = useEntityKinds();
-  const { updateFilters, queryParameters } = useEntityListProvider();
-  const [selectedKind, setSelectedKind] = useState(((_a = [queryParameters.kind].flat()[0]) != null ? _a : initialFilter).toLocaleLowerCase("en-US"));
+  const catalogApi = useApi(catalogApiRef);
+  const { value: allKinds } = useAsync(async () => {
+    return await catalogApi.getEntityFacets({ facets: ["kind"] }).then((response) => {
+      var _a;
+      return ((_a = response.facets.kind) == null ? void 0 : _a.map((f) => f.value).sort()) || [];
+    });
+  });
+  const {
+    updateFilters,
+    queryParameters: { kind: kindParameter }
+  } = useEntityList();
+  const queryParamKind = useMemo(() => [kindParameter].flat()[0], [kindParameter]);
+  const [selectedKind, setSelectedKind] = useState(queryParamKind != null ? queryParamKind : initialFilter);
   useEffect(() => {
     updateFilters({
       kind: selectedKind ? new EntityKindFilter(selectedKind) : void 0
     });
   }, [selectedKind, updateFilters]);
-  const options = [capitalize(selectedKind)].concat(allKinds).sort().reduce((acc, kind) => {
+  useEffect(() => {
+    if (queryParamKind) {
+      setSelectedKind(queryParamKind);
+    }
+  }, [queryParamKind]);
+  const options = [capitalize(selectedKind)].concat(allKinds != null ? allKinds : []).sort().reduce((acc, kind) => {
     acc[kind.toLocaleLowerCase("en-US")] = kind;
     return acc;
   }, {});
@@ -283,7 +359,7 @@ const useStyles$1 = makeStyles({
     marginBottom: "1rem"
   }
 });
-function CatalogResultListItem(props) {
+function CatalogSearchResultListItem(props) {
   const result = props.result;
   const classes = useStyles$1();
   return /* @__PURE__ */ React.createElement(Link, {
@@ -311,7 +387,7 @@ const columnFactories = Object.freeze({
   createNameColumn(options) {
     function formatContent(entity) {
       var _a;
-      return ((_a = entity.metadata) == null ? void 0 : _a.title) || formatEntityRefTitle(entity, {
+      return ((_a = entity.metadata) == null ? void 0 : _a.title) || humanizeEntityRef(entity, {
         defaultKind: options == null ? void 0 : options.defaultKind
       });
     }
@@ -394,11 +470,16 @@ const columnFactories = Object.freeze({
   }
 });
 
+const YellowStar = withStyles({
+  root: {
+    color: "#f3ba37"
+  }
+})(Star);
 const CatalogTable = (props) => {
   var _a, _b, _c;
   const { columns, actions } = props;
   const { isStarredEntity, toggleStarredEntity } = useStarredEntities();
-  const { loading, error, entities, filters } = useEntityListProvider();
+  const { loading, error, entities, filters } = useEntityList();
   const defaultColumns = useMemo(() => {
     var _a2;
     return [
@@ -424,7 +505,8 @@ const CatalogTable = (props) => {
   }
   const defaultActions = [
     ({ entity }) => {
-      const url = getEntityMetadataViewUrl(entity);
+      var _a2;
+      const url = (_a2 = entity.metadata.annotations) == null ? void 0 : _a2[ANNOTATION_VIEW_URL];
       return {
         icon: () => /* @__PURE__ */ React.createElement(OpenInNew, {
           "aria-label": "View",
@@ -440,7 +522,8 @@ const CatalogTable = (props) => {
       };
     },
     ({ entity }) => {
-      const url = getEntityMetadataEditUrl(entity);
+      var _a2;
+      const url = (_a2 = entity.metadata.annotations) == null ? void 0 : _a2[ANNOTATION_EDIT_URL];
       return {
         icon: () => /* @__PURE__ */ React.createElement(EditIcon, {
           "aria-label": "Edit",
@@ -459,8 +542,8 @@ const CatalogTable = (props) => {
       const isStarred = isStarredEntity(entity);
       return {
         cellStyle: { paddingLeft: "1em" },
-        icon: () => favoriteEntityIcon(isStarred),
-        tooltip: favoriteEntityTooltip(isStarred),
+        icon: () => isStarred ? /* @__PURE__ */ React.createElement(YellowStar, null) : /* @__PURE__ */ React.createElement(StarBorder, null),
+        tooltip: isStarred ? "Remove from favorites" : "Add to favorites",
         onClick: () => toggleStarredEntity(entity)
       };
     }
@@ -473,12 +556,12 @@ const CatalogTable = (props) => {
     return {
       entity,
       resolved: {
-        name: formatEntityRefTitle(entity, {
+        name: humanizeEntityRef(entity, {
           defaultKind: "Component"
         }),
-        ownedByRelationsTitle: ownedByRelations.map((r) => formatEntityRefTitle(r, { defaultKind: "group" })).join(", "),
+        ownedByRelationsTitle: ownedByRelations.map((r) => humanizeEntityRef(r, { defaultKind: "group" })).join(", "),
         ownedByRelations,
-        partOfSystemRelationTitle: partOfSystemRelations.map((r) => formatEntityRefTitle(r, {
+        partOfSystemRelationTitle: partOfSystemRelations.map((r) => humanizeEntityRef(r, {
           defaultKind: "system"
         })).join(", "),
         partOfSystemRelations
@@ -643,14 +726,16 @@ const EntityLayout = (props) => {
     UNSTABLE_contextMenuOptions,
     children
   } = props;
-  const { kind, namespace, name } = useEntityCompoundName();
-  const { entity, loading, error } = useContext(EntityContext);
+  const { kind, namespace, name } = useRouteRefParams(entityRouteRef);
+  const { entity, loading, error } = useAsyncEntity();
   const location = useLocation();
   const routes = useElementFilter(children, (elements) => elements.selectByComponentData({
     key: dataKey,
     withStrictError: "Child of EntityLayout must be an EntityLayout.Route"
   }).getElements().flatMap(({ props: elementProps }) => {
-    if (elementProps.if && entity && !elementProps.if(entity)) {
+    if (!entity) {
+      return [];
+    } else if (elementProps.if && !elementProps.if(entity)) {
       return [];
     }
     return [
@@ -752,7 +837,7 @@ function isOrphan(entity) {
 }
 function EntityOrphanWarning() {
   const navigate = useNavigate();
-  const catalogLink = useRouteRef(catalogRouteRef);
+  const catalogLink = useRouteRef(rootRouteRef);
   const [confirmationDialogOpen, setConfirmationDialogOpen] = useState(false);
   const { entity } = useEntity();
   const cleanUpAfterRemoval = async () => {
@@ -824,13 +909,16 @@ const EntitySwitchCaseComponent = (_props) => null;
 attachComponentData(EntitySwitchCaseComponent, ENTITY_SWITCH_KEY, true);
 const EntitySwitch = (props) => {
   var _a, _b;
-  const { entity } = useEntity();
+  const { entity } = useAsyncEntity();
   const apis = useApiHolder();
   const results = useElementFilter(props.children, (collection) => collection.selectByComponentData({
     key: ENTITY_SWITCH_KEY,
     withStrictError: "Child of EntitySwitch is not an EntitySwitch.Case"
   }).getElements().flatMap((element) => {
     var _a2;
+    if (!entity) {
+      return [];
+    }
     const { if: condition, children: elementsChildren } = element.props;
     return [
       {
@@ -872,11 +960,11 @@ function strCmp(a, b) {
   return Boolean(a && (a == null ? void 0 : a.toLocaleLowerCase("en-US")) === (b == null ? void 0 : b.toLocaleLowerCase("en-US")));
 }
 function isKind(kind) {
-  return (entity) => strCmp(entity == null ? void 0 : entity.kind, kind);
+  return (entity) => strCmp(entity.kind, kind);
 }
 function isComponentType(type) {
   return (entity) => {
-    if (!strCmp(entity == null ? void 0 : entity.kind, "component")) {
+    if (!strCmp(entity.kind, "component")) {
       return false;
     }
     const componentEntity = entity;
@@ -886,7 +974,7 @@ function isComponentType(type) {
 function isNamespace(namespace) {
   return (entity) => {
     var _a;
-    return strCmp((_a = entity == null ? void 0 : entity.metadata) == null ? void 0 : _a.namespace, namespace);
+    return strCmp((_a = entity.metadata) == null ? void 0 : _a.namespace, namespace);
   };
 }
 
@@ -950,7 +1038,7 @@ const catalogPlugin = createPlugin({
     })
   ],
   routes: {
-    catalogIndex: catalogRouteRef,
+    catalogIndex: rootRouteRef,
     catalogEntity: entityRouteRef
   },
   externalRoutes: {
@@ -960,74 +1048,74 @@ const catalogPlugin = createPlugin({
 });
 const CatalogIndexPage = catalogPlugin.provide(createRoutableExtension({
   name: "CatalogIndexPage",
-  component: () => import('./index-5c367aca.esm.js').then((m) => m.CatalogPage),
-  mountPoint: catalogRouteRef
+  component: () => import('./index-142ea58f.esm.js').then((m) => m.CatalogPage),
+  mountPoint: rootRouteRef
 }));
 const CatalogEntityPage = catalogPlugin.provide(createRoutableExtension({
   name: "CatalogEntityPage",
-  component: () => import('./index-3467aa13.esm.js').then((m) => m.CatalogEntityPage),
+  component: () => import('./index-4e6adb42.esm.js').then((m) => m.CatalogEntityPage),
   mountPoint: entityRouteRef
 }));
 const EntityAboutCard = catalogPlugin.provide(createComponentExtension({
   name: "EntityAboutCard",
   component: {
-    lazy: () => import('./index-36e4660a.esm.js').then((m) => m.AboutCard)
+    lazy: () => import('./index-19e9c476.esm.js').then((m) => m.AboutCard)
   }
 }));
 const EntityLinksCard = catalogPlugin.provide(createComponentExtension({
   name: "EntityLinksCard",
   component: {
-    lazy: () => import('./index-52271589.esm.js').then((m) => m.EntityLinksCard)
+    lazy: () => import('./index-896aeac9.esm.js').then((m) => m.EntityLinksCard)
   }
 }));
 const EntityHasSystemsCard = catalogPlugin.provide(createComponentExtension({
   name: "EntityHasSystemsCard",
   component: {
-    lazy: () => import('./index-bb5ef8ab.esm.js').then((m) => m.HasSystemsCard)
+    lazy: () => import('./index-3763491b.esm.js').then((m) => m.HasSystemsCard)
   }
 }));
 const EntityHasComponentsCard = catalogPlugin.provide(createComponentExtension({
   name: "EntityHasComponentsCard",
   component: {
-    lazy: () => import('./index-14286170.esm.js').then((m) => m.HasComponentsCard)
+    lazy: () => import('./index-acb3cf04.esm.js').then((m) => m.HasComponentsCard)
   }
 }));
 const EntityHasSubcomponentsCard = catalogPlugin.provide(createComponentExtension({
   name: "EntityHasSubcomponentsCard",
   component: {
-    lazy: () => import('./index-69fcf315.esm.js').then((m) => m.HasSubcomponentsCard)
+    lazy: () => import('./index-41ab53b6.esm.js').then((m) => m.HasSubcomponentsCard)
   }
 }));
 const EntityHasResourcesCard = catalogPlugin.provide(createComponentExtension({
   name: "EntityHasResourcesCard",
   component: {
-    lazy: () => import('./index-df3c8250.esm.js').then((m) => m.HasResourcesCard)
+    lazy: () => import('./index-b3ad464b.esm.js').then((m) => m.HasResourcesCard)
   }
 }));
 const EntityDependsOnComponentsCard = catalogPlugin.provide(createComponentExtension({
   name: "EntityDependsOnComponentsCard",
   component: {
-    lazy: () => import('./index-be138931.esm.js').then((m) => m.DependsOnComponentsCard)
+    lazy: () => import('./index-66fdb6ad.esm.js').then((m) => m.DependsOnComponentsCard)
   }
 }));
 const EntityDependencyOfComponentsCard = catalogPlugin.provide(createComponentExtension({
   name: "EntityDependencyOfComponentsCard",
   component: {
-    lazy: () => import('./index-2a9d68c3.esm.js').then((m) => m.DependencyOfComponentsCard)
+    lazy: () => import('./index-390fab14.esm.js').then((m) => m.DependencyOfComponentsCard)
   }
 }));
 const EntityDependsOnResourcesCard = catalogPlugin.provide(createComponentExtension({
   name: "EntityDependsOnResourcesCard",
   component: {
-    lazy: () => import('./index-583e6f94.esm.js').then((m) => m.DependsOnResourcesCard)
+    lazy: () => import('./index-d41abbff.esm.js').then((m) => m.DependsOnResourcesCard)
   }
 }));
 const RelatedEntitiesCard = catalogPlugin.provide(createComponentExtension({
   name: "RelatedEntitiesCard",
   component: {
-    lazy: () => import('./index-172990ed.esm.js').then((m) => m.RelatedEntitiesCard)
+    lazy: () => import('./index-c2914273.esm.js').then((m) => m.RelatedEntitiesCard)
   }
 }));
 
-export { AboutCard as A, isNamespace as B, CatalogKindHeader as C, isComponentType as D, EntityListContainer as E, FilteredEntityLayout as F, RelatedEntitiesCard as R, FilterContainer as a, CatalogTable as b, createComponentRouteRef as c, AboutContent as d, AboutField as e, CatalogEntityPage as f, CatalogIndexPage as g, catalogPlugin as h, EntityAboutCard as i, EntityDependencyOfComponentsCard as j, EntityDependsOnComponentsCard as k, EntityDependsOnResourcesCard as l, EntityHasComponentsCard as m, EntityHasResourcesCard as n, EntityHasSubcomponentsCard as o, EntityHasSystemsCard as p, EntityLinksCard as q, CatalogResultListItem as r, columnFactories as s, EntityLayout as t, EntityOrphanWarning as u, isOrphan as v, EntityProcessingErrorsPanel as w, hasCatalogProcessingErrors as x, EntitySwitch as y, isKind as z };
-//# sourceMappingURL=index-de01f9dd.esm.js.map
+export { AboutCard as A, isComponentType as B, CatalogKindHeader as C, DefaultStarredEntitiesApi as D, EntityListContainer as E, FilteredEntityLayout as F, RelatedEntitiesCard as R, FilterContainer as a, CatalogTable as b, createComponentRouteRef as c, AboutContent as d, AboutField as e, CatalogEntityPage as f, CatalogIndexPage as g, catalogPlugin as h, EntityAboutCard as i, EntityDependencyOfComponentsCard as j, EntityDependsOnComponentsCard as k, EntityDependsOnResourcesCard as l, EntityHasComponentsCard as m, EntityHasResourcesCard as n, EntityHasSubcomponentsCard as o, EntityHasSystemsCard as p, EntityLinksCard as q, CatalogSearchResultListItem as r, EntityLayout as s, EntityOrphanWarning as t, isOrphan as u, EntityProcessingErrorsPanel as v, hasCatalogProcessingErrors as w, EntitySwitch as x, isKind as y, isNamespace as z };
+//# sourceMappingURL=index-24c3e4e1.esm.js.map