@backstage/test-utils 1.2.5-next.0 → 1.2.6-next.0

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # @backstage/test-utils
 
+## 1.2.6-next.0
+
+### Patch Changes
+
+- 928a12a9b3: Internal refactor of `/alpha` exports.
+- Updated dependencies
+  - @backstage/core-plugin-api@1.4.1-next.0
+  - @backstage/config@1.0.6
+  - @backstage/core-app-api@1.5.1-next.0
+  - @backstage/theme@0.2.17
+  - @backstage/types@1.0.2
+  - @backstage/plugin-permission-common@0.7.3
+  - @backstage/plugin-permission-react@0.4.11-next.0
+
+## 1.2.5
+
+### Patch Changes
+
+- Updated dependencies
+  - @backstage/theme@0.2.17
+  - @backstage/core-app-api@1.5.0
+  - @backstage/core-plugin-api@1.4.0
+  - @backstage/config@1.0.6
+  - @backstage/types@1.0.2
+  - @backstage/plugin-permission-common@0.7.3
+  - @backstage/plugin-permission-react@0.4.10
+
 ## 1.2.5-next.0
 
 ### Patch Changes

package/alpha/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@backstage/test-utils",
-  "version": "1.2.5-next.0",
-  "main": "../dist/index.esm.js",
-  "types": "../dist/index.alpha.d.ts"
+  "version": "1.2.6-next.0",
+  "main": "../dist/alpha.esm.js",
+  "module": "../dist/alpha.esm.js",
+  "types": "../dist/alpha.d.ts"
 }

package/dist/alpha.d.ts

@@ -0,0 +1,9 @@
+import { PropsWithChildren } from 'react';
+
+/**
+ * Mock for PluginProvider to use in unit tests
+ * @alpha
+ */
+declare const MockPluginProvider: ({ children }: PropsWithChildren<{}>) => JSX.Element;
+
+export { MockPluginProvider };

package/dist/alpha.esm.js

@@ -0,0 +1,16 @@
+import React from 'react';
+import { PluginProvider } from '@backstage/core-plugin-api/alpha';
+import { createPlugin } from '@backstage/core-plugin-api';
+
+const MockPluginProvider = ({ children }) => {
+  const plugin = createPlugin({
+    id: "my-plugin",
+    __experimentalConfigure(_) {
+      return {};
+    }
+  });
+  return /* @__PURE__ */ React.createElement(PluginProvider, { plugin }, children);
+};
+
+export { MockPluginProvider };
+//# sourceMappingURL=alpha.esm.js.map

package/dist/alpha.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alpha.esm.js","sources":["../src/testUtils/MockPluginProvider.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 React, { PropsWithChildren } from 'react';\nimport { PluginProvider } from '@backstage/core-plugin-api/alpha';\nimport { createPlugin } from '@backstage/core-plugin-api';\n\n/**\n * Mock for PluginProvider to use in unit tests\n * @alpha\n */\nexport const MockPluginProvider = ({ children }: PropsWithChildren<{}>) => {\n  type TestInputPluginOptions = {};\n  type TestPluginOptions = {};\n  const plugin = createPlugin({\n    id: 'my-plugin',\n    __experimentalConfigure(_: TestInputPluginOptions): TestPluginOptions {\n      return {};\n    },\n  });\n\n  return <PluginProvider plugin={plugin}>{children}</PluginProvider>;\n};\n"],"names":[],"mappings":";;;;AAwBO,MAAM,kBAAqB,GAAA,CAAC,EAAE,QAAA,EAAsC,KAAA;AAGzE,EAAA,MAAM,SAAS,YAAa,CAAA;AAAA,IAC1B,EAAI,EAAA,WAAA;AAAA,IACJ,wBAAwB,CAA8C,EAAA;AACpE,MAAA,OAAO,EAAC,CAAA;AAAA,KACV;AAAA,GACD,CAAA,CAAA;AAED,EAAO,uBAAA,KAAA,CAAA,aAAA,CAAC,cAAe,EAAA,EAAA,MAAA,EAAA,EAAiB,QAAS,CAAA,CAAA;AACnD;;;;"}

