@backstage/frontend-defaults 0.2.0-next.2 → 0.2.0

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @backstage/frontend-defaults
 
+## 0.2.0
+
+### Minor Changes
+
+- 4823831: Introduced a `createFrontendFeatureLoader()` function, as well as a `FrontendFeatureLoader` interface, to gather several frontend plugins, modules or feature loaders in a single exported entrypoint and load them, possibly asynchronously. This new feature, very similar to the `createBackendFeatureLoader()` already available on the backend, supersedes the previous `CreateAppFeatureLoader` type which has been deprecated.
+- 8250ffe: **BREAKING**: Dropped support for the removed opaque `@backstage/ExtensionOverrides` and `@backstage/BackstagePlugin` types.
+
+### Patch Changes
+
+- 4d18b55: It's now possible to provide a middleware that wraps all extension factories by passing an `extensionFactoryMiddleware` to either `createApp()` or `createSpecializedApp()`.
+- abcdf44: Internal refactor to match updated `createSpecializedApp`.
+- e3f19db: Feature discovery and resolution logic used in `createApp` is now exposed via the `discoverAvailableFeatures` and `resolveAsyncFeatures` functions respectively.
+- Updated dependencies
+  - @backstage/frontend-app-api@0.11.0
+  - @backstage/frontend-plugin-api@0.10.0
+  - @backstage/plugin-app@0.1.7
+  - @backstage/config@1.3.2
+  - @backstage/errors@1.2.7
+
 ## 0.2.0-next.2
 
 ### Minor Changes

package/dist/createApp.esm.js

