@backstage/plugin-techdocs 0.0.0-nightly-20220301023335 → 0.0.0-nightly-20220305022735

package/CHANGELOG.md

@@ -1,6 +1,18 @@
 # @backstage/plugin-techdocs
 
-## 0.0.0-nightly-20220301023335
+## 0.0.0-nightly-20220305022735
+
+### Patch Changes
+
+- 7a1dbe6ce9: The panels of `TechDocsCustomHome` now use the `useEntityOwnership` hook to resolve ownership when the `'ownedByUser'` filter predicate is used.
+- Updated dependencies
+  - @backstage/plugin-catalog@0.0.0-nightly-20220305022735
+  - @backstage/plugin-catalog-react@0.0.0-nightly-20220305022735
+  - @backstage/core-components@0.0.0-nightly-20220305022735
+  - @backstage/catalog-model@0.0.0-nightly-20220305022735
+  - @backstage/plugin-search@0.0.0-nightly-20220305022735
+
+## 0.15.0
 
 ### Minor Changes
 
@@ -33,18 +45,23 @@
 ### Patch Changes
 
 - 64b430f80d: chore(deps): bump `react-text-truncate` from 0.17.0 to 0.18.0
+- 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.
 - c5fda066b1: Collapse techdocs sidebar on small devices
+- f590d1681b: Removed usage of deprecated favorite utility methods.
 - 5b0f9a75fa: Remove copyright from old footer in documentation generated with previous version of `mkdocs-techdocs-plugin` (`v0.2.2`).
 - 0c3ba547a6: Show feedback when copying code snippet to clipboard.
 - 0ca964ee0e: Fixed a bug that could cause searches in the in-context TechDocs search bar to show results from a different TechDocs site.
+- 36aa63022b: Use `CompoundEntityRef` instead of `EntityName`, and `getCompoundEntityRef` instead of `getEntityName`, from `@backstage/catalog-model`.
 - Updated dependencies
-  - @backstage/core-components@0.0.0-nightly-20220301023335
-  - @backstage/plugin-search@0.0.0-nightly-20220301023335
-  - @backstage/core-plugin-api@0.0.0-nightly-20220301023335
-  - @backstage/plugin-catalog-react@0.0.0-nightly-20220301023335
-  - @backstage/integration@0.0.0-nightly-20220301023335
-  - @backstage/plugin-catalog@0.0.0-nightly-20220301023335
-  - @backstage/integration-react@0.0.0-nightly-20220301023335
+  - @backstage/catalog-model@0.12.0
+  - @backstage/core-components@0.9.0
+  - @backstage/plugin-search@0.7.2
+  - @backstage/plugin-catalog@0.9.1
+  - @backstage/plugin-catalog-react@0.8.0
+  - @backstage/integration@0.8.0
+  - @backstage/core-plugin-api@0.8.0
+  - @backstage/integration-react@0.1.24
 
 ## 0.14.0
 

package/dist/esm/{TechDocsCustomHome-c5d31d27.esm.js → TechDocsCustomHome-75cceaae.esm.js}

@@ -1,11 +1,10 @@
 import React, { useState } from 'react';
 import useAsync from 'react-use/lib/useAsync';
 import { makeStyles } from '@material-ui/core';
-import { catalogApiRef, CATALOG_FILTER_EXISTS, isOwnerOf } from '@backstage/plugin-catalog-react';
-import { parseEntityRef, DEFAULT_NAMESPACE } from '@backstage/catalog-model';
+import { catalogApiRef, CATALOG_FILTER_EXISTS, useEntityOwnership } from '@backstage/plugin-catalog-react';
 import { TechDocsPageWrapper, DocsTable, DocsCardGrid } from '../index.esm.js';
 import { Content, Progress, WarningPanel, CodeSnippet, HeaderTabs, ContentHeader, SupportButton } from '@backstage/core-components';
-import { useApi, identityApiRef } from '@backstage/core-plugin-api';
+import { useApi } from '@backstage/core-plugin-api';
 import '@backstage/errors';
 import 'event-source-polyfill';
 import 'react-router-dom';