package/dist/index.d.ts

@@ -1,86 +1,11 @@
-/**
- * Utilities to test Backstage plugins and apps.
- *
- * @packageDocumentation
- */
-
-import { AnalyticsApi } from '@backstage/core-plugin-api';
-import { AnalyticsEvent } from '@backstage/core-plugin-api';
-import { ApiHolder } from '@backstage/core-plugin-api';
-import { ApiRef } from '@backstage/core-plugin-api';
-import { AuthorizeResult } from '@backstage/plugin-permission-common';
-import { ComponentType } from 'react';
+import { AnalyticsApi, AnalyticsEvent, ConfigApi, ErrorApiError, ErrorApiErrorContext, ErrorApi, DiscoveryApi, IdentityApi, FetchApi, StorageApi, StorageValueSnapshot, RouteRef, ExternalRouteRef, ApiHolder, ApiRef } from '@backstage/core-plugin-api';
 import { Config } from '@backstage/config';
-import { ConfigApi } from '@backstage/core-plugin-api';
+import { JsonObject, JsonValue, Observable } from '@backstage/types';
 import crossFetch from 'cross-fetch';
-import { DiscoveryApi } from '@backstage/core-plugin-api';
-import { ErrorApi } from '@backstage/core-plugin-api';
-import { ErrorApiError } from '@backstage/core-plugin-api';
-import { ErrorApiErrorContext } from '@backstage/core-plugin-api';
-import { EvaluatePermissionRequest } from '@backstage/plugin-permission-common';
-import { EvaluatePermissionResponse } from '@backstage/plugin-permission-common';
-import { ExternalRouteRef } from '@backstage/core-plugin-api';
-import { FetchApi } from '@backstage/core-plugin-api';
-import { IdentityApi } from '@backstage/core-plugin-api';
-import { JsonObject } from '@backstage/types';
-import { JsonValue } from '@backstage/types';
-import { MatcherFunction } from '@testing-library/react';
-import { Observable } from '@backstage/types';
 import { PermissionApi } from '@backstage/plugin-permission-react';
-import { PropsWithChildren } from 'react';
-import { ReactElement } from 'react';
-import { ReactNode } from 'react';
-import { RenderOptions } from '@testing-library/react';
-import { RenderResult } from '@testing-library/react';
-import { RouteRef } from '@backstage/core-plugin-api';
-import { StorageApi } from '@backstage/core-plugin-api';
-import { StorageValueSnapshot } from '@backstage/core-plugin-api';
-
-/**
- * AsyncLogCollector type used in {@link (withLogCollector:1)} callback function.
- * @public
- */
-export declare type AsyncLogCollector = () => Promise<void>;
-
-/**
- * Map of severity level and corresponding log lines.
- * @public
- */
-export declare type CollectedLogs<T extends LogFuncs> = {
-    [key in T]: string[];
-};
-
-/**
- * Creates a Wrapper component that wraps a component inside a Backstage test app,
- * providing a mocked theme and app context, along with mocked APIs.
- *
- * @param options - Additional options for the rendering.
- * @public
- */
-export declare function createTestAppWrapper(options?: TestAppOptions): (props: {
-    children: ReactNode;
-}) => JSX.Element;
-
-/**
- * ErrorWithContext contains error and ErrorApiErrorContext
- * @public
- */
-export declare type ErrorWithContext = {
-    error: ErrorApiError;
-    context?: ErrorApiErrorContext;
-};
-
-/**
- * Union type used in {@link (withLogCollector:3)} callback function.
- * @public
- */
-export declare type LogCollector = AsyncLogCollector | SyncLogCollector;
-
-/**
- * Severity levels of {@link CollectedLogs}
- * @public
- */
-export declare type LogFuncs = 'log' | 'warn' | 'error';
+import { EvaluatePermissionRequest, AuthorizeResult, EvaluatePermissionResponse } from '@backstage/plugin-permission-common';
+import { ReactNode, ComponentType, ReactElement } from 'react';
+import { RenderResult, MatcherFunction, RenderOptions } from '@testing-library/react';
 
 /**
  * Mock implementation of {@link core-plugin-api#AnalyticsApi} with helpers to ensure that events are sent correctly.
@@ -88,28 +13,12 @@ export declare type LogFuncs = 'log' | 'warn' | 'error';
  *
  * @public
  */