@@ -17,14 +17,14 @@ function createApp(options) {
     const config = await options?.configLoader?.().then((c) => c.config) ?? ConfigReader.fromConfigs(
       overrideBaseUrlConfigs(defaultConfigLoaderSync())
     );
-    const { features: discoveredFeatures } = discoverAvailableFeatures(config);
-    const { features: providedFeatures } = await resolveAsyncFeatures({
+    const { features: discoveredFeaturesAndLoaders } = discoverAvailableFeatures(config);
+    const { features: loadedFeatures } = await resolveAsyncFeatures({
       config,
-      features: options?.features
+      features: [...discoveredFeaturesAndLoaders, ...options?.features ?? []]
     });
     const app = createSpecializedApp({
       config,
-      features: [appPlugin, ...discoveredFeatures, ...providedFeatures],
+      features: [appPlugin, ...loadedFeatures],
       bindRoutes: options?.bindRoutes,
       extensionFactoryMiddleware: options?.extensionFactoryMiddleware
     });

package/dist/createApp.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"createApp.esm.js","sources":["../src/createApp.tsx"],"sourcesContent":["/*\n * Copyright 2024 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, { JSX, ReactNode } from 'react';\nimport {\n  ConfigApi,\n  coreExtensionData,\n  ExtensionFactoryMiddleware,\n} from '@backstage/frontend-plugin-api';\n// eslint-disable-next-line @backstage/no-relative-monorepo-imports\nimport { defaultConfigLoaderSync } from '../../core-app-api/src/app/defaultConfigLoader';\n// eslint-disable-next-line @backstage/no-relative-monorepo-imports\nimport { overrideBaseUrlConfigs } from '../../core-app-api/src/app/overrideBaseUrlConfigs';\nimport { ConfigReader } from '@backstage/config';\nimport {\n  CreateAppRouteBinder,\n  FrontendFeature,\n  createSpecializedApp,\n} from '@backstage/frontend-app-api';\nimport appPlugin from '@backstage/plugin-app';\nimport { discoverAvailableFeatures } from './discovery';\nimport { resolveAsyncFeatures } from './resolution';\n\n/**\n * A source of dynamically loaded frontend features.\n *\n * @public\n */\nexport interface CreateAppFeatureLoader {\n  /**\n   * Returns name of this loader. suitable for showing to users.\n   */\n  getLoaderName(): string;\n\n  /**\n   * Loads a number of features dynamically.\n   */\n  load(options: { config: ConfigApi }): Promise<{\n    features: FrontendFeature[];\n  }>;\n}\n\n/**\n * Options for {@link createApp}.\n *\n * @public\n */\nexport interface CreateAppOptions {\n  features?: (FrontendFeature | CreateAppFeatureLoader)[];\n  configLoader?: () => Promise<{ config: ConfigApi }>;\n  bindRoutes?(context: { bind: CreateAppRouteBinder }): void;\n  /**\n   * The component to render while loading the app (waiting for config, features, etc)\n   *\n   * Is the text \"Loading...\" by default.\n   * If set to \"null\" then no loading fallback component is rendered.   *\n   */\n  loadingComponent?: ReactNode;\n  extensionFactoryMiddleware?:\n    | ExtensionFactoryMiddleware\n    | ExtensionFactoryMiddleware[];\n}\n\n/**\n * Creates a new Backstage frontend app instance. See https://backstage.io/docs/frontend-system/building-apps/index\n *\n * @public\n */\nexport function createApp(options?: CreateAppOptions): {\n  createRoot(): JSX.Element;\n} {\n  let suspenseFallback = options?.loadingComponent;\n  if (suspenseFallback === undefined) {\n    suspenseFallback = 'Loading...';\n  }\n\n  async function appLoader() {\n    const config =\n      (await options?.configLoader?.().then(c => c.config)) ??\n      ConfigReader.fromConfigs(\n        overrideBaseUrlConfigs(defaultConfigLoaderSync()),\n      );\n\n    const { features: discoveredFeatures } = discoverAvailableFeatures(config);\n    const { features: providedFeatures } = await resolveAsyncFeatures({\n      config,\n      features: options?.features,\n    });\n\n    const app = createSpecializedApp({\n      config,\n      features: [appPlugin, ...discoveredFeatures, ...providedFeatures],\n      bindRoutes: options?.bindRoutes,\n      extensionFactoryMiddleware: options?.extensionFactoryMiddleware,\n    });\n\n    const rootEl = app.tree.root.instance!.getData(\n      coreExtensionData.reactElement,\n    );\n\n    return { default: () => rootEl };\n  }\n\n  return {\n    createRoot() {\n      const LazyApp = React.lazy(appLoader);\n      return (\n        <React.Suspense fallback={suspenseFallback}>\n          <LazyApp />\n        </React.Suspense>\n      );\n    },\n  };\n}\n"],"names":[],"mappings":";;;;;;;;;;AAiFO,SAAS,UAAU,OAExB,EAAA;AACA,EAAA,IAAI,mBAAmB,OAAS,EAAA,gBAAA;AAChC,EAAA,IAAI,qBAAqB,KAAW,CAAA,EAAA;AAClC,IAAmB,gBAAA,GAAA,YAAA;AAAA;AAGrB,EAAA,eAAe,SAAY,GAAA;AACzB,IAAM,MAAA,MAAA,GACH,MAAM,OAAA,EAAS,YAAe,IAAA,CAAE,KAAK,CAAK,CAAA,KAAA,CAAA,CAAE,MAAM,CAAA,IACnD,YAAa,CAAA,WAAA;AAAA,MACX,sBAAA,CAAuB,yBAAyB;AAAA,KAClD;AAEF,IAAA,MAAM,EAAE,QAAA,EAAU,kBAAmB,EAAA,GAAI,0BAA0B,MAAM,CAAA;AACzE,IAAA,MAAM,EAAE,QAAA,EAAU,gBAAiB,EAAA,GAAI,MAAM,oBAAqB,CAAA;AAAA,MAChE,MAAA;AAAA,MACA,UAAU,OAAS,EAAA;AAAA,KACpB,CAAA;AAED,IAAA,MAAM,MAAM,oBAAqB,CAAA;AAAA,MAC/B,MAAA;AAAA,MACA,UAAU,CAAC,SAAA,EAAW,GAAG,kBAAA,EAAoB,GAAG,gBAAgB,CAAA;AAAA,MAChE,YAAY,OAAS,EAAA,UAAA;AAAA,MACrB,4BAA4B,OAAS,EAAA;AAAA,KACtC,CAAA;AAED,IAAA,MAAM,MAAS,GAAA,GAAA,CAAI,IAAK,CAAA,IAAA,CAAK,QAAU,CAAA,OAAA;AAAA,MACrC,iBAAkB,CAAA;AAAA,KACpB;AAEA,IAAO,OAAA,EAAE,OAAS,EAAA,MAAM,MAAO,EAAA;AAAA;AAGjC,EAAO,OAAA;AAAA,IACL,UAAa,GAAA;AACX,MAAM,MAAA,OAAA,GAAU,KAAM,CAAA,IAAA,CAAK,SAAS,CAAA;AACpC,MACE,uBAAA,KAAA,CAAA,aAAA,CAAC,MAAM,QAAN,EAAA,EAAe,UAAU,gBACxB,EAAA,kBAAA,KAAA,CAAA,aAAA,CAAC,aAAQ,CACX,CAAA;AAAA;AAEJ,GACF;AACF;;;;"}
+{"version":3,"file":"createApp.esm.js","sources":["../src/createApp.tsx"],"sourcesContent":["/*\n * Copyright 2024 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, { JSX, ReactNode } from 'react';\nimport {\n  ConfigApi,\n  coreExtensionData,\n  ExtensionFactoryMiddleware,\n  FrontendFeature,\n  FrontendFeatureLoader,\n} from '@backstage/frontend-plugin-api';\n// eslint-disable-next-line @backstage/no-relative-monorepo-imports\nimport { defaultConfigLoaderSync } from '../../core-app-api/src/app/defaultConfigLoader';\n// eslint-disable-next-line @backstage/no-relative-monorepo-imports\nimport { overrideBaseUrlConfigs } from '../../core-app-api/src/app/overrideBaseUrlConfigs';\nimport { ConfigReader } from '@backstage/config';\nimport {\n  CreateAppRouteBinder,\n  createSpecializedApp,\n} from '@backstage/frontend-app-api';\nimport appPlugin from '@backstage/plugin-app';\nimport { discoverAvailableFeatures } from './discovery';\nimport { resolveAsyncFeatures } from './resolution';\n\n/**\n * A source of dynamically loaded frontend features.\n *\n * @public\n * @deprecated Use the {@link @backstage/frontend-plugin-api#createFrontendFeatureLoader} function instead.\n */\nexport interface CreateAppFeatureLoader {\n  /**\n   * Returns name of this loader. suitable for showing to users.\n   */\n  getLoaderName(): string;\n\n  /**\n   * Loads a number of features dynamically.\n   */\n  load(options: { config: ConfigApi }): Promise<{\n    features: FrontendFeature[];\n  }>;\n}\n\n/**\n * Options for {@link createApp}.\n *\n * @public\n */\nexport interface CreateAppOptions {\n  features?: (\n    | FrontendFeature\n    | FrontendFeatureLoader\n    | CreateAppFeatureLoader\n  )[];\n  configLoader?: () => Promise<{ config: ConfigApi }>;\n  bindRoutes?(context: { bind: CreateAppRouteBinder }): void;\n  /**\n   * The component to render while loading the app (waiting for config, features, etc)\n   *\n   * Is the text \"Loading...\" by default.\n   * If set to \"null\" then no loading fallback component is rendered.   *\n   */\n  loadingComponent?: ReactNode;\n  extensionFactoryMiddleware?:\n    | ExtensionFactoryMiddleware\n    | ExtensionFactoryMiddleware[];\n}\n\n/**\n * Creates a new Backstage frontend app instance. See https://backstage.io/docs/frontend-system/building-apps/index\n *\n * @public\n */\nexport function createApp(options?: CreateAppOptions): {\n  createRoot(): JSX.Element;\n} {\n  let suspenseFallback = options?.loadingComponent;\n  if (suspenseFallback === undefined) {\n    suspenseFallback = 'Loading...';\n  }\n\n  async function appLoader() {\n    const config =\n      (await options?.configLoader?.().then(c => c.config)) ??\n      ConfigReader.fromConfigs(\n        overrideBaseUrlConfigs(defaultConfigLoaderSync()),\n      );\n\n    const { features: discoveredFeaturesAndLoaders } =\n      discoverAvailableFeatures(config);\n    const { features: loadedFeatures } = await resolveAsyncFeatures({\n      config,\n      features: [...discoveredFeaturesAndLoaders, ...(options?.features ?? [])],\n    });\n\n    const app = createSpecializedApp({\n      config,\n      features: [appPlugin, ...loadedFeatures],\n      bindRoutes: options?.bindRoutes,\n      extensionFactoryMiddleware: options?.extensionFactoryMiddleware,\n    });\n\n    const rootEl = app.tree.root.instance!.getData(\n      coreExtensionData.reactElement,\n    );\n\n    return { default: () => rootEl };\n  }\n\n  return {\n    createRoot() {\n      const LazyApp = React.lazy(appLoader);\n      return (\n        <React.Suspense fallback={suspenseFallback}>\n          <LazyApp />\n        </React.Suspense>\n      );\n    },\n  };\n}\n"],"names":[],"mappings":";;;;;;;;;;AAuFO,SAAS,UAAU,OAExB,EAAA;AACA,EAAA,IAAI,mBAAmB,OAAS,EAAA,gBAAA;AAChC,EAAA,IAAI,qBAAqB,KAAW,CAAA,EAAA;AAClC,IAAmB,gBAAA,GAAA,YAAA;AAAA;AAGrB,EAAA,eAAe,SAAY,GAAA;AACzB,IAAM,MAAA,MAAA,GACH,MAAM,OAAA,EAAS,YAAe,IAAA,CAAE,KAAK,CAAK,CAAA,KAAA,CAAA,CAAE,MAAM,CAAA,IACnD,YAAa,CAAA,WAAA;AAAA,MACX,sBAAA,CAAuB,yBAAyB;AAAA,KAClD;AAEF,IAAA,MAAM,EAAE,QAAA,EAAU,4BAA6B,EAAA,GAC7C,0BAA0B,MAAM,CAAA;AAClC,IAAA,MAAM,EAAE,QAAA,EAAU,cAAe,EAAA,GAAI,MAAM,oBAAqB,CAAA;AAAA,MAC9D,MAAA;AAAA,MACA,QAAA,EAAU,CAAC,GAAG,4BAAA,EAA8B,GAAI,OAAS,EAAA,QAAA,IAAY,EAAG;AAAA,KACzE,CAAA;AAED,IAAA,MAAM,MAAM,oBAAqB,CAAA;AAAA,MAC/B,MAAA;AAAA,MACA,QAAU,EAAA,CAAC,SAAW,EAAA,GAAG,cAAc,CAAA;AAAA,MACvC,YAAY,OAAS,EAAA,UAAA;AAAA,MACrB,4BAA4B,OAAS,EAAA;AAAA,KACtC,CAAA;AAED,IAAA,MAAM,MAAS,GAAA,GAAA,CAAI,IAAK,CAAA,IAAA,CAAK,QAAU,CAAA,OAAA;AAAA,MACrC,iBAAkB,CAAA;AAAA,KACpB;AAEA,IAAO,OAAA,EAAE,OAAS,EAAA,MAAM,MAAO,EAAA;AAAA;AAGjC,EAAO,OAAA;AAAA,IACL,UAAa,GAAA;AACX,MAAM,MAAA,OAAA,GAAU,KAAM,CAAA,IAAA,CAAK,SAAS,CAAA;AACpC,MACE,uBAAA,KAAA,CAAA,aAAA,CAAC,MAAM,QAAN,EAAA,EAAe,UAAU,gBACxB,EAAA,kBAAA,KAAA,CAAA,aAAA,CAAC,aAAQ,CACX,CAAA;AAAA;AAEJ,GACF;AACF;;;;"}

package/dist/discovery.esm.js

@@ -1,4 +1,5 @@
 import { ConfigReader } from '@backstage/config';
+import { isBackstageFeatureLoader } from './resolution.esm.js';
 
 function readPackageDetectionConfig(config) {
   const packages = config.getOptional("app.experimental.packages");
@@ -42,7 +43,7 @@ function discoverAvailableFeatures(config) {
         return false;
       }
       return true;
-    }).map((m) => m.default).filter(isBackstageFeature) ?? []
+    }).map((m) => m.default).filter(isFeatureOrLoader) ?? []
   };
 }
 function isBackstageFeature(obj) {
@@ -51,6 +52,9 @@ function isBackstageFeature(obj) {
   }
   return false;
 }
