@backstage/frontend-defaults 0.2.5-next.1 → 0.3.0-next.2

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @backstage/frontend-defaults
 
+## 0.3.0-next.2
+
+### Minor Changes
+
+- 76832a9: **BREAKING**: Removed the deprecated `CreateAppFeatureLoader` and support for it in other APIs. Switch existing usage to use the newer `createFrontendFeatureLoader` from `@backstage/frontend-plugin-api` instead.
+
+### Patch Changes
+
+- 22de964: Deprecated `createPublicSignInApp`, which has been replaced by the new `appModulePublicSignIn` from `@backstage/plugin-app/alpha` instead.
+- e4ddf22: Internal update to align with new blueprint parameter naming in the new frontend system.
+- Updated dependencies
+  - @backstage/frontend-plugin-api@0.11.0-next.1
+  - @backstage/frontend-app-api@0.12.0-next.2
+  - @backstage/plugin-app@0.2.0-next.1
+  - @backstage/config@1.3.3
+  - @backstage/errors@1.2.7
+
 ## 0.2.5-next.1
 
 ### Patch Changes

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 { JSX, lazy, ReactNode, Suspense } 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  FrontendPluginInfoResolver,\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  pluginInfoResolver?: FrontendPluginInfoResolver;\n  flags?: { allowUnknownExtensionConfig?: boolean };\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      pluginInfoResolver: options?.pluginInfoResolver,\n      flags: options?.flags,\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 = lazy(appLoader);\n      return (\n        <Suspense fallback={suspenseFallback}>\n          <LazyApp />\n        </Suspense>\n      );\n    },\n  };\n}\n"],"names":[],"mappings":";;;;;;;;;;;AA0FO,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,0BAAA;AAAA,MACrC,oBAAoB,OAAS,EAAA,kBAAA;AAAA,MAC7B,OAAO,OAAS,EAAA;AAAA,KACjB,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,KAAK,SAAS,CAAA;AAC9B,MAAA,2BACG,QAAS,EAAA,EAAA,QAAA,EAAU,gBAClB,EAAA,QAAA,kBAAA,GAAA,CAAC,WAAQ,CACX,EAAA,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 { JSX, lazy, ReactNode, Suspense } 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  FrontendPluginInfoResolver,\n} from '@backstage/frontend-app-api';\nimport appPlugin from '@backstage/plugin-app';\nimport { discoverAvailableFeatures } from './discovery';\nimport { resolveAsyncFeatures } from './resolution';\n\n/**\n * Options for {@link createApp}.\n *\n * @public\n */\nexport interface CreateAppOptions {\n  features?: (FrontendFeature | FrontendFeatureLoader)[];\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  pluginInfoResolver?: FrontendPluginInfoResolver;\n  flags?: { allowUnknownExtensionConfig?: boolean };\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      pluginInfoResolver: options?.pluginInfoResolver,\n      flags: options?.flags,\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 = lazy(appLoader);\n      return (\n        <Suspense fallback={suspenseFallback}>\n          <LazyApp />\n        </Suspense>\n      );\n    },\n  };\n}\n"],"names":[],"mappings":";;;;;;;;;;;AAkEO,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,0BAAA;AAAA,MACrC,oBAAoB,OAAS,EAAA,kBAAA;AAAA,MAC7B,OAAO,OAAS,EAAA;AAAA,KACjB,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,KAAK,SAAS,CAAA;AAC9B,MAAA,2BACG,QAAS,EAAA,EAAA,QAAA,EAAU,gBAClB,EAAA,QAAA,kBAAA,GAAA,CAAC,WAAQ,CACX,EAAA,CAAA;AAAA;AAEJ,GACF;AACF;;;;"}

package/dist/createPublicSignInApp.esm.js

