@backstage/plugin-catalog-react 0.0.0-nightly-20220313021839 → 0.0.0-nightly-20220316022902

package/CHANGELOG.md

@@ -1,17 +1,36 @@
 # @backstage/plugin-catalog-react
 
-## 0.0.0-nightly-20220313021839
+## 0.0.0-nightly-20220316022902
+
+### Major Changes
+
+- b58c70c223: This package has been promoted to v1.0! To understand how this change affects the package, please check out our [versioning policy](https://backstage.io/docs/overview/versioning-policy).
+
+### Minor Changes
+
+- f7fb7295e6: **BREAKING**: Removed the deprecated `favoriteEntityTooltip` and `favoriteEntityIcon` functions.
+- 4cd92028b8: **BREAKING**: The following deprecated annotation reading helper functions were removed:
+
+  - `getEntityMetadataViewUrl`, use `entity.metadata.annotations?.[ANNOTATION_VIEW_URL]` instead.
+  - `getEntityMetadataEditUrl`, use `entity.metadata.annotations?.[ANNOTATION_EDIT_URL]` instead.
+
+- 1f2757bb07: **BREAKING**: The `useEntity` hook no longer returns loading or error states, and will throw an error if the entity is not immediately available. In practice this means that `useEntity` can only be used in contexts where the entity is guaranteed to have been loaded, for example inside an `EntityLayout`. To access the loading state of the entity, use `useAsyncEntity` instead.
+- 0f3520d499: **BREAKING**: Removed the deprecated `formatEntityRefTitle`, use `humanizeEntityRef` instead.
 
 ### Patch Changes
 
 - a422d7ce5e: chore(deps): bump `@testing-library/react` from 11.2.6 to 12.1.3
 - Updated dependencies
-  - @backstage/core-components@0.0.0-nightly-20220313021839
-  - @backstage/core-plugin-api@0.0.0-nightly-20220313021839
-  - @backstage/version-bridge@0.0.0-nightly-20220313021839
-  - @backstage/plugin-permission-react@0.0.0-nightly-20220313021839
-  - @backstage/catalog-model@0.0.0-nightly-20220313021839
-  - @backstage/catalog-client@0.0.0-nightly-20220313021839
+  - @backstage/core-components@0.0.0-nightly-20220316022902
+  - @backstage/core-plugin-api@0.0.0-nightly-20220316022902
+  - @backstage/version-bridge@0.0.0-nightly-20220316022902
+  - @backstage/plugin-permission-react@0.0.0-nightly-20220316022902
+  - @backstage/catalog-model@0.0.0-nightly-20220316022902
+  - @backstage/integration@0.0.0-nightly-20220316022902
+  - @backstage/catalog-client@0.0.0-nightly-20220316022902
+  - @backstage/errors@0.0.0-nightly-20220316022902
+  - @backstage/types@0.0.0-nightly-20220316022902
+  - @backstage/plugin-permission-common@0.0.0-nightly-20220316022902
 
 ## 0.9.0
 

package/alpha/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backstage/plugin-catalog-react",
-  "version": "0.0.0-nightly-20220313021839",
+  "version": "0.0.0-nightly-20220316022902",
   "main": "../dist/index.esm.js",
   "types": "../dist/index.alpha.d.ts"
 }

package/dist/index.alpha.d.ts