+function isFeatureOrLoader(obj) {
+  return isBackstageFeature(obj) || isBackstageFeatureLoader(obj);
+}
 
 export { discoverAvailableFeatures };
 //# sourceMappingURL=discovery.esm.js.map

package/dist/discovery.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"discovery.esm.js","sources":["../src/discovery.ts"],"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 { Config, ConfigReader } from '@backstage/config';\nimport { FrontendFeature } from '@backstage/frontend-app-api';\n\ninterface DiscoveryGlobal {\n  modules: Array<{ name: string; export?: string; default: unknown }>;\n}\n\nfunction readPackageDetectionConfig(config: Config) {\n  const packages = config.getOptional('app.experimental.packages');\n  if (packages === undefined || packages === null) {\n    return undefined;\n  }\n\n  if (typeof packages === 'string') {\n    if (packages !== 'all') {\n      throw new Error(\n        `Invalid app.experimental.packages mode, got '${packages}', expected 'all'`,\n      );\n    }\n    return {};\n  }\n\n  if (typeof packages !== 'object' || Array.isArray(packages)) {\n    throw new Error(\n      \"Invalid config at 'app.experimental.packages', expected object\",\n    );\n  }\n  const packagesConfig = new ConfigReader(\n    packages,\n    'app.experimental.packages',\n  );\n\n  return {\n    include: packagesConfig.getOptionalStringArray('include'),\n    exclude: packagesConfig.getOptionalStringArray('exclude'),\n  };\n}\n\n/**\n * @public\n */\nexport function discoverAvailableFeatures(config: Config): {\n  features: FrontendFeature[];\n} {\n  const discovered = (\n    window as { '__@backstage/discovered__'?: DiscoveryGlobal }\n  )['__@backstage/discovered__'];\n\n  const detection = readPackageDetectionConfig(config);\n  if (!detection) {\n    return { features: [] };\n  }\n\n  return {\n    features:\n      discovered?.modules\n        .filter(({ name }) => {\n          if (detection.exclude?.includes(name)) {\n            return false;\n          }\n          if (detection.include && !detection.include.includes(name)) {\n            return false;\n          }\n          return true;\n        })\n        .map(m => m.default)\n        .filter(isBackstageFeature) ?? [],\n  };\n}\n\nfunction isBackstageFeature(obj: unknown): obj is FrontendFeature {\n  if (obj !== null && typeof obj === 'object' && '$$type' in obj) {\n    return (\n      obj.$$type === '@backstage/FrontendPlugin' ||\n      obj.$$type === '@backstage/FrontendModule'\n    );\n  }\n  return false;\n}\n"],"names":[],"mappings":";;AAuBA,SAAS,2BAA2B,MAAgB,EAAA;AAClD,EAAM,MAAA,QAAA,GAAW,MAAO,CAAA,WAAA,CAAY,2BAA2B,CAAA;AAC/D,EAAI,IAAA,QAAA,KAAa,KAAa,CAAA,IAAA,QAAA,KAAa,IAAM,EAAA;AAC/C,IAAO,OAAA,KAAA,CAAA;AAAA;AAGT,EAAI,IAAA,OAAO,aAAa,QAAU,EAAA;AAChC,IAAA,IAAI,aAAa,KAAO,EAAA;AACtB,MAAA,MAAM,IAAI,KAAA;AAAA,QACR,gDAAgD,QAAQ,CAAA,iBAAA;AAAA,OAC1D;AAAA;AAEF,IAAA,OAAO,EAAC;AAAA;AAGV,EAAA,IAAI,OAAO,QAAa,KAAA,QAAA,IAAY,KAAM,CAAA,OAAA,CAAQ,QAAQ,CAAG,EAAA;AAC3D,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KACF;AAAA;AAEF,EAAA,MAAM,iBAAiB,IAAI,YAAA;AAAA,IACzB,QAAA;AAAA,IACA;AAAA,GACF;AAEA,EAAO,OAAA;AAAA,IACL,OAAA,EAAS,cAAe,CAAA,sBAAA,CAAuB,SAAS,CAAA;AAAA,IACxD,OAAA,EAAS,cAAe,CAAA,sBAAA,CAAuB,SAAS;AAAA,GAC1D;AACF;AAKO,SAAS,0BAA0B,MAExC,EAAA;AACA,EAAM,MAAA,UAAA,GACJ,OACA,2BAA2B,CAAA;AAE7B,EAAM,MAAA,SAAA,GAAY,2BAA2B,MAAM,CAAA;AACnD,EAAA,IAAI,CAAC,SAAW,EAAA;AACd,IAAO,OAAA,EAAE,QAAU,EAAA,EAAG,EAAA;AAAA;AAGxB,EAAO,OAAA;AAAA,IACL,UACE,UAAY,EAAA,OAAA,CACT,OAAO,CAAC,EAAE,MAAW,KAAA;AACpB,MAAA,IAAI,SAAU,CAAA,OAAA,EAAS,QAAS,CAAA,IAAI,CAAG,EAAA;AACrC,QAAO,OAAA,KAAA;AAAA;AAET,MAAA,IAAI,UAAU,OAAW,IAAA,CAAC,UAAU,OAAQ,CAAA,QAAA,CAAS,IAAI,CAAG,EAAA;AAC1D,QAAO,OAAA,KAAA;AAAA;AAET,MAAO,OAAA,IAAA;AAAA,KACR,CACA,CAAA,GAAA,CAAI,CAAK,CAAA,KAAA,CAAA,CAAE,OAAO,CAClB,CAAA,MAAA,CAAO,kBAAkB,CAAA,IAAK;AAAC,GACtC;AACF;AAEA,SAAS,mBAAmB,GAAsC,EAAA;AAChE,EAAA,IAAI,QAAQ,IAAQ,IAAA,OAAO,GAAQ,KAAA,QAAA,IAAY,YAAY,GAAK,EAAA;AAC9D,IAAA,OACE,GAAI,CAAA,MAAA,KAAW,2BACf,IAAA,GAAA,CAAI,MAAW,KAAA,2BAAA;AAAA;AAGnB,EAAO,OAAA,KAAA;AACT;;;;"}
+{"version":3,"file":"discovery.esm.js","sources":["../src/discovery.ts"],"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 { Config, ConfigReader } from '@backstage/config';\nimport {\n  FrontendFeature,\n  FrontendFeatureLoader,\n} from '@backstage/frontend-plugin-api';\nimport { isBackstageFeatureLoader } from './resolution';\n\ninterface DiscoveryGlobal {\n  modules: Array<{ name: string; export?: string; default: unknown }>;\n}\n\nfunction readPackageDetectionConfig(config: Config) {\n  const packages = config.getOptional('app.experimental.packages');\n  if (packages === undefined || packages === null) {\n    return undefined;\n  }\n\n  if (typeof packages === 'string') {\n    if (packages !== 'all') {\n      throw new Error(\n        `Invalid app.experimental.packages mode, got '${packages}', expected 'all'`,\n      );\n    }\n    return {};\n  }\n\n  if (typeof packages !== 'object' || Array.isArray(packages)) {\n    throw new Error(\n      \"Invalid config at 'app.experimental.packages', expected object\",\n    );\n  }\n  const packagesConfig = new ConfigReader(\n    packages,\n    'app.experimental.packages',\n  );\n\n  return {\n    include: packagesConfig.getOptionalStringArray('include'),\n    exclude: packagesConfig.getOptionalStringArray('exclude'),\n  };\n}\n\n/**\n * @public\n */\nexport function discoverAvailableFeatures(config: Config): {\n  features: (FrontendFeature | FrontendFeatureLoader)[];\n} {\n  const discovered = (\n    window as { '__@backstage/discovered__'?: DiscoveryGlobal }\n  )['__@backstage/discovered__'];\n\n  const detection = readPackageDetectionConfig(config);\n  if (!detection) {\n    return { features: [] };\n  }\n\n  return {\n    features:\n      discovered?.modules\n        .filter(({ name }) => {\n          if (detection.exclude?.includes(name)) {\n            return false;\n          }\n          if (detection.include && !detection.include.includes(name)) {\n            return false;\n          }\n          return true;\n        })\n        .map(m => m.default)\n        .filter(isFeatureOrLoader) ?? [],\n  };\n}\n\nfunction isBackstageFeature(obj: unknown): obj is FrontendFeature {\n  if (obj !== null && typeof obj === 'object' && '$$type' in obj) {\n    return (\n      obj.$$type === '@backstage/FrontendPlugin' ||\n      obj.$$type === '@backstage/FrontendModule'\n    );\n  }\n  return false;\n}\n\nfunction isFeatureOrLoader(\n  obj: unknown,\n): obj is FrontendFeature | FrontendFeatureLoader {\n  return isBackstageFeature(obj) || isBackstageFeatureLoader(obj);\n}\n"],"names":[],"mappings":";;;AA2BA,SAAS,2BAA2B,MAAgB,EAAA;AAClD,EAAM,MAAA,QAAA,GAAW,MAAO,CAAA,WAAA,CAAY,2BAA2B,CAAA;AAC/D,EAAI,IAAA,QAAA,KAAa,KAAa,CAAA,IAAA,QAAA,KAAa,IAAM,EAAA;AAC/C,IAAO,OAAA,KAAA,CAAA;AAAA;AAGT,EAAI,IAAA,OAAO,aAAa,QAAU,EAAA;AAChC,IAAA,IAAI,aAAa,KAAO,EAAA;AACtB,MAAA,MAAM,IAAI,KAAA;AAAA,QACR,gDAAgD,QAAQ,CAAA,iBAAA;AAAA,OAC1D;AAAA;AAEF,IAAA,OAAO,EAAC;AAAA;AAGV,EAAA,IAAI,OAAO,QAAa,KAAA,QAAA,IAAY,KAAM,CAAA,OAAA,CAAQ,QAAQ,CAAG,EAAA;AAC3D,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KACF;AAAA;AAEF,EAAA,MAAM,iBAAiB,IAAI,YAAA;AAAA,IACzB,QAAA;AAAA,IACA;AAAA,GACF;AAEA,EAAO,OAAA;AAAA,IACL,OAAA,EAAS,cAAe,CAAA,sBAAA,CAAuB,SAAS,CAAA;AAAA,IACxD,OAAA,EAAS,cAAe,CAAA,sBAAA,CAAuB,SAAS;AAAA,GAC1D;AACF;AAKO,SAAS,0BAA0B,MAExC,EAAA;AACA,EAAM,MAAA,UAAA,GACJ,OACA,2BAA2B,CAAA;AAE7B,EAAM,MAAA,SAAA,GAAY,2BAA2B,MAAM,CAAA;AACnD,EAAA,IAAI,CAAC,SAAW,EAAA;AACd,IAAO,OAAA,EAAE,QAAU,EAAA,EAAG,EAAA;AAAA;AAGxB,EAAO,OAAA;AAAA,IACL,UACE,UAAY,EAAA,OAAA,CACT,OAAO,CAAC,EAAE,MAAW,KAAA;AACpB,MAAA,IAAI,SAAU,CAAA,OAAA,EAAS,QAAS,CAAA,IAAI,CAAG,EAAA;AACrC,QAAO,OAAA,KAAA;AAAA;AAET,MAAA,IAAI,UAAU,OAAW,IAAA,CAAC,UAAU,OAAQ,CAAA,QAAA,CAAS,IAAI,CAAG,EAAA;AAC1D,QAAO,OAAA,KAAA;AAAA;AAET,MAAO,OAAA,IAAA;AAAA,KACR,CACA,CAAA,GAAA,CAAI,CAAK,CAAA,KAAA,CAAA,CAAE,OAAO,CAClB,CAAA,MAAA,CAAO,iBAAiB,CAAA,IAAK;AAAC,GACrC;AACF;AAEA,SAAS,mBAAmB,GAAsC,EAAA;AAChE,EAAA,IAAI,QAAQ,IAAQ,IAAA,OAAO,GAAQ,KAAA,QAAA,IAAY,YAAY,GAAK,EAAA;AAC9D,IAAA,OACE,GAAI,CAAA,MAAA,KAAW,2BACf,IAAA,GAAA,CAAI,MAAW,KAAA,2BAAA;AAAA;AAGnB,EAAO,OAAA,KAAA;AACT;AAEA,SAAS,kBACP,GACgD,EAAA;AAChD,EAAA,OAAO,kBAAmB,CAAA,GAAG,CAAK,IAAA,wBAAA,CAAyB,GAAG,CAAA;AAChE;;;;"}

