@backstage/core-plugin-api 1.0.4 → 1.0.6-next.0

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # @backstage/core-plugin-api
 
+## 1.0.6-next.0
+
+### Patch Changes
+
+- 744fea158b: Added `getSystemIcons()` function to the `AppContext` available through `useApp` that will pull a list of all the icons that have been registered in the App.
+- bf5e9030eb: Updated dependency `msw` to `^0.45.0`.
+- ef9ab322de: Minor API signatures cleanup
+
+## 1.0.5
+
+### Patch Changes
+
+- 80da5162c7: Introduced a new experimental feature that allows you to declare plugin-wide options for your plugin by defining
+  `__experimentalConfigure` in your `createPlugin` options. See https://backstage.io/docs/plugins/customization.md for more information.
+
+  This is an experimental feature and it will have breaking changes in the future.
+
+- 87649a06bf: Add a note that the `fetchApi` utility should not be used on sign-in page implementations and similar.
+
+## 1.0.5-next.0
+
+### Patch Changes
+
+- 80da5162c7: Introduced a new experimental feature that allows you to declare plugin-wide options for your plugin by defining
+  `__experimentalConfigure` in your `createPlugin` options. See https://backstage.io/docs/plugins/customization.md for more information.
+
+  This is an experimental feature and it will have breaking changes in the future.
+
 ## 1.0.4
 
 ### Patch Changes

package/alpha/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backstage/core-plugin-api",
-  "version": "1.0.4",
+  "version": "1.0.6-next.0",
   "main": "../dist/index.esm.js",
   "types": "../dist/index.alpha.d.ts"
 }

package/dist/index.alpha.d.ts