@@ -26,9 +25,13 @@ import '@material-ui/lab';
 import '@material-ui/icons/Close';
 import 'react-use/lib/useAsyncRetry';
 import '@material-ui/icons/Code';
+import '@backstage/catalog-model';
 import 'react-use/lib/useCopyToClipboard';
 import 'lodash';
 import '@material-ui/icons/Share';
+import '@material-ui/styles';
+import '@material-ui/icons/Star';
+import '@material-ui/icons/StarBorder';
 import '@backstage/plugin-catalog';
 
 const panels = {
@@ -47,14 +50,14 @@ const CustomPanel = ({
     }
   });
   const classes = useStyles();
-  const { value: user } = useOwnUser();
+  const { loading: loadingOwnership, isOwnedEntity } = useEntityOwnership();
   const Panel = panels[config.panelType];
   const shownEntities = entities.filter((entity) => {
     if (config.filterPredicate === "ownedByUser") {
-      if (!user) {
+      if (loadingOwnership) {
         return false;
       }
-      return isOwnerOf(user, entity);
+      return isOwnedEntity(entity);
     }
     return typeof config.filterPredicate === "function" && config.filterPredicate(entity);
   });
@@ -124,17 +127,6 @@ const TechDocsCustomHome = (props) => {
     index
   }))));
 };
-function useOwnUser() {
-  const catalogApi = useApi(catalogApiRef);
-  const identityApi = useApi(identityApiRef);
-  return useAsync(async () => {
-    const identity = await identityApi.getBackstageIdentity();
-    return catalogApi.getEntityByName(parseEntityRef(identity.userEntityRef, {
-      defaultKind: "User",
-      defaultNamespace: DEFAULT_NAMESPACE
-    }));
-  }, [catalogApi, identityApi]);
-}
 
 export { TechDocsCustomHome };
-//# sourceMappingURL=TechDocsCustomHome-c5d31d27.esm.js.map
+//# sourceMappingURL=TechDocsCustomHome-75cceaae.esm.js.map