@@ -432,37 +432,11 @@ export declare interface EntityTypePickerProps {
  */
 export declare const FavoriteEntity: (props: FavoriteEntityProps) => JSX.Element;
 
-/**
- * @public
- * @deprecated due to low utility value.
- */
-export declare const favoriteEntityIcon: (isStarred: boolean) => JSX.Element;
-
 /** @public */
 export declare type FavoriteEntityProps = ComponentProps<typeof IconButton> & {
     entity: Entity;
 };
 
-/**
- * @public
- * @deprecated due to low utility value.
- */
-export declare const favoriteEntityTooltip: (isStarred: boolean) => "Remove from favorites" | "Add to favorites";
-
-/** @public @deprecated please use {@link humanizeEntityRef} instead */
-export declare const formatEntityRefTitle: typeof humanizeEntityRef;
-
-/**
- * @public
- * @deprecated use entity.metadata.annotations?.[ANNOTATION_EDIT_URL] instead.
- */
-export declare function getEntityMetadataEditUrl(entity: Entity): string | undefined;
-
-/**
- * @public
- * @deprecated use entity.metadata.annotations?.[ANNOTATION_VIEW_URL] instead. */
-export declare function getEntityMetadataViewUrl(entity: Entity): string | undefined;
-
 /**
  * Get the related entity references.
  *
@@ -571,12 +545,6 @@ export declare function useAsyncEntity<TEntity extends Entity = Entity>(): Entit
  */
 export declare function useEntity<TEntity extends Entity = Entity>(): {
     entity: TEntity;
-    /** @deprecated use {@link useAsyncEntity} instead */
-    loading: boolean;
-    /** @deprecated use {@link useAsyncEntity} instead */
-    error?: Error;
-    /** @deprecated use {@link useAsyncEntity} instead */
-    refresh?: VoidFunction;
 };
 
 /**

package/dist/index.beta.d.ts

@@ -432,37 +432,11 @@ export declare interface EntityTypePickerProps {
  */
 export declare const FavoriteEntity: (props: FavoriteEntityProps) => JSX.Element;
 
-/**
- * @public
- * @deprecated due to low utility value.
- */
-export declare const favoriteEntityIcon: (isStarred: boolean) => JSX.Element;
-
 /** @public */
 export declare type FavoriteEntityProps = ComponentProps<typeof IconButton> & {
     entity: Entity;
 };
 
-/**
- * @public
- * @deprecated due to low utility value.
- */
-export declare const favoriteEntityTooltip: (isStarred: boolean) => "Remove from favorites" | "Add to favorites";
-
-/** @public @deprecated please use {@link humanizeEntityRef} instead */
-export declare const formatEntityRefTitle: typeof humanizeEntityRef;
-
-/**
- * @public
- * @deprecated use entity.metadata.annotations?.[ANNOTATION_EDIT_URL] instead.
- */
-export declare function getEntityMetadataEditUrl(entity: Entity): string | undefined;
-
-/**
- * @public
- * @deprecated use entity.metadata.annotations?.[ANNOTATION_VIEW_URL] instead. */
-export declare function getEntityMetadataViewUrl(entity: Entity): string | undefined;
-
 /**
  * Get the related entity references.
  *
@@ -562,12 +536,6 @@ export declare function useAsyncEntity<TEntity extends Entity = Entity>(): Entit
  */
 export declare function useEntity<TEntity extends Entity = Entity>(): {
     entity: TEntity;
-    /** @deprecated use {@link useAsyncEntity} instead */
-    loading: boolean;
-    /** @deprecated use {@link useAsyncEntity} instead */
-    error?: Error;
-    /** @deprecated use {@link useAsyncEntity} instead */
-    refresh?: VoidFunction;
 };
 
 /**

package/dist/index.d.ts

@@ -432,37 +432,11 @@ export declare interface EntityTypePickerProps {
  */
 export declare const FavoriteEntity: (props: FavoriteEntityProps) => JSX.Element;
 
-/**
- * @public
- * @deprecated due to low utility value.
- */
-export declare const favoriteEntityIcon: (isStarred: boolean) => JSX.Element;
-
 /** @public */
 export declare type FavoriteEntityProps = ComponentProps<typeof IconButton> & {
     entity: Entity;
 };
 
-/**
- * @public
- * @deprecated due to low utility value.
- */
-export declare const favoriteEntityTooltip: (isStarred: boolean) => "Remove from favorites" | "Add to favorites";
-
-/** @public @deprecated please use {@link humanizeEntityRef} instead */
-export declare const formatEntityRefTitle: typeof humanizeEntityRef;
-
-/**
- * @public
- * @deprecated use entity.metadata.annotations?.[ANNOTATION_EDIT_URL] instead.
- */
-export declare function getEntityMetadataEditUrl(entity: Entity): string | undefined;
-
-/**
- * @public
- * @deprecated use entity.metadata.annotations?.[ANNOTATION_VIEW_URL] instead. */
-export declare function getEntityMetadataViewUrl(entity: Entity): string | undefined;
-
 /**
  * Get the related entity references.
  *
@@ -562,12 +536,6 @@ export declare function useAsyncEntity<TEntity extends Entity = Entity>(): Entit
  */
 export declare function useEntity<TEntity extends Entity = Entity>(): {
     entity: TEntity;
-    /** @deprecated use {@link useAsyncEntity} instead */
-    loading: boolean;
-    /** @deprecated use {@link useAsyncEntity} instead */
-    error?: Error;
-    /** @deprecated use {@link useAsyncEntity} instead */
-    refresh?: VoidFunction;
 };
 
 /**

package/dist/index.esm.js

@@ -10,7 +10,7 @@ import { useLocation, useNavigate } from 'react-router';
 import useAsyncFn from 'react-use/lib/useAsyncFn';
 import useDebounce from 'react-use/lib/useDebounce';
 import useMountedState from 'react-use/lib/useMountedState';
-import { ANNOTATION_VIEW_URL, ANNOTATION_EDIT_URL, parseEntityRef, ANNOTATION_SOURCE_LOCATION, parseLocationRef, RELATION_MEMBER_OF, getCompoundEntityRef, stringifyEntityRef, RELATION_OWNED_BY, DEFAULT_NAMESPACE, RELATION_PART_OF, ANNOTATION_LOCATION, ANNOTATION_ORIGIN_LOCATION } from '@backstage/catalog-model';
+import { parseEntityRef, ANNOTATION_SOURCE_LOCATION, parseLocationRef, RELATION_MEMBER_OF, getCompoundEntityRef, stringifyEntityRef, RELATION_OWNED_BY, DEFAULT_NAMESPACE, RELATION_PART_OF, ANNOTATION_LOCATION, ANNOTATION_ORIGIN_LOCATION } from '@backstage/catalog-model';
 import useAsync from 'react-use/lib/useAsync';
 import isEqual$1 from 'lodash/isEqual';
 import sortBy from 'lodash/sortBy';
@@ -99,10 +99,9 @@ function useEntity() {
     throw new Error("EntityContext v1 not available");
   }
   if (!value.entity) {
-    console.warn("DEPRECATION: useEntity hook is being called outside of an EntityLayout where the entity has not been loaded. If this is intentional, please use useAsyncEntity instead. This warning will be replaced with an error in future releases.");
+    throw new Error("useEntity hook is being called outside of an EntityLayout where the entity has not been loaded. If this is intentional, please use useAsyncEntity instead.");
   }
-  const { entity, loading, error, refresh } = value;
-  return { entity, loading, error, refresh };
+  return { entity: value.entity };
 }
 function useAsyncEntity() {
   const versionedHolder = useVersionedContext("entity-context");
@@ -129,15 +128,6 @@ function reduceEntityFilters(filters) {
   return (entity) => filters.every((filter) => !filter.filterEntity || filter.filterEntity(entity));
 }
 
-function getEntityMetadataViewUrl(entity) {
-  var _a;
-  return (_a = entity.metadata.annotations) == null ? void 0 : _a[ANNOTATION_VIEW_URL];
-}
-function getEntityMetadataEditUrl(entity) {
-  var _a;
-  return (_a = entity.metadata.annotations) == null ? void 0 : _a[ANNOTATION_EDIT_URL];
-}
-
 function getEntityRelations(entity, relationType, filter) {
   var _a;
   let entityNames = ((_a = entity == null ? void 0 : entity.relations) == null ? void 0 : _a.filter((r) => r.type === relationType).map((r) => parseEntityRef(r.targetRef))) || [];
@@ -278,7 +268,6 @@ function entityRouteParams(entity) {
   };
 }
 
-const formatEntityRefTitle = humanizeEntityRef;
 function humanizeEntityRef(entityRef, opts) {
   const defaultKind = opts == null ? void 0 : opts.defaultKind;
   let kind;
@@ -609,7 +598,11 @@ function useEntityOwnership() {
 }
 
 function useEntityPermission(permission) {
-  const { entity, loading: loadingEntity, error: entityError } = useEntity();
+  const {
+    entity,
+    loading: loadingEntity,
+    error: entityError
+  } = useAsyncEntity();
   const {
     allowed,
     loading: loadingPermission,
@@ -1083,8 +1076,6 @@ const YellowStar = withStyles({
     color: "#f3ba37"
   }
 })(Star);
-const favoriteEntityTooltip = (isStarred) => isStarred ? "Remove from favorites" : "Add to favorites";
-const favoriteEntityIcon = (isStarred) => isStarred ? /* @__PURE__ */ React.createElement(YellowStar, null) : /* @__PURE__ */ React.createElement(StarBorder, null);
 const FavoriteEntity = (props) => {
   const { toggleStarredEntity, isStarredEntity } = useStarredEntity(props.entity);
   return /* @__PURE__ */ React.createElement(IconButton, {
@@ -2022,5 +2013,5 @@ const MockEntityListContextProvider = ({
   }, children);
 };
 
-export { AsyncEntityProvider, EntityKindFilter, EntityKindPicker, EntityLifecycleFilter, EntityLifecyclePicker, EntityListContext, EntityListProvider, EntityOwnerFilter, EntityOwnerPicker, EntityProvider, EntityRefLink, EntityRefLinks, EntitySearchBar, EntityTable, EntityTagFilter, EntityTagPicker, EntityTextFilter, EntityTypeFilter, EntityTypePicker, FavoriteEntity, InspectEntityDialog, MockEntityListContextProvider, MockStarredEntitiesApi, UnregisterEntityDialog, UserListFilter, UserListPicker, catalogApiRef, columnFactories, entityRouteParams, entityRouteRef, favoriteEntityIcon, favoriteEntityTooltip, formatEntityRefTitle, getEntityMetadataEditUrl, getEntityMetadataViewUrl, getEntityRelations, getEntitySourceLocation, humanizeEntityRef, isOwnerOf, starredEntitiesApiRef, useAsyncEntity, useEntity, useEntityList, useEntityOwnership, useEntityPermission, useEntityTypeFilter, useRelatedEntities, useStarredEntities, useStarredEntity };
+export { AsyncEntityProvider, EntityKindFilter, EntityKindPicker, EntityLifecycleFilter, EntityLifecyclePicker, EntityListContext, EntityListProvider, EntityOwnerFilter, EntityOwnerPicker, EntityProvider, EntityRefLink, EntityRefLinks, EntitySearchBar, EntityTable, EntityTagFilter, EntityTagPicker, EntityTextFilter, EntityTypeFilter, EntityTypePicker, FavoriteEntity, InspectEntityDialog, MockEntityListContextProvider, MockStarredEntitiesApi, UnregisterEntityDialog, UserListFilter, UserListPicker, catalogApiRef, columnFactories, entityRouteParams, entityRouteRef, getEntityRelations, getEntitySourceLocation, humanizeEntityRef, isOwnerOf, starredEntitiesApiRef, useAsyncEntity, useEntity, useEntityList, useEntityOwnership, useEntityPermission, useEntityTypeFilter, useRelatedEntities, useStarredEntities, useStarredEntity };
 //# sourceMappingURL=index.esm.js.map