@@ -301,6 +301,10 @@ export declare type AppContext = {
      * Get a common or custom icon for this app.
      */
     getSystemIcon(key: string): IconComponent_2 | undefined;
+    /**
+     * Get a list of common and custom icons for this app.
+     */
+    getSystemIcons(): Record<string, IconComponent_2>;
     /**
      * Get the components registered for various purposes in the app.
      */
@@ -498,7 +502,7 @@ export declare type BackstageIdentityResponse = {
  *
  * @public
  */
-export declare type BackstagePlugin<Routes extends AnyRoutes = {}, ExternalRoutes extends AnyExternalRoutes = {}> = {
+export declare type BackstagePlugin<Routes extends AnyRoutes = {}, ExternalRoutes extends AnyExternalRoutes = {}, PluginInputOptions extends {} = {}> = {
     getId(): string;
     getApis(): Iterable<AnyApiFactory>;
     /**
@@ -508,6 +512,7 @@ export declare type BackstagePlugin<Routes extends AnyRoutes = {}, ExternalRoute
     provide<T>(extension: Extension<T>): T;
     routes: Routes;
     externalRoutes: ExternalRoutes;
+    __experimentalReconfigure(options: PluginInputOptions): void;
 };
 
 /**
@@ -696,7 +701,7 @@ export declare function createExternalRouteRef<Params extends {
  * @param config - Plugin configuration.
  * @public
  */
-export declare function createPlugin<Routes extends AnyRoutes = {}, ExternalRoutes extends AnyExternalRoutes = {}>(config: PluginConfig<Routes, ExternalRoutes>): BackstagePlugin<Routes, ExternalRoutes>;
+export declare function createPlugin<Routes extends AnyRoutes = {}, ExternalRoutes extends AnyExternalRoutes = {}, PluginInputOptions extends {} = {}>(config: PluginConfig<Routes, ExternalRoutes, PluginInputOptions>): BackstagePlugin<Routes, ExternalRoutes, PluginInputOptions>;
 
 /**
  * Used by {@link createComponentExtension} and {@link createRoutableExtension}.
@@ -1111,6 +1116,13 @@ export declare type FetchApi = {
  * This is a wrapper for the fetch API, that has additional behaviors such as
  * the ability to automatically inject auth information where necessary.
  *
+ * Note that the default behavior of this API (unless overridden by your org),
+ * is to require that the user is already signed in so that it has auth
+ * information to inject. Therefore, using the default implementation of this
+ * utility API e.g. on the `SignInPage` or similar, would cause issues. In
+ * special circumstances like those, you can use the regular system `fetch`
+ * instead.
+ *
  * @public
  */
 export declare const fetchApiRef: ApiRef<FetchApi>;
@@ -1477,12 +1489,13 @@ export declare type PendingOAuthRequest = {
  *
  * @public
  */
-export declare type PluginConfig<Routes extends AnyRoutes, ExternalRoutes extends AnyExternalRoutes> = {
+export declare type PluginConfig<Routes extends AnyRoutes, ExternalRoutes extends AnyExternalRoutes, PluginInputOptions extends {}> = {
     id: string;
     apis?: Iterable<AnyApiFactory>;
     routes?: Routes;
     externalRoutes?: ExternalRoutes;
     featureFlags?: PluginFeatureFlagConfig[];
+    __experimentalConfigure?(options?: PluginInputOptions): {};
 };
 
 /**
@@ -1495,6 +1508,23 @@ export declare type PluginFeatureFlagConfig = {
     name: string;
 };
 
+/**
+ * Properties for the PluginProvider component.
+ *
+ * @alpha
+ */
+export declare interface PluginOptionsProviderProps {
+    children: ReactNode;
+    plugin?: BackstagePlugin;
+}
+
+/**
+ * Contains the plugin configuration.
+ *
+ * @alpha
+ */
+export declare const PluginProvider: (props: PluginOptionsProviderProps) => JSX.Element;
+
 /**
  * Profile information of the user.
  *
@@ -1767,6 +1797,14 @@ export declare const useApp: () => AppContext;
  */
 export declare function useElementFilter<T>(node: ReactNode, filterFn: (arg: ElementCollection) => T, dependencies?: any[]): T;
 
+/**
+ * Grab the current entity from the context, throws if the entity has not yet been loaded
+ * or is not available.
+ *
+ * @alpha
+ */
+export declare function usePluginOptions<TPluginOptions extends {} = {}>(): TPluginOptions;
+
 /**
  * React hook for constructing URLs to routes.
  *

package/dist/index.beta.d.ts

@@ -301,6 +301,10 @@ export declare type AppContext = {
      * Get a common or custom icon for this app.
      */
     getSystemIcon(key: string): IconComponent_2 | undefined;
+    /**
+     * Get a list of common and custom icons for this app.
+     */
+    getSystemIcons(): Record<string, IconComponent_2>;
     /**
      * Get the components registered for various purposes in the app.
      */
@@ -498,7 +502,7 @@ export declare type BackstageIdentityResponse = {
  *
  * @public
  */
-export declare type BackstagePlugin<Routes extends AnyRoutes = {}, ExternalRoutes extends AnyExternalRoutes = {}> = {
+export declare type BackstagePlugin<Routes extends AnyRoutes = {}, ExternalRoutes extends AnyExternalRoutes = {}, PluginInputOptions extends {} = {}> = {
     getId(): string;
     getApis(): Iterable<AnyApiFactory>;
     /**
@@ -508,6 +512,7 @@ export declare type BackstagePlugin<Routes extends AnyRoutes = {}, ExternalRoute
     provide<T>(extension: Extension<T>): T;
     routes: Routes;
     externalRoutes: ExternalRoutes;
+    __experimentalReconfigure(options: PluginInputOptions): void;
 };
 
 /**
@@ -696,7 +701,7 @@ export declare function createExternalRouteRef<Params extends {
  * @param config - Plugin configuration.
  * @public
  */
-export declare function createPlugin<Routes extends AnyRoutes = {}, ExternalRoutes extends AnyExternalRoutes = {}>(config: PluginConfig<Routes, ExternalRoutes>): BackstagePlugin<Routes, ExternalRoutes>;
+export declare function createPlugin<Routes extends AnyRoutes = {}, ExternalRoutes extends AnyExternalRoutes = {}, PluginInputOptions extends {} = {}>(config: PluginConfig<Routes, ExternalRoutes, PluginInputOptions>): BackstagePlugin<Routes, ExternalRoutes, PluginInputOptions>;
 
 /**
  * Used by {@link createComponentExtension} and {@link createRoutableExtension}.
@@ -1111,6 +1116,13 @@ export declare type FetchApi = {
  * This is a wrapper for the fetch API, that has additional behaviors such as
  * the ability to automatically inject auth information where necessary.
  *
+ * Note that the default behavior of this API (unless overridden by your org),
+ * is to require that the user is already signed in so that it has auth
+ * information to inject. Therefore, using the default implementation of this
+ * utility API e.g. on the `SignInPage` or similar, would cause issues. In
+ * special circumstances like those, you can use the regular system `fetch`
+ * instead.
+ *
  * @public
  */
 export declare const fetchApiRef: ApiRef<FetchApi>;
@@ -1477,12 +1489,13 @@ export declare type PendingOAuthRequest = {
  *
  * @public
  */
-export declare type PluginConfig<Routes extends AnyRoutes, ExternalRoutes extends AnyExternalRoutes> = {
+export declare type PluginConfig<Routes extends AnyRoutes, ExternalRoutes extends AnyExternalRoutes, PluginInputOptions extends {}> = {
     id: string;
     apis?: Iterable<AnyApiFactory>;
     routes?: Routes;
     externalRoutes?: ExternalRoutes;
     featureFlags?: PluginFeatureFlagConfig[];
+    __experimentalConfigure?(options?: PluginInputOptions): {};
 };
 
 /**
@@ -1495,6 +1508,10 @@ export declare type PluginFeatureFlagConfig = {
     name: string;
 };
 
+/* Excluded from this release type: PluginOptionsProviderProps */
+
+/* Excluded from this release type: PluginProvider */
+
 /**
  * Profile information of the user.
  *
@@ -1767,6 +1784,8 @@ export declare const useApp: () => AppContext;
  */
 export declare function useElementFilter<T>(node: ReactNode, filterFn: (arg: ElementCollection) => T, dependencies?: any[]): T;
 
+/* Excluded from this release type: usePluginOptions */
+
 /**
  * React hook for constructing URLs to routes.
  *

package/dist/index.d.ts

@@ -301,6 +301,10 @@ export declare type AppContext = {
      * Get a common or custom icon for this app.
      */
     getSystemIcon(key: string): IconComponent_2 | undefined;
+    /**
+     * Get a list of common and custom icons for this app.
+     */
+    getSystemIcons(): Record<string, IconComponent_2>;
     /**
      * Get the components registered for various purposes in the app.
      */
@@ -498,7 +502,7 @@ export declare type BackstageIdentityResponse = {
  *
  * @public
  */
-export declare type BackstagePlugin<Routes extends AnyRoutes = {}, ExternalRoutes extends AnyExternalRoutes = {}> = {
+export declare type BackstagePlugin<Routes extends AnyRoutes = {}, ExternalRoutes extends AnyExternalRoutes = {}, PluginInputOptions extends {} = {}> = {
     getId(): string;
     getApis(): Iterable<AnyApiFactory>;
     /**
@@ -508,6 +512,7 @@ export declare type BackstagePlugin<Routes extends AnyRoutes = {}, ExternalRoute
     provide<T>(extension: Extension<T>): T;
     routes: Routes;
     externalRoutes: ExternalRoutes;
+    __experimentalReconfigure(options: PluginInputOptions): void;
 };
 
 /**
@@ -696,7 +701,7 @@ export declare function createExternalRouteRef<Params extends {
  * @param config - Plugin configuration.
  * @public
  */
-export declare function createPlugin<Routes extends AnyRoutes = {}, ExternalRoutes extends AnyExternalRoutes = {}>(config: PluginConfig<Routes, ExternalRoutes>): BackstagePlugin<Routes, ExternalRoutes>;
+export declare function createPlugin<Routes extends AnyRoutes = {}, ExternalRoutes extends AnyExternalRoutes = {}, PluginInputOptions extends {} = {}>(config: PluginConfig<Routes, ExternalRoutes, PluginInputOptions>): BackstagePlugin<Routes, ExternalRoutes, PluginInputOptions>;
 
 /**
  * Used by {@link createComponentExtension} and {@link createRoutableExtension}.
@@ -1111,6 +1116,13 @@ export declare type FetchApi = {
  * This is a wrapper for the fetch API, that has additional behaviors such as
  * the ability to automatically inject auth information where necessary.
  *
+ * Note that the default behavior of this API (unless overridden by your org),
+ * is to require that the user is already signed in so that it has auth
+ * information to inject. Therefore, using the default implementation of this
+ * utility API e.g. on the `SignInPage` or similar, would cause issues. In
+ * special circumstances like those, you can use the regular system `fetch`
+ * instead.
+ *
  * @public
  */
 export declare const fetchApiRef: ApiRef<FetchApi>;
@@ -1477,12 +1489,13 @@ export declare type PendingOAuthRequest = {
  *
  * @public
  */
-export declare type PluginConfig<Routes extends AnyRoutes, ExternalRoutes extends AnyExternalRoutes> = {
+export declare type PluginConfig<Routes extends AnyRoutes, ExternalRoutes extends AnyExternalRoutes, PluginInputOptions extends {}> = {
     id: string;
     apis?: Iterable<AnyApiFactory>;
     routes?: Routes;
     externalRoutes?: ExternalRoutes;
     featureFlags?: PluginFeatureFlagConfig[];
+    __experimentalConfigure?(options?: PluginInputOptions): {};
 };
 
 /**
@@ -1495,6 +1508,10 @@ export declare type PluginFeatureFlagConfig = {
     name: string;
 };
 
+/* Excluded from this release type: PluginOptionsProviderProps */
+
+/* Excluded from this release type: PluginProvider */
+
 /**
  * Profile information of the user.
  *
@@ -1767,6 +1784,8 @@ export declare const useApp: () => AppContext;
  */
 export declare function useElementFilter<T>(node: ReactNode, filterFn: (arg: ElementCollection) => T, dependencies?: any[]): T;
 
+/* Excluded from this release type: usePluginOptions */
+
 /**
  * React hook for constructing URLs to routes.
  *

package/dist/index.esm.js

@@ -81,7 +81,9 @@ class ApiRefImpl {
     this.config = config;
     const valid = config.id.split(".").flatMap((part) => part.split("-")).every((part) => part.match(/^[a-z][a-z0-9]*$/));
     if (!valid) {
-      throw new Error(`API id must only contain period separated lowercase alphanum tokens with dashes, got '${config.id}'`);
+      throw new Error(
+        `API id must only contain period separated lowercase alphanum tokens with dashes, got '${config.id}'`
+      );
     }
   }
   get id() {
@@ -241,8 +243,36 @@ function useAnalytics() {
   return tracker;
 }
 
+const contextKey = "plugin-context";
+const PluginProvider = (props) => {
+  const { children, plugin } = props;
+  const { Provider } = createVersionedContext(contextKey);
+  return /* @__PURE__ */ React.createElement(Provider, {
+    value: createVersionedValueMap({
+      1: {
+        plugin
+      }
+    })
+  }, children);
+};
+function usePluginOptions() {
+  const versionedHolder = useVersionedContext(
+    contextKey
+  );
+  if (!versionedHolder) {
+    throw new Error("Plugin Options context is not available");
+  }
+  const value = versionedHolder.atVersion(1);
+  if (!value) {
+    throw new Error("Plugin Options v1 is not available");
+  }
+  return value.plugin.getPluginOptions();
+}
+
 const useApp = () => {
-  const versionedContext = useVersionedContext("app-context");
+  const versionedContext = useVersionedContext(
+    "app-context"
+  );
   if (!versionedContext) {
     throw new Error("App context is not available");
   }
@@ -253,7 +283,10 @@ const useApp = () => {
   return appContext;
 };
 
-const globalStore = getOrCreateGlobalSingleton("component-data-store", () => /* @__PURE__ */ new WeakMap());
+const globalStore = getOrCreateGlobalSingleton(
+  "component-data-store",
+  () => /* @__PURE__ */ new WeakMap()
+);
 const componentDataKey = "__backstage_data";
 function attachComponentData(component, type, data) {
   var _a;
@@ -271,7 +304,9 @@ function attachComponentData(component, type, data) {
   }
   if (container.map.has(type)) {
     const name = component.displayName || component.name;
-    throw new Error(`Attempted to attach duplicate data "${type}" to component "${name}"`);
+    throw new Error(
+      `Attempted to attach duplicate data "${type}" to component "${name}"`
+    );
   }
   container.map.set(type, data);
 }
@@ -291,7 +326,10 @@ function getComponentData(node, type) {
   return container.map.get(type);
 }
 
-const routeRefType = getOrCreateGlobalSingleton("route-ref-type", () => Symbol("route-ref-type"));
+const routeRefType = getOrCreateGlobalSingleton(
+  "route-ref-type",
+  () => Symbol("route-ref-type")
+);
 
 var _a$2;
 class RouteRefImpl {
@@ -310,7 +348,10 @@ class RouteRefImpl {
 _a$2 = routeRefType;
 function createRouteRef(config) {
   var _a2;
-  return new RouteRefImpl(config.id, (_a2 = config.params) != null ? _a2 : []);
+  return new RouteRefImpl(
+    config.id,
+    (_a2 = config.params) != null ? _a2 : []
+  );
 }
 
 var _a$1;
@@ -333,7 +374,9 @@ function createSubRouteRef(config) {
   const pathParams = path.split("/").filter((p) => p.startsWith(":")).map((p) => p.substring(1));
   const params = [...parent.params, ...pathParams];
   if (parent.params.some((p) => pathParams.includes(p))) {
-    throw new Error("SubRouteRef may not have params that overlap with its parent");
+    throw new Error(
+      "SubRouteRef may not have params that overlap with its parent"
+    );
   }
   if (!path.startsWith("/")) {
     throw new Error(`SubRouteRef path must start with '/', got '${path}'`);
@@ -346,7 +389,12 @@ function createSubRouteRef(config) {
       throw new Error(`SubRouteRef path has invalid param, got '${param}'`);
     }
   }
-  const subRouteRef = new SubRouteRefImpl(id, path, parent, params);
+  const subRouteRef = new SubRouteRefImpl(
+    id,
+    path,
+    parent,
+    params
+  );
   return subRouteRef;
 }
 
@@ -365,17 +413,26 @@ class ExternalRouteRefImpl {
 _a = routeRefType;
 function createExternalRouteRef(options) {
   var _a2;
-  return new ExternalRouteRefImpl(options.id, (_a2 = options.params) != null ? _a2 : [], Boolean(options.optional));
+  return new ExternalRouteRefImpl(
+    options.id,
+    (_a2 = options.params) != null ? _a2 : [],
+    Boolean(options.optional)
+  );
 }
 
 function useRouteRef(routeRef) {
   const sourceLocation = useLocation();
-  const versionedContext = useVersionedContext("routing-context");
+  const versionedContext = useVersionedContext(
+    "routing-context"
+  );
   if (!versionedContext) {
     throw new Error("Routing context is not available");
   }
   const resolver = versionedContext.atVersion(1);
-  const routeFunc = useMemo(() => resolver && resolver.resolve(routeRef, sourceLocation), [resolver, routeRef, sourceLocation]);
+  const routeFunc = useMemo(
+    () => resolver && resolver.resolve(routeRef, sourceLocation),
+    [resolver, routeRef, sourceLocation]
+  );
   if (!versionedContext) {
     throw new Error("useRouteRef used outside of routing context");
   }
@@ -423,37 +480,42 @@ function createRoutableExtension(options) {
   const { component, mountPoint, name } = options;
   return createReactExtension({
     component: {
-      lazy: () => component().then((InnerComponent) => {
-        const RoutableExtensionWrapper = (props) => {
-          try {
-            useRouteRef(mountPoint);
-          } catch (error) {
-            if (typeof error === "object" && error !== null) {
-              const { message } = error;
-              if (typeof message === "string" && message.startsWith("No path for ")) {
-                throw new Error(`Routable extension component with mount point ${mountPoint} was not discovered in the app element tree. Routable extension components may not be rendered by other components and must be directly available as an element within the App provider component.`);
+      lazy: () => component().then(
+        (InnerComponent) => {
+          const RoutableExtensionWrapper = (props) => {
+            try {
+              useRouteRef(mountPoint);
+            } catch (error) {
+              if (typeof error === "object" && error !== null) {
+                const { message } = error;
+                if (typeof message === "string" && message.startsWith("No path for ")) {
+                  throw new Error(
+                    `Routable extension component with mount point ${mountPoint} was not discovered in the app element tree. Routable extension components may not be rendered by other components and must be directly available as an element within the App provider component.`
+                  );
+                }
               }
+              throw error;
             }
-            throw error;
-          }
-          return /* @__PURE__ */ React.createElement(InnerComponent, {
-            ...props
-          });
-        };
-        const componentName = name || InnerComponent.displayName || InnerComponent.name || "LazyComponent";
-        RoutableExtensionWrapper.displayName = `RoutableExtension(${componentName})`;
-        return RoutableExtensionWrapper;
-      }, (error) => {
-        const RoutableExtensionWrapper = (_) => {
-          const app = useApp();
-          const { BootErrorPage } = app.getComponents();
-          return /* @__PURE__ */ React.createElement(BootErrorPage, {
-            step: "load-chunk",
-            error
-          });
-        };
-        return RoutableExtensionWrapper;
-      })
+            return /* @__PURE__ */ React.createElement(InnerComponent, {
+              ...props
+            });
+          };
+          const componentName = name || InnerComponent.displayName || InnerComponent.name || "LazyComponent";
+          RoutableExtensionWrapper.displayName = `RoutableExtension(${componentName})`;
+          return RoutableExtensionWrapper;
+        },
+        (error) => {
+          const RoutableExtensionWrapper = (_) => {
+            const app = useApp();
+            const { BootErrorPage } = app.getComponents();
+            return /* @__PURE__ */ React.createElement(BootErrorPage, {
+              step: "load-chunk",
+              error
+            });
+          };
+          return RoutableExtensionWrapper;
+        }
+      )
     },
     data: {
       "core.mountPoint": mountPoint
@@ -468,12 +530,16 @@ function createComponentExtension(options) {
 function createReactExtension(options) {
   const { data = {}, name } = options;
   if (!name) {
-    console.warn("Declaring extensions without name is DEPRECATED. Make sure that all usages of createReactExtension, createComponentExtension and createRoutableExtension provide a name.");
+    console.warn(
+      "Declaring extensions without name is DEPRECATED. Make sure that all usages of createReactExtension, createComponentExtension and createRoutableExtension provide a name."
+    );
   }
   let Component;
   if ("lazy" in options.component) {
     const lazyLoader = options.component.lazy;
-    Component = lazy(() => lazyLoader().then((component) => ({ default: component })));
+    Component = lazy(
+      () => lazyLoader().then((component) => ({ default: component }))
+    );
   } else {
     Component = options.component.sync;
   }
@@ -495,9 +561,11 @@ function createReactExtension(options) {
             ...name && { extension: name },
             ...mountPoint && { routeRef: mountPoint.id }
           }
+        }, /* @__PURE__ */ React.createElement(PluginProvider, {
+          plugin
         }, /* @__PURE__ */ React.createElement(Component, {
           ...props
-        }))));
+        })))));
       };
       attachComponentData(Result, "core.plugin", plugin);
       for (const [key, value] of Object.entries(data)) {
@@ -515,13 +583,23 @@ function selectChildren(rootNode, featureFlagsApi, selector, strictError) {
       return [];
     }
     if (node.type === Fragment) {
-      return selectChildren(node.props.children, featureFlagsApi, selector, strictError);
+      return selectChildren(
+        node.props.children,
+        featureFlagsApi,
+        selector,
+        strictError
+      );
     }
     if (getComponentData(node, "core.featureFlagged")) {
       const props = node.props;
       const isEnabled = "with" in props ? featureFlagsApi.isActive(props.with) : !featureFlagsApi.isActive(props.without);
       if (isEnabled) {
-        return selectChildren(node.props.children, featureFlagsApi, selector, strictError);
+        return selectChildren(
+          node.props.children,
+          featureFlagsApi,
+          selector,
+          strictError
+        );
       }
       return [];
     }
@@ -531,7 +609,12 @@ function selectChildren(rootNode, featureFlagsApi, selector, strictError) {
     if (strictError) {
       throw new Error(strictError);
     }
-    return selectChildren(node.props.children, featureFlagsApi, selector, strictError);
+    return selectChildren(
+      node.props.children,
+      featureFlagsApi,
+      selector,
+      strictError
+    );
   });
 }
 class Collection {
@@ -540,11 +623,20 @@ class Collection {
     this.featureFlagsApi = featureFlagsApi;
   }
   selectByComponentData(query) {
-    const selection = selectChildren(this.node, this.featureFlagsApi, (node) => getComponentData(node, query.key) !== void 0, query.withStrictError);
+    const selection = selectChildren(
+      this.node,
+      this.featureFlagsApi,
+      (node) => getComponentData(node, query.key) !== void 0,
+      query.withStrictError
+    );
     return new Collection(selection, this.featureFlagsApi);
   }
   findComponentData(query) {
-    const selection = selectChildren(this.node, this.featureFlagsApi, (node) => getComponentData(node, query.key) !== void 0);
+    const selection = selectChildren(
+      this.node,
+      this.featureFlagsApi,
+      (node) => getComponentData(node, query.key) !== void 0
+    );
     return selection.map((node) => getComponentData(node, query.key)).filter((data) => data !== void 0);
   }
   getElements() {
@@ -560,6 +652,7 @@ function useElementFilter(node, filterFn, dependencies = []) {
 class PluginImpl {
   constructor(config) {
     this.config = config;
+    this.options = void 0;
   }
   getId() {
     return this.config.id;
@@ -583,6 +676,18 @@ class PluginImpl {
   provide(extension) {
     return extension.expose(this);
   }
+  __experimentalReconfigure(options) {
+    if (this.config.__experimentalConfigure) {
+      this.options = this.config.__experimentalConfigure(options);
+    }
+  }
+  getPluginOptions() {
+    var _a;
+    if (this.config.__experimentalConfigure && !this.options) {
+      this.options = this.config.__experimentalConfigure();
+    }
+    return (_a = this.options) != null ? _a : {};
+  }
   toString() {
     return `plugin{${this.config.id}}`;
   }
@@ -591,5 +696,5 @@ function createPlugin(config) {
   return new PluginImpl(config);
 }
 
-export { AnalyticsContext, FeatureFlagState, SessionState, alertApiRef, analyticsApiRef, appThemeApiRef, atlassianAuthApiRef, attachComponentData, bitbucketAuthApiRef, configApiRef, createApiFactory, createApiRef, createComponentExtension, createExternalRouteRef, createPlugin, createReactExtension, createRoutableExtension, createRouteRef, createSubRouteRef, discoveryApiRef, errorApiRef, featureFlagsApiRef, fetchApiRef, getComponentData, githubAuthApiRef, gitlabAuthApiRef, googleAuthApiRef, identityApiRef, microsoftAuthApiRef, oauthRequestApiRef, oktaAuthApiRef, oneloginAuthApiRef, storageApiRef, useAnalytics, useApi, useApiHolder, useApp, useElementFilter, useRouteRef, useRouteRefParams, withApis };
+export { AnalyticsContext, FeatureFlagState, PluginProvider, SessionState, alertApiRef, analyticsApiRef, appThemeApiRef, atlassianAuthApiRef, attachComponentData, bitbucketAuthApiRef, configApiRef, createApiFactory, createApiRef, createComponentExtension, createExternalRouteRef, createPlugin, createReactExtension, createRoutableExtension, createRouteRef, createSubRouteRef, discoveryApiRef, errorApiRef, featureFlagsApiRef, fetchApiRef, getComponentData, githubAuthApiRef, gitlabAuthApiRef, googleAuthApiRef, identityApiRef, microsoftAuthApiRef, oauthRequestApiRef, oktaAuthApiRef, oneloginAuthApiRef, storageApiRef, useAnalytics, useApi, useApiHolder, useApp, useElementFilter, usePluginOptions, useRouteRef, useRouteRefParams, withApis };
 //# sourceMappingURL=index.esm.js.map