package/dist/esm/TechDocsCustomHome-75cceaae.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TechDocsCustomHome-75cceaae.esm.js","sources":["../../src/home/components/TechDocsCustomHome.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 React, { useState } from 'react';\nimport useAsync from 'react-use/lib/useAsync';\nimport { makeStyles } from '@material-ui/core';\nimport { CSSProperties } from '@material-ui/styles';\nimport {\n  CATALOG_FILTER_EXISTS,\n  catalogApiRef,\n  CatalogApi,\n  useEntityOwnership,\n} from '@backstage/plugin-catalog-react';\nimport { Entity } from '@backstage/catalog-model';\nimport { DocsTable } from './Tables';\nimport { DocsCardGrid } from './Grids';\nimport { TechDocsPageWrapper } from './TechDocsPageWrapper';\n\nimport {\n  CodeSnippet,\n  Content,\n  HeaderTabs,\n  Progress,\n  WarningPanel,\n  SupportButton,\n  ContentHeader,\n} from '@backstage/core-components';\nimport { useApi } from '@backstage/core-plugin-api';\n\nconst panels = {\n  DocsTable: DocsTable,\n  DocsCardGrid: DocsCardGrid,\n};\n\n/**\n * Available panel types\n *\n * @public\n */\nexport type PanelType = 'DocsCardGrid' | 'DocsTable';\n\n/**\n * Type representing a TechDocsCustomHome panel.\n *\n * @public\n */\nexport interface PanelConfig {\n  title: string;\n  description: string;\n  panelType: PanelType;\n  panelCSS?: CSSProperties;\n  filterPredicate: ((entity: Entity) => boolean) | string;\n}\n\n/**\n * Type representing a TechDocsCustomHome tab.\n *\n * @public\n */\nexport interface TabConfig {\n  label: string;\n  panels: PanelConfig[];\n}\n\n/**\n * Type representing a list of TechDocsCustomHome tabs.\n *\n * @public\n */\nexport type TabsConfig = TabConfig[];\n\nconst CustomPanel = ({\n  config,\n  entities,\n  index,\n}: {\n  config: PanelConfig;\n  entities: Entity[];\n  index: number;\n}) => {\n  const useStyles = makeStyles({\n    panelContainer: {\n      marginBottom: '2rem',\n      ...(config.panelCSS ? config.panelCSS : {}),\n    },\n  });\n  const classes = useStyles();\n  const { loading: loadingOwnership, isOwnedEntity } = useEntityOwnership();\n\n  const Panel = panels[config.panelType];\n\n  const shownEntities = entities.filter(entity => {\n    if (config.filterPredicate === 'ownedByUser') {\n      if (loadingOwnership) {\n        return false;\n      }\n      return isOwnedEntity(entity);\n    }\n\n    return (\n      typeof config.filterPredicate === 'function' &&\n      config.filterPredicate(entity)\n    );\n  });\n\n  return (\n    <>\n      <ContentHeader title={config.title} description={config.description}>\n        {index === 0 ? (\n          <SupportButton>\n            Discover documentation in your ecosystem.\n          </SupportButton>\n        ) : null}\n      </ContentHeader>\n      <div className={classes.panelContainer}>\n        <Panel data-testid=\"techdocs-custom-panel\" entities={shownEntities} />\n      </div>\n    </>\n  );\n};\n\n/**\n * Props for {@link TechDocsCustomHome}\n *\n * @public\n */\nexport type TechDocsCustomHomeProps = {\n  tabsConfig: TabsConfig;\n};\n\nexport const TechDocsCustomHome = (props: TechDocsCustomHomeProps) => {\n  const { tabsConfig } = props;\n  const [selectedTab, setSelectedTab] = useState<number>(0);\n  const catalogApi: CatalogApi = useApi(catalogApiRef);\n\n  const {\n    value: entities,\n    loading,\n    error,\n  } = useAsync(async () => {\n    const response = await catalogApi.getEntities({\n      filter: {\n        'metadata.annotations.backstage.io/techdocs-ref': CATALOG_FILTER_EXISTS,\n      },\n      fields: [\n        'apiVersion',\n        'kind',\n        'metadata',\n        'relations',\n        'spec.owner',\n        'spec.type',\n      ],\n    });\n    return response.items.filter((entity: Entity) => {\n      return !!entity.metadata.annotations?.['backstage.io/techdocs-ref'];\n    });\n  });\n\n  const currentTabConfig = tabsConfig[selectedTab];\n\n  if (loading) {\n    return (\n      <TechDocsPageWrapper>\n        <Content>\n          <Progress />\n        </Content>\n      </TechDocsPageWrapper>\n    );\n  }\n\n  if (error) {\n    return (\n      <TechDocsPageWrapper>\n        <Content>\n          <WarningPanel\n            severity=\"error\"\n            title=\"Could not load available documentation.\"\n          >\n            <CodeSnippet language=\"text\" text={error.toString()} />\n          </WarningPanel>\n        </Content>\n      </TechDocsPageWrapper>\n    );\n  }\n\n  return (\n    <TechDocsPageWrapper>\n      <HeaderTabs\n        selectedIndex={selectedTab}\n        onChange={index => setSelectedTab(index)}\n        tabs={tabsConfig.map(({ label }, index) => ({\n          id: index.toString(),\n          label,\n        }))}\n      />\n      <Content data-testid=\"techdocs-content\">\n        {currentTabConfig.panels.map((config, index) => (\n          <CustomPanel\n            key={index}\n            config={config}\n            entities={!!entities ? entities : []}\n            index={index}\n          />\n        ))}\n      </Content>\n    </TechDocsPageWrapper>\n  );\n};\n"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0CA,MAAM,SAAS;AAAA,EACb;AAAA,EACA;AAAA;AAwCF,MAAM,cAAc,CAAC;AAAA,EACnB;AAAA,EACA;AAAA,EACA;AAAA,MAKI;AACJ,QAAM,YAAY,WAAW;AAAA,IAC3B,gBAAgB;AAAA,MACd,cAAc;AAAA,SACV,OAAO,WAAW,OAAO,WAAW;AAAA;AAAA;AAG5C,QAAM,UAAU;AAChB,QAAM,EAAE,SAAS,kBAAkB,kBAAkB;AAErD,QAAM,QAAQ,OAAO,OAAO;AAE5B,QAAM,gBAAgB,SAAS,OAAO,YAAU;AAC9C,QAAI,OAAO,oBAAoB,eAAe;AAC5C,UAAI,kBAAkB;AACpB,eAAO;AAAA;AAET,aAAO,cAAc;AAAA;AAGvB,WACE,OAAO,OAAO,oBAAoB,cAClC,OAAO,gBAAgB;AAAA;AAI3B,uGAEK,eAAD;AAAA,IAAe,OAAO,OAAO;AAAA,IAAO,aAAa,OAAO;AAAA,KACrD,UAAU,wCACR,eAAD,MAAe,+CAGb,2CAEL,OAAD;AAAA,IAAK,WAAW,QAAQ;AAAA,yCACrB,OAAD;AAAA,IAAO,eAAY;AAAA,IAAwB,UAAU;AAAA;AAAA;MAehD,qBAAqB,CAAC,UAAmC;AACpE,QAAM,EAAE,eAAe;AACvB,QAAM,CAAC,aAAa,kBAAkB,SAAiB;AACvD,QAAM,aAAyB,OAAO;AAEtC,QAAM;AAAA,IACJ,OAAO;AAAA,IACP;AAAA,IACA;AAAA,MACE,SAAS,YAAY;AACvB,UAAM,WAAW,MAAM,WAAW,YAAY;AAAA,MAC5C,QAAQ;AAAA,QACN,kDAAkD;AAAA;AAAA,MAEpD,QAAQ;AAAA,QACN;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA;AAAA;AAGJ,WAAO,SAAS,MAAM,OAAO,CAAC,WAAmB;AAtKrD;AAuKM,aAAO,CAAC,eAAQ,SAAS,gBAAhB,mBAA8B;AAAA;AAAA;AAI3C,QAAM,mBAAmB,WAAW;AAEpC,MAAI,SAAS;AACX,+CACG,qBAAD,0CACG,SAAD,0CACG,UAAD;AAAA;AAMR,MAAI,OAAO;AACT,+CACG,qBAAD,0CACG,SAAD,0CACG,cAAD;AAAA,MACE,UAAS;AAAA,MACT,OAAM;AAAA,2CAEL,aAAD;AAAA,MAAa,UAAS;AAAA,MAAO,MAAM,MAAM;AAAA;AAAA;AAOnD,6CACG,qBAAD,0CACG,YAAD;AAAA,IACE,eAAe;AAAA,IACf,UAAU,WAAS,eAAe;AAAA,IAClC,MAAM,WAAW,IAAI,CAAC,EAAE,SAAS;AAAW,MAC1C,IAAI,MAAM;AAAA,MACV;AAAA;AAAA,0CAGH,SAAD;AAAA,IAAS,eAAY;AAAA,KAClB,iBAAiB,OAAO,IAAI,CAAC,QAAQ,8CACnC,aAAD;AAAA,IACE,KAAK;AAAA,IACL;AAAA,IACA,UAAU,CAAC,CAAC,WAAW,WAAW;AAAA,IAClC;AAAA;AAAA;;;;"}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 /// <reference types="react" />
-import { Entity, EntityName } from '@backstage/catalog-model';
+import { Entity, CompoundEntityRef } from '@backstage/catalog-model';
 import * as _backstage_core_plugin_api from '@backstage/core-plugin-api';
 import { DiscoveryApi, FetchApi, IdentityApi } from '@backstage/core-plugin-api';
 import { Config } from '@backstage/config';
@@ -59,9 +59,9 @@ interface TechDocsStorageApi {
     getApiOrigin(): Promise<string>;
     getStorageUrl(): Promise<string>;
     getBuilder(): Promise<string>;
-    getEntityDocs(entityId: EntityName, path: string): Promise<string>;
-    syncEntityDocs(entityId: EntityName, logHandler?: (line: string) => void): Promise<SyncResult>;
-    getBaseUrl(oldBaseUrl: string, entityId: EntityName, path: string): Promise<string>;
+    getEntityDocs(entityId: CompoundEntityRef, path: string): Promise<string>;
+    syncEntityDocs(entityId: CompoundEntityRef, logHandler?: (line: string) => void): Promise<SyncResult>;
+    getBaseUrl(oldBaseUrl: string, entityId: CompoundEntityRef, path: string): Promise<string>;
 }
 /**
  * API to talk to techdocs-backend.
@@ -73,8 +73,8 @@ interface TechDocsApi {
      * Set to techdocs.requestUrl as the URL for techdocs-backend API.
      */
     getApiOrigin(): Promise<string>;
-    getTechDocsMetadata(entityId: EntityName): Promise<TechDocsMetadata>;
-    getEntityMetadata(entityId: EntityName): Promise<TechDocsEntityMetadata>;
+    getTechDocsMetadata(entityId: CompoundEntityRef): Promise<TechDocsMetadata>;
+    getEntityMetadata(entityId: CompoundEntityRef): Promise<TechDocsEntityMetadata>;
 }
 
 /**
@@ -101,7 +101,7 @@ declare class TechDocsClient implements TechDocsApi {
      *
      * @param entityId - Object containing entity data like name, namespace, etc.
      */
-    getTechDocsMetadata(entityId: EntityName): Promise<TechDocsMetadata>;
+    getTechDocsMetadata(entityId: CompoundEntityRef): Promise<TechDocsMetadata>;
     /**
      * Retrieve metadata about an entity.
      *
@@ -110,7 +110,7 @@ declare class TechDocsClient implements TechDocsApi {
      *
      * @param entityId - Object containing entity data like name, namespace, etc.
      */
-    getEntityMetadata(entityId: EntityName): Promise<TechDocsEntityMetadata>;
+    getEntityMetadata(entityId: CompoundEntityRef): Promise<TechDocsEntityMetadata>;
 }
 /**
  * API which talks to TechDocs storage to fetch files to render.
@@ -139,7 +139,7 @@ declare class TechDocsStorageClient implements TechDocsStorageApi {
      * @returns HTML content of the docs page as string
      * @throws Throws error when the page is not found.
      */
