@backstage/frontend-app-api 0.3.0-next.1 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,50 @@
 # @backstage/frontend-app-api
 
+## 0.3.0
+
+### Minor Changes
+
+- 68fc9dc60e: Added the ability to configure bound routes through `app.routes.bindings`. The routing system used by `createApp` has been replaced by one that only supports route refs of the new format from `@backstage/frontend-plugin-api`. The requirement for route refs to have the same ID as their associated extension has been removed.
+
+### Patch Changes
+
+- e28d379e32: Refactor internal extension instance system into an app graph.
+- fdc348d5d3: The options parameter of `createApp` is now optional.
+- 6c2b872153: Add official support for React 18.
+- dc613f9bcf: Updated `app.extensions` configuration schema.
+- 733bd95746: Implement new `AppTreeApi`
+- 685a4c8901: Installed features are now deduplicated both by reference and ID when available. Features passed to `createApp` now override both discovered and loaded features.
+- fa28d4e6df: No longer throw error on invalid input if the child is disabled.
+- bb98953cb9: Register default implementation for the `Translation API` on the new `createApp`.
+- fe6d09953d: Fix for app node output IDs not being serialized correctly.
+- 77f009b35d: Internal updates to match changes in the experimental `@backstage/frontend-plugin-api`.
+- 4d6fa921db: Internal refactor to rename the app graph to app tree
+- Updated dependencies
+  - @backstage/core-components@0.13.8
+  - @backstage/frontend-plugin-api@0.3.0
+  - @backstage/plugin-graphiql@0.3.0
+  - @backstage/core-plugin-api@1.8.0
+  - @backstage/version-bridge@1.0.7
+  - @backstage/core-app-api@1.11.1
+  - @backstage/theme@0.4.4
+  - @backstage/config@1.1.1
+  - @backstage/types@1.1.1
+
+## 0.3.0-next.2
+
+### Patch Changes
+
+- [#20999](https://github.com/backstage/backstage/pull/20999) [`fdc348d5d3`](https://github.com/backstage/backstage/commit/fdc348d5d30a98b52d8a756daba29d616418da93) Thanks [@Rugvip](https://github.com/Rugvip)! - The options parameter of `createApp` is now optional.
+
+- [#20888](https://github.com/backstage/backstage/pull/20888) [`733bd95746`](https://github.com/backstage/backstage/commit/733bd95746b99ad8cdb4a7b87e8dc3e16d3b764a) Thanks [@Rugvip](https://github.com/Rugvip)! - Implement new `AppTreeApi`
+
+- [#20999](https://github.com/backstage/backstage/pull/20999) [`fa28d4e6df`](https://github.com/backstage/backstage/commit/fa28d4e6dfcbee2bc8695b7b24289a401df96acd) Thanks [@Rugvip](https://github.com/Rugvip)! - No longer throw error on invalid input if the child is disabled.
+
+- Updated dependencies
+  - @backstage/core-components@0.13.8-next.2
+  - @backstage/frontend-plugin-api@0.3.0-next.2
+  - @backstage/plugin-graphiql@0.3.0-next.2
+
 ## 0.3.0-next.1
 
 ### Patch Changes

package/dist/index.d.ts

@@ -58,7 +58,7 @@ declare function createExtensionTree(options: {
     config: Config;
 }): ExtensionTree;
 /** @public */
-declare function createApp(options: {
+declare function createApp(options?: {
     features?: (BackstagePlugin | ExtensionOverrides)[];
     configLoader?: () => Promise<ConfigApi>;
     bindRoutes?(context: {

package/dist/index.esm.js

@@ -1,6 +1,6 @@
 import React, { useMemo, useState, useEffect } from 'react';
 import { ConfigReader } from '@backstage/config';
-import { createExtension, createExtensionInput, coreExtensionData, useRouteRef, createThemeExtension } from '@backstage/frontend-plugin-api';
+import { createExtension, createExtensionInput, coreExtensionData, useRouteRef, createThemeExtension, appTreeApiRef } from '@backstage/frontend-plugin-api';
 import { useRoutes, BrowserRouter, useInRouterContext, MemoryRouter, matchRoutes, generatePath, Route } from 'react-router-dom';
 import { SidebarPage, sidebarConfig, Sidebar, SidebarDivider, useSidebarOpenState, Link, SidebarItem, Progress, ErrorPage, ErrorPanel } from '@backstage/core-components';
 import { makeStyles } from '@material-ui/core';
@@ -2155,7 +2155,9 @@ function instantiateAppNodeTree(rootNode) {
         }
         return [{ id: child.spec.id, instance: childInstance }];
       });
-      instantiatedAttachments.set(input, instantiatedChildren);
+      if (instantiatedChildren.length > 0) {
+        instantiatedAttachments.set(input, instantiatedChildren);
+      }
     }
     node.instance = createAppNodeInstance({
       spec: node.spec,
@@ -2271,11 +2273,11 @@ function createApp(options) {
       overrideBaseUrlConfigs(defaultConfigLoaderSync())
     );
     const discoveredFeatures = getAvailableFeatures(config);
-    const loadedFeatures = (_d = await ((_c = options.featureLoader) == null ? void 0 : _c.call(options, { config }))) != null ? _d : [];
+    const loadedFeatures = (_d = await ((_c = options == null ? void 0 : options.featureLoader) == null ? void 0 : _c.call(options, { config }))) != null ? _d : [];
     const allFeatures = deduplicateFeatures([
       ...discoveredFeatures,
       ...loadedFeatures,
-      ...(_e = options.features) != null ? _e : []
+      ...(_e = options == null ? void 0 : options.features) != null ? _e : []
     ]);
     const tree = createAppTree({
       features: allFeatures,
@@ -2288,12 +2290,12 @@ function createApp(options) {
       )
     );
     const routeIds = collectRouteIds(allFeatures);
-    const App = () => /* @__PURE__ */ React.createElement(ApiProvider, { apis: createApiHolder(tree.root, config) }, /* @__PURE__ */ React.createElement(AppContextProvider, { appContext }, /* @__PURE__ */ React.createElement(AppThemeProvider, null, /* @__PURE__ */ React.createElement(
+    const App = () => /* @__PURE__ */ React.createElement(ApiProvider, { apis: createApiHolder(tree, config) }, /* @__PURE__ */ React.createElement(AppContextProvider, { appContext }, /* @__PURE__ */ React.createElement(AppThemeProvider, null, /* @__PURE__ */ React.createElement(
       RoutingProvider,
       {
         ...extractRouteInfoFromAppNode(tree.root),
         routeBindings: resolveRouteBindings(
-          options.bindRoutes,
+          options == null ? void 0 : options.bindRoutes,
           config,
           routeIds
         )
@@ -2355,14 +2357,14 @@ function createLegacyAppContext(plugins) {
     }
   };
 }
-function createApiHolder(core, configApi) {
+function createApiHolder(tree, configApi) {
   var _a, _b, _c, _d;
   const factoryRegistry = new ApiFactoryRegistry();
-  const pluginApis = (_b = (_a = core.edges.attachments.get("apis")) == null ? void 0 : _a.map((e) => {
+  const pluginApis = (_b = (_a = tree.root.edges.attachments.get("apis")) == null ? void 0 : _a.map((e) => {
     var _a2;
     return (_a2 = e.instance) == null ? void 0 : _a2.getData(coreExtensionData.apiFactory);
   }).filter((x) => !!x)) != null ? _b : [];
-  const themeExtensions = (_d = (_c = core.edges.attachments.get("themes")) == null ? void 0 : _c.map((e) => {
+  const themeExtensions = (_d = (_c = tree.root.edges.attachments.get("themes")) == null ? void 0 : _c.map((e) => {
     var _a2;
     return (_a2 = e.instance) == null ? void 0 : _a2.getData(coreExtensionData.theme);
   }).filter((x) => !!x)) != null ? _d : [];
@@ -2405,6 +2407,13 @@ function createApiHolder(core, configApi) {
       return appIdentityProxy;
     }
   });
+  factoryRegistry.register("static", {
+    api: appTreeApiRef,
+    deps: {},
+    factory: () => ({
+      getTree: () => ({ tree })
+    })
+  });
   factoryRegistry.register("static", {
     api: appThemeApiRef,
     deps: {},