Merge branch 'backstage:master' into fix-group-diagram-scroll-behaviour

plugins/explore/CHANGELOG.md

@@ -1,5 +1,31 @@
 # @backstage/plugin-explore
 
+## 0.3.42
+
+### Patch Changes
+
+- 5c25ce6d9e: Added a section to explore plugin README that describes the customization of explore tools content.
+- Updated dependencies
+  - @backstage/plugin-catalog-react@1.2.1
+  - @backstage/core-components@0.12.0
+  - @backstage/core-plugin-api@1.1.0
+  - @backstage/catalog-model@1.1.3
+  - @backstage/theme@0.2.16
+  - @backstage/plugin-explore-react@0.0.23
+
+## 0.3.42-next.1
+
+### Patch Changes
+
+- 5c25ce6d9e: Added a section to explore plugin README that describes the customization of explore tools content.
+- Updated dependencies
+  - @backstage/core-components@0.12.0-next.1
+  - @backstage/catalog-model@1.1.3-next.0
+  - @backstage/core-plugin-api@1.1.0-next.0
+  - @backstage/theme@0.2.16
+  - @backstage/plugin-catalog-react@1.2.1-next.1
+  - @backstage/plugin-explore-react@0.0.23-next.0
+
 ## 0.3.42-next.0
 
 ### Patch Changes

plugins/explore/README.md

@@ -79,3 +79,39 @@ const routes = (
   </FlatRoutes>
 );
 ```
+
+## ToolExplorer Content Customization
+
+Override the `exploreToolsConfigRef` API in `/packages/app/src/apis.ts`.
+
+```tsx
+import { exploreToolsConfigRef } from '@backstage/plugin-explore-react';
+
+export const apis: AnyApiFactory[] = [
+  ...
+
+  createApiFactory({
+    api: exploreToolsConfigRef,
+    deps: {},
+    factory: () => ({
+        async getTools() {
+          return tools;
+        },
+      /*  e.g. tools = [
+            {
+              title: 'New Relic',
+              description:'new relic plugin,
+              url: '/newrelic',
+              image: 'https://i.imgur.com/L37ikrX.jpg',
+              tags: ['newrelic', 'proxy', 'nerdGraph'],
+            },
+          ]
+       */
+    }),
+  }),
+
+  ....
+
+];
+
+```

plugins/explore/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@backstage/plugin-explore",
   "description": "A Backstage plugin for building an exploration page of your software ecosystem",
-  "version": "0.3.42-next.0",
+  "version": "0.3.42",
   "main": "src/index.ts",
   "types": "src/index.ts",
   "license": "Apache-2.0",
@@ -61,7 +61,7 @@
     "@testing-library/user-event": "^14.0.0",
     "@types/node": "^16.11.26",
     "cross-fetch": "^3.1.5",
-    "msw": "^0.47.0"
+    "msw": "^0.48.0"
   },
   "files": [
     "dist"

plugins/explore/src/components/DefaultExplorePage/DefaultExplorePage.test.tsx

@@ -21,8 +21,8 @@ import React from 'react';
 import { DefaultExplorePage } from './DefaultExplorePage';
 
 describe('<DefaultExplorePage />', () => {
-  const catalogApi: jest.Mocked<typeof catalogApiRef.T> = {
-    addLocation: jest.fn(_a => new Promise(() => {})),
+  const catalogApi = {
+    addLocation: jest.fn(),
     getEntities: jest.fn(),
     getLocationByRef: jest.fn(),
     getLocationById: jest.fn(),

plugins/explore/src/components/DomainExplorerContent/DomainExplorerContent.test.tsx

@@ -22,8 +22,8 @@ import React from 'react';
 import { DomainExplorerContent } from './DomainExplorerContent';
 
 describe('<DomainExplorerContent />', () => {
-  const catalogApi: jest.Mocked<typeof catalogApiRef.T> = {
-    addLocation: jest.fn(_a => new Promise(() => {})),
+  const catalogApi = {
+    addLocation: jest.fn(),
     getEntities: jest.fn(),
     getLocationByRef: jest.fn(),
     getLocationById: jest.fn(),

plugins/explore/src/components/GroupsExplorerContent/GroupsExplorerContent.test.tsx

@@ -22,8 +22,8 @@ import React from 'react';
 import { GroupsExplorerContent } from '../GroupsExplorerContent';
 
 describe('<GroupsExplorerContent />', () => {
-  const catalogApi: jest.Mocked<typeof catalogApiRef.T> = {
-    addLocation: jest.fn(_a => new Promise(() => {})),
+  const catalogApi = {
+    addLocation: jest.fn(),
     getEntities: jest.fn(),
     getLocationByRef: jest.fn(),
     getLocationById: jest.fn(),