-    getEntityDocs(entityId: EntityName, path: string): Promise<string>;
+    getEntityDocs(entityId: CompoundEntityRef, path: string): Promise<string>;
     /**
      * Check if docs are on the latest version and trigger rebuild if not
      *
@@ -148,8 +148,8 @@ declare class TechDocsStorageClient implements TechDocsStorageApi {
      * @returns Whether documents are currently synchronized to newest version
      * @throws Throws error on error from sync endpoint in Techdocs Backend
      */
-    syncEntityDocs(entityId: EntityName, logHandler?: (line: string) => void): Promise<SyncResult>;
-    getBaseUrl(oldBaseUrl: string, entityId: EntityName, path: string): Promise<string>;
+    syncEntityDocs(entityId: CompoundEntityRef, logHandler?: (line: string) => void): Promise<SyncResult>;
+    getBaseUrl(oldBaseUrl: string, entityId: CompoundEntityRef, path: string): Promise<string>;
 }
 
 /**
@@ -158,7 +158,7 @@ declare class TechDocsStorageClient implements TechDocsStorageApi {
  * @public
  */
 declare type ReaderProps = {
-    entityRef: EntityName;
+    entityRef: CompoundEntityRef;
     withSearch?: boolean;
     onReady?: () => void;
 };
@@ -170,14 +170,14 @@ declare type ReaderProps = {
 declare const Reader: (props: ReaderProps) => JSX.Element;
 
 /**
- * Helper function that gives the children of {@link TechDocsReaderPage} acccess to techdocs and entity metadata
+ * Helper function that gives the children of {@link TechDocsReaderPage} access to techdocs and entity metadata
  *
  * @public
  */
 declare type TechDocsReaderPageRenderFunction = ({ techdocsMetadataValue, entityMetadataValue, entityRef, }: {
     techdocsMetadataValue?: TechDocsMetadata | undefined;
     entityMetadataValue?: TechDocsEntityMetadata | undefined;
-    entityRef: EntityName;
+    entityRef: CompoundEntityRef;
     onReady: () => void;
 }) => JSX.Element;
 /**
@@ -205,7 +205,7 @@ declare type TechDocsPageRenderFunction = TechDocsReaderPageRenderFunction;
  * @public
  */
 declare type TechDocsReaderPageHeaderProps = PropsWithChildren<{
-    entityRef: EntityName;
+    entityRef: CompoundEntityRef;
     entityMetadata?: TechDocsEntityMetadata;
     techDocsMetadata?: TechDocsMetadata;
 }>;
@@ -256,7 +256,7 @@ declare const DocsResultListItem: (props: TechDocsSearchResultListItemProps) =>
  * @public
  */
 declare type TechDocsSearchProps = {
-    entityId: EntityName;
+    entityId: CompoundEntityRef;
     debounceTime?: number;
 };
 /**
@@ -298,7 +298,7 @@ declare type DocsTableRow = {
     resolved: {
         docsUrl: string;
         ownedByRelationsTitle: string;
-        ownedByRelations: EntityName[];
+        ownedByRelations: CompoundEntityRef[];
     };
 };
 

package/dist/index.esm.js

@@ -24,10 +24,13 @@ import useAsync from 'react-use/lib/useAsync';
 import useAsyncRetry from 'react-use/lib/useAsyncRetry';
 import CodeIcon from '@material-ui/icons/Code';
 import { RELATION_OWNED_BY } from '@backstage/catalog-model';
-import { getEntityRelations, EntityRefLink, EntityRefLinks, useEntityList, favoriteEntityIcon, favoriteEntityTooltip, formatEntityRefTitle, useStarredEntities, CATALOG_FILTER_EXISTS, EntityListProvider, UserListPicker, EntityOwnerPicker, EntityTagPicker, useEntity } from '@backstage/plugin-catalog-react';
+import { getEntityRelations, EntityRefLink, EntityRefLinks, useEntityList, humanizeEntityRef, useStarredEntities, CATALOG_FILTER_EXISTS, EntityListProvider, UserListPicker, EntityOwnerPicker, EntityTagPicker, useEntity } from '@backstage/plugin-catalog-react';
 import useCopyToClipboard from 'react-use/lib/useCopyToClipboard';
 import { capitalize } from 'lodash';
 import ShareIcon from '@material-ui/icons/Share';
+import { withStyles as withStyles$1 } from '@material-ui/styles';
+import Star from '@material-ui/icons/Star';
+import StarBorder from '@material-ui/icons/StarBorder';
 import { FilteredEntityLayout, FilterContainer, EntityListContainer } from '@backstage/plugin-catalog';
 
 const techdocsStorageApiRef = createApiRef({
@@ -1121,7 +1124,7 @@ const useTechDocsReaderDom = (entityRef) => {
             --md-source-version-icon: url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path fill-rule="evenodd" d="M2.5 7.775V2.75a.25.25 0 0 1 .25-.25h5.025a.25.25 0 0 1 .177.073l6.25 6.25a.25.25 0 0 1 0 .354l-5.025 5.025a.25.25 0 0 1-.354 0l-6.25-6.25a.25.25 0 0 1-.073-.177zm-1.5 0V2.75C1 1.784 1.784 1 2.75 1h5.025c.464 0 .91.184 1.238.513l6.25 6.25a1.75 1.75 0 0 1 0 2.474l-5.026 5.026a1.75 1.75 0 0 1-2.474 0l-6.25-6.25A1.75 1.75 0 0 1 1 7.775zM6 5a1 1 0 1 0 0 2 1 1 0 0 0 0-2z"/></svg>');
             --md-version-icon: url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 512"><!--! Font Awesome Free 6.0.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2022 Fonticons, Inc.--><path d="m310.6 246.6-127.1 128c-7.1 6.3-15.3 9.4-23.5 9.4s-16.38-3.125-22.63-9.375l-127.1-128C.224 237.5-2.516 223.7 2.438 211.8S19.07 192 32 192h255.1c12.94 0 24.62 7.781 29.58 19.75s3.12 25.75-6.08 34.85z"/></svg>');
           }
-          
+
           :host > * {
             /* CODE */
             --md-code-fg-color: ${theme.palette.text.primary};
@@ -1209,7 +1212,7 @@ const useTechDocsReaderDom = (entityRef) => {
             .md-main__inner {
               margin-top: 0;
             }
-            
+
             .md-sidebar {
               height: calc(100% - 100px);
               position: fixed;
@@ -1221,13 +1224,13 @@ const useTechDocsReaderDom = (entityRef) => {
             .md-sidebar--secondary {
               right: ${theme.spacing(3)}px;
             }
-            
+
             .md-content {
               max-width: calc(100% - 16rem * 2);
               margin-left: 16rem;
               margin-bottom: 50px;
             }
-            
+
             .md-footer {
               position: fixed;
               bottom: 0px;
@@ -1242,7 +1245,7 @@ const useTechDocsReaderDom = (entityRef) => {
             .md-dialog {
               background-color: unset;
             }
-            
+
             @media screen and (max-width: 76.1875em) {
               .md-nav {
                 transition: none !important;
@@ -1335,7 +1338,7 @@ const useTechDocsReaderDom = (entityRef) => {
           `
     }),
     injectCss({
-      css: `        
+      css: `
             .md-typeset {
               font-size: var(--md-typeset-font-size);
             }
@@ -1367,11 +1370,11 @@ const useTechDocsReaderDom = (entityRef) => {
             .md-typeset .md-content__button {
               color: var(--md-default-fg-color);
             }
-            
+
             .md-typeset hr {
               border-bottom: 0.05rem dotted ${theme.palette.divider};
             }
-            
+
             .md-typeset details {
               font-size: var(--md-typeset-font-size) !important;
             }
@@ -1388,7 +1391,7 @@ const useTechDocsReaderDom = (entityRef) => {
             .md-typeset details[open] > summary:after {
               transform: rotate(90deg) translateX(-50%) !important;
             }
-            
+
             .md-typeset blockquote {
               color: var(--md-default-fg-color--light);
               border-left: 0.2rem solid var(--md-default-fg-color--light);
@@ -1432,13 +1435,13 @@ const useTechDocsReaderDom = (entityRef) => {
             .highlight .md-clipboard:after {
               content: unset;
             }
-            
+
             .highlight .nx {
               color: ${isDarkTheme ? "#ff53a3" : "#ec407a"};
             }
 
             /* CODE HILITE */
-            .codehilite .gd { 
+            .codehilite .gd {
               background-color: ${isDarkTheme ? "rgba(248,81,73,0.65)" : "#fdd"};
             }
 
@@ -1804,6 +1807,11 @@ const EntityListDocsGrid = () => {
   });
 };
 
+const YellowStar = withStyles$1({
+  root: {
+    color: "#f3ba37"
+  }
+})(Star);
 const actionFactories = {
   createCopyDocsUrlAction(copyToClipboard) {
     return (row) => {
@@ -1821,8 +1829,8 @@ const actionFactories = {
       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)
       };
     };
@@ -1883,7 +1891,7 @@ const DocsTable = (props) => {
           name: toLowerMaybe(entity.metadata.name, config)
         }),
         ownedByRelations,
-        ownedByRelationsTitle: ownedByRelations.map((r) => formatEntityRefTitle(r, { defaultKind: "group" })).join(", ")
+        ownedByRelationsTitle: ownedByRelations.map((r) => humanizeEntityRef(r, { defaultKind: "group" })).join(", ")
       }
     };
   });
@@ -2043,7 +2051,7 @@ const EntityTechdocsContent = techdocsPlugin.provide(createRoutableExtension({
 }));
 const TechDocsCustomHome = techdocsPlugin.provide(createRoutableExtension({
   name: "TechDocsCustomHome",
-  component: () => import('./esm/TechDocsCustomHome-c5d31d27.esm.js').then((m) => m.TechDocsCustomHome),
+  component: () => import('./esm/TechDocsCustomHome-75cceaae.esm.js').then((m) => m.TechDocsCustomHome),
   mountPoint: rootRouteRef
 }));
 const TechDocsIndexPage$2 = techdocsPlugin.provide(createRoutableExtension({