@backstage/frontend-test-utils 0.5.3-next.0 → 0.5.3-next.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @backstage/frontend-test-utils
 
+## 0.5.3-next.1
+
+### Patch Changes
+
+- fa363f9: Added support for `ExternalRouteRef` in the `mountedRoutes` option of `renderInTestApp` and `renderTestApp`.
+- Updated dependencies
+  - @backstage/frontend-plugin-api@0.17.0-next.1
+  - @backstage/core-plugin-api@1.12.6-next.1
+  - @backstage/frontend-app-api@0.16.3-next.1
+  - @backstage/plugin-app@0.4.6-next.1
+  - @backstage/plugin-permission-common@0.9.9-next.1
+
 ## 0.5.3-next.0
 
 ### Patch Changes

package/dist/app/renderInTestApp.esm.js

@@ -4,10 +4,13 @@ import { Link, MemoryRouter } from 'react-router-dom';
 import { prepareSpecializedApp } from '@backstage/frontend-app-api';
 import { render } from '@testing-library/react';
 import { ConfigReader } from '@backstage/config';
-import { coreExtensionData, NavItemBlueprint, useRouteRef, createExtension, createFrontendModule, createFrontendPlugin, createApiFactory } from '@backstage/frontend-plugin-api';
+import { coreExtensionData, NavItemBlueprint, useRouteRef, createExtension, createRouteRef, createFrontendModule, createFrontendPlugin, createApiFactory } from '@backstage/frontend-plugin-api';
 import { RouterBlueprint } from '@backstage/plugin-app-react';
 import appPlugin from '@backstage/plugin-app';
 import { getMockApiFactory } from '../apis/MockWithApiFactory.esm.js';
+import { OpaqueExternalRouteRef } from '../frontend-internal/src/routing/OpaqueExternalRouteRef.esm.js';
+import '../frontend-internal/src/routing/OpaqueRouteRef.esm.js';
+import '../frontend-internal/src/routing/OpaqueSubRouteRef.esm.js';
 
 const DEFAULT_MOCK_CONFIG = {
   app: { baseUrl: "http://localhost:3000" },
@@ -73,8 +76,16 @@ function renderInTestApp(element, options) {
       }
     })
   ];