@@ -1,62 +1,12 @@
-import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
-import { createFrontendModule, coreExtensionData, useApi, identityApiRef } from '@backstage/frontend-plugin-api';
-import { useAsync, useMountEffect } from '@react-hookz/web';
+import { appModulePublicSignIn } from '@backstage/plugin-app/alpha';
 import { createApp } from './createApp.esm.js';
-import appPlugin from '@backstage/plugin-app';
 
-function InternalCookieAuthRedirect() {
-  const identityApi = useApi(identityApiRef);
-  const [state, actions] = useAsync(async () => {
-    const { token } = await identityApi.getCredentials();
-    if (!token) {
-      throw new Error("Expected Backstage token in sign-in response");
-    }
-    return token;
-  });
-  useMountEffect(actions.execute);
-  if (state.status === "error" && state.error) {
-    return /* @__PURE__ */ jsxs(Fragment, { children: [
-      "An error occurred: ",
-      state.error.message
-    ] });
-  }
-  if (state.status === "success" && state.result) {
-    return /* @__PURE__ */ jsxs(
-      "form",
-      {
-        ref: (form) => form?.submit(),
-        action: window.location.href,
-        method: "POST",
-        style: { visibility: "hidden" },
-        children: [
-          /* @__PURE__ */ jsx("input", { type: "hidden", name: "type", value: "sign-in" }),
-          /* @__PURE__ */ jsx("input", { type: "hidden", name: "token", value: state.result }),
-          /* @__PURE__ */ jsx("input", { type: "submit", value: "Continue" })
-        ]
-      }
-    );
-  }
-  return null;
-}
 function createPublicSignInApp(options) {
   return createApp({
     ...options,
-    features: [
-      ...options?.features ?? [],
-      // This is a rather than app plugin override in order for it to take precedence over any supplied app plugin override
-      createFrontendModule({
-        pluginId: "app",
-        extensions: [
-          appPlugin.getExtension("app/layout").override({
-            factory: () => [
-              coreExtensionData.reactElement(/* @__PURE__ */ jsx(InternalCookieAuthRedirect, {}))
-            ]
-          })
-        ]
-      })
-    ]
+    features: [...options?.features ?? [], appModulePublicSignIn]
   });
 }
 
-export { InternalCookieAuthRedirect, createPublicSignInApp };
+export { createPublicSignInApp };
 //# sourceMappingURL=createPublicSignInApp.esm.js.map