-export declare class MockAnalyticsApi implements AnalyticsApi {
+declare class MockAnalyticsApi implements AnalyticsApi {
     private events;
     captureEvent(event: AnalyticsEvent): void;
     getEvents(): AnalyticsEvent[];
 }
 
-/**
- *  This is a mocking method suggested in the Jest docs, as it is not implemented in JSDOM yet.
- *  It can be used to mock values for the MUI `useMediaQuery` hook if it is used in a tested component.
- *
- *  For issues checkout the documentation:
- *  https://jestjs.io/docs/manual-mocks#mocking-methods-which-are-not-implemented-in-jsdom
- *
- *  If there are any updates from MUI React on testing `useMediaQuery` this mock should be replaced
- *  https://material-ui.com/components/use-media-query/#testing
- *
- * @public
- */
-export declare function mockBreakpoint(options: {
-    matches: boolean;
-}): void;
-
 /**
  * MockConfigApi is a thin wrapper around {@link @backstage/config#ConfigReader}
  * that can be used to mock configuration using a plain object.
@@ -128,7 +37,7 @@ export declare function mockBreakpoint(options: {
  * );
  * ```
  */
-export declare class MockConfigApi implements ConfigApi {
+declare class MockConfigApi implements ConfigApi {
     private readonly config;
     constructor(data: JsonObject);
     /** {@inheritdoc @backstage/config#Config.has} */
@@ -165,12 +74,27 @@ export declare class MockConfigApi implements ConfigApi {
     getOptionalStringArray(key: string): string[] | undefined;
 }
 
+/**
+ * Constructor arguments for {@link MockErrorApi}
+ * @public
+ */
+declare type MockErrorApiOptions = {
+    collect?: boolean;
+};
+/**
+ * ErrorWithContext contains error and ErrorApiErrorContext
+ * @public
+ */
+declare type ErrorWithContext = {
+    error: ErrorApiError;
+    context?: ErrorApiErrorContext;
+};
 /**
  * Mock implementation of the {@link core-plugin-api#ErrorApi} to be used in tests.
  * Includes withForError and getErrors methods for error testing.
  * @public
  */
-export declare class MockErrorApi implements ErrorApi {
+declare class MockErrorApi implements ErrorApi {
     private readonly options;
     private readonly errors;
     private readonly waiters;
@@ -184,35 +108,12 @@ export declare class MockErrorApi implements ErrorApi {
     waitForError(pattern: RegExp, timeoutMs?: number): Promise<ErrorWithContext>;
 }
 
-/**
- * Constructor arguments for {@link MockErrorApi}
- * @public
- */
-export declare type MockErrorApiOptions = {
-    collect?: boolean;
-};
-
-/**
- * A test helper implementation of {@link @backstage/core-plugin-api#FetchApi}.
- *
- * @public
- */
-export declare class MockFetchApi implements FetchApi {
-    private readonly implementation;
-    /**
-     * Creates a mock {@link @backstage/core-plugin-api#FetchApi}.
-     */
-    constructor(options?: MockFetchApiOptions);
-    /** {@inheritdoc @backstage/core-plugin-api#FetchApi.fetch} */
-    get fetch(): typeof crossFetch;
-}
-
 /**
  * The options given when constructing a {@link MockFetchApi}.
  *
  * @public
  */
-export declare interface MockFetchApiOptions {
+interface MockFetchApiOptions {
     /**
      * Define the underlying base `fetch` implementation.
      *
@@ -266,6 +167,20 @@ export declare interface MockFetchApiOptions {
         identityApi: Pick<IdentityApi, 'getCredentials'>;
     };
 }
+/**
+ * A test helper implementation of {@link @backstage/core-plugin-api#FetchApi}.
+ *
+ * @public
+ */
+declare class MockFetchApi implements FetchApi {
+    private readonly implementation;
+    /**
+     * Creates a mock {@link @backstage/core-plugin-api#FetchApi}.
+     */
+    constructor(options?: MockFetchApiOptions);
+    /** {@inheritdoc @backstage/core-plugin-api#FetchApi.fetch} */
+    get fetch(): typeof crossFetch;
+}
 
 /**
  * Mock implementation of
@@ -274,19 +189,24 @@ export declare interface MockFetchApiOptions {
  * request.
  * @public
  */
-export declare class MockPermissionApi implements PermissionApi {
+declare class MockPermissionApi implements PermissionApi {
     private readonly requestHandler;
     constructor(requestHandler?: (request: EvaluatePermissionRequest) => AuthorizeResult.ALLOW | AuthorizeResult.DENY);
     authorize(request: EvaluatePermissionRequest): Promise<EvaluatePermissionResponse>;
 }
 
-/* Excluded from this release type: MockPluginProvider */
-
+/**
+ * Type for map holding data in {@link MockStorageApi}
+ * @public
+ */
+declare type MockStorageBucket = {
+    [key: string]: any;
+};
 /**
  * Mock implementation of the {@link core-plugin-api#StorageApi} to be used in tests
  * @public
  */
-export declare class MockStorageApi implements StorageApi {
+declare class MockStorageApi implements StorageApi {
     private readonly namespace;
     private readonly data;
     private readonly bucketStorageApis;
@@ -304,13 +224,67 @@ export declare class MockStorageApi implements StorageApi {
 }
 
 /**
- * Type for map holding data in {@link MockStorageApi}
+ *  This is a mocking method suggested in the Jest docs, as it is not implemented in JSDOM yet.
+ *  It can be used to mock values for the MUI `useMediaQuery` hook if it is used in a tested component.
+ *
+ *  For issues checkout the documentation:
+ *  https://jestjs.io/docs/manual-mocks#mocking-methods-which-are-not-implemented-in-jsdom
+ *
+ *  If there are any updates from MUI React on testing `useMediaQuery` this mock should be replaced
+ *  https://material-ui.com/components/use-media-query/#testing
+ *
  * @public
  */
-export declare type MockStorageBucket = {
-    [key: string]: any;
-};
+declare function mockBreakpoint(options: {
+    matches: boolean;
+}): void;
 
+/**
+ * Options to customize the behavior of the test app wrapper.
+ * @public
+ */
+declare type TestAppOptions = {
+    /**
+     * Initial route entries to pass along as `initialEntries` to the router.
+     */
+    routeEntries?: string[];
+    /**
+     * An object of paths to mount route ref on, with the key being the path and the value
+     * being the RouteRef that the path will be bound to. This allows the route refs to be
+     * used by `useRouteRef` in the rendered elements.
+     *
+     * @example
+     * wrapInTestApp(<MyComponent />, \{
+     *   mountedRoutes: \{
+     *     '/my-path': myRouteRef,
+     *   \}
+     * \})
+     * // ...
+     * const link = useRouteRef(myRouteRef)
+     */
+    mountedRoutes?: {
+        [path: string]: RouteRef | ExternalRouteRef;
+    };
+};
+/**
+ * Creates a Wrapper component that wraps a component inside a Backstage test app,
+ * providing a mocked theme and app context, along with mocked APIs.
+ *
+ * @param options - Additional options for the rendering.
+ * @public
+ */
+declare function createTestAppWrapper(options?: TestAppOptions): (props: {
+    children: ReactNode;
+}) => JSX.Element;
+/**
+ * Wraps a component inside a Backstage test app, providing a mocked theme
+ * and app context, along with mocked APIs.
+ *
+ * @param Component - A component or react node to render inside the test app.
+ * @param options - Additional options for the rendering.
+ * @public
+ */
+declare function wrapInTestApp(Component: ComponentType | ReactNode, options?: TestAppOptions): ReactElement;
 /**
  * Renders a component inside a Backstage test app, providing a mocked theme
  * and app context, along with mocked APIs.
@@ -322,96 +296,104 @@ export declare type MockStorageBucket = {
  * @param options - Additional options for the rendering.
  * @public
  */
-export declare function renderInTestApp(Component: ComponentType | ReactNode, options?: TestAppOptions): Promise<RenderResult>;
-
+declare function renderInTestApp(Component: ComponentType | ReactNode, options?: TestAppOptions): Promise<RenderResult>;
 /**
- * @public
- * Simplifies rendering of async components in by taking care of the wrapping inside act
+ * Returns a `@testing-library/react` valid MatcherFunction for supplied text
  *
- * @remarks
+ * @param string - text Text to match by element's textContent
  *
- * Components using useEffect to perform an asynchronous action (such as fetch) must be rendered within an async
- * act call to properly get the final state, even with mocked responses. This utility method makes the signature a bit
- * cleaner, since act doesn't return the result of the evaluated function.
- * https://github.com/testing-library/react-testing-library/issues/281
- * https://github.com/facebook/react/pull/14853
+ * @public
  */
-export declare function renderWithEffects(nodes: ReactElement, options?: Pick<RenderOptions, 'wrapper'>): Promise<RenderResult>;
+declare const textContentMatcher: (text: string) => MatcherFunction;
 
 /**
  * Sets up handlers for request mocking
  * @public
  * @param worker - service worker
  */
-export declare function setupRequestMockHandlers(worker: {
+declare function setupRequestMockHandlers(worker: {
     listen: (t: any) => void;
     close: () => void;
     resetHandlers: () => void;
 }): void;
 
+/**
+ * Severity levels of {@link CollectedLogs}
+ * @public
+ */
+declare type LogFuncs = 'log' | 'warn' | 'error';
+/**
+ * AsyncLogCollector type used in {@link (withLogCollector:1)} callback function.
+ * @public
+ */
+declare type AsyncLogCollector = () => Promise<void>;
 /**
  * SyncLogCollector type used in {@link (withLogCollector:2)} callback function.
  * @public
  */
-export declare type SyncLogCollector = () => void;
-
+declare type SyncLogCollector = () => void;
 /**
- * The `TestApiProvider` is a Utility API context provider that is particularly
- * well suited for development and test environments such as unit tests, storybooks,
- * and isolated plugin development setups.
- *
- * It lets you provide any number of API implementations, without necessarily
- * having to fully implement each of the APIs.
- *
- * A migration from `ApiRegistry` and `ApiProvider` might look like this, from:
- *
- * ```tsx
- * renderInTestApp(
- *   <ApiProvider
- *     apis={ApiRegistry.from([
- *       [identityApiRef, mockIdentityApi as unknown as IdentityApi]
- *     ])}
- *   >
- *     {...}
- *   </ApiProvider>
- * )
- * ```
- *
- * To the following:
- *
- * ```tsx
- * renderInTestApp(
- *   <TestApiProvider apis={[[identityApiRef, mockIdentityApi]]}>
- *     {...}
- *   </TestApiProvider>
- * )
- * ```
- *
- * Note that the cast to `IdentityApi` is no longer needed as long as the mock API
- * implements a subset of the `IdentityApi`.
- *
+ * Union type used in {@link (withLogCollector:3)} callback function.
  * @public
- **/
-export declare const TestApiProvider: <T extends any[]>(props: TestApiProviderProps<T>) => JSX.Element;
-
+ */
+declare type LogCollector = AsyncLogCollector | SyncLogCollector;
 /**
- * Properties for the {@link TestApiProvider} component.
- *
+ * Map of severity level and corresponding log lines.
  * @public
  */
-export declare type TestApiProviderProps<TApiPairs extends any[]> = {
-    apis: readonly [...TestApiProviderPropsApiPairs<TApiPairs>];
-    children: ReactNode;
+declare type CollectedLogs<T extends LogFuncs> = {
+    [key in T]: string[];
 };
+/**
+ * Asynchronous log collector with that collects all categories
+ * @public
+ */
+declare function withLogCollector(callback: AsyncLogCollector): Promise<CollectedLogs<LogFuncs>>;
+/**
+ * Synchronous log collector with that collects all categories
+ * @public
+ */
+declare function withLogCollector(callback: SyncLogCollector): CollectedLogs<LogFuncs>;
+/**
+ * Asynchronous log collector with that only collects selected categories
+ * @public
+ */
+declare function withLogCollector<T extends LogFuncs>(logsToCollect: T[], callback: AsyncLogCollector): Promise<CollectedLogs<T>>;
+/**
+ * Synchronous log collector with that only collects selected categories
+ * @public
+ */
+declare function withLogCollector<T extends LogFuncs>(logsToCollect: T[], callback: SyncLogCollector): CollectedLogs<T>;
+
+/**
+ * @public
+ * Simplifies rendering of async components in by taking care of the wrapping inside act
+ *
+ * @remarks
+ *
+ * Components using useEffect to perform an asynchronous action (such as fetch) must be rendered within an async
+ * act call to properly get the final state, even with mocked responses. This utility method makes the signature a bit
+ * cleaner, since act doesn't return the result of the evaluated function.
+ * https://github.com/testing-library/react-testing-library/issues/281
+ * https://github.com/facebook/react/pull/14853
+ */
+declare function renderWithEffects(nodes: ReactElement, options?: Pick<RenderOptions, 'wrapper'>): Promise<RenderResult>;
 
 /** @ignore */
 declare type TestApiProviderPropsApiPair<TApi> = TApi extends infer TImpl ? readonly [ApiRef<TApi>, Partial<TImpl>] : never;
-
 /** @ignore */
 declare type TestApiProviderPropsApiPairs<TApiPairs> = {
     [TIndex in keyof TApiPairs]: TestApiProviderPropsApiPair<TApiPairs[TIndex]>;
 };
-
+/**
+ * Properties for the {@link TestApiProvider} component.
+ *
+ * @public
+ */
+declare type TestApiProviderProps<TApiPairs extends any[]> = {
+    apis: readonly [...TestApiProviderPropsApiPairs<TApiPairs>];
+    children: ReactNode;
+};
 /**
  * The `TestApiRegistry` is an {@link @backstage/core-plugin-api#ApiHolder} implementation
  * that is particularly well suited for development and test environments such as
@@ -419,7 +401,7 @@ declare type TestApiProviderPropsApiPairs<TApiPairs> = {
  *
  * @public
  */
-export declare class TestApiRegistry implements ApiHolder {
+declare class TestApiRegistry implements ApiHolder {
     private readonly apis;
     /**
      * Creates a new {@link TestApiRegistry} with a list of API implementation pairs.
@@ -447,76 +429,43 @@ export declare class TestApiRegistry implements ApiHolder {
      */
     get<T>(api: ApiRef<T>): T | undefined;
 }
-
 /**
- * Options to customize the behavior of the test app wrapper.
- * @public
- */
-export declare type TestAppOptions = {
-    /**
-     * Initial route entries to pass along as `initialEntries` to the router.
-     */
-    routeEntries?: string[];
-    /**
-     * An object of paths to mount route ref on, with the key being the path and the value
-     * being the RouteRef that the path will be bound to. This allows the route refs to be
-     * used by `useRouteRef` in the rendered elements.
-     *
-     * @example
-     * wrapInTestApp(<MyComponent />, \{
-     *   mountedRoutes: \{
-     *     '/my-path': myRouteRef,
-     *   \}
-     * \})
-     * // ...
-     * const link = useRouteRef(myRouteRef)
-     */
-    mountedRoutes?: {
-        [path: string]: RouteRef | ExternalRouteRef;
-    };
-};
-
-/**
- * Returns a `@testing-library/react` valid MatcherFunction for supplied text
+ * The `TestApiProvider` is a Utility API context provider that is particularly
+ * well suited for development and test environments such as unit tests, storybooks,
+ * and isolated plugin development setups.
  *
- * @param string - text Text to match by element's textContent
+ * It lets you provide any number of API implementations, without necessarily
+ * having to fully implement each of the APIs.
  *
- * @public
- */
-export declare const textContentMatcher: (text: string) => MatcherFunction;
-
-/**
- * Asynchronous log collector with that collects all categories
- * @public
- */
-export declare function withLogCollector(callback: AsyncLogCollector): Promise<CollectedLogs<LogFuncs>>;
-
-/**
- * Synchronous log collector with that collects all categories
- * @public
- */
-export declare function withLogCollector(callback: SyncLogCollector): CollectedLogs<LogFuncs>;
-
-/**
- * Asynchronous log collector with that only collects selected categories
- * @public
- */
-export declare function withLogCollector<T extends LogFuncs>(logsToCollect: T[], callback: AsyncLogCollector): Promise<CollectedLogs<T>>;
-
-/**
- * Synchronous log collector with that only collects selected categories
- * @public
- */
-export declare function withLogCollector<T extends LogFuncs>(logsToCollect: T[], callback: SyncLogCollector): CollectedLogs<T>;
-
-/**
- * Wraps a component inside a Backstage test app, providing a mocked theme
- * and app context, along with mocked APIs.
+ * A migration from `ApiRegistry` and `ApiProvider` might look like this, from:
+ *
+ * ```tsx
+ * renderInTestApp(
+ *   <ApiProvider
+ *     apis={ApiRegistry.from([
+ *       [identityApiRef, mockIdentityApi as unknown as IdentityApi]
+ *     ])}
+ *   >
+ *     // ...
+ *   </ApiProvider>
+ * )
+ * ```
+ *
+ * To the following:
+ *
+ * ```tsx
+ * renderInTestApp(
+ *   <TestApiProvider apis={[[identityApiRef, mockIdentityApi]]}>
+ *     // ...
+ *   </TestApiProvider>
+ * )
+ * ```
+ *
+ * Note that the cast to `IdentityApi` is no longer needed as long as the mock API
+ * implements a subset of the `IdentityApi`.
  *
- * @param Component - A component or react node to render inside the test app.
- * @param options - Additional options for the rendering.
  * @public
  */
-export declare function wrapInTestApp(Component: ComponentType | ReactNode, options?: TestAppOptions): ReactElement;
+declare const TestApiProvider: <T extends any[]>(props: TestApiProviderProps<T>) => JSX.Element;
 
-export { }
+export { AsyncLogCollector, CollectedLogs, ErrorWithContext, LogCollector, LogFuncs, MockAnalyticsApi, MockConfigApi, MockErrorApi, MockErrorApiOptions, MockFetchApi, MockFetchApiOptions, MockPermissionApi, MockStorageApi, MockStorageBucket, SyncLogCollector, TestApiProvider, TestApiProviderProps, TestApiRegistry, TestAppOptions, createTestAppWrapper, mockBreakpoint, renderInTestApp, renderWithEffects, setupRequestMockHandlers, textContentMatcher, withLogCollector, wrapInTestApp };