+  const externalBindings = /* @__PURE__ */ new Map();
   if (options?.mountedRoutes) {
-    for (const [path, routeRef] of Object.entries(options.mountedRoutes)) {
+    for (const [path, optionRef] of Object.entries(options.mountedRoutes)) {
+      let routeRef;
+      if (OpaqueExternalRouteRef.isType(optionRef)) {
+        routeRef = createRouteRef();
+        externalBindings.set(optionRef, routeRef);
+      } else {
+        routeRef = optionRef;
+      }
       extensions.push(
         createExtension({
           kind: "test-route",
@@ -141,7 +152,12 @@ function renderInTestApp(element, options) {
         const [apiRef, implementation] = entry;
         return createApiFactory(apiRef, implementation);
       })
-    }
+    },
+    bindRoutes: externalBindings.size > 0 ? ({ bind }) => {
+      for (const [externalRef, targetRef] of externalBindings) {
+        bind({ ref: externalRef }, { ref: targetRef });
+      }
+    } : void 0
   }).finalize();
   return render(
     app.tree.root.instance.getData(coreExtensionData.reactElement)

package/dist/app/renderInTestApp.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"renderInTestApp.esm.js","sources":["../../src/app/renderInTestApp.tsx"],"sourcesContent":["/*\n * Copyright 2023 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 { Fragment } from 'react';\nimport { Link, MemoryRouter } from 'react-router-dom';\nimport { prepareSpecializedApp } from '@backstage/frontend-app-api';\nimport { RenderResult, render } from '@testing-library/react';\nimport { ConfigReader } from '@backstage/config';\nimport { JsonObject } from '@backstage/types';\nimport {\n  createExtension,\n  ExtensionDefinition,\n  coreExtensionData,\n  RouteRef,\n  useRouteRef,\n  IconComponent,\n  NavItemBlueprint,\n  createFrontendPlugin,\n  FrontendFeature,\n  createFrontendModule,\n  createApiFactory,\n  type ApiRef,\n} from '@backstage/frontend-plugin-api';\nimport { RouterBlueprint } from '@backstage/plugin-app-react';\nimport appPlugin from '@backstage/plugin-app';\nimport { getMockApiFactory } from '../apis/MockWithApiFactory';\n// eslint-disable-next-line @backstage/no-relative-monorepo-imports\nimport type { CreateSpecializedAppInternalOptions } from '../../../frontend-app-api/src/wiring/createSpecializedApp';\nimport { TestApiPairs } from '../apis/TestApiProvider';\n\nconst DEFAULT_MOCK_CONFIG = {\n  app: { baseUrl: 'http://localhost:3000' },\n  backend: { baseUrl: 'http://localhost:7007' },\n};\n\n/**\n * Options to customize the behavior of the test app.\n * @public\n */\nexport type TestAppOptions<TApiPairs extends any[] = any[]> = {\n  /**\n   * An object of paths to mount route ref on, with the key being the path and the value\n   * being the RouteRef that the path will be bound to. This allows the route refs to be\n   * used by `useRouteRef` in the rendered elements.\n   *\n   * @example\n   * ```ts\n   * renderInTestApp(<MyComponent />, {\n   *   mountedRoutes: {\n   *     '/my-path': myRouteRef,\n   *   }\n   * })\n   * // ...\n   * const link = useRouteRef(myRouteRef)\n   * ```\n   */\n  mountedRoutes?: { [path: string]: RouteRef };\n\n  /**\n   * Additional configuration passed to the app when rendering elements inside it.\n   */\n  config?: JsonObject;\n\n  /**\n   * Additional features to add to the test app.\n   */\n  features?: FrontendFeature[];\n\n  /**\n   * Initial route entries to use for the router.\n   */\n  initialRouteEntries?: string[];\n\n  /**\n   * API overrides to provide to the test app. Use `mockApis` helpers\n   * from `@backstage/frontend-test-utils` to create mock implementations.\n   *\n   * @example\n   * ```ts\n   * import { mockApis } from '@backstage/frontend-test-utils';\n   *\n   * renderInTestApp(<MyComponent />, {\n   *   apis: [mockApis.identity({ userEntityRef: 'user:default/guest' })],\n   * })\n   * ```\n   */\n  apis?: readonly [...TestApiPairs<TApiPairs>];\n};\n\nconst NavItem = (props: {\n  routeRef: RouteRef<undefined>;\n  title: string;\n  icon: IconComponent;\n}) => {\n  const { routeRef, title, icon: Icon } = props;\n  const link = useRouteRef(routeRef);\n  if (!link) {\n    return null;\n  }\n  return (\n    <li>\n      <Link to={link()}>\n        <Icon /> {title}\n      </Link>\n    </li>\n  );\n};\n\nconst appPluginOverride = appPlugin.withOverrides({\n  extensions: [\n    appPlugin.getExtension('sign-in-page:app').override({\n      disabled: true,\n    }),\n    appPlugin.getExtension('app/layout').override({\n      disabled: true,\n    }),\n    appPlugin.getExtension('app/routes').override({\n      disabled: true,\n    }),\n    appPlugin.getExtension('app/nav').override({\n      output: [coreExtensionData.reactElement],\n      factory(_originalFactory, { inputs }) {\n        return [\n          coreExtensionData.reactElement(\n            <nav>\n              <ul>\n                {inputs.items.map(\n                  (item: (typeof inputs.items)[number], index: number) => {\n                    const { icon, title, routeRef } = item.get(\n                      NavItemBlueprint.dataRefs.target,\n                    );\n\n                    return (\n                      <NavItem\n                        key={index}\n                        icon={icon}\n                        title={title}\n                        routeRef={routeRef}\n                      />\n                    );\n                  },\n                )}\n              </ul>\n            </nav>,\n          ),\n        ];\n      },\n    }),\n  ],\n});\n\n/**\n * @public\n * Renders the given element in a test app, for use in unit tests.\n */\nexport function renderInTestApp<const TApiPairs extends any[] = any[]>(\n  element: JSX.Element,\n  options?: TestAppOptions<TApiPairs>,\n): RenderResult {\n  const extensions: Array<ExtensionDefinition> = [\n    createExtension({\n      attachTo: { id: 'app/root', input: 'children' },\n      output: [coreExtensionData.reactElement],\n      factory: () => {\n        return [coreExtensionData.reactElement(element)];\n      },\n    }),\n  ];\n\n  if (options?.mountedRoutes) {\n    for (const [path, routeRef] of Object.entries(options.mountedRoutes)) {\n      // TODO(Rugvip): add support for external route refs\n      extensions.push(\n        createExtension({\n          kind: 'test-route',\n          name: path,\n          attachTo: { id: 'app/root', input: 'elements' },\n          output: [\n            coreExtensionData.reactElement,\n            coreExtensionData.routePath,\n            coreExtensionData.routeRef,\n          ],\n          factory: () => [\n            coreExtensionData.reactElement(<Fragment />),\n            coreExtensionData.routePath(path),\n            coreExtensionData.routeRef(routeRef),\n          ],\n        }),\n      );\n    }\n  }\n\n  const features: FrontendFeature[] = [\n    createFrontendModule({\n      pluginId: 'app',\n      extensions: [\n        RouterBlueprint.make({\n          params: {\n            component: ({ children }) => (\n              <MemoryRouter\n                initialEntries={options?.initialRouteEntries}\n                future={{\n                  v7_relativeSplatPath: false,\n                  v7_startTransition: false,\n                }}\n              >\n                {children}\n              </MemoryRouter>\n            ),\n          },\n        }),\n      ],\n    }),\n    createFrontendPlugin({\n      pluginId: 'test',\n      extensions,\n    }),\n    appPluginOverride,\n  ];\n\n  if (options?.features) {\n    features.push(...options.features);\n  }\n\n  const app = prepareSpecializedApp({\n    features,\n    config: ConfigReader.fromConfigs([\n      {\n        context: 'render-config',\n        data: options?.config ?? DEFAULT_MOCK_CONFIG,\n      },\n    ]),\n    __internal: options?.apis && {\n      apiFactoryOverrides: options.apis.map(entry => {\n        const mockFactory = getMockApiFactory(entry);\n        if (mockFactory) {\n          return mockFactory;\n        }\n        const [apiRef, implementation] = entry as readonly [ApiRef<any>, any];\n        return createApiFactory(apiRef, implementation);\n      }),\n    },\n  } as CreateSpecializedAppInternalOptions).finalize();\n\n  return render(\n    app.tree.root.instance!.getData(coreExtensionData.reactElement),\n  );\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"renderInTestApp.esm.js","sources":["../../src/app/renderInTestApp.tsx"],"sourcesContent":["/*\n * Copyright 2023 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 { Fragment } from 'react';\nimport { Link, MemoryRouter } from 'react-router-dom';\nimport { prepareSpecializedApp } from '@backstage/frontend-app-api';\nimport { RenderResult, render } from '@testing-library/react';\nimport { ConfigReader } from '@backstage/config';\nimport { JsonObject } from '@backstage/types';\nimport {\n  createExtension,\n  ExtensionDefinition,\n  coreExtensionData,\n  RouteRef,\n  useRouteRef,\n  IconComponent,\n  NavItemBlueprint,\n  createFrontendPlugin,\n  FrontendFeature,\n  createFrontendModule,\n  createApiFactory,\n  createRouteRef,\n  ExternalRouteRef,\n  type ApiRef,\n} from '@backstage/frontend-plugin-api';\nimport { RouterBlueprint } from '@backstage/plugin-app-react';\nimport appPlugin from '@backstage/plugin-app';\nimport { getMockApiFactory } from '../apis/MockWithApiFactory';\n// eslint-disable-next-line @backstage/no-relative-monorepo-imports\nimport type { CreateSpecializedAppInternalOptions } from '../../../frontend-app-api/src/wiring/createSpecializedApp';\nimport { TestApiPairs } from '../apis/TestApiProvider';\nimport { OpaqueExternalRouteRef } from '@internal/frontend';\n\nconst DEFAULT_MOCK_CONFIG = {\n  app: { baseUrl: 'http://localhost:3000' },\n  backend: { baseUrl: 'http://localhost:7007' },\n};\n\n/**\n * Options to customize the behavior of the test app.\n * @public\n */\nexport type TestAppOptions<TApiPairs extends any[] = any[]> = {\n  /**\n   * An object of paths to mount route ref on, with the key being the path and the value\n   * being the route ref that the path will be bound to. This allows the route refs to be\n   * used by `useRouteRef` in the rendered elements.\n   *\n   * @example\n   * ```ts\n   * renderInTestApp(<MyComponent />, {\n   *   mountedRoutes: {\n   *     '/my-path': myRouteRef,\n   *   }\n   * })\n   * // ...\n   * const link = useRouteRef(myRouteRef)\n   * ```\n   */\n  mountedRoutes?: { [path: string]: RouteRef | ExternalRouteRef };\n\n  /**\n   * Additional configuration passed to the app when rendering elements inside it.\n   */\n  config?: JsonObject;\n\n  /**\n   * Additional features to add to the test app.\n   */\n  features?: FrontendFeature[];\n\n  /**\n   * Initial route entries to use for the router.\n   */\n  initialRouteEntries?: string[];\n\n  /**\n   * API overrides to provide to the test app. Use `mockApis` helpers\n   * from `@backstage/frontend-test-utils` to create mock implementations.\n   *\n   * @example\n   * ```ts\n   * import { mockApis } from '@backstage/frontend-test-utils';\n   *\n   * renderInTestApp(<MyComponent />, {\n   *   apis: [mockApis.identity({ userEntityRef: 'user:default/guest' })],\n   * })\n   * ```\n   */\n  apis?: readonly [...TestApiPairs<TApiPairs>];\n};\n\nconst NavItem = (props: {\n  routeRef: RouteRef<undefined>;\n  title: string;\n  icon: IconComponent;\n}) => {\n  const { routeRef, title, icon: Icon } = props;\n  const link = useRouteRef(routeRef);\n  if (!link) {\n    return null;\n  }\n  return (\n    <li>\n      <Link to={link()}>\n        <Icon /> {title}\n      </Link>\n    </li>\n  );\n};\n\nconst appPluginOverride = appPlugin.withOverrides({\n  extensions: [\n    appPlugin.getExtension('sign-in-page:app').override({\n      disabled: true,\n    }),\n    appPlugin.getExtension('app/layout').override({\n      disabled: true,\n    }),\n    appPlugin.getExtension('app/routes').override({\n      disabled: true,\n    }),\n    appPlugin.getExtension('app/nav').override({\n      output: [coreExtensionData.reactElement],\n      factory(_originalFactory, { inputs }) {\n        return [\n          coreExtensionData.reactElement(\n            <nav>\n              <ul>\n                {inputs.items.map(\n                  (item: (typeof inputs.items)[number], index: number) => {\n                    const { icon, title, routeRef } = item.get(\n                      NavItemBlueprint.dataRefs.target,\n                    );\n\n                    return (\n                      <NavItem\n                        key={index}\n                        icon={icon}\n                        title={title}\n                        routeRef={routeRef}\n                      />\n                    );\n                  },\n                )}\n              </ul>\n            </nav>,\n          ),\n        ];\n      },\n    }),\n  ],\n});\n\n/**\n * @public\n * Renders the given element in a test app, for use in unit tests.\n */\nexport function renderInTestApp<const TApiPairs extends any[] = any[]>(\n  element: JSX.Element,\n  options?: TestAppOptions<TApiPairs>,\n): RenderResult {\n  const extensions: Array<ExtensionDefinition> = [\n    createExtension({\n      attachTo: { id: 'app/root', input: 'children' },\n      output: [coreExtensionData.reactElement],\n      factory: () => {\n        return [coreExtensionData.reactElement(element)];\n      },\n    }),\n  ];\n\n  const externalBindings = new Map<ExternalRouteRef, RouteRef>();\n\n  if (options?.mountedRoutes) {\n    for (const [path, optionRef] of Object.entries(options.mountedRoutes)) {\n      let routeRef: RouteRef;\n\n      if (OpaqueExternalRouteRef.isType(optionRef)) {\n        // Create an actual route ref for the external route, then bind the external ref to it\n        routeRef = createRouteRef();\n        externalBindings.set(optionRef, routeRef);\n      } else {\n        routeRef = optionRef;\n      }\n\n      extensions.push(\n        createExtension({\n          kind: 'test-route',\n          name: path,\n          attachTo: { id: 'app/root', input: 'elements' },\n          output: [\n            coreExtensionData.reactElement,\n            coreExtensionData.routePath,\n            coreExtensionData.routeRef,\n          ],\n          factory: () => [\n            coreExtensionData.reactElement(<Fragment />),\n            coreExtensionData.routePath(path),\n            coreExtensionData.routeRef(routeRef),\n          ],\n        }),\n      );\n    }\n  }\n\n  const features: FrontendFeature[] = [\n    createFrontendModule({\n      pluginId: 'app',\n      extensions: [\n        RouterBlueprint.make({\n          params: {\n            component: ({ children }) => (\n              <MemoryRouter\n                initialEntries={options?.initialRouteEntries}\n                future={{\n                  v7_relativeSplatPath: false,\n                  v7_startTransition: false,\n                }}\n              >\n                {children}\n              </MemoryRouter>\n            ),\n          },\n        }),\n      ],\n    }),\n    createFrontendPlugin({\n      pluginId: 'test',\n      extensions,\n    }),\n    appPluginOverride,\n  ];\n\n  if (options?.features) {\n    features.push(...options.features);\n  }\n\n  const app = prepareSpecializedApp({\n    features,\n    config: ConfigReader.fromConfigs([\n      {\n        context: 'render-config',\n        data: options?.config ?? DEFAULT_MOCK_CONFIG,\n      },\n    ]),\n    __internal: options?.apis && {\n      apiFactoryOverrides: options.apis.map(entry => {\n        const mockFactory = getMockApiFactory(entry);\n        if (mockFactory) {\n          return mockFactory;\n        }\n        const [apiRef, implementation] = entry as readonly [ApiRef<any>, any];\n        return createApiFactory(apiRef, implementation);\n      }),\n    },\n    bindRoutes:\n      externalBindings.size > 0\n        ? ({ bind }) => {\n            for (const [externalRef, targetRef] of externalBindings) {\n              bind({ ref: externalRef }, { ref: targetRef });\n            }\n          }\n        : undefined,\n  } as CreateSpecializedAppInternalOptions).finalize();\n\n  return render(\n    app.tree.root.instance!.getData(coreExtensionData.reactElement),\n  );\n}\n"],"names":[],"mappings":"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"}

package/dist/app/renderTestApp.esm.js

@@ -1,13 +1,16 @@
 import { jsx } from 'react/jsx-runtime';
 import { Fragment } from 'react';
 import { prepareSpecializedApp } from '@backstage/frontend-app-api';
-import { createExtension, coreExtensionData, createFrontendModule, createFrontendPlugin, createApiFactory } from '@backstage/frontend-plugin-api';
+import { createRouteRef, createExtension, coreExtensionData, createFrontendModule, createFrontendPlugin, createApiFactory } from '@backstage/frontend-plugin-api';
 import { render } from '@testing-library/react';
 import appPlugin from '@backstage/plugin-app';
 import { ConfigReader } from '@backstage/config';
 import { MemoryRouter } from 'react-router-dom';
 import { RouterBlueprint } from '@backstage/plugin-app-react';
 import { getMockApiFactory } from '../apis/MockWithApiFactory.esm.js';
+import { OpaqueExternalRouteRef } from '../frontend-internal/src/routing/OpaqueExternalRouteRef.esm.js';
+import '../frontend-internal/src/routing/OpaqueRouteRef.esm.js';
+import '../frontend-internal/src/routing/OpaqueSubRouteRef.esm.js';
 
 const DEFAULT_MOCK_CONFIG = {
   app: { baseUrl: "http://localhost:3000" },
@@ -22,8 +25,16 @@ const appPluginOverride = appPlugin.withOverrides({
 });
 function renderTestApp(options) {
   const extensions = [...options?.extensions ?? []];
+  const externalBindings = /* @__PURE__ */ new Map();
   if (options?.mountedRoutes) {
-    for (const [path, routeRef] of Object.entries(options.mountedRoutes)) {
+    for (const [path, optionRef] of Object.entries(options.mountedRoutes)) {
+      let routeRef;
+      if (OpaqueExternalRouteRef.isType(optionRef)) {
+        routeRef = createRouteRef();
+        externalBindings.set(optionRef, routeRef);
+      } else {
+        routeRef = optionRef;
+      }
       extensions.push(
         createExtension({
           kind: "test-route",
@@ -90,7 +101,12 @@ function renderTestApp(options) {
         const [apiRef, implementation] = entry;
         return createApiFactory(apiRef, implementation);
       })
-    }
+    },
+    bindRoutes: externalBindings.size > 0 ? ({ bind }) => {
+      for (const [externalRef, targetRef] of externalBindings) {
+        bind({ ref: externalRef }, { ref: targetRef });
+      }
+    } : void 0
   }).finalize();
   return render(
     app.tree.root.instance.getData(coreExtensionData.reactElement)

package/dist/app/renderTestApp.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"renderTestApp.esm.js","sources":["../../src/app/renderTestApp.tsx"],"sourcesContent":["/*\n * Copyright 2025 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 { Fragment } from 'react';\nimport { prepareSpecializedApp } from '@backstage/frontend-app-api';\nimport {\n  coreExtensionData,\n  createApiFactory,\n  createExtension,\n  createFrontendModule,\n  createFrontendPlugin,\n  ExtensionDefinition,\n  FrontendFeature,\n  RouteRef,\n  type ApiRef,\n} from '@backstage/frontend-plugin-api';\nimport { render, type RenderResult } from '@testing-library/react';\nimport appPlugin from '@backstage/plugin-app';\nimport { JsonObject } from '@backstage/types';\nimport { ConfigReader } from '@backstage/config';\nimport { MemoryRouter } from 'react-router-dom';\nimport { RouterBlueprint } from '@backstage/plugin-app-react';\nimport { getMockApiFactory } from '../apis/MockWithApiFactory';\n// eslint-disable-next-line @backstage/no-relative-monorepo-imports\nimport type { CreateSpecializedAppInternalOptions } from '../../../frontend-app-api/src/wiring/createSpecializedApp';\nimport { TestApiPairs } from '../apis/TestApiProvider';\n\nconst DEFAULT_MOCK_CONFIG = {\n  app: { baseUrl: 'http://localhost:3000' },\n  backend: { baseUrl: 'http://localhost:7007' },\n};\n\n/**\n * Options for `renderTestApp`.\n *\n * @public\n */\nexport type RenderTestAppOptions<TApiPairs extends any[] = any[]> = {\n  /**\n   * Additional configuration passed to the app when rendering elements inside it.\n   */\n  config?: JsonObject;\n  /**\n   * Additional extensions to add to the test app.\n   */\n  extensions?: ExtensionDefinition<any>[];\n\n  /**\n   * Additional features to add to the test app.\n   */\n  features?: FrontendFeature[];\n\n  /**\n   * Initial route entries to use for the router.\n   */\n  initialRouteEntries?: string[];\n\n  /**\n   * An object of paths to mount route refs on, with the key being the path and\n   * the value being the RouteRef that the path will be bound to. This allows\n   * the route refs to be used by `useRouteRef` in the rendered elements.\n   *\n   * @example\n   * ```ts\n   * renderTestApp({\n   *   mountedRoutes: {\n   *     '/my-path': myRouteRef,\n   *   },\n   *   extensions: [...],\n   * })\n   * ```\n   */\n  mountedRoutes?: { [path: string]: RouteRef };\n\n  /**\n   * API overrides to provide to the test app. Use `mockApis` helpers\n   * from `@backstage/frontend-test-utils` to create mock implementations.\n   *\n   * @example\n   * ```ts\n   * import { mockApis } from '@backstage/frontend-test-utils';\n   *\n   * renderTestApp({\n   *   apis: [mockApis.identity({ userEntityRef: 'user:default/guest' })],\n   *   extensions: [...],\n   * })\n   * ```\n   */\n  apis?: readonly [...TestApiPairs<TApiPairs>];\n};\n\nconst appPluginOverride = appPlugin.withOverrides({\n  extensions: [\n    appPlugin.getExtension('sign-in-page:app').override({\n      disabled: true,\n    }),\n  ],\n});\n\n/**\n * Renders the provided extensions inside a Backstage app, returning the same\n * utilities as `@testing-library/react` `render` function.\n *\n * @public\n */\nexport function renderTestApp<const TApiPairs extends any[] = any[]>(\n  options?: RenderTestAppOptions<TApiPairs>,\n): RenderResult {\n  const extensions = [...(options?.extensions ?? [])];\n\n  if (options?.mountedRoutes) {\n    for (const [path, routeRef] of Object.entries(options.mountedRoutes)) {\n      extensions.push(\n        createExtension({\n          kind: 'test-route',\n          name: path,\n          attachTo: { id: 'app/routes', input: 'routes' },\n          output: [\n            coreExtensionData.reactElement,\n            coreExtensionData.routePath,\n            coreExtensionData.routeRef,\n          ],\n          factory: () => [\n            coreExtensionData.reactElement(<Fragment />),\n            coreExtensionData.routePath(path),\n            coreExtensionData.routeRef(routeRef),\n          ],\n        }),\n      );\n    }\n  }\n\n  const features: FrontendFeature[] = [\n    createFrontendModule({\n      pluginId: 'app',\n      extensions: [\n        RouterBlueprint.make({\n          params: {\n            component: ({ children }) => (\n              <MemoryRouter\n                initialEntries={options?.initialRouteEntries}\n                future={{\n                  v7_relativeSplatPath: false,\n                  v7_startTransition: false,\n                }}\n              >\n                {children}\n              </MemoryRouter>\n            ),\n          },\n        }),\n      ],\n    }),\n    createFrontendPlugin({\n      pluginId: 'test',\n      extensions,\n    }),\n    appPluginOverride,\n  ];\n\n  if (options?.features) {\n    features.push(...options.features);\n  }\n\n  const app = prepareSpecializedApp({\n    features,\n    config: ConfigReader.fromConfigs([\n      {\n        context: 'render-config',\n        data: options?.config ?? DEFAULT_MOCK_CONFIG,\n      },\n    ]),\n    __internal: options?.apis && {\n      apiFactoryOverrides: options.apis.map(entry => {\n        const mockFactory = getMockApiFactory(entry);\n        if (mockFactory) {\n          return mockFactory;\n        }\n        const [apiRef, implementation] = entry as readonly [ApiRef<any>, any];\n        return createApiFactory(apiRef, implementation);\n      }),\n    },\n  } as CreateSpecializedAppInternalOptions).finalize();\n\n  return render(\n    app.tree.root.instance!.getData(coreExtensionData.reactElement),\n  );\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"renderTestApp.esm.js","sources":["../../src/app/renderTestApp.tsx"],"sourcesContent":["/*\n * Copyright 2025 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 { Fragment } from 'react';\nimport { prepareSpecializedApp } from '@backstage/frontend-app-api';\nimport {\n  coreExtensionData,\n  createApiFactory,\n  createExtension,\n  createFrontendModule,\n  createFrontendPlugin,\n  ExtensionDefinition,\n  FrontendFeature,\n  RouteRef,\n  ExternalRouteRef,\n  createRouteRef,\n  type ApiRef,\n} from '@backstage/frontend-plugin-api';\nimport { render, type RenderResult } from '@testing-library/react';\nimport appPlugin from '@backstage/plugin-app';\nimport { JsonObject } from '@backstage/types';\nimport { ConfigReader } from '@backstage/config';\nimport { MemoryRouter } from 'react-router-dom';\nimport { RouterBlueprint } from '@backstage/plugin-app-react';\nimport { getMockApiFactory } from '../apis/MockWithApiFactory';\n// eslint-disable-next-line @backstage/no-relative-monorepo-imports\nimport type { CreateSpecializedAppInternalOptions } from '../../../frontend-app-api/src/wiring/createSpecializedApp';\nimport { TestApiPairs } from '../apis/TestApiProvider';\nimport { OpaqueExternalRouteRef } from '@internal/frontend';\n\nconst DEFAULT_MOCK_CONFIG = {\n  app: { baseUrl: 'http://localhost:3000' },\n  backend: { baseUrl: 'http://localhost:7007' },\n};\n\n/**\n * Options for `renderTestApp`.\n *\n * @public\n */\nexport type RenderTestAppOptions<TApiPairs extends any[] = any[]> = {\n  /**\n   * Additional configuration passed to the app when rendering elements inside it.\n   */\n  config?: JsonObject;\n  /**\n   * Additional extensions to add to the test app.\n   */\n  extensions?: ExtensionDefinition<any>[];\n\n  /**\n   * Additional features to add to the test app.\n   */\n  features?: FrontendFeature[];\n\n  /**\n   * Initial route entries to use for the router.\n   */\n  initialRouteEntries?: string[];\n\n  /**\n   * An object of paths to mount route refs on, with the key being the path and\n   * the value being the route ref that the path will be bound to. This allows\n   * the route refs to be used by `useRouteRef` in the rendered elements.\n   *\n   * @example\n   * ```ts\n   * renderTestApp({\n   *   mountedRoutes: {\n   *     '/my-path': myRouteRef,\n   *   },\n   *   extensions: [...],\n   * })\n   * ```\n   */\n  mountedRoutes?: { [path: string]: RouteRef | ExternalRouteRef };\n\n  /**\n   * API overrides to provide to the test app. Use `mockApis` helpers\n   * from `@backstage/frontend-test-utils` to create mock implementations.\n   *\n   * @example\n   * ```ts\n   * import { mockApis } from '@backstage/frontend-test-utils';\n   *\n   * renderTestApp({\n   *   apis: [mockApis.identity({ userEntityRef: 'user:default/guest' })],\n   *   extensions: [...],\n   * })\n   * ```\n   */\n  apis?: readonly [...TestApiPairs<TApiPairs>];\n};\n\nconst appPluginOverride = appPlugin.withOverrides({\n  extensions: [\n    appPlugin.getExtension('sign-in-page:app').override({\n      disabled: true,\n    }),\n  ],\n});\n\n/**\n * Renders the provided extensions inside a Backstage app, returning the same\n * utilities as `@testing-library/react` `render` function.\n *\n * @public\n */\nexport function renderTestApp<const TApiPairs extends any[] = any[]>(\n  options?: RenderTestAppOptions<TApiPairs>,\n): RenderResult {\n  const extensions = [...(options?.extensions ?? [])];\n\n  const externalBindings = new Map<ExternalRouteRef, RouteRef>();\n\n  if (options?.mountedRoutes) {\n    for (const [path, optionRef] of Object.entries(options.mountedRoutes)) {\n      let routeRef: RouteRef;\n\n      if (OpaqueExternalRouteRef.isType(optionRef)) {\n        // Create an actual route ref for the external route, then bind the external ref to it\n        routeRef = createRouteRef();\n        externalBindings.set(optionRef, routeRef);\n      } else {\n        routeRef = optionRef;\n      }\n\n      extensions.push(\n        createExtension({\n          kind: 'test-route',\n          name: path,\n          attachTo: { id: 'app/routes', input: 'routes' },\n          output: [\n            coreExtensionData.reactElement,\n            coreExtensionData.routePath,\n            coreExtensionData.routeRef,\n          ],\n          factory: () => [\n            coreExtensionData.reactElement(<Fragment />),\n            coreExtensionData.routePath(path),\n            coreExtensionData.routeRef(routeRef),\n          ],\n        }),\n      );\n    }\n  }\n\n  const features: FrontendFeature[] = [\n    createFrontendModule({\n      pluginId: 'app',\n      extensions: [\n        RouterBlueprint.make({\n          params: {\n            component: ({ children }) => (\n              <MemoryRouter\n                initialEntries={options?.initialRouteEntries}\n                future={{\n                  v7_relativeSplatPath: false,\n                  v7_startTransition: false,\n                }}\n              >\n                {children}\n              </MemoryRouter>\n            ),\n          },\n        }),\n      ],\n    }),\n    createFrontendPlugin({\n      pluginId: 'test',\n      extensions,\n    }),\n    appPluginOverride,\n  ];\n\n  if (options?.features) {\n    features.push(...options.features);\n  }\n\n  const app = prepareSpecializedApp({\n    features,\n    config: ConfigReader.fromConfigs([\n      {\n        context: 'render-config',\n        data: options?.config ?? DEFAULT_MOCK_CONFIG,\n      },\n    ]),\n    __internal: options?.apis && {\n      apiFactoryOverrides: options.apis.map(entry => {\n        const mockFactory = getMockApiFactory(entry);\n        if (mockFactory) {\n          return mockFactory;\n        }\n        const [apiRef, implementation] = entry as readonly [ApiRef<any>, any];\n        return createApiFactory(apiRef, implementation);\n      }),\n    },\n    bindRoutes:\n      externalBindings.size > 0\n        ? ({ bind }) => {\n            for (const [externalRef, targetRef] of externalBindings) {\n              bind({ ref: externalRef }, { ref: targetRef });\n            }\n          }\n        : undefined,\n  } as CreateSpecializedAppInternalOptions).finalize();\n\n  return render(\n    app.tree.root.instance!.getData(coreExtensionData.reactElement),\n  );\n}\n"],"names":[],"mappings":"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"}

package/dist/frontend-app-api/src/wiring/createErrorCollector.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"createErrorCollector.esm.js","sources":["../../../../../frontend-app-api/src/wiring/createErrorCollector.ts"],"sourcesContent":["/*\n * Copyright 2025 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 { AppNode, FrontendPlugin } from '@backstage/frontend-plugin-api';\n\n/**\n * @public\n */\nexport type AppErrorTypes = {\n  // resolveAppNodeSpecs\n  EXTENSION_IGNORED: {\n    context: { plugin: FrontendPlugin; extensionId: string };\n  };\n  INVALID_EXTENSION_CONFIG_KEY: {\n    context: { extensionId: string };\n  };\n  // resolveAppTree\n  EXTENSION_INPUT_REDIRECT_CONFLICT: {\n    context: { node: AppNode; inputName: string };\n  };\n  // instantiateAppNodeTree\n  EXTENSION_INPUT_DATA_IGNORED: {\n    context: { node: AppNode; inputName: string };\n  };\n  EXTENSION_INPUT_DATA_MISSING: {\n    context: { node: AppNode; inputName: string };\n  };\n  EXTENSION_INPUT_INTERNAL_IGNORED: {\n    context: {\n      node: AppNode;\n      inputName: string;\n      extensionId: string;\n      plugin: FrontendPlugin;\n    };\n  };\n  EXTENSION_ATTACHMENT_CONFLICT: {\n    context: { node: AppNode; inputName: string };\n  };\n  EXTENSION_ATTACHMENT_MISSING: {\n    context: { node: AppNode; inputName: string };\n  };\n  EXTENSION_CONFIGURATION_INVALID: {\n    context: { node: AppNode };\n  };\n  EXTENSION_INVALID: {\n    context: { node: AppNode };\n  };\n  EXTENSION_OUTPUT_CONFLICT: {\n    context: { node: AppNode; dataRefId: string };\n  };\n  EXTENSION_OUTPUT_MISSING: {\n    context: { node: AppNode; dataRefId: string };\n  };\n  EXTENSION_OUTPUT_IGNORED: {\n    context: { node: AppNode; dataRefId: string };\n  };\n  EXTENSION_FACTORY_ERROR: {\n    context: { node: AppNode };\n  };\n  // createSpecializedApp\n  API_EXTENSION_INVALID: {\n    context: { node: AppNode };\n  };\n  API_FACTORY_CONFLICT: {\n    context: {\n      node: AppNode;\n      apiRefId: string;\n      pluginId: string;\n      existingPluginId: string;\n    };\n  };\n  EXTENSION_BOOTSTRAP_PREDICATE_IGNORED: {\n    context: { node: AppNode };\n  };\n  EXTENSION_BOOTSTRAP_API_UNAVAILABLE: {\n    context: { node: AppNode; apiRefId: string };\n  };\n  EXTENSION_BOOTSTRAP_API_OVERRIDE_IGNORED: {\n    context: {\n      node: AppNode;\n      apiRefId: string;\n      bootstrapNode: AppNode;\n      pluginId: string;\n      bootstrapPluginId: string;\n    };\n  };\n  // routing\n  ROUTE_DUPLICATE: {\n    context: { routeId: string };\n  };\n  ROUTE_BINDING_INVALID_VALUE: {\n    context: { routeId: string };\n  };\n  ROUTE_NOT_FOUND: {\n    context: { routeId: string };\n  };\n};\n\n/**\n * @public\n */\nexport type AppError =\n  keyof AppErrorTypes extends infer ICode extends keyof AppErrorTypes\n    ? ICode extends any\n      ? {\n          code: ICode;\n          message: string;\n          context: AppErrorTypes[ICode]['context'];\n        }\n      : never\n    : never;\n\n/** @internal */\nexport interface ErrorCollector<TContext extends {} = {}> {\n  report<TCode extends keyof AppErrorTypes>(\n    report: Omit<\n      AppErrorTypes[TCode]['context'],\n      keyof TContext\n    > extends infer IContext extends {}\n      ? {} extends IContext\n        ? {\n            code: TCode;\n            message: string;\n          }\n        : {\n            code: TCode;\n            message: string;\n            context: IContext;\n          }\n      : never,\n  ): void;\n  child<TAdditionalContext extends {}>(\n    context: TAdditionalContext,\n  ): ErrorCollector<TContext & TAdditionalContext>;\n  collectErrors(): AppError[] | undefined;\n}\n\n/** @internal */\nexport function createErrorCollector(\n  context?: Partial<AppError['context']>,\n): ErrorCollector {\n  const errors: AppError[] = [];\n  const children: ErrorCollector[] = [];\n  return {\n    report(report: { code: string; message: string; context?: {} }) {\n      errors.push({\n        ...report,\n        context: { ...context, ...report.context },\n      } as AppError);\n    },\n    collectErrors() {\n      const allErrors = [\n        ...errors,\n        ...children.flatMap(child => child.collectErrors() ?? []),\n      ];\n      errors.length = 0;\n      if (allErrors.length === 0) {\n        return undefined;\n      }\n      return allErrors;\n    },\n    child(childContext) {\n      const child = createErrorCollector({ ...context, ...childContext });\n      children.push(child);\n      return child as ErrorCollector<any>;\n    },\n  };\n}\n"],"names":[],"mappings":"AAuJO,SAAS,qBACd,OAAA,EACgB;AAChB,EAAA,MAAM,SAAqB,EAAC;AAC5B,EAAA,MAAM,WAA6B,EAAC;AACpC,EAAA,OAAO;AAAA,IACL,OAAO,MAAA,EAAyD;AAC9D,MAAA,MAAA,CAAO,IAAA,CAAK;AAAA,QACV,GAAG,MAAA;AAAA,QACH,SAAS,EAAE,GAAG,OAAA,EAAS,GAAG,OAAO,OAAA;AAAQ,OAC9B,CAAA;AAAA,IACf,CAAA;AAAA,IACA,aAAA,GAAgB;AACd,MAAA,MAAM,SAAA,GAAY;AAAA,QAChB,GAAG,MAAA;AAAA,QACH,GAAG,SAAS,OAAA,CAAQ,CAAA,KAAA,KAAS,MAAM,aAAA,EAAc,IAAK,EAAE;AAAA,OAC1D;AACA,MAAA,MAAA,CAAO,MAAA,GAAS,CAAA;AAChB,MAAA,IAAI,SAAA,CAAU,WAAW,CAAA,EAAG;AAC1B,QAAA,OAAO,MAAA;AAAA,MACT;AACA,MAAA,OAAO,SAAA;AAAA,IACT,CAAA;AAAA,IACA,MAAM,YAAA,EAAc;AAClB,MAAA,MAAM,QAAQ,oBAAA,CAAqB,EAAE,GAAG,OAAA,EAAS,GAAG,cAAc,CAAA;AAClE,MAAA,QAAA,CAAS,KAAK,KAAK,CAAA;AACnB,MAAA,OAAO,KAAA;AAAA,IACT;AAAA,GACF;AACF;;;;"}
+{"version":3,"file":"createErrorCollector.esm.js","sources":["../../../../../frontend-app-api/src/wiring/createErrorCollector.ts"],"sourcesContent":["/*\n * Copyright 2025 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 { AppNode, FrontendPlugin } from '@backstage/frontend-plugin-api';\n\n/**\n * @public\n */\nexport type AppErrorTypes = {\n  // resolveAppNodeSpecs\n  EXTENSION_IGNORED: {\n    context: { plugin: FrontendPlugin; extensionId: string };\n  };\n  INVALID_EXTENSION_CONFIG_KEY: {\n    context: { extensionId: string };\n  };\n  // resolveAppTree\n  EXTENSION_INPUT_REDIRECT_CONFLICT: {\n    context: { node: AppNode; inputName: string };\n  };\n  // instantiateAppNodeTree\n  EXTENSION_INPUT_DATA_IGNORED: {\n    context: { node: AppNode; inputName: string };\n  };\n  EXTENSION_INPUT_DATA_MISSING: {\n    context: { node: AppNode; inputName: string };\n  };\n  EXTENSION_INPUT_INTERNAL_IGNORED: {\n    context: {\n      node: AppNode;\n      inputName: string;\n      extensionId: string;\n      plugin: FrontendPlugin;\n    };\n  };\n  EXTENSION_ATTACHMENT_CONFLICT: {\n    context: { node: AppNode; inputName: string };\n  };\n  EXTENSION_ATTACHMENT_MISSING: {\n    context: { node: AppNode; inputName: string };\n  };\n  EXTENSION_CONFIGURATION_INVALID: {\n    context: { node: AppNode };\n  };\n  EXTENSION_INVALID: {\n    context: { node: AppNode };\n  };\n  EXTENSION_OUTPUT_CONFLICT: {\n    context: { node: AppNode; dataRefId: string };\n  };\n  EXTENSION_OUTPUT_MISSING: {\n    context: { node: AppNode; dataRefId: string };\n  };\n  EXTENSION_OUTPUT_IGNORED: {\n    context: { node: AppNode; dataRefId: string };\n  };\n  EXTENSION_FACTORY_ERROR: {\n    context: { node: AppNode };\n  };\n  // createSpecializedApp\n  API_EXTENSION_INVALID: {\n    context: { node: AppNode };\n  };\n  API_FACTORY_CONFLICT: {\n    context: {\n      node: AppNode;\n      apiRefId: string;\n      pluginId: string;\n      existingPluginId: string;\n    };\n  };\n  EXTENSION_BOOTSTRAP_PREDICATE_IGNORED: {\n    context: { node: AppNode };\n  };\n  EXTENSION_BOOTSTRAP_API_UNAVAILABLE: {\n    context: { node: AppNode; apiRefId: string };\n  };\n  EXTENSION_BOOTSTRAP_API_OVERRIDE_IGNORED: {\n    context: {\n      node: AppNode;\n      apiRefId: string;\n      bootstrapNode: AppNode;\n      pluginId: string;\n      bootstrapPluginId: string;\n    };\n  };\n  FEATURE_FLAG_INVALID: {\n    context: { pluginId: string; flagName: string; error: Error };\n  };\n  // routing\n  ROUTE_DUPLICATE: {\n    context: { routeId: string };\n  };\n  ROUTE_BINDING_INVALID_VALUE: {\n    context: { routeId: string };\n  };\n  ROUTE_NOT_FOUND: {\n    context: { routeId: string };\n  };\n};\n\n/**\n * @public\n */\nexport type AppError =\n  keyof AppErrorTypes extends infer ICode extends keyof AppErrorTypes\n    ? ICode extends any\n      ? {\n          code: ICode;\n          message: string;\n          context: AppErrorTypes[ICode]['context'];\n        }\n      : never\n    : never;\n\n/** @internal */\nexport interface ErrorCollector<TContext extends {} = {}> {\n  report<TCode extends keyof AppErrorTypes>(\n    report: Omit<\n      AppErrorTypes[TCode]['context'],\n      keyof TContext\n    > extends infer IContext extends {}\n      ? {} extends IContext\n        ? {\n            code: TCode;\n            message: string;\n          }\n        : {\n            code: TCode;\n            message: string;\n            context: IContext;\n          }\n      : never,\n  ): void;\n  child<TAdditionalContext extends {}>(\n    context: TAdditionalContext,\n  ): ErrorCollector<TContext & TAdditionalContext>;\n  collectErrors(): AppError[] | undefined;\n}\n\n/** @internal */\nexport function createErrorCollector(\n  context?: Partial<AppError['context']>,\n): ErrorCollector {\n  const errors: AppError[] = [];\n  const children: ErrorCollector[] = [];\n  return {\n    report(report: { code: string; message: string; context?: {} }) {\n      errors.push({\n        ...report,\n        context: { ...context, ...report.context },\n      } as AppError);\n    },\n    collectErrors() {\n      const allErrors = [\n        ...errors,\n        ...children.flatMap(child => child.collectErrors() ?? []),\n      ];\n      errors.length = 0;\n      if (allErrors.length === 0) {\n        return undefined;\n      }\n      return allErrors;\n    },\n    child(childContext) {\n      const child = createErrorCollector({ ...context, ...childContext });\n      children.push(child);\n      return child as ErrorCollector<any>;\n    },\n  };\n}\n"],"names":[],"mappings":"AA0JO,SAAS,qBACd,OAAA,EACgB;AAChB,EAAA,MAAM,SAAqB,EAAC;AAC5B,EAAA,MAAM,WAA6B,EAAC;AACpC,EAAA,OAAO;AAAA,IACL,OAAO,MAAA,EAAyD;AAC9D,MAAA,MAAA,CAAO,IAAA,CAAK;AAAA,QACV,GAAG,MAAA;AAAA,QACH,SAAS,EAAE,GAAG,OAAA,EAAS,GAAG,OAAO,OAAA;AAAQ,OAC9B,CAAA;AAAA,IACf,CAAA;AAAA,IACA,aAAA,GAAgB;AACd,MAAA,MAAM,SAAA,GAAY;AAAA,QAChB,GAAG,MAAA;AAAA,QACH,GAAG,SAAS,OAAA,CAAQ,CAAA,KAAA,KAAS,MAAM,aAAA,EAAc,IAAK,EAAE;AAAA,OAC1D;AACA,MAAA,MAAA,CAAO,MAAA,GAAS,CAAA;AAChB,MAAA,IAAI,SAAA,CAAU,WAAW,CAAA,EAAG;AAC1B,QAAA,OAAO,MAAA;AAAA,MACT;AACA,MAAA,OAAO,SAAA;AAAA,IACT,CAAA;AAAA,IACA,MAAM,YAAA,EAAc;AAClB,MAAA,MAAM,QAAQ,oBAAA,CAAqB,EAAE,GAAG,OAAA,EAAS,GAAG,cAAc,CAAA;AAClE,MAAA,QAAA,CAAS,KAAK,KAAK,CAAA;AACnB,MAAA,OAAO,KAAA;AAAA,IACT;AAAA,GACF;AACF;;;;"}

package/dist/frontend-internal/src/routing/OpaqueExternalRouteRef.esm.js

@@ -0,0 +1,9 @@
+import { OpaqueType } from '../../../opaque-internal/src/OpaqueType.esm.js';
+
+const OpaqueExternalRouteRef = OpaqueType.create({
+  type: "@backstage/ExternalRouteRef",
+  versions: ["v1"]
+});
+
+export { OpaqueExternalRouteRef };
+//# sourceMappingURL=OpaqueExternalRouteRef.esm.js.map

package/dist/frontend-internal/src/routing/OpaqueExternalRouteRef.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpaqueExternalRouteRef.esm.js","sources":["../../../../../frontend-internal/src/routing/OpaqueExternalRouteRef.ts"],"sourcesContent":["/*\n * Copyright 2025 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 { ExternalRouteRef } from '@backstage/frontend-plugin-api';\nimport { OpaqueType } from '@internal/opaque';\n\nexport const OpaqueExternalRouteRef = OpaqueType.create<{\n  public: ExternalRouteRef;\n  versions: {\n    readonly version: 'v1';\n\n    getParams(): string[];\n    getDescription(): string;\n    getDefaultTarget(): string | undefined;\n\n    setId(id: string): void;\n  };\n}>({\n  type: '@backstage/ExternalRouteRef',\n  versions: ['v1'],\n});\n"],"names":[],"mappings":";;AAmBO,MAAM,sBAAA,GAAyB,WAAW,MAAA,CAW9C;AAAA,EACD,IAAA,EAAM,6BAAA;AAAA,EACN,QAAA,EAAU,CAAC,IAAI;AACjB,CAAC;;;;"}

package/dist/frontend-internal/src/routing/OpaqueRouteRef.esm.js

@@ -0,0 +1,7 @@
+import { OpaqueType } from '../../../opaque-internal/src/OpaqueType.esm.js';
+
+OpaqueType.create({
+  type: "@backstage/RouteRef",
+  versions: ["v1"]
+});
+//# sourceMappingURL=OpaqueRouteRef.esm.js.map

package/dist/frontend-internal/src/routing/OpaqueRouteRef.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpaqueRouteRef.esm.js","sources":["../../../../../frontend-internal/src/routing/OpaqueRouteRef.ts"],"sourcesContent":["/*\n * Copyright 2025 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 { RouteRef } from '@backstage/frontend-plugin-api';\nimport { OpaqueType } from '@internal/opaque';\n\nexport const OpaqueRouteRef = OpaqueType.create<{\n  public: RouteRef;\n  versions: {\n    readonly version: 'v1';\n\n    getParams(): string[];\n    getDescription(): string;\n\n    alias: string | undefined;\n\n    setId(id: string): void;\n  };\n}>({\n  type: '@backstage/RouteRef',\n  versions: ['v1'],\n});\n"],"names":[],"mappings":";;AAmB8B,WAAW,MAAA,CAYtC;AAAA,EACD,IAAA,EAAM,qBAAA;AAAA,EACN,QAAA,EAAU,CAAC,IAAI;AACjB,CAAC"}

package/dist/frontend-internal/src/routing/OpaqueSubRouteRef.esm.js

@@ -0,0 +1,7 @@
+import { OpaqueType } from '../../../opaque-internal/src/OpaqueType.esm.js';
+
+OpaqueType.create({
+  type: "@backstage/SubRouteRef",
+  versions: ["v1"]
+});
+//# sourceMappingURL=OpaqueSubRouteRef.esm.js.map

package/dist/frontend-internal/src/routing/OpaqueSubRouteRef.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpaqueSubRouteRef.esm.js","sources":["../../../../../frontend-internal/src/routing/OpaqueSubRouteRef.ts"],"sourcesContent":["/*\n * Copyright 2025 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 { RouteRef, SubRouteRef } from '@backstage/frontend-plugin-api';\nimport { OpaqueType } from '@internal/opaque';\n\nexport const OpaqueSubRouteRef = OpaqueType.create<{\n  public: SubRouteRef;\n  versions: {\n    readonly version: 'v1';\n\n    getParams(): string[];\n    getParent(): RouteRef;\n    getDescription(): string;\n  };\n}>({\n  type: '@backstage/SubRouteRef',\n  versions: ['v1'],\n});\n"],"names":[],"mappings":";;AAmBiC,WAAW,MAAA,CASzC;AAAA,EACD,IAAA,EAAM,wBAAA;AAAA,EACN,QAAA,EAAU,CAAC,IAAI;AACjB,CAAC"}

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as _backstage_config from '@backstage/config';
 import { Config } from '@backstage/config';
 import * as _backstage_frontend_plugin_api from '@backstage/frontend-plugin-api';
-import { ApiFactory, ApiRef, AlertApi, AlertMessage, FeatureFlagsApi, FeatureFlagState, FeatureFlag, FeatureFlagsSaveOptions, AnalyticsApi, AnalyticsEvent, TranslationApi, TranslationRef, TranslationSnapshot, ConfigApi as ConfigApi$1, DiscoveryApi as DiscoveryApi$1, IdentityApi as IdentityApi$1, StorageApi as StorageApi$1, ErrorApi as ErrorApi$1, FetchApi as FetchApi$1, ExtensionDataRef, AppNode, ExtensionDefinitionParameters, ExtensionDefinition, RouteRef, FrontendFeature } from '@backstage/frontend-plugin-api';
+import { ApiFactory, ApiRef, AlertApi, AlertMessage, FeatureFlagsApi, FeatureFlagState, FeatureFlag, FeatureFlagsSaveOptions, AnalyticsApi, AnalyticsEvent, TranslationApi, TranslationRef, TranslationSnapshot, ConfigApi as ConfigApi$1, DiscoveryApi as DiscoveryApi$1, IdentityApi as IdentityApi$1, StorageApi as StorageApi$1, ErrorApi as ErrorApi$1, FetchApi as FetchApi$1, ExtensionDataRef, AppNode, ExtensionDefinitionParameters, ExtensionDefinition, RouteRef, ExternalRouteRef, FrontendFeature } from '@backstage/frontend-plugin-api';
 import { PermissionApi } from '@backstage/plugin-permission-react';
 import { Observable, JsonObject, JsonValue } from '@backstage/types';
 import { EvaluatePermissionRequest, AuthorizeResult, EvaluatePermissionResponse } from '@backstage/plugin-permission-common';
@@ -794,7 +794,7 @@ declare function createExtensionTester<T extends ExtensionDefinitionParameters,
 type TestAppOptions<TApiPairs extends any[] = any[]> = {
     /**
      * 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
+     * being the route ref that the path will be bound to. This allows the route refs to be
      * used by `useRouteRef` in the rendered elements.
      *
      * @example
@@ -809,7 +809,7 @@ type TestAppOptions<TApiPairs extends any[] = any[]> = {
      * ```
      */
     mountedRoutes?: {
-        [path: string]: RouteRef;
+        [path: string]: RouteRef | ExternalRouteRef;
     };
     /**
      * Additional configuration passed to the app when rendering elements inside it.
@@ -868,7 +868,7 @@ type RenderTestAppOptions<TApiPairs extends any[] = any[]> = {
     initialRouteEntries?: string[];
     /**
      * An object of paths to mount route refs on, with the key being the path and
-     * the value being the RouteRef that the path will be bound to. This allows
+     * the value being the route ref that the path will be bound to. This allows
      * the route refs to be used by `useRouteRef` in the rendered elements.
      *
      * @example
@@ -882,7 +882,7 @@ type RenderTestAppOptions<TApiPairs extends any[] = any[]> = {
      * ```
      */
     mountedRoutes?: {
-        [path: string]: RouteRef;
+        [path: string]: RouteRef | ExternalRouteRef;
     };
     /**
      * API overrides to provide to the test app. Use `mockApis` helpers

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backstage/frontend-test-utils",
-  "version": "0.5.3-next.0",
+  "version": "0.5.3-next.1",
   "backstage": {
     "role": "web-library"
   },
@@ -33,13 +33,13 @@
   "dependencies": {
     "@backstage/config": "1.3.8-next.0",
     "@backstage/core-app-api": "1.20.1-next.0",
-    "@backstage/core-plugin-api": "1.12.6-next.0",
+    "@backstage/core-plugin-api": "1.12.6-next.1",
     "@backstage/filter-predicates": "0.1.3-next.0",
-    "@backstage/frontend-app-api": "0.16.3-next.0",
-    "@backstage/frontend-plugin-api": "0.17.0-next.0",
-    "@backstage/plugin-app": "0.4.6-next.0",
+    "@backstage/frontend-app-api": "0.16.3-next.1",
+    "@backstage/frontend-plugin-api": "0.17.0-next.1",
+    "@backstage/plugin-app": "0.4.6-next.1",
     "@backstage/plugin-app-react": "0.2.3-next.0",
-    "@backstage/plugin-permission-common": "0.9.9-next.0",
+    "@backstage/plugin-permission-common": "0.9.9-next.1",
     "@backstage/plugin-permission-react": "0.5.1-next.0",
     "@backstage/test-utils": "1.7.18-next.0",
     "@backstage/types": "1.2.2",
@@ -49,7 +49,7 @@
     "zod": "^3.25.76 || ^4.0.0"
   },
   "devDependencies": {
-    "@backstage/cli": "0.36.2-next.0",
+    "@backstage/cli": "0.36.2-next.1",
     "@testing-library/jest-dom": "^6.0.0",
     "@types/jest": "*",
     "@types/react": "^18.0.0",