package/dist/createPublicSignInApp.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"createPublicSignInApp.esm.js","sources":["../src/createPublicSignInApp.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 {\n  coreExtensionData,\n  createFrontendModule,\n  identityApiRef,\n  useApi,\n} from '@backstage/frontend-plugin-api';\nimport { useAsync, useMountEffect } from '@react-hookz/web';\nimport { CreateAppOptions, createApp } from './createApp';\nimport appPlugin from '@backstage/plugin-app';\n\n// This is a copy of the CookieAuthRedirect component from the auth-react\n// plugin, to avoid a dependency on that package. Long-term we want this to be\n// the only implementation and remove the one in auth-react once the old frontend system is gone.\n\n// TODO(Rugvip): Should this be part of the app plugin instead? since it owns the backend part of it.\n\n/** @internal */\nexport function InternalCookieAuthRedirect() {\n  const identityApi = useApi(identityApiRef);\n\n  const [state, actions] = useAsync(async () => {\n    const { token } = await identityApi.getCredentials();\n    if (!token) {\n      throw new Error('Expected Backstage token in sign-in response');\n    }\n    return token;\n  });\n\n  useMountEffect(actions.execute);\n\n  if (state.status === 'error' && state.error) {\n    return <>An error occurred: {state.error.message}</>;\n  }\n\n  if (state.status === 'success' && state.result) {\n    return (\n      <form\n        ref={form => form?.submit()}\n        action={window.location.href}\n        method=\"POST\"\n        style={{ visibility: 'hidden' }}\n      >\n        <input type=\"hidden\" name=\"type\" value=\"sign-in\" />\n        <input type=\"hidden\" name=\"token\" value={state.result} />\n        <input type=\"submit\" value=\"Continue\" />\n      </form>\n    );\n  }\n\n  return null;\n}\n\n/**\n * Creates an app that is suitable for the public sign-in page, for use in the `index-public-experimental.tsx` file.\n *\n * @remarks\n *\n * This app has an override for the `app/layout` extension, which means that\n * most extension typically installed in an app will be ignored. However, you\n * can still for example install API and root element extensions.\n *\n * A typical setup of this app will only install a custom sign-in page.\n *\n * @example\n * ```ts\n * const app = createPublicSignInApp({\n *   features: [signInPageModule],\n * });\n * ```\n *\n * @public\n */\nexport function createPublicSignInApp(options?: CreateAppOptions) {\n  return createApp({\n    ...options,\n    features: [\n      ...(options?.features ?? []),\n      // This is a rather than app plugin override in order for it to take precedence over any supplied app plugin override\n      createFrontendModule({\n        pluginId: 'app',\n        extensions: [\n          appPlugin.getExtension('app/layout').override({\n            factory: () => [\n              coreExtensionData.reactElement(<InternalCookieAuthRedirect />),\n            ],\n          }),\n        ],\n      }),\n    ],\n  });\n}\n"],"names":[],"mappings":";;;;;;AAiCO,SAAS,0BAA6B,GAAA;AAC3C,EAAM,MAAA,WAAA,GAAc,OAAO,cAAc,CAAA;AAEzC,EAAA,MAAM,CAAC,KAAA,EAAO,OAAO,CAAA,GAAI,SAAS,YAAY;AAC5C,IAAA,MAAM,EAAE,KAAA,EAAU,GAAA,MAAM,YAAY,cAAe,EAAA;AACnD,IAAA,IAAI,CAAC,KAAO,EAAA;AACV,MAAM,MAAA,IAAI,MAAM,8CAA8C,CAAA;AAAA;AAEhE,IAAO,OAAA,KAAA;AAAA,GACR,CAAA;AAED,EAAA,cAAA,CAAe,QAAQ,OAAO,CAAA;AAE9B,EAAA,IAAI,KAAM,CAAA,MAAA,KAAW,OAAW,IAAA,KAAA,CAAM,KAAO,EAAA;AAC3C,IAAA,uBAAS,IAAA,CAAA,QAAA,EAAA,EAAA,QAAA,EAAA;AAAA,MAAA,qBAAA;AAAA,MAAoB,MAAM,KAAM,CAAA;AAAA,KAAQ,EAAA,CAAA;AAAA;AAGnD,EAAA,IAAI,KAAM,CAAA,MAAA,KAAW,SAAa,IAAA,KAAA,CAAM,MAAQ,EAAA;AAC9C,IACE,uBAAA,IAAA;AAAA,MAAC,MAAA;AAAA,MAAA;AAAA,QACC,GAAA,EAAK,CAAQ,IAAA,KAAA,IAAA,EAAM,MAAO,EAAA;AAAA,QAC1B,MAAA,EAAQ,OAAO,QAAS,CAAA,IAAA;AAAA,QACxB,MAAO,EAAA,MAAA;AAAA,QACP,KAAA,EAAO,EAAE,UAAA,EAAY,QAAS,EAAA;AAAA,QAE9B,QAAA,EAAA;AAAA,0BAAA,GAAA,CAAC,WAAM,IAAK,EAAA,QAAA,EAAS,IAAK,EAAA,MAAA,EAAO,OAAM,SAAU,EAAA,CAAA;AAAA,0BACjD,GAAA,CAAC,WAAM,IAAK,EAAA,QAAA,EAAS,MAAK,OAAQ,EAAA,KAAA,EAAO,MAAM,MAAQ,EAAA,CAAA;AAAA,0BACtD,GAAA,CAAA,OAAA,EAAA,EAAM,IAAK,EAAA,QAAA,EAAS,OAAM,UAAW,EAAA;AAAA;AAAA;AAAA,KACxC;AAAA;AAIJ,EAAO,OAAA,IAAA;AACT;AAsBO,SAAS,sBAAsB,OAA4B,EAAA;AAChE,EAAA,OAAO,SAAU,CAAA;AAAA,IACf,GAAG,OAAA;AAAA,IACH,QAAU,EAAA;AAAA,MACR,GAAI,OAAS,EAAA,QAAA,IAAY,EAAC;AAAA;AAAA,MAE1B,oBAAqB,CAAA;AAAA,QACnB,QAAU,EAAA,KAAA;AAAA,QACV,UAAY,EAAA;AAAA,UACV,SAAU,CAAA,YAAA,CAAa,YAAY,CAAA,CAAE,QAAS,CAAA;AAAA,YAC5C,SAAS,MAAM;AAAA,cACb,iBAAkB,CAAA,YAAA,iBAAc,GAAA,CAAA,0BAAA,EAAA,EAA2B,CAAE;AAAA;AAC/D,WACD;AAAA;AACH,OACD;AAAA;AACH,GACD,CAAA;AACH;;;;"}
+{"version":3,"file":"createPublicSignInApp.esm.js","sources":["../src/createPublicSignInApp.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 { appModulePublicSignIn } from '@backstage/plugin-app/alpha';\nimport { CreateAppOptions, createApp } from './createApp';\n\n/**\n * @public\n * @deprecated Use {@link @backstage/plugin-app/alpha#appModulePublicSignIn} instead.\n */\nexport function createPublicSignInApp(options?: CreateAppOptions) {\n  return createApp({\n    ...options,\n    features: [...(options?.features ?? []), appModulePublicSignIn],\n  });\n}\n"],"names":[],"mappings":";;;AAuBO,SAAS,sBAAsB,OAA4B,EAAA;AAChE,EAAA,OAAO,SAAU,CAAA;AAAA,IACf,GAAG,OAAA;AAAA,IACH,UAAU,CAAC,GAAI,SAAS,QAAY,IAAA,IAAK,qBAAqB;AAAA,GAC/D,CAAA;AACH;;;;"}