package/dist/frontend-plugin-api/src/wiring/createFrontendFeatureLoader.esm.js

@@ -0,0 +1,22 @@
+function isInternalFrontendFeatureLoader(opaque) {
+  if (opaque.$$type === "@backstage/FrontendFeatureLoader") {
+    toInternalFrontendFeatureLoader(opaque);
+    return true;
+  }
+  return false;
+}
+function toInternalFrontendFeatureLoader(plugin) {
+  const internal = plugin;
+  if (internal.$$type !== "@backstage/FrontendFeatureLoader") {
+    throw new Error(`Invalid plugin instance, bad type '${internal.$$type}'`);
+  }
+  if (internal.version !== "v1") {
+    throw new Error(
+      `Invalid plugin instance, bad version '${internal.version}'`
+    );
+  }
+  return internal;
+}
+
+export { isInternalFrontendFeatureLoader, toInternalFrontendFeatureLoader };
+//# sourceMappingURL=createFrontendFeatureLoader.esm.js.map

package/dist/frontend-plugin-api/src/wiring/createFrontendFeatureLoader.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createFrontendFeatureLoader.esm.js","sources":["../../../../../frontend-plugin-api/src/wiring/createFrontendFeatureLoader.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 { ConfigApi } from '../apis/definitions';\nimport { describeParentCallSite } from '../routing/describeParentCallSite';\nimport { FrontendFeature } from './types';\n\n/** @public */\nexport interface CreateFrontendFeatureLoaderOptions {\n  loader(deps: {\n    config: ConfigApi;\n  }):\n    | Iterable<\n        | FrontendFeature\n        | FrontendFeatureLoader\n        | Promise<{ default: FrontendFeature | FrontendFeatureLoader }>\n      >\n    | Promise<\n        Iterable<\n          | FrontendFeature\n          | FrontendFeatureLoader\n          | Promise<{ default: FrontendFeature | FrontendFeatureLoader }>\n        >\n      >\n    | AsyncIterable<\n        | FrontendFeature\n        | FrontendFeatureLoader\n        | { default: FrontendFeature | FrontendFeatureLoader }\n      >;\n}\n\n/** @public */\nexport interface FrontendFeatureLoader {\n  readonly $$type: '@backstage/FrontendFeatureLoader';\n}\n\n/** @internal */\nexport interface InternalFrontendFeatureLoader extends FrontendFeatureLoader {\n  readonly version: 'v1';\n  readonly description: string;\n  readonly loader: (deps: {\n    config: ConfigApi;\n  }) => Promise<(FrontendFeature | FrontendFeatureLoader)[]>;\n}\n\n/** @public */\nexport function createFrontendFeatureLoader(\n  options: CreateFrontendFeatureLoaderOptions,\n): FrontendFeatureLoader {\n  const description = `created at '${describeParentCallSite()}'`;\n  return {\n    $$type: '@backstage/FrontendFeatureLoader',\n    version: 'v1',\n    description,\n    toString() {\n      return `FeatureLoader{description=${description}}`;\n    },\n    async loader(deps: {\n      config: ConfigApi;\n    }): Promise<(FrontendFeature | FrontendFeatureLoader)[]> {\n      const it = await options.loader(deps);\n      const result = new Array<FrontendFeature | FrontendFeatureLoader>();\n      for await (const item of it) {\n        if (isFeatureOrLoader(item)) {\n          result.push(item);\n        } else if ('default' in item) {\n          result.push(item.default);\n        } else {\n          throw new Error(`Invalid item \"${item}\"`);\n        }\n      }\n      return result;\n    },\n  } as InternalFrontendFeatureLoader;\n}\n\n/** @internal */\nexport function isInternalFrontendFeatureLoader(opaque: {\n  $$type: string;\n}): opaque is InternalFrontendFeatureLoader {\n  if (opaque.$$type === '@backstage/FrontendFeatureLoader') {\n    // Make sure we throw if invalid\n    toInternalFrontendFeatureLoader(opaque as FrontendFeatureLoader);\n    return true;\n  }\n  return false;\n}\n\n/** @internal */\nexport function toInternalFrontendFeatureLoader(\n  plugin: FrontendFeatureLoader,\n): InternalFrontendFeatureLoader {\n  const internal = plugin as InternalFrontendFeatureLoader;\n  if (internal.$$type !== '@backstage/FrontendFeatureLoader') {\n    throw new Error(`Invalid plugin instance, bad type '${internal.$$type}'`);\n  }\n  if (internal.version !== 'v1') {\n    throw new Error(\n      `Invalid plugin instance, bad version '${internal.version}'`,\n    );\n  }\n  return internal;\n}\n\nfunction isFeatureOrLoader(\n  obj: unknown,\n): obj is FrontendFeature | FrontendFeatureLoader {\n  if (obj !== null && typeof obj === 'object' && '$$type' in obj) {\n    return (\n      obj.$$type === '@backstage/FrontendPlugin' ||\n      obj.$$type === '@backstage/FrontendModule' ||\n      obj.$$type === '@backstage/FrontendFeatureLoader'\n    );\n  }\n  return false;\n}\n"],"names":[],"mappings":"AA0FO,SAAS,gCAAgC,MAEJ,EAAA;AAC1C,EAAI,IAAA,MAAA,CAAO,WAAW,kCAAoC,EAAA;AAExD,IAAA,+BAAA,CAAgC,MAA+B,CAAA;AAC/D,IAAO,OAAA,IAAA;AAAA;AAET,EAAO,OAAA,KAAA;AACT;AAGO,SAAS,gCACd,MAC+B,EAAA;AAC/B,EAAA,MAAM,QAAW,GAAA,MAAA;AACjB,EAAI,IAAA,QAAA,CAAS,WAAW,kCAAoC,EAAA;AAC1D,IAAA,MAAM,IAAI,KAAA,CAAM,CAAsC,mCAAA,EAAA,QAAA,CAAS,MAAM,CAAG,CAAA,CAAA,CAAA;AAAA;AAE1E,EAAI,IAAA,QAAA,CAAS,YAAY,IAAM,EAAA;AAC7B,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,CAAA,sCAAA,EAAyC,SAAS,OAAO,CAAA,CAAA;AAAA,KAC3D;AAAA;AAEF,EAAO,OAAA,QAAA;AACT;;;;"}

package/dist/index.d.ts

@@ -1,12 +1,13 @@
 import React, { ReactNode, JSX } from 'react';
-import { ConfigApi, ExtensionFactoryMiddleware } from '@backstage/frontend-plugin-api';
-import { FrontendFeature, CreateAppRouteBinder } from '@backstage/frontend-app-api';
+import { ConfigApi, FrontendFeature, FrontendFeatureLoader, ExtensionFactoryMiddleware } from '@backstage/frontend-plugin-api';
+import { CreateAppRouteBinder } from '@backstage/frontend-app-api';
 import { Config } from '@backstage/config';
 
 /**
  * A source of dynamically loaded frontend features.
  *
  * @public
+ * @deprecated Use the {@link @backstage/frontend-plugin-api#createFrontendFeatureLoader} function instead.
  */
 interface CreateAppFeatureLoader {
     /**
@@ -28,7 +29,7 @@ interface CreateAppFeatureLoader {
  * @public
  */
 interface CreateAppOptions {
-    features?: (FrontendFeature | CreateAppFeatureLoader)[];
+    features?: (FrontendFeature | FrontendFeatureLoader | CreateAppFeatureLoader)[];
     configLoader?: () => Promise<{
         config: ConfigApi;
     }>;
@@ -81,13 +82,13 @@ declare function createPublicSignInApp(options?: CreateAppOptions): {
  * @public
  */
 declare function discoverAvailableFeatures(config: Config): {
-    features: FrontendFeature[];
+    features: (FrontendFeature | FrontendFeatureLoader)[];
 };
 
 /** @public */
 declare function resolveAsyncFeatures(options: {
     config: Config;
-    features?: (FrontendFeature | CreateAppFeatureLoader)[];
+    features?: (FrontendFeature | FrontendFeatureLoader | CreateAppFeatureLoader)[];
 }): Promise<{
     features: FrontendFeature[];
 }>;

package/dist/resolution.esm.js

@@ -1,25 +1,64 @@
 import { stringifyError } from '@backstage/errors';
+import { isInternalFrontendFeatureLoader } from './frontend-plugin-api/src/wiring/createFrontendFeatureLoader.esm.js';
 
 async function resolveAsyncFeatures(options) {
   const features = [];
-  for (const entry of options.features ?? []) {
-    if ("load" in entry) {
+  for (const item of options?.features ?? []) {
+    if ("load" in item) {
       try {
-        const result = await entry.load({ config: options.config });
+        const result = await item.load({ config: options.config });
         features.push(...result.features);
       } catch (e) {
         throw new Error(
-          `Failed to read frontend features from loader '${entry.getLoaderName()}', ${stringifyError(
+          `Failed to read frontend features from loader '${item.getLoaderName()}', ${stringifyError(
             e
           )}`
         );
       }
     } else {
-      features.push(entry);
+      features.push(item);
     }
   }
-  return { features };
+  const loadedFeatures = [];
+  const alreadyMetFeatureLoaders = [];
+  const maxRecursionDepth = 5;
+  async function applyFeatureLoaders(featuresOrLoaders, recursionDepth) {
+    if (featuresOrLoaders.length === 0) {
+      return;
+    }
+    for (const featureOrLoader of featuresOrLoaders) {
+      if (isBackstageFeatureLoader(featureOrLoader)) {
+        if (alreadyMetFeatureLoaders.some((l) => l === featureOrLoader)) {
+          continue;
+        }
+        if (isInternalFrontendFeatureLoader(featureOrLoader)) {
+          if (recursionDepth > maxRecursionDepth) {
+            throw new Error(
+              `Maximum feature loading recursion depth (${maxRecursionDepth}) reached for the feature loader ${featureOrLoader.description}`
+            );
+          }
+          alreadyMetFeatureLoaders.push(featureOrLoader);
+          let result;
+          try {
+            result = await featureOrLoader.loader({ config: options.config });
+          } catch (e) {
+            throw new Error(
+              `Failed to read frontend features from loader ${featureOrLoader.description}: ${stringifyError(e)}`
+            );
+          }
+          await applyFeatureLoaders(result, recursionDepth + 1);
+        }
+      } else {
+        loadedFeatures.push(featureOrLoader);
+      }
+    }
+  }
+  await applyFeatureLoaders(features, 1);
+  return { features: loadedFeatures };
+}
+function isBackstageFeatureLoader(obj) {
+  return obj !== null && typeof obj === "object" && "$$type" in obj && obj.$$type === "@backstage/FrontendFeatureLoader";
 }
 
-export { resolveAsyncFeatures };
+export { isBackstageFeatureLoader, resolveAsyncFeatures };
 //# sourceMappingURL=resolution.esm.js.map

package/dist/resolution.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolution.esm.js","sources":["../src/resolution.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 { Config } from '@backstage/config';\nimport { stringifyError } from '@backstage/errors';\nimport { FrontendFeature } from '@backstage/frontend-app-api';\nimport { CreateAppFeatureLoader } from './createApp';\n\n/** @public */\nexport async function resolveAsyncFeatures(options: {\n  config: Config;\n  features?: (FrontendFeature | CreateAppFeatureLoader)[];\n}): Promise<{ features: FrontendFeature[] }> {\n  const features = [];\n  for (const entry of options.features ?? []) {\n    if ('load' in entry) {\n      try {\n        const result = await entry.load({ config: options.config });\n        features.push(...result.features);\n      } catch (e) {\n        throw new Error(\n          `Failed to read frontend features from loader '${entry.getLoaderName()}', ${stringifyError(\n            e,\n          )}`,\n        );\n      }\n    } else {\n      features.push(entry);\n    }\n  }\n  return { features };\n}\n"],"names":[],"mappings":";;AAsBA,eAAsB,qBAAqB,OAGE,EAAA;AAC3C,EAAA,MAAM,WAAW,EAAC;AAClB,EAAA,KAAA,MAAW,KAAS,IAAA,OAAA,CAAQ,QAAY,IAAA,EAAI,EAAA;AAC1C,IAAA,IAAI,UAAU,KAAO,EAAA;AACnB,MAAI,IAAA;AACF,QAAM,MAAA,MAAA,GAAS,MAAM,KAAM,CAAA,IAAA,CAAK,EAAE,MAAQ,EAAA,OAAA,CAAQ,QAAQ,CAAA;AAC1D,QAAS,QAAA,CAAA,IAAA,CAAK,GAAG,MAAA,CAAO,QAAQ,CAAA;AAAA,eACzB,CAAG,EAAA;AACV,QAAA,MAAM,IAAI,KAAA;AAAA,UACR,CAAiD,8CAAA,EAAA,KAAA,CAAM,aAAc,EAAC,CAAM,GAAA,EAAA,cAAA;AAAA,YAC1E;AAAA,WACD,CAAA;AAAA,SACH;AAAA;AACF,KACK,MAAA;AACL,MAAA,QAAA,CAAS,KAAK,KAAK,CAAA;AAAA;AACrB;AAEF,EAAA,OAAO,EAAE,QAAS,EAAA;AACpB;;;;"}
+{"version":3,"file":"resolution.esm.js","sources":["../src/resolution.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 { Config } from '@backstage/config';\nimport { stringifyError } from '@backstage/errors';\nimport {\n  FrontendFeature,\n  FrontendFeatureLoader,\n} from '@backstage/frontend-plugin-api';\nimport { CreateAppFeatureLoader } from './createApp';\n// eslint-disable-next-line @backstage/no-relative-monorepo-imports\nimport { isInternalFrontendFeatureLoader } from '../../frontend-plugin-api/src/wiring/createFrontendFeatureLoader';\n\n/** @public */\nexport async function resolveAsyncFeatures(options: {\n  config: Config;\n  features?: (\n    | FrontendFeature\n    | FrontendFeatureLoader\n    | CreateAppFeatureLoader\n  )[];\n}): Promise<{ features: FrontendFeature[] }> {\n  const features: (FrontendFeature | FrontendFeatureLoader)[] = [];\n\n  // Separate deprecated CreateAppFeatureLoader elements from the frontend features,\n  // and manage the deprecated elements first.\n  for (const item of options?.features ?? []) {\n    if ('load' in item) {\n      try {\n        const result = await item.load({ config: options.config });\n        features.push(...result.features);\n      } catch (e) {\n        throw new Error(\n          `Failed to read frontend features from loader '${item.getLoaderName()}', ${stringifyError(\n            e,\n          )}`,\n        );\n      }\n    } else {\n      features.push(item);\n    }\n  }\n\n  const loadedFeatures: FrontendFeature[] = [];\n  const alreadyMetFeatureLoaders: FrontendFeatureLoader[] = [];\n  const maxRecursionDepth = 5;\n\n  async function applyFeatureLoaders(\n    featuresOrLoaders: (FrontendFeature | FrontendFeatureLoader)[],\n    recursionDepth: number,\n  ) {\n    if (featuresOrLoaders.length === 0) {\n      return;\n    }\n\n    for (const featureOrLoader of featuresOrLoaders) {\n      if (isBackstageFeatureLoader(featureOrLoader)) {\n        if (alreadyMetFeatureLoaders.some(l => l === featureOrLoader)) {\n          continue;\n        }\n        if (isInternalFrontendFeatureLoader(featureOrLoader)) {\n          if (recursionDepth > maxRecursionDepth) {\n            throw new Error(\n              `Maximum feature loading recursion depth (${maxRecursionDepth}) reached for the feature loader ${featureOrLoader.description}`,\n            );\n          }\n          alreadyMetFeatureLoaders.push(featureOrLoader);\n          let result: (FrontendFeature | FrontendFeatureLoader)[];\n          try {\n            result = await featureOrLoader.loader({ config: options.config });\n          } catch (e) {\n            throw new Error(\n              `Failed to read frontend features from loader ${\n                featureOrLoader.description\n              }: ${stringifyError(e)}`,\n            );\n          }\n          await applyFeatureLoaders(result, recursionDepth + 1);\n        }\n      } else {\n        loadedFeatures.push(featureOrLoader);\n      }\n    }\n  }\n\n  await applyFeatureLoaders(features, 1);\n\n  return { features: loadedFeatures };\n}\n\nexport function isBackstageFeatureLoader(\n  obj: unknown,\n): obj is FrontendFeatureLoader {\n  return (\n    obj !== null &&\n    typeof obj === 'object' &&\n    '$$type' in obj &&\n    obj.$$type === '@backstage/FrontendFeatureLoader'\n  );\n}\n"],"names":[],"mappings":";;;AA2BA,eAAsB,qBAAqB,OAOE,EAAA;AAC3C,EAAA,MAAM,WAAwD,EAAC;AAI/D,EAAA,KAAA,MAAW,IAAQ,IAAA,OAAA,EAAS,QAAY,IAAA,EAAI,EAAA;AAC1C,IAAA,IAAI,UAAU,IAAM,EAAA;AAClB,MAAI,IAAA;AACF,QAAM,MAAA,MAAA,GAAS,MAAM,IAAK,CAAA,IAAA,CAAK,EAAE,MAAQ,EAAA,OAAA,CAAQ,QAAQ,CAAA;AACzD,QAAS,QAAA,CAAA,IAAA,CAAK,GAAG,MAAA,CAAO,QAAQ,CAAA;AAAA,eACzB,CAAG,EAAA;AACV,QAAA,MAAM,IAAI,KAAA;AAAA,UACR,CAAiD,8CAAA,EAAA,IAAA,CAAK,aAAc,EAAC,CAAM,GAAA,EAAA,cAAA;AAAA,YACzE;AAAA,WACD,CAAA;AAAA,SACH;AAAA;AACF,KACK,MAAA;AACL,MAAA,QAAA,CAAS,KAAK,IAAI,CAAA;AAAA;AACpB;AAGF,EAAA,MAAM,iBAAoC,EAAC;AAC3C,EAAA,MAAM,2BAAoD,EAAC;AAC3D,EAAA,MAAM,iBAAoB,GAAA,CAAA;AAE1B,EAAe,eAAA,mBAAA,CACb,mBACA,cACA,EAAA;AACA,IAAI,IAAA,iBAAA,CAAkB,WAAW,CAAG,EAAA;AAClC,MAAA;AAAA;AAGF,IAAA,KAAA,MAAW,mBAAmB,iBAAmB,EAAA;AAC/C,MAAI,IAAA,wBAAA,CAAyB,eAAe,CAAG,EAAA;AAC7C,QAAA,IAAI,wBAAyB,CAAA,IAAA,CAAK,CAAK,CAAA,KAAA,CAAA,KAAM,eAAe,CAAG,EAAA;AAC7D,UAAA;AAAA;AAEF,QAAI,IAAA,+BAAA,CAAgC,eAAe,CAAG,EAAA;AACpD,UAAA,IAAI,iBAAiB,iBAAmB,EAAA;AACtC,YAAA,MAAM,IAAI,KAAA;AAAA,cACR,CAA4C,yCAAA,EAAA,iBAAiB,CAAoC,iCAAA,EAAA,eAAA,CAAgB,WAAW,CAAA;AAAA,aAC9H;AAAA;AAEF,UAAA,wBAAA,CAAyB,KAAK,eAAe,CAAA;AAC7C,UAAI,IAAA,MAAA;AACJ,UAAI,IAAA;AACF,YAAA,MAAA,GAAS,MAAM,eAAgB,CAAA,MAAA,CAAO,EAAE,MAAQ,EAAA,OAAA,CAAQ,QAAQ,CAAA;AAAA,mBACzD,CAAG,EAAA;AACV,YAAA,MAAM,IAAI,KAAA;AAAA,cACR,gDACE,eAAgB,CAAA,WAClB,CAAK,EAAA,EAAA,cAAA,CAAe,CAAC,CAAC,CAAA;AAAA,aACxB;AAAA;AAEF,UAAM,MAAA,mBAAA,CAAoB,MAAQ,EAAA,cAAA,GAAiB,CAAC,CAAA;AAAA;AACtD,OACK,MAAA;AACL,QAAA,cAAA,CAAe,KAAK,eAAe,CAAA;AAAA;AACrC;AACF;AAGF,EAAM,MAAA,mBAAA,CAAoB,UAAU,CAAC,CAAA;AAErC,EAAO,OAAA,EAAE,UAAU,cAAe,EAAA;AACpC;AAEO,SAAS,yBACd,GAC8B,EAAA;AAC9B,EACE,OAAA,GAAA,KAAQ,QACR,OAAO,GAAA,KAAQ,YACf,QAAY,IAAA,GAAA,IACZ,IAAI,MAAW,KAAA,kCAAA;AAEnB;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backstage/frontend-defaults",
-  "version": "0.2.0-next.2",
+  "version": "0.2.0",
   "backstage": {
     "role": "web-library"
   },
@@ -31,17 +31,17 @@
     "test": "backstage-cli package test"
   },
   "dependencies": {
-    "@backstage/config": "1.3.2",
-    "@backstage/errors": "1.2.7",
-    "@backstage/frontend-app-api": "0.11.0-next.2",
-    "@backstage/frontend-plugin-api": "0.10.0-next.2",
-    "@backstage/plugin-app": "0.1.7-next.2",
+    "@backstage/config": "^1.3.2",
+    "@backstage/errors": "^1.2.7",
+    "@backstage/frontend-app-api": "^0.11.0",
+    "@backstage/frontend-plugin-api": "^0.10.0",
+    "@backstage/plugin-app": "^0.1.7",
     "@react-hookz/web": "^24.0.0"
   },
   "devDependencies": {
-    "@backstage/cli": "0.31.0-next.1",
-    "@backstage/core-plugin-api": "1.10.4",
-    "@backstage/test-utils": "1.7.6-next.0",
+    "@backstage/cli": "^0.31.0",
+    "@backstage/core-plugin-api": "^1.10.5",
+    "@backstage/test-utils": "^1.7.6",
     "@testing-library/jest-dom": "^6.0.0",
     "@testing-library/react": "^16.0.0",
     "@types/react": "^18.0.0",