@backstage/frontend-plugin-api 0.3.1-next.0 → 0.4.0-next.2

package/CHANGELOG.md

@@ -1,5 +1,46 @@
 # @backstage/frontend-plugin-api
 
+## 0.4.0-next.2
+
+### Minor Changes
+
+- 8f5d6c1: Extension inputs are now wrapped into an additional object when passed to the extension factory, with the previous values being available at the `output` property. The `ExtensionInputValues` type has also been replaced by `ResolvedExtensionInputs`.
+- 8837a96: **BREAKING**: This version changes how extensions are created and how their IDs are determined. The `createExtension` function now accepts `kind`, `namespace` and `name` instead of `id`. All of the new options are optional, and are used to construct the final extension ID. By convention extension creators should set the `kind` to match their own name, for example `createNavItemExtension` sets the kind `nav-item`.
+
+  The `createExtension` function as well as all extension creators now also return an `ExtensionDefinition` rather than an `Extension`, which in turn needs to be passed to `createPlugin` or `createExtensionOverrides` to be used.
+
+### Patch Changes
+
+- b7adf24: Update alpha component ref type to be more specific than any, delete boot page component and use new plugin type for error boundary component extensions.
+- 73246ec: Added translation APIs as well as `createTranslationExtension`.
+- cb4197a: Forward ` node`` instead of  `extensionId` to resolved extension inputs.
+- Updated dependencies
+  - @backstage/config@1.1.1
+  - @backstage/core-components@0.13.9-next.2
+  - @backstage/core-plugin-api@1.8.1-next.1
+  - @backstage/types@1.1.1
+  - @backstage/version-bridge@1.0.7
+
+## 0.4.0-next.1
+
+### Minor Changes
+
+- a5a04739e1: The extension `factory` function now longer receives `id` or `source`, but instead now provides the extension's `AppNode` as `node`. The `ExtensionBoundary` component has also been updated to receive a `node` prop rather than `id` and `source`.
+
+### Patch Changes
+
+- 5eb6b8a7bc: Added the nav logo extension for customization of sidebar logo
+- 1f12fb762c: Create factories for overriding default core components extensions.
+- 59709286b3: Add feature flags to plugins and extension overrides.
+- e539735435: Added `createSignInPageExtension`.
+- f27ee7d937: Migrate analytics api and context files.
+- Updated dependencies
+  - @backstage/core-components@0.13.9-next.1
+  - @backstage/core-plugin-api@1.8.1-next.1
+  - @backstage/config@1.1.1
+  - @backstage/types@1.1.1
+  - @backstage/version-bridge@1.0.7
+
 ## 0.3.1-next.0
 
 ### Patch Changes

package/dist/index.d.ts

@@ -1,11 +1,56 @@
 /// <reference types="react" />
+import React, { ReactNode, JSX as JSX$1, ComponentType } from 'react';
 import * as _backstage_core_plugin_api from '@backstage/core-plugin-api';
-import { IconComponent as IconComponent$1, AnyApiFactory, AppTheme, AnyApiRef } from '@backstage/core-plugin-api';
+import { IconComponent as IconComponent$1, AnyApiFactory, AppTheme, ApiRef, AnyApiRef, SignInPageProps } from '@backstage/core-plugin-api';
 export { AlertApi, AlertMessage, AnyApiFactory, AnyApiRef, ApiFactory, ApiHolder, ApiRef, ApiRefConfig, AppTheme, AppThemeApi, AuthProviderInfo, AuthRequestOptions, BackstageIdentityApi, BackstageIdentityResponse, BackstageUserIdentity, ConfigApi, DiscoveryApi, ErrorApi, ErrorApiError, ErrorApiErrorContext, FeatureFlag, FeatureFlagState, FeatureFlagsApi, FeatureFlagsSaveOptions, FetchApi, IdentityApi, OAuthApi, OAuthRequestApi, OAuthRequester, OAuthRequesterOptions, OAuthScope, OpenIdConnectApi, PendingOAuthRequest, ProfileInfo, ProfileInfoApi, SessionApi, SessionState, StorageApi, StorageValueSnapshot, TypesToApiRefs, alertApiRef, appThemeApiRef, atlassianAuthApiRef, bitbucketAuthApiRef, bitbucketServerAuthApiRef, configApiRef, createApiFactory, createApiRef, discoveryApiRef, errorApiRef, featureFlagsApiRef, fetchApiRef, githubAuthApiRef, gitlabAuthApiRef, googleAuthApiRef, identityApiRef, microsoftAuthApiRef, oauthRequestApiRef, oktaAuthApiRef, oneloginAuthApiRef, storageApiRef, useApi, useApiHolder, withApis } from '@backstage/core-plugin-api';
 import { JsonObject } from '@backstage/types';
-import React, { JSX as JSX$1, ReactNode, ComponentType } from 'react';
+import { TranslationResource, TranslationMessages } from '@backstage/core-plugin-api/alpha';
+export { TranslationMessages, TranslationMessagesOptions, TranslationRef, TranslationRefOptions, TranslationResource, TranslationResourceOptions, createTranslationMessages, createTranslationRef, createTranslationResource, useTranslationRef } from '@backstage/core-plugin-api/alpha';
 import { z, ZodSchema, ZodTypeDef } from 'zod';
 
+/**
+ * Common analytics context attributes.
+ *
+ * @public
+ */
+type CommonAnalyticsContext = {
+    /**
+     * The nearest known parent plugin where the event was captured.
+     */
+    pluginId: string;
+    /**
+     * The nearest known parent extension where the event was captured.
+     */
+    /**
+     * The nearest known parent extension where the event was captured.
+     */
+    extensionId: string;
+};
+/**
+ * Analytics context envelope.
+ *
+ * @public
+ */
+type AnalyticsContextValue = CommonAnalyticsContext & {
+    [param in string]: string | boolean | number | undefined;
+};
+
+/**
+ * Provides components in the child react tree an Analytics Context, ensuring
+ * all analytics events captured within the context have relevant attributes.
+ *
+ * @remarks
+ *
+ * Analytics contexts are additive, meaning the context ultimately emitted with
+ * an event is the combination of all contexts in the parent tree.
+ *
+ * @public
+ */
+declare const AnalyticsContext: (options: {
+    attributes: Partial<AnalyticsContextValue>;
+    children: ReactNode;
+}) => React.JSX.Element;
+
 /**
  * Catch-all type for route params.
  *
@@ -217,6 +262,47 @@ interface ConfigurableExtensionDataRef<TData, TConfig extends {
 /** @public */
 declare function createExtensionDataRef<TData>(id: string): ConfigurableExtensionDataRef<TData>;
 
+/**
+ * Utility type to expand type aliases into their equivalent type.
+ * @ignore
+ */
+type Expand<T> = T extends infer O ? {
+    [K in keyof O]: O[K];
+} : never;
+/** @public */
+type CoreProgressProps = {};
+/** @public */
+type CoreNotFoundErrorPageProps = {
+    children?: ReactNode;
+};
+/** @public */
+type CoreErrorBoundaryFallbackProps = {
+    plugin?: BackstagePlugin;
+    error: Error;
+    resetError: () => void;
+};
+
+/** @public */
+type ComponentRef<T extends {} = {}> = {
+    id: string;
+    T: T;
+};
+/** @public */
+declare const coreComponentRefs: {
+    progress: ComponentRef<CoreProgressProps>;
+    notFoundErrorPage: ComponentRef<CoreNotFoundErrorPageProps>;
+    errorBoundaryFallback: ComponentRef<CoreErrorBoundaryFallbackProps>;
+};
+
+/** @public */
+interface ExtensionBoundaryProps {
+    node: AppNode;
+    routable?: boolean;
+    children: ReactNode;
+}
+/** @public */
+declare function ExtensionBoundary(props: ExtensionBoundaryProps): React.JSX.Element;
+
 /** @public */
 type NavTarget = {
     title: string;
@@ -224,6 +310,11 @@ type NavTarget = {
     routeRef: RouteRef<undefined>;
 };
 /** @public */
+type LogoElements = {
+    logoIcon?: JSX$1.Element;
+    logoFull?: JSX$1.Element;
+};
+/** @public */
 declare const coreExtensionData: {
     reactElement: ConfigurableExtensionDataRef<JSX$1.Element, {}>;
     routePath: ConfigurableExtensionDataRef<string, {}>;
@@ -231,6 +322,11 @@ declare const coreExtensionData: {
     routeRef: ConfigurableExtensionDataRef<RouteRef<AnyRouteRefParams>, {}>;
     navTarget: ConfigurableExtensionDataRef<NavTarget, {}>;
     theme: ConfigurableExtensionDataRef<AppTheme, {}>;
+    logoElements: ConfigurableExtensionDataRef<LogoElements, {}>;
+    component: ConfigurableExtensionDataRef<{
+        ref: ComponentRef;
+        impl: ComponentType;
+    }, {}>;
 };
 
 /** @public */
@@ -242,14 +338,6 @@ type PortableSchema<TOutput> = {
 /** @public */
 declare function createSchemaFromZod<TOutput, TInput>(schemaCreator: (zImpl: typeof z) => ZodSchema<TOutput, ZodTypeDef, TInput>): PortableSchema<TOutput>;
 
-/**
- * Utility type to expand type aliases into their equivalent type.
- * @ignore
- */
-type Expand<T> = T extends infer O ? {
-    [K in keyof O]: O[K];
-} : never;
-
 /** @public */
 interface ExtensionInput<TExtensionData extends AnyExtensionDataMap, TConfig extends {
     singleton: boolean;
@@ -268,32 +356,6 @@ declare function createExtensionInput<TExtensionData extends AnyExtensionDataMap
     optional: TConfig['optional'] extends true ? true : false;
 }>;
 
-/** @public */
-type AnyRoutes = {
-    [name in string]: RouteRef;
-};
-/** @public */
-type AnyExternalRoutes = {
-    [name in string]: ExternalRouteRef;
-};
-/** @public */
-interface PluginOptions<Routes extends AnyRoutes, ExternalRoutes extends AnyExternalRoutes> {
-    id: string;
-    routes?: Routes;
-    externalRoutes?: ExternalRoutes;
-    extensions?: Extension<unknown>[];
-}
-/** @public */
-interface BackstagePlugin<Routes extends AnyRoutes = AnyRoutes, ExternalRoutes extends AnyExternalRoutes = AnyExternalRoutes> {
-    $$type: '@backstage/BackstagePlugin';
-    id: string;
-    extensions: Extension<unknown>[];
-    routes: Routes;
-    externalRoutes: ExternalRoutes;
-}
-/** @public */
-declare function createPlugin<Routes extends AnyRoutes = {}, ExternalRoutes extends AnyExternalRoutes = {}>(options: PluginOptions<Routes, ExternalRoutes>): BackstagePlugin<Routes, ExternalRoutes>;
-
 /** @public */
 type AnyExtensionDataMap = {
     [name in string]: ExtensionDataRef<unknown, {
@@ -321,17 +383,27 @@ type ExtensionDataValues<TExtensionData extends AnyExtensionDataMap> = {
     } ? DataName : never]?: TExtensionData[DataName]['T'];
 };
 /**
- * Converts an extension input map into the matching concrete input values type.
+ * Convert a single extension input into a matching resolved input.
  * @public
  */
-type ExtensionInputValues<TInputs extends {
+type ResolvedExtensionInput<TExtensionData extends AnyExtensionDataMap> = {
+    node: AppNode;
+    output: ExtensionDataValues<TExtensionData>;
+};
+/**
+ * Converts an extension input map into a matching collection of resolved inputs.
+ * @public
+ */
+type ResolvedExtensionInputs<TInputs extends {
     [name in string]: ExtensionInput<any, any>;
 }> = {
-    [InputName in keyof TInputs]: false extends TInputs[InputName]['config']['singleton'] ? Array<Expand<ExtensionDataValues<TInputs[InputName]['extensionData']>>> : false extends TInputs[InputName]['config']['optional'] ? Expand<ExtensionDataValues<TInputs[InputName]['extensionData']>> : Expand<ExtensionDataValues<TInputs[InputName]['extensionData']> | undefined>;
+    [InputName in keyof TInputs]: false extends TInputs[InputName]['config']['singleton'] ? Array<Expand<ResolvedExtensionInput<TInputs[InputName]['extensionData']>>> : false extends TInputs[InputName]['config']['optional'] ? Expand<ResolvedExtensionInput<TInputs[InputName]['extensionData']>> : Expand<ResolvedExtensionInput<TInputs[InputName]['extensionData']> | undefined>;
 };
 /** @public */
 interface CreateExtensionOptions<TOutput extends AnyExtensionDataMap, TInputs extends AnyExtensionInputMap, TConfig> {
-    id: string;
+    kind?: string;
+    namespace?: string;
+    name?: string;
     attachTo: {
         id: string;
         input: string;
@@ -341,12 +413,32 @@ interface CreateExtensionOptions<TOutput extends AnyExtensionDataMap, TInputs ex
     output: TOutput;
     configSchema?: PortableSchema<TConfig>;
     factory(options: {
-        source?: BackstagePlugin;
+        node: AppNode;
         config: TConfig;
-        inputs: Expand<ExtensionInputValues<TInputs>>;
+        inputs: Expand<ResolvedExtensionInputs<TInputs>>;
     }): Expand<ExtensionDataValues<TOutput>>;
 }
 /** @public */
+interface ExtensionDefinition<TConfig> {
+    $$type: '@backstage/ExtensionDefinition';
+    kind?: string;
+    namespace?: string;
+    name?: string;
+    attachTo: {
+        id: string;
+        input: string;
+    };
+    disabled: boolean;
+    inputs: AnyExtensionInputMap;
+    output: AnyExtensionDataMap;
+    configSchema?: PortableSchema<TConfig>;
+    factory(options: {
+        node: AppNode;
+        config: TConfig;
+        inputs: ResolvedExtensionInputs<any>;
+    }): ExtensionDataValues<any>;
+}
+/** @public */
 interface Extension<TConfig> {
     $$type: '@backstage/Extension';
     id: string;
@@ -359,21 +451,58 @@ interface Extension<TConfig> {
     output: AnyExtensionDataMap;
     configSchema?: PortableSchema<TConfig>;
     factory(options: {
-        source?: BackstagePlugin;
+        node: AppNode;
         config: TConfig;
-        inputs: Record<string, undefined | Record<string, unknown> | Array<Record<string, unknown>>>;
+        inputs: ResolvedExtensionInputs<any>;
     }): ExtensionDataValues<any>;
 }
 /** @public */
-declare function createExtension<TOutput extends AnyExtensionDataMap, TInputs extends AnyExtensionInputMap, TConfig = never>(options: CreateExtensionOptions<TOutput, TInputs, TConfig>): Extension<TConfig>;
+declare function createExtension<TOutput extends AnyExtensionDataMap, TInputs extends AnyExtensionInputMap, TConfig = never>(options: CreateExtensionOptions<TOutput, TInputs, TConfig>): ExtensionDefinition<TConfig>;
+
+/**
+ * Feature flag configuration.
+ *
+ * @public
+ */
+type FeatureFlagConfig = {
+    /** Feature flag name */
+    name: string;
+};
+
+/** @public */
+type AnyRoutes = {
+    [name in string]: RouteRef;
+};
+/** @public */
+type AnyExternalRoutes = {
+    [name in string]: ExternalRouteRef;
+};
+/** @public */
+interface PluginOptions<Routes extends AnyRoutes, ExternalRoutes extends AnyExternalRoutes> {
+    id: string;
+    routes?: Routes;
+    externalRoutes?: ExternalRoutes;
+    extensions?: ExtensionDefinition<unknown>[];
+    featureFlags?: FeatureFlagConfig[];
+}
+/** @public */
+interface BackstagePlugin<Routes extends AnyRoutes = AnyRoutes, ExternalRoutes extends AnyExternalRoutes = AnyExternalRoutes> {
+    readonly $$type: '@backstage/BackstagePlugin';
+    readonly id: string;
+    readonly routes: Routes;
+    readonly externalRoutes: ExternalRoutes;
+}
+/** @public */
+declare function createPlugin<Routes extends AnyRoutes = {}, ExternalRoutes extends AnyExternalRoutes = {}>(options: PluginOptions<Routes, ExternalRoutes>): BackstagePlugin<Routes, ExternalRoutes>;
 
 /** @public */
 interface ExtensionOverridesOptions {
-    extensions: Extension<unknown>[];
+    extensions: ExtensionDefinition<unknown>[];
+    featureFlags?: FeatureFlagConfig[];
 }
 /** @public */
 interface ExtensionOverrides {
-    $$type: '@backstage/ExtensionOverrides';
+    readonly $$type: '@backstage/ExtensionOverrides';
 }
 /** @public */
 declare function createExtensionOverrides(options: ExtensionOverridesOptions): ExtensionOverrides;
@@ -476,29 +605,145 @@ interface AppTreeApi {
  */
 declare const appTreeApiRef: _backstage_core_plugin_api.ApiRef<AppTreeApi>;
 
-/** @public */
-interface ExtensionBoundaryProps {
-    id: string;
-    source?: BackstagePlugin;
-    routable?: boolean;
-    children: ReactNode;
+/**
+ * API for looking up components based on component refs.
+ *
+ * @public
+ */
+interface ComponentsApi {
+    getComponent<T extends {}>(ref: ComponentRef<T>): ComponentType<T>;
 }
-/** @public */
-declare function ExtensionBoundary(props: ExtensionBoundaryProps): React.JSX.Element;
+/**
+ * The `ApiRef` of {@link ComponentsApi}.
+ *
+ * @public
+ */
+declare const componentsApiRef: _backstage_core_plugin_api.ApiRef<ComponentsApi>;
+/**
+ * @public
+ * Returns the component associated with the given ref.
+ */
+declare function useComponentRef<T extends {}>(ref: ComponentRef<T>): ComponentType<T>;
+
+/**
+ * Represents an event worth tracking in an analytics system that could inform
+ * how users of a Backstage instance are using its features.
+ *
+ * @public
+ */
+type AnalyticsEvent = {
+    /**
+     * A string that identifies the event being tracked by the type of action the
+     * event represents. Be careful not to encode extra metadata in this string
+     * that should instead be placed in the Analytics Context or attributes.
+     * Examples include:
+     *
+     * - view
+     * - click
+     * - filter
+     * - search
+     * - hover
+     * - scroll
+     */
+    action: string;
+    /**
+     * A string that uniquely identifies the object that the action is being
+     * taken on. Examples include:
+     *
+     * - The path of the page viewed
+     * - The url of the link clicked
+     * - The value that was filtered by
+     * - The text that was searched for
+     */
+    subject: string;
+    /**
+     * An optional numeric value relevant to the event that could be aggregated
+     * by analytics tools. Examples include:
+     *
+     * - The index or position of the clicked element in an ordered list
+     * - The percentage of an element that has been scrolled through
+     * - The amount of time that has elapsed since a fixed point
+     * - A satisfaction score on a fixed scale
+     */
+    value?: number;
+    /**
+     * Optional, additional attributes (representing dimensions or metrics)
+     * specific to the event that could be forwarded on to analytics systems.
+     */
+    attributes?: AnalyticsEventAttributes;
+    /**
+     * Contextual metadata relating to where the event was captured and by whom.
+     * This could include information about the route, plugin, or extension in
+     * which an event was captured.
+     */
+    context: AnalyticsContextValue;
+};
+/**
+ * A structure allowing other arbitrary metadata to be provided by analytics
+ * event emitters.
+ *
+ * @public
+ */
+type AnalyticsEventAttributes = {
+    [attribute in string]: string | boolean | number;
+};
+/**
+ * Represents a tracker with methods that can be called to track events in a
+ * configured analytics service.
+ *
+ * @public
+ */
+type AnalyticsTracker = {
+    captureEvent: (action: string, subject: string, options?: {
+        value?: number;
+        attributes?: AnalyticsEventAttributes;
+    }) => void;
+};
+/**
+ * The Analytics API is used to track user behavior in a Backstage instance.
+ *
+ * @remarks
+ *
+ * To instrument your App or Plugin, retrieve an analytics tracker using the
+ * useAnalytics() hook. This will return a pre-configured AnalyticsTracker
+ * with relevant methods for instrumentation.
+ *
+ * @public
+ */
+type AnalyticsApi = {
+    /**
+     * Primary event handler responsible for compiling and forwarding events to
+     * an analytics system.
+     */
+    captureEvent(event: AnalyticsEvent): void;
+};
+/**
+ * The API reference of {@link AnalyticsApi}.
+ *
+ * @public
+ */
+declare const analyticsApiRef: ApiRef<AnalyticsApi>;
+
+/**
+ * Gets a pre-configured analytics tracker.
+ *
+ * @public
+ */
+declare function useAnalytics(): AnalyticsTracker;
 
 /** @public */
 declare function createApiExtension<TConfig extends {}, TInputs extends AnyExtensionInputMap>(options: ({
     api: AnyApiRef;
     factory: (options: {
         config: TConfig;
-        inputs: Expand<ExtensionInputValues<TInputs>>;
+        inputs: Expand<ResolvedExtensionInputs<TInputs>>;
     }) => AnyApiFactory;
 } | {
     factory: AnyApiFactory;
 }) & {
     configSchema?: PortableSchema<TConfig>;
     inputs?: TInputs;
-}): Extension<TConfig>;
+}): ExtensionDefinition<TConfig>;
 
 /**
  * Helper for creating extensions for a routable React page component.
@@ -512,7 +757,8 @@ declare function createPageExtension<TConfig extends {
 } | {
     configSchema: PortableSchema<TConfig>;
 }) & {
-    id: string;
+    namespace?: string;
+    name?: string;
     attachTo?: {
         id: string;
         input: string;
@@ -522,25 +768,78 @@ declare function createPageExtension<TConfig extends {
     routeRef?: RouteRef;
     loader: (options: {
         config: TConfig;
-        inputs: Expand<ExtensionInputValues<TInputs>>;
+        inputs: Expand<ResolvedExtensionInputs<TInputs>>;
     }) => Promise<JSX.Element>;
-}): Extension<TConfig>;
+}): ExtensionDefinition<TConfig>;
 
 /**
  * Helper for creating extensions for a nav item.
  * @public
  */
 declare function createNavItemExtension(options: {
-    id: string;
+    namespace?: string;
+    name?: string;
     routeRef: RouteRef<undefined>;
     title: string;
     icon: IconComponent$1;
-}): Extension<{
+}): ExtensionDefinition<{
     title: string;
 }>;
 
+/**
+ *
+ * @public
+ */
+declare function createSignInPageExtension<TConfig extends {}, TInputs extends AnyExtensionInputMap>(options: {
+    namespace?: string;
+    name?: string;
+    attachTo?: {
+        id: string;
+        input: string;
+    };
+    configSchema?: PortableSchema<TConfig>;
+    disabled?: boolean;
+    inputs?: TInputs;
+    loader: (options: {
+        config: TConfig;
+        inputs: Expand<ResolvedExtensionInputs<TInputs>>;
+    }) => Promise<ComponentType<SignInPageProps>>;
+}): ExtensionDefinition<TConfig>;
+
+/** @public */
+declare function createThemeExtension(theme: AppTheme): ExtensionDefinition<never>;
+
+/** @public */
+declare function createComponentExtension<TProps extends {}, TConfig extends {}, TInputs extends AnyExtensionInputMap>(options: {
+    ref: ComponentRef<TProps>;
+    name?: string;
+    disabled?: boolean;
+    inputs?: TInputs;
+    configSchema?: PortableSchema<TConfig>;
+    component: {
+        lazy: (values: {
+            config: TConfig;
+            inputs: Expand<ResolvedExtensionInputs<TInputs>>;
+        }) => Promise<ComponentType<TProps>>;
+    } | {
+        sync: (values: {
+            config: TConfig;
+            inputs: Expand<ResolvedExtensionInputs<TInputs>>;
+        }) => ComponentType<TProps>;
+    };
+}): ExtensionDefinition<TConfig>;
+
+/** @public */
+declare function createTranslationExtension(options: {
+    name?: string;
+    resource: TranslationResource | TranslationMessages;
+}): ExtensionDefinition<never>;
 /** @public */
-declare function createThemeExtension(theme: AppTheme): Extension<never>;
+declare namespace createTranslationExtension {
+    const translationDataRef: ConfigurableExtensionDataRef<TranslationResource<string> | TranslationMessages<string, {
+        [x: string]: string;
+    }, boolean>, {}>;
+}
 
 /**
  * IconComponent is the common icon type used throughout Backstage when
@@ -564,4 +863,4 @@ type IconComponent = ComponentType<{
     fontSize?: 'medium' | 'large' | 'small' | 'inherit';
 }>;
 
-export { AnyExtensionDataMap, AnyExtensionInputMap, AnyExternalRoutes, AnyRouteRefParams, AnyRoutes, AppNode, AppNodeEdges, AppNodeInstance, AppNodeSpec, AppTree, AppTreeApi, BackstagePlugin, ConfigurableExtensionDataRef, CreateExtensionOptions, Extension, ExtensionBoundary, ExtensionBoundaryProps, ExtensionDataRef, ExtensionDataValues, ExtensionInput, ExtensionInputValues, ExtensionOverrides, ExtensionOverridesOptions, ExternalRouteRef, IconComponent, NavTarget, PluginOptions, PortableSchema, RouteFunc, RouteRef, SubRouteRef, appTreeApiRef, coreExtensionData, createApiExtension, createExtension, createExtensionDataRef, createExtensionInput, createExtensionOverrides, createExternalRouteRef, createNavItemExtension, createPageExtension, createPlugin, createRouteRef, createSchemaFromZod, createSubRouteRef, createThemeExtension, useRouteRef, useRouteRefParams };
+export { AnalyticsApi, AnalyticsContext, AnalyticsContextValue, AnalyticsEvent, AnalyticsEventAttributes, AnalyticsTracker, AnyExtensionDataMap, AnyExtensionInputMap, AnyExternalRoutes, AnyRouteRefParams, AnyRoutes, AppNode, AppNodeEdges, AppNodeInstance, AppNodeSpec, AppTree, AppTreeApi, BackstagePlugin, CommonAnalyticsContext, ComponentRef, ComponentsApi, ConfigurableExtensionDataRef, CoreErrorBoundaryFallbackProps, CoreNotFoundErrorPageProps, CoreProgressProps, CreateExtensionOptions, Extension, ExtensionBoundary, ExtensionBoundaryProps, ExtensionDataRef, ExtensionDataValues, ExtensionDefinition, ExtensionInput, ExtensionOverrides, ExtensionOverridesOptions, ExternalRouteRef, FeatureFlagConfig, IconComponent, LogoElements, NavTarget, PluginOptions, PortableSchema, ResolvedExtensionInput, ResolvedExtensionInputs, RouteFunc, RouteRef, SubRouteRef, analyticsApiRef, appTreeApiRef, componentsApiRef, coreComponentRefs, coreExtensionData, createApiExtension, createComponentExtension, createExtension, createExtensionDataRef, createExtensionInput, createExtensionOverrides, createExternalRouteRef, createNavItemExtension, createPageExtension, createPlugin, createRouteRef, createSchemaFromZod, createSignInPageExtension, createSubRouteRef, createThemeExtension, createTranslationExtension, useAnalytics, useComponentRef, useRouteRef, useRouteRefParams };