@backstage/frontend-app-api 0.2.0 → 0.3.0-next.0

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # @backstage/frontend-app-api
 
+## 0.3.0-next.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.
+- 6c2b872153: Add official support for React 18.
+- dc613f9bcf: Updated `app.extensions` configuration schema.
+- 685a4c8901: Installed features are now deduplicated both by reference and ID when available. Features passed to `createApp` now override both discovered and loaded features.
+- bb98953cb9: Register default implementation for the `Translation API` on the new `createApp`.
+- Updated dependencies
+  - @backstage/core-components@0.13.7-next.0
+  - @backstage/frontend-plugin-api@0.3.0-next.0
+  - @backstage/plugin-graphiql@0.3.0-next.0
+  - @backstage/core-plugin-api@1.8.0-next.0
+  - @backstage/version-bridge@1.0.7-next.0
+  - @backstage/core-app-api@1.11.1-next.0
+  - @backstage/theme@0.4.4-next.0
+  - @backstage/config@1.1.1
+  - @backstage/types@1.1.1
+
 ## 0.2.0
 
 ### Minor Changes

package/config.d.ts

@@ -24,20 +24,27 @@ export interface Config {
       packages?: 'all' | { include?: string[]; exclude?: string[] };
     };
 
+    routes?: {
+      /**
+       * @deepVisibility frontend
+       */
+      bindings?: { [externalRouteRefId: string]: string };
+    };
+
     /**
      * @deepVisibility frontend
      */
-    extensions?:
+    extensions?: Array<
       | string
       | {
           [extensionId: string]:
             | boolean
-            | string
             | {
-                at?: string;
-                extension?: string;
+                attachTo?: { id: string; input: string };
+                disabled?: boolean;
                 config?: unknown;
               };
-        };
+        }
+    >;
   };
 }

package/dist/index.d.ts

@@ -1,8 +1,45 @@
 import { JSX } from 'react';
 import { Config } from '@backstage/config';
-import { ExtensionDataRef, BackstagePlugin, ExtensionOverrides } from '@backstage/frontend-plugin-api';
+import { ExternalRouteRef, RouteRef, SubRouteRef, ExtensionDataRef, BackstagePlugin, ExtensionOverrides } from '@backstage/frontend-plugin-api';
 import { ConfigApi } from '@backstage/core-plugin-api';
-import { AppRouteBinder } from '@backstage/core-app-api';
+
+/**
+ * Extracts a union of the keys in a map whose value extends the given type
+ *
+ * @ignore
+ */
+type KeysWithType<Obj extends {
+    [key in string]: any;
+}, Type> = {
+    [key in keyof Obj]: Obj[key] extends Type ? key : never;
+}[keyof Obj];
+/**
+ * Takes a map Map required values and makes all keys matching Keys optional
+ *
+ * @ignore
+ */
+type PartialKeys<Map extends {
+    [name in string]: any;
+}, Keys extends keyof Map> = Partial<Pick<Map, Keys>> & Required<Omit<Map, Keys>>;
+/**
+ * Creates a map of target routes with matching parameters based on a map of external routes.
+ *
+ * @ignore
+ */
+type TargetRouteMap<ExternalRoutes extends {
+    [name: string]: ExternalRouteRef;
+}> = {
+    [name in keyof ExternalRoutes]: ExternalRoutes[name] extends ExternalRouteRef<infer Params, any> ? RouteRef<Params> | SubRouteRef<Params> : never;
+};
+/**
+ * A function that can bind from external routes of a given plugin, to concrete
+ * routes of other plugins. See {@link createApp}.
+ *
+ * @public
+ */
+type AppRouteBinder = <TExternalRoutes extends {
+    [name: string]: ExternalRouteRef;
+}>(externalRoutes: TExternalRoutes, targetRoutes: PartialKeys<TargetRouteMap<TExternalRoutes>, KeysWithType<TExternalRoutes, ExternalRouteRef<any, true>>>) => void;
 
 /** @public */
 interface ExtensionTreeNode {
@@ -34,4 +71,4 @@ declare function createApp(options: {
     createRoot(): JSX.Element;
 };
 
-export { ExtensionTree, ExtensionTreeNode, createApp, createExtensionTree };
+export { AppRouteBinder, ExtensionTree, ExtensionTreeNode, createApp, createExtensionTree };