package/dist/index.d.ts

@@ -1,36 +1,16 @@
 import * as react from 'react';
 import { ReactNode, JSX } from 'react';
-import { ConfigApi, FrontendFeature, FrontendFeatureLoader, ExtensionFactoryMiddleware } from '@backstage/frontend-plugin-api';
+import { FrontendFeature, FrontendFeatureLoader, ConfigApi, ExtensionFactoryMiddleware } from '@backstage/frontend-plugin-api';
 import { CreateAppRouteBinder, FrontendPluginInfoResolver } 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 {
-    /**
-     * Returns name of this loader. suitable for showing to users.
-     */
-    getLoaderName(): string;
-    /**
-     * Loads a number of features dynamically.
-     */
-    load(options: {
-        config: ConfigApi;
-    }): Promise<{
-        features: FrontendFeature[];
-    }>;
-}
 /**
  * Options for {@link createApp}.
  *
  * @public
  */
 interface CreateAppOptions {
-    features?: (FrontendFeature | FrontendFeatureLoader | CreateAppFeatureLoader)[];
+    features?: (FrontendFeature | FrontendFeatureLoader)[];
     configLoader?: () => Promise<{
         config: ConfigApi;
     }>;
@@ -60,24 +40,8 @@ declare function createApp(options?: CreateAppOptions): {
 };
 
 /**
- * Creates an app that is suitable for the public sign-in page, for use in the `index-public-experimental.tsx` file.
- *
- * @remarks
- *
- * This app has an override for the `app/layout` extension, which means that
- * most extension typically installed in an app will be ignored. However, you
- * can still for example install API and root element extensions.
- *
- * A typical setup of this app will only install a custom sign-in page.
- *
- * @example
- * ```ts
- * const app = createPublicSignInApp({
- *   features: [signInPageModule],
- * });
- * ```
- *
  * @public
+ * @deprecated Use {@link @backstage/plugin-app/alpha#appModulePublicSignIn} instead.
  */
 declare function createPublicSignInApp(options?: CreateAppOptions): {
     createRoot(): react.JSX.Element;
@@ -93,9 +57,9 @@ declare function discoverAvailableFeatures(config: Config): {
 /** @public */
 declare function resolveAsyncFeatures(options: {
     config: Config;
-    features?: (FrontendFeature | FrontendFeatureLoader | CreateAppFeatureLoader)[];
+    features?: (FrontendFeature | FrontendFeatureLoader)[];
 }): Promise<{
     features: FrontendFeature[];
 }>;
 
-export { type CreateAppFeatureLoader, type CreateAppOptions, createApp, createPublicSignInApp, discoverAvailableFeatures, resolveAsyncFeatures };
+export { type CreateAppOptions, createApp, createPublicSignInApp, discoverAvailableFeatures, resolveAsyncFeatures };

package/dist/resolution.esm.js

@@ -2,23 +2,6 @@ import { stringifyError } from '@backstage/errors';
 import { isInternalFrontendFeatureLoader } from './frontend-plugin-api/src/wiring/createFrontendFeatureLoader.esm.js';
 
 async function resolveAsyncFeatures(options) {
-  const features = [];
-  for (const item of options?.features ?? []) {
-    if ("load" in item) {
-      try {
-        const result = await item.load({ config: options.config });
-        features.push(...result.features);
-      } catch (e) {
-        throw new Error(
-          `Failed to read frontend features from loader '${item.getLoaderName()}', ${stringifyError(
-            e
-          )}`
-        );
-      }
-    } else {
-      features.push(item);
-    }
-  }
   const loadedFeatures = [];
   const alreadyMetFeatureLoaders = [];
   const maxRecursionDepth = 5;
@@ -53,7 +36,7 @@ async function resolveAsyncFeatures(options) {
       }
     }
   }
-  await applyFeatureLoaders(features, 1);
+  await applyFeatureLoaders(options.features ?? [], 1);
   return { features: loadedFeatures };
 }
 function isBackstageFeatureLoader(obj) {

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 {\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;;;;"}
+{"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';\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?: (FrontendFeature | FrontendFeatureLoader)[];\n}): Promise<{ features: FrontendFeature[] }> {\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(options.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":";;;AA0BA,eAAsB,qBAAqB,OAGE,EAAA;AAC3C,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,EAAA,MAAM,mBAAoB,CAAA,OAAA,CAAQ,QAAY,IAAA,IAAI,CAAC,CAAA;AAEnD,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.5-next.1",
+  "version": "0.3.0-next.2",
   "backstage": {
     "role": "web-library"
   },
@@ -33,13 +33,13 @@
   "dependencies": {
     "@backstage/config": "1.3.3",
     "@backstage/errors": "1.2.7",
-    "@backstage/frontend-app-api": "0.11.5-next.1",
-    "@backstage/frontend-plugin-api": "0.11.0-next.0",
-    "@backstage/plugin-app": "0.2.0-next.0",
+    "@backstage/frontend-app-api": "0.12.0-next.2",
+    "@backstage/frontend-plugin-api": "0.11.0-next.1",
+    "@backstage/plugin-app": "0.2.0-next.1",
     "@react-hookz/web": "^24.0.0"
   },
   "devDependencies": {
-    "@backstage/cli": "0.33.2-next.0",
+    "@backstage/cli": "0.34.0-next.1",
     "@backstage/core-plugin-api": "1.10.9",
     "@backstage/test-utils": "1.7.11-next.0",
     "@testing-library/jest-dom": "^6.0.0",