@backstage/core-plugin-api 1.10.5 → 1.10.6-next.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @backstage/core-plugin-api
 
+## 1.10.6-next.0
+
+### Patch Changes
+
+- a47fd39: Removes instances of default React imports, a necessary update for the upcoming React 19 migration.
+
+  <https://legacy.reactjs.org/blog/2020/09/22/introducing-the-new-jsx-transform.html>
+
+- Updated dependencies
+  - @backstage/config@1.3.2
+  - @backstage/errors@1.2.7
+  - @backstage/types@1.2.1
+  - @backstage/version-bridge@1.0.11
+
 ## 1.10.5
 
 ### Patch Changes

package/dist/analytics/AnalyticsContext.esm.js

@@ -1,5 +1,6 @@
+import { jsx } from 'react/jsx-runtime';
 import { createVersionedContext, createVersionedValueMap } from '@backstage/version-bridge';
-import React, { useContext } from 'react';
+import { useContext } from 'react';
 
 const AnalyticsReactContext = createVersionedContext("analytics-context");
 const useAnalyticsContext = () => {
@@ -25,7 +26,7 @@ const AnalyticsContext = (options) => {
     ...attributes
   };
   const versionedCombinedValue = createVersionedValueMap({ 1: combinedValue });
-  return /* @__PURE__ */ React.createElement(AnalyticsReactContext.Provider, { value: versionedCombinedValue }, children);
+  return /* @__PURE__ */ jsx(AnalyticsReactContext.Provider, { value: versionedCombinedValue, children });
 };
 
 export { AnalyticsContext, useAnalyticsContext };

package/dist/analytics/AnalyticsContext.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"AnalyticsContext.esm.js","sources":["../../src/analytics/AnalyticsContext.tsx"],"sourcesContent":["/*\n * Copyright 2021 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  createVersionedContext,\n  createVersionedValueMap,\n} from '@backstage/version-bridge';\nimport React, { ReactNode, useContext } from 'react';\nimport { AnalyticsContextValue } from './types';\n\nconst AnalyticsReactContext = createVersionedContext<{\n  1: AnalyticsContextValue;\n}>('analytics-context');\n\n/**\n * A \"private\" (to this package) hook that enables context inheritance and a\n * way to read Analytics Context values at event capture-time.\n *\n * @internal\n */\nexport const useAnalyticsContext = (): AnalyticsContextValue => {\n  const theContext = useContext(AnalyticsReactContext);\n\n  // Provide a default value if no value exists.\n  if (theContext === undefined) {\n    return {\n      routeRef: 'unknown',\n      pluginId: 'root',\n      extension: 'App',\n    };\n  }\n\n  // This should probably never happen, but check for it.\n  const theValue = theContext.atVersion(1);\n  if (theValue === undefined) {\n    throw new Error('No context found for version 1.');\n  }\n\n  return theValue;\n};\n\n/**\n * Provides components in the child react tree an Analytics Context, ensuring\n * all analytics events captured within the context have relevant attributes.\n *\n * @remarks\n *\n * Analytics contexts are additive, meaning the context ultimately emitted with\n * an event is the combination of all contexts in the parent tree.\n *\n * @public\n */\nexport const AnalyticsContext = (options: {\n  attributes: Partial<AnalyticsContextValue>;\n  children: ReactNode;\n}) => {\n  const { attributes, children } = options;\n\n  const parentValues = useAnalyticsContext();\n  const combinedValue = {\n    ...parentValues,\n    ...attributes,\n  };\n\n  const versionedCombinedValue = createVersionedValueMap({ 1: combinedValue });\n  return (\n    <AnalyticsReactContext.Provider value={versionedCombinedValue}>\n      {children}\n    </AnalyticsReactContext.Provider>\n  );\n};\n\n/**\n * Returns an HOC wrapping the provided component in an Analytics context with\n * the given values.\n *\n * @param Component - Component to be wrapped with analytics context attributes\n * @param values - Analytics context key/value pairs.\n * @internal\n */\nexport function withAnalyticsContext<TProps extends {}>(\n  Component: React.ComponentType<TProps>,\n  values: AnalyticsContextValue,\n) {\n  const ComponentWithAnalyticsContext = (props: TProps) => {\n    return (\n      <AnalyticsContext attributes={values}>\n        <Component {...props} />\n      </AnalyticsContext>\n    );\n  };\n  ComponentWithAnalyticsContext.displayName = `WithAnalyticsContext(${\n    Component.displayName || Component.name || 'Component'\n  })`;\n  return ComponentWithAnalyticsContext;\n}\n"],"names":[],"mappings":";;;AAuBA,MAAM,qBAAA,GAAwB,uBAE3B,mBAAmB,CAAA;AAQf,MAAM,sBAAsB,MAA6B;AAC9D,EAAM,MAAA,UAAA,GAAa,WAAW,qBAAqB,CAAA;AAGnD,EAAA,IAAI,eAAe,KAAW,CAAA,EAAA;AAC5B,IAAO,OAAA;AAAA,MACL,QAAU,EAAA,SAAA;AAAA,MACV,QAAU,EAAA,MAAA;AAAA,MACV,SAAW,EAAA;AAAA,KACb;AAAA;AAIF,EAAM,MAAA,QAAA,GAAW,UAAW,CAAA,SAAA,CAAU,CAAC,CAAA;AACvC,EAAA,IAAI,aAAa,KAAW,CAAA,EAAA;AAC1B,IAAM,MAAA,IAAI,MAAM,iCAAiC,CAAA;AAAA;AAGnD,EAAO,OAAA,QAAA;AACT;AAaa,MAAA,gBAAA,GAAmB,CAAC,OAG3B,KAAA;AACJ,EAAM,MAAA,EAAE,UAAY,EAAA,QAAA,EAAa,GAAA,OAAA;AAEjC,EAAA,MAAM,eAAe,mBAAoB,EAAA;AACzC,EAAA,MAAM,aAAgB,GAAA;AAAA,IACpB,GAAG,YAAA;AAAA,IACH,GAAG;AAAA,GACL;AAEA,EAAA,MAAM,sBAAyB,GAAA,uBAAA,CAAwB,EAAE,CAAA,EAAG,eAAe,CAAA;AAC3E,EAAA,2CACG,qBAAsB,CAAA,QAAA,EAAtB,EAA+B,KAAA,EAAO,0BACpC,QACH,CAAA;AAEJ;;;;"}
+{"version":3,"file":"AnalyticsContext.esm.js","sources":["../../src/analytics/AnalyticsContext.tsx"],"sourcesContent":["/*\n * Copyright 2021 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  createVersionedContext,\n  createVersionedValueMap,\n} from '@backstage/version-bridge';\nimport { ComponentType, ReactNode, useContext } from 'react';\nimport { AnalyticsContextValue } from './types';\n\nconst AnalyticsReactContext = createVersionedContext<{\n  1: AnalyticsContextValue;\n}>('analytics-context');\n\n/**\n * A \"private\" (to this package) hook that enables context inheritance and a\n * way to read Analytics Context values at event capture-time.\n *\n * @internal\n */\nexport const useAnalyticsContext = (): AnalyticsContextValue => {\n  const theContext = useContext(AnalyticsReactContext);\n\n  // Provide a default value if no value exists.\n  if (theContext === undefined) {\n    return {\n      routeRef: 'unknown',\n      pluginId: 'root',\n      extension: 'App',\n    };\n  }\n\n  // This should probably never happen, but check for it.\n  const theValue = theContext.atVersion(1);\n  if (theValue === undefined) {\n    throw new Error('No context found for version 1.');\n  }\n\n  return theValue;\n};\n\n/**\n * Provides components in the child react tree an Analytics Context, ensuring\n * all analytics events captured within the context have relevant attributes.\n *\n * @remarks\n *\n * Analytics contexts are additive, meaning the context ultimately emitted with\n * an event is the combination of all contexts in the parent tree.\n *\n * @public\n */\nexport const AnalyticsContext = (options: {\n  attributes: Partial<AnalyticsContextValue>;\n  children: ReactNode;\n}) => {\n  const { attributes, children } = options;\n\n  const parentValues = useAnalyticsContext();\n  const combinedValue = {\n    ...parentValues,\n    ...attributes,\n  };\n\n  const versionedCombinedValue = createVersionedValueMap({ 1: combinedValue });\n  return (\n    <AnalyticsReactContext.Provider value={versionedCombinedValue}>\n      {children}\n    </AnalyticsReactContext.Provider>\n  );\n};\n\n/**\n * Returns an HOC wrapping the provided component in an Analytics context with\n * the given values.\n *\n * @param Component - Component to be wrapped with analytics context attributes\n * @param values - Analytics context key/value pairs.\n * @internal\n */\nexport function withAnalyticsContext<TProps extends {}>(\n  Component: ComponentType<TProps>,\n  values: AnalyticsContextValue,\n) {\n  const ComponentWithAnalyticsContext = (props: TProps) => {\n    return (\n      <AnalyticsContext attributes={values}>\n        <Component {...props} />\n      </AnalyticsContext>\n    );\n  };\n  ComponentWithAnalyticsContext.displayName = `WithAnalyticsContext(${\n    Component.displayName || Component.name || 'Component'\n  })`;\n  return ComponentWithAnalyticsContext;\n}\n"],"names":[],"mappings":";;;;AAuBA,MAAM,qBAAA,GAAwB,uBAE3B,mBAAmB,CAAA;AAQf,MAAM,sBAAsB,MAA6B;AAC9D,EAAM,MAAA,UAAA,GAAa,WAAW,qBAAqB,CAAA;AAGnD,EAAA,IAAI,eAAe,KAAW,CAAA,EAAA;AAC5B,IAAO,OAAA;AAAA,MACL,QAAU,EAAA,SAAA;AAAA,MACV,QAAU,EAAA,MAAA;AAAA,MACV,SAAW,EAAA;AAAA,KACb;AAAA;AAIF,EAAM,MAAA,QAAA,GAAW,UAAW,CAAA,SAAA,CAAU,CAAC,CAAA;AACvC,EAAA,IAAI,aAAa,KAAW,CAAA,EAAA;AAC1B,IAAM,MAAA,IAAI,MAAM,iCAAiC,CAAA;AAAA;AAGnD,EAAO,OAAA,QAAA;AACT;AAaa,MAAA,gBAAA,GAAmB,CAAC,OAG3B,KAAA;AACJ,EAAM,MAAA,EAAE,UAAY,EAAA,QAAA,EAAa,GAAA,OAAA;AAEjC,EAAA,MAAM,eAAe,mBAAoB,EAAA;AACzC,EAAA,MAAM,aAAgB,GAAA;AAAA,IACpB,GAAG,YAAA;AAAA,IACH,GAAG;AAAA,GACL;AAEA,EAAA,MAAM,sBAAyB,GAAA,uBAAA,CAAwB,EAAE,CAAA,EAAG,eAAe,CAAA;AAC3E,EAAA,2BACG,qBAAsB,CAAA,QAAA,EAAtB,EAA+B,KAAA,EAAO,wBACpC,QACH,EAAA,CAAA;AAEJ;;;;"}

package/dist/apis/definitions/AlertApi.esm.js

@@ -1,4 +1,4 @@
-import 'react';
+import 'react/jsx-runtime';
 import '@backstage/version-bridge';
 import '@backstage/errors';
 import { createApiRef } from '../system/ApiRef.esm.js';

package/dist/apis/definitions/AnalyticsApi.esm.js

@@ -1,4 +1,4 @@
-import 'react';
+import 'react/jsx-runtime';
 import '@backstage/version-bridge';
 import '@backstage/errors';
 import { createApiRef } from '../system/ApiRef.esm.js';

package/dist/apis/definitions/AppThemeApi.esm.js

@@ -1,4 +1,4 @@
-import 'react';
+import 'react/jsx-runtime';
 import '@backstage/version-bridge';
 import '@backstage/errors';
 import { createApiRef } from '../system/ApiRef.esm.js';

package/dist/apis/definitions/ConfigApi.esm.js

@@ -1,4 +1,4 @@
-import 'react';
+import 'react/jsx-runtime';
 import '@backstage/version-bridge';
 import '@backstage/errors';
 import { createApiRef } from '../system/ApiRef.esm.js';

package/dist/apis/definitions/DiscoveryApi.esm.js

@@ -1,4 +1,4 @@
-import 'react';
+import 'react/jsx-runtime';
 import '@backstage/version-bridge';
 import '@backstage/errors';
 import { createApiRef } from '../system/ApiRef.esm.js';

package/dist/apis/definitions/ErrorApi.esm.js

@@ -1,4 +1,4 @@
-import 'react';
+import 'react/jsx-runtime';
 import '@backstage/version-bridge';
 import '@backstage/errors';
 import { createApiRef } from '../system/ApiRef.esm.js';

package/dist/apis/definitions/FeatureFlagsApi.esm.js

@@ -1,4 +1,4 @@
-import 'react';
+import 'react/jsx-runtime';
 import '@backstage/version-bridge';
 import '@backstage/errors';
 import { createApiRef } from '../system/ApiRef.esm.js';

package/dist/apis/definitions/FetchApi.esm.js

@@ -1,4 +1,4 @@
-import 'react';
+import 'react/jsx-runtime';
 import '@backstage/version-bridge';
 import '@backstage/errors';
 import { createApiRef } from '../system/ApiRef.esm.js';

package/dist/apis/definitions/IdentityApi.esm.js

@@ -1,4 +1,4 @@
-import 'react';
+import 'react/jsx-runtime';
 import '@backstage/version-bridge';
 import '@backstage/errors';
 import { createApiRef } from '../system/ApiRef.esm.js';

package/dist/apis/definitions/OAuthRequestApi.esm.js

@@ -1,4 +1,4 @@
-import 'react';
+import 'react/jsx-runtime';
 import '@backstage/version-bridge';
 import '@backstage/errors';
 import { createApiRef } from '../system/ApiRef.esm.js';

package/dist/apis/definitions/StorageApi.esm.js

@@ -1,4 +1,4 @@
-import 'react';
+import 'react/jsx-runtime';
 import '@backstage/version-bridge';
 import '@backstage/errors';
 import { createApiRef } from '../system/ApiRef.esm.js';

package/dist/apis/definitions/auth.esm.js

@@ -1,4 +1,4 @@
-import 'react';
+import 'react/jsx-runtime';
 import '@backstage/version-bridge';
 import '@backstage/errors';
 import { createApiRef } from '../system/ApiRef.esm.js';

package/dist/apis/system/useApi.esm.js

@@ -1,4 +1,4 @@
-import React from 'react';
+import { jsx } from 'react/jsx-runtime';
 import { useVersionedContext } from '@backstage/version-bridge';
 import { NotImplementedError } from '@backstage/errors';
 
@@ -38,7 +38,7 @@ function withApis(apis) {
           impls[key] = api;
         }
       }
-      return /* @__PURE__ */ React.createElement(WrappedComponent, { ...props, ...impls });
+      return /* @__PURE__ */ jsx(WrappedComponent, { ...props, ...impls });
     };
     const displayName = WrappedComponent.displayName || WrappedComponent.name || "Component";
     Hoc.displayName = `withApis(${displayName})`;

package/dist/apis/system/useApi.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"useApi.esm.js","sources":["../../../src/apis/system/useApi.tsx"],"sourcesContent":["/*\n * Copyright 2020 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 React, { PropsWithChildren } from 'react';\nimport { ApiRef, ApiHolder, TypesToApiRefs } from './types';\nimport { useVersionedContext } from '@backstage/version-bridge';\nimport { NotImplementedError } from '@backstage/errors';\n\n/**\n * React hook for retrieving {@link ApiHolder}, an API catalog.\n *\n * @public\n */\nexport function useApiHolder(): ApiHolder {\n  const versionedHolder = useVersionedContext<{ 1: ApiHolder }>('api-context');\n  if (!versionedHolder) {\n    throw new NotImplementedError('API context is not available');\n  }\n\n  const apiHolder = versionedHolder.atVersion(1);\n  if (!apiHolder) {\n    throw new NotImplementedError('ApiContext v1 not available');\n  }\n  return apiHolder;\n}\n\n/**\n * React hook for retrieving APIs.\n *\n * @param apiRef - Reference of the API to use.\n * @public\n */\nexport function useApi<T>(apiRef: ApiRef<T>): T {\n  const apiHolder = useApiHolder();\n\n  const api = apiHolder.get(apiRef);\n  if (!api) {\n    throw new NotImplementedError(`No implementation available for ${apiRef}`);\n  }\n  return api;\n}\n\n/**\n * Wrapper for giving component an API context.\n *\n * @param apis - APIs for the context.\n * @public\n */\nexport function withApis<T extends {}>(apis: TypesToApiRefs<T>) {\n  return function withApisWrapper<TProps extends T>(\n    WrappedComponent: React.ComponentType<TProps>,\n  ) {\n    const Hoc = (props: PropsWithChildren<Omit<TProps, keyof T>>) => {\n      const apiHolder = useApiHolder();\n\n      const impls = {} as T;\n\n      for (const key in apis) {\n        if (apis.hasOwnProperty(key)) {\n          const ref = apis[key];\n\n          const api = apiHolder.get(ref);\n          if (!api) {\n            throw new NotImplementedError(\n              `No implementation available for ${ref}`,\n            );\n          }\n          impls[key] = api;\n        }\n      }\n\n      return <WrappedComponent {...(props as TProps)} {...impls} />;\n    };\n    const displayName =\n      WrappedComponent.displayName || WrappedComponent.name || 'Component';\n\n    Hoc.displayName = `withApis(${displayName})`;\n\n    return Hoc;\n  };\n}\n"],"names":[],"mappings":";;;;AA0BO,SAAS,YAA0B,GAAA;AACxC,EAAM,MAAA,eAAA,GAAkB,oBAAsC,aAAa,CAAA;AAC3E,EAAA,IAAI,CAAC,eAAiB,EAAA;AACpB,IAAM,MAAA,IAAI,oBAAoB,8BAA8B,CAAA;AAAA;AAG9D,EAAM,MAAA,SAAA,GAAY,eAAgB,CAAA,SAAA,CAAU,CAAC,CAAA;AAC7C,EAAA,IAAI,CAAC,SAAW,EAAA;AACd,IAAM,MAAA,IAAI,oBAAoB,6BAA6B,CAAA;AAAA;AAE7D,EAAO,OAAA,SAAA;AACT;AAQO,SAAS,OAAU,MAAsB,EAAA;AAC9C,EAAA,MAAM,YAAY,YAAa,EAAA;AAE/B,EAAM,MAAA,GAAA,GAAM,SAAU,CAAA,GAAA,CAAI,MAAM,CAAA;AAChC,EAAA,IAAI,CAAC,GAAK,EAAA;AACR,IAAA,MAAM,IAAI,mBAAA,CAAoB,CAAmC,gCAAA,EAAA,MAAM,CAAE,CAAA,CAAA;AAAA;AAE3E,EAAO,OAAA,GAAA;AACT;AAQO,SAAS,SAAuB,IAAyB,EAAA;AAC9D,EAAO,OAAA,SAAS,gBACd,gBACA,EAAA;AACA,IAAM,MAAA,GAAA,GAAM,CAAC,KAAoD,KAAA;AAC/D,MAAA,MAAM,YAAY,YAAa,EAAA;AAE/B,MAAA,MAAM,QAAQ,EAAC;AAEf,MAAA,KAAA,MAAW,OAAO,IAAM,EAAA;AACtB,QAAI,IAAA,IAAA,CAAK,cAAe,CAAA,GAAG,CAAG,EAAA;AAC5B,UAAM,MAAA,GAAA,GAAM,KAAK,GAAG,CAAA;AAEpB,UAAM,MAAA,GAAA,GAAM,SAAU,CAAA,GAAA,CAAI,GAAG,CAAA;AAC7B,UAAA,IAAI,CAAC,GAAK,EAAA;AACR,YAAA,MAAM,IAAI,mBAAA;AAAA,cACR,mCAAmC,GAAG,CAAA;AAAA,aACxC;AAAA;AAEF,UAAA,KAAA,CAAM,GAAG,CAAI,GAAA,GAAA;AAAA;AACf;AAGF,MAAA,uBAAQ,KAAA,CAAA,aAAA,CAAA,gBAAA,EAAA,EAAkB,GAAI,KAAA,EAAmB,GAAG,KAAO,EAAA,CAAA;AAAA,KAC7D;AACA,IAAA,MAAM,WACJ,GAAA,gBAAA,CAAiB,WAAe,IAAA,gBAAA,CAAiB,IAAQ,IAAA,WAAA;AAE3D,IAAI,GAAA,CAAA,WAAA,GAAc,YAAY,WAAW,CAAA,CAAA,CAAA;AAEzC,IAAO,OAAA,GAAA;AAAA,GACT;AACF;;;;"}
+{"version":3,"file":"useApi.esm.js","sources":["../../../src/apis/system/useApi.tsx"],"sourcesContent":["/*\n * Copyright 2020 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 { ComponentType, PropsWithChildren } from 'react';\nimport { ApiRef, ApiHolder, TypesToApiRefs } from './types';\nimport { useVersionedContext } from '@backstage/version-bridge';\nimport { NotImplementedError } from '@backstage/errors';\n\n/**\n * React hook for retrieving {@link ApiHolder}, an API catalog.\n *\n * @public\n */\nexport function useApiHolder(): ApiHolder {\n  const versionedHolder = useVersionedContext<{ 1: ApiHolder }>('api-context');\n  if (!versionedHolder) {\n    throw new NotImplementedError('API context is not available');\n  }\n\n  const apiHolder = versionedHolder.atVersion(1);\n  if (!apiHolder) {\n    throw new NotImplementedError('ApiContext v1 not available');\n  }\n  return apiHolder;\n}\n\n/**\n * React hook for retrieving APIs.\n *\n * @param apiRef - Reference of the API to use.\n * @public\n */\nexport function useApi<T>(apiRef: ApiRef<T>): T {\n  const apiHolder = useApiHolder();\n\n  const api = apiHolder.get(apiRef);\n  if (!api) {\n    throw new NotImplementedError(`No implementation available for ${apiRef}`);\n  }\n  return api;\n}\n\n/**\n * Wrapper for giving component an API context.\n *\n * @param apis - APIs for the context.\n * @public\n */\nexport function withApis<T extends {}>(apis: TypesToApiRefs<T>) {\n  return function withApisWrapper<TProps extends T>(\n    WrappedComponent: ComponentType<TProps>,\n  ) {\n    const Hoc = (props: PropsWithChildren<Omit<TProps, keyof T>>) => {\n      const apiHolder = useApiHolder();\n\n      const impls = {} as T;\n\n      for (const key in apis) {\n        if (apis.hasOwnProperty(key)) {\n          const ref = apis[key];\n\n          const api = apiHolder.get(ref);\n          if (!api) {\n            throw new NotImplementedError(\n              `No implementation available for ${ref}`,\n            );\n          }\n          impls[key] = api;\n        }\n      }\n\n      return <WrappedComponent {...(props as TProps)} {...impls} />;\n    };\n    const displayName =\n      WrappedComponent.displayName || WrappedComponent.name || 'Component';\n\n    Hoc.displayName = `withApis(${displayName})`;\n\n    return Hoc;\n  };\n}\n"],"names":[],"mappings":";;;;AA0BO,SAAS,YAA0B,GAAA;AACxC,EAAM,MAAA,eAAA,GAAkB,oBAAsC,aAAa,CAAA;AAC3E,EAAA,IAAI,CAAC,eAAiB,EAAA;AACpB,IAAM,MAAA,IAAI,oBAAoB,8BAA8B,CAAA;AAAA;AAG9D,EAAM,MAAA,SAAA,GAAY,eAAgB,CAAA,SAAA,CAAU,CAAC,CAAA;AAC7C,EAAA,IAAI,CAAC,SAAW,EAAA;AACd,IAAM,MAAA,IAAI,oBAAoB,6BAA6B,CAAA;AAAA;AAE7D,EAAO,OAAA,SAAA;AACT;AAQO,SAAS,OAAU,MAAsB,EAAA;AAC9C,EAAA,MAAM,YAAY,YAAa,EAAA;AAE/B,EAAM,MAAA,GAAA,GAAM,SAAU,CAAA,GAAA,CAAI,MAAM,CAAA;AAChC,EAAA,IAAI,CAAC,GAAK,EAAA;AACR,IAAA,MAAM,IAAI,mBAAA,CAAoB,CAAmC,gCAAA,EAAA,MAAM,CAAE,CAAA,CAAA;AAAA;AAE3E,EAAO,OAAA,GAAA;AACT;AAQO,SAAS,SAAuB,IAAyB,EAAA;AAC9D,EAAO,OAAA,SAAS,gBACd,gBACA,EAAA;AACA,IAAM,MAAA,GAAA,GAAM,CAAC,KAAoD,KAAA;AAC/D,MAAA,MAAM,YAAY,YAAa,EAAA;AAE/B,MAAA,MAAM,QAAQ,EAAC;AAEf,MAAA,KAAA,MAAW,OAAO,IAAM,EAAA;AACtB,QAAI,IAAA,IAAA,CAAK,cAAe,CAAA,GAAG,CAAG,EAAA;AAC5B,UAAM,MAAA,GAAA,GAAM,KAAK,GAAG,CAAA;AAEpB,UAAM,MAAA,GAAA,GAAM,SAAU,CAAA,GAAA,CAAI,GAAG,CAAA;AAC7B,UAAA,IAAI,CAAC,GAAK,EAAA;AACR,YAAA,MAAM,IAAI,mBAAA;AAAA,cACR,mCAAmC,GAAG,CAAA;AAAA,aACxC;AAAA;AAEF,UAAA,KAAA,CAAM,GAAG,CAAI,GAAA,GAAA;AAAA;AACf;AAGF,MAAA,uBAAQ,GAAA,CAAA,gBAAA,EAAA,EAAkB,GAAI,KAAA,EAAmB,GAAG,KAAO,EAAA,CAAA;AAAA,KAC7D;AACA,IAAA,MAAM,WACJ,GAAA,gBAAA,CAAiB,WAAe,IAAA,gBAAA,CAAiB,IAAQ,IAAA,WAAA;AAE3D,IAAI,GAAA,CAAA,WAAA,GAAc,YAAY,WAAW,CAAA,CAAA,CAAA;AAEzC,IAAO,OAAA,GAAA;AAAA,GACT;AACF;;;;"}

package/dist/extensions/PluginErrorBoundary.esm.js

@@ -1,6 +1,7 @@
-import React from 'react';
+import { jsx } from 'react/jsx-runtime';
+import { Component } from 'react';
 
-class PluginErrorBoundary extends React.Component {
+class PluginErrorBoundary extends Component {
   static getDerivedStateFromError(error) {
     return { error };
   }
@@ -13,7 +14,7 @@ class PluginErrorBoundary extends React.Component {
     const { app, plugin } = this.props;
     const { ErrorBoundaryFallback } = app.getComponents();
     if (error) {
-      return /* @__PURE__ */ React.createElement(
+      return /* @__PURE__ */ jsx(
         ErrorBoundaryFallback,
         {
           error,

package/dist/extensions/PluginErrorBoundary.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"PluginErrorBoundary.esm.js","sources":["../../src/extensions/PluginErrorBoundary.tsx"],"sourcesContent":["/*\n * Copyright 2021 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 React from 'react';\nimport { AppContext } from '../app/types';\nimport { BackstagePlugin } from '../plugin';\n\ntype Props = React.PropsWithChildren<{\n  app: AppContext;\n  plugin: BackstagePlugin;\n}>;\n\ntype State = { error: Error | undefined };\n\nexport class PluginErrorBoundary extends React.Component<Props, State> {\n  static getDerivedStateFromError(error: Error) {\n    return { error };\n  }\n\n  state: State = { error: undefined };\n\n  handleErrorReset = () => {\n    this.setState({ error: undefined });\n  };\n\n  render() {\n    const { error } = this.state;\n    const { app, plugin } = this.props;\n    const { ErrorBoundaryFallback } = app.getComponents();\n\n    if (error) {\n      return (\n        <ErrorBoundaryFallback\n          error={error}\n          resetError={this.handleErrorReset}\n          plugin={plugin}\n        />\n      );\n    }\n\n    return this.props.children;\n  }\n}\n"],"names":[],"mappings":";;AA2Ba,MAAA,mBAAA,SAA4B,MAAM,SAAwB,CAAA;AAAA,EACrE,OAAO,yBAAyB,KAAc,EAAA;AAC5C,IAAA,OAAO,EAAE,KAAM,EAAA;AAAA;AACjB,EAEA,KAAA,GAAe,EAAE,KAAA,EAAO,KAAU,CAAA,EAAA;AAAA,EAElC,mBAAmB,MAAM;AACvB,IAAA,IAAA,CAAK,QAAS,CAAA,EAAE,KAAO,EAAA,KAAA,CAAA,EAAW,CAAA;AAAA,GACpC;AAAA,EAEA,MAAS,GAAA;AACP,IAAM,MAAA,EAAE,KAAM,EAAA,GAAI,IAAK,CAAA,KAAA;AACvB,IAAA,MAAM,EAAE,GAAA,EAAK,MAAO,EAAA,GAAI,IAAK,CAAA,KAAA;AAC7B,IAAA,MAAM,EAAE,qBAAA,EAA0B,GAAA,GAAA,CAAI,aAAc,EAAA;AAEpD,IAAA,IAAI,KAAO,EAAA;AACT,MACE,uBAAA,KAAA,CAAA,aAAA;AAAA,QAAC,qBAAA;AAAA,QAAA;AAAA,UACC,KAAA;AAAA,UACA,YAAY,IAAK,CAAA,gBAAA;AAAA,UACjB;AAAA;AAAA,OACF;AAAA;AAIJ,IAAA,OAAO,KAAK,KAAM,CAAA,QAAA;AAAA;AAEtB;;;;"}
+{"version":3,"file":"PluginErrorBoundary.esm.js","sources":["../../src/extensions/PluginErrorBoundary.tsx"],"sourcesContent":["/*\n * Copyright 2021 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 { PropsWithChildren, Component } from 'react';\nimport { AppContext } from '../app/types';\nimport { BackstagePlugin } from '../plugin';\n\ntype Props = PropsWithChildren<{\n  app: AppContext;\n  plugin: BackstagePlugin;\n}>;\n\ntype State = { error: Error | undefined };\n\nexport class PluginErrorBoundary extends Component<Props, State> {\n  static getDerivedStateFromError(error: Error) {\n    return { error };\n  }\n\n  state: State = { error: undefined };\n\n  handleErrorReset = () => {\n    this.setState({ error: undefined });\n  };\n\n  render() {\n    const { error } = this.state;\n    const { app, plugin } = this.props;\n    const { ErrorBoundaryFallback } = app.getComponents();\n\n    if (error) {\n      return (\n        <ErrorBoundaryFallback\n          error={error}\n          resetError={this.handleErrorReset}\n          plugin={plugin}\n        />\n      );\n    }\n\n    return this.props.children;\n  }\n}\n"],"names":[],"mappings":";;;AA2BO,MAAM,4BAA4B,SAAwB,CAAA;AAAA,EAC/D,OAAO,yBAAyB,KAAc,EAAA;AAC5C,IAAA,OAAO,EAAE,KAAM,EAAA;AAAA;AACjB,EAEA,KAAA,GAAe,EAAE,KAAA,EAAO,KAAU,CAAA,EAAA;AAAA,EAElC,mBAAmB,MAAM;AACvB,IAAA,IAAA,CAAK,QAAS,CAAA,EAAE,KAAO,EAAA,KAAA,CAAA,EAAW,CAAA;AAAA,GACpC;AAAA,EAEA,MAAS,GAAA;AACP,IAAM,MAAA,EAAE,KAAM,EAAA,GAAI,IAAK,CAAA,KAAA;AACvB,IAAA,MAAM,EAAE,GAAA,EAAK,MAAO,EAAA,GAAI,IAAK,CAAA,KAAA;AAC7B,IAAA,MAAM,EAAE,qBAAA,EAA0B,GAAA,GAAA,CAAI,aAAc,EAAA;AAEpD,IAAA,IAAI,KAAO,EAAA;AACT,MACE,uBAAA,GAAA;AAAA,QAAC,qBAAA;AAAA,QAAA;AAAA,UACC,KAAA;AAAA,UACA,YAAY,IAAK,CAAA,gBAAA;AAAA,UACjB;AAAA;AAAA,OACF;AAAA;AAIJ,IAAA,OAAO,KAAK,KAAM,CAAA,QAAA;AAAA;AAEtB;;;;"}

package/dist/extensions/extensions.esm.js

@@ -1,4 +1,5 @@
-import React, { lazy, Suspense, useEffect } from 'react';
+import { jsx } from 'react/jsx-runtime';
+import { lazy, Suspense, useEffect } from 'react';
 import { AnalyticsContext } from '../analytics/AnalyticsContext.esm.js';
 import { useAnalytics } from '../analytics/useAnalytics.esm.js';
 import { useApp } from '../app/useApp.esm.js';
@@ -33,7 +34,7 @@ function createRoutableExtension(options) {
           useEffect(() => {
             analytics.captureEvent(routableExtensionRenderedEvent, "");
           }, [analytics]);
-          return /* @__PURE__ */ React.createElement(InnerComponent, { ...props });
+          return /* @__PURE__ */ jsx(InnerComponent, { ...props });
         };
         const componentName = name || InnerComponent.displayName || InnerComponent.name || "LazyComponent";
         RoutableExtensionWrapper.displayName = `RoutableExtension(${componentName})`;
@@ -82,17 +83,17 @@ function createReactExtension(options) {
         const app = useApp();
         const { Progress } = app.getComponents();
         const mountPoint = data?.["core.mountPoint"];
-        return /* @__PURE__ */ React.createElement(Suspense, { fallback: /* @__PURE__ */ React.createElement(Progress, null) }, /* @__PURE__ */ React.createElement(PluginErrorBoundary, { app, plugin }, /* @__PURE__ */ React.createElement(
+        return /* @__PURE__ */ jsx(Suspense, { fallback: /* @__PURE__ */ jsx(Progress, {}), children: /* @__PURE__ */ jsx(PluginErrorBoundary, { app, plugin, children: /* @__PURE__ */ jsx(
           AnalyticsContext,
           {
             attributes: {
               pluginId: plugin.getId(),
               ...name && { extension: name },
               ...mountPoint && { routeRef: mountPoint.id }
-            }
-          },
-          /* @__PURE__ */ React.createElement(Component, { ...props })
-        )));
+            },
+            children: /* @__PURE__ */ jsx(Component, { ...props })
+          }
+        ) }) });
       };
       attachComponentData(Result, "core.plugin", plugin);
       attachComponentData(Result, "core.extensionName", name);

package/dist/extensions/extensions.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"extensions.esm.js","sources":["../../src/extensions/extensions.tsx"],"sourcesContent":["/*\n * Copyright 2020 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 React, { lazy, Suspense, useEffect } from 'react';\nimport { AnalyticsContext, useAnalytics } from '../analytics';\nimport { useApp } from '../app';\nimport { RouteRef, useRouteRef } from '../routing';\nimport { attachComponentData } from './componentData';\nimport { Extension, BackstagePlugin } from '../plugin';\nimport { PluginErrorBoundary } from './PluginErrorBoundary';\nimport { routableExtensionRenderedEvent } from '../analytics/Tracker';\nimport { ForwardedError } from '@backstage/errors';\n\n/**\n * Lazy or synchronous retrieving of extension components.\n *\n * @public\n */\nexport type ComponentLoader<T> =\n  | {\n      lazy: () => Promise<T>;\n    }\n  | {\n      sync: T;\n    };\n\n/**\n * Extension for components that can have its own URL route (top-level pages, tabs etc.).\n *\n * @remarks\n *\n * We do not use ComponentType as the return type, since it doesn't let us convey the children prop.\n * ComponentType inserts children as an optional prop whether the inner component accepts it or not,\n * making it impossible to make the usage of children type safe.\n *\n * See {@link https://backstage.io/docs/plugins/composability#extensions}.\n *\n * @public\n */\nexport function createRoutableExtension<\n  T extends (props: any) => JSX.Element | null,\n>(options: {\n  /**\n   * A loader for the component that is rendered by this extension.\n   */\n  component: () => Promise<T>;\n\n  /**\n   * The mount point to bind this routable extension to.\n   *\n   * If this extension is placed somewhere in the app element tree of a Backstage\n   * app, callers will be able to route to this extensions by calling,\n   * `useRouteRef` with this mount point.\n   */\n  mountPoint: RouteRef;\n\n  /**\n   * The name of this extension that will represent it at runtime. It is for example\n   * used to identify this extension in analytics data.\n   *\n   * If possible the name should always be the same as the name of the exported\n   * variable for this extension.\n   */\n  name?: string;\n}): Extension<T> {\n  const { component, mountPoint, name } = options;\n  return createReactExtension({\n    component: {\n      lazy: () =>\n        component().then(InnerComponent => {\n          const RoutableExtensionWrapper: any = (props: any) => {\n            const analytics = useAnalytics();\n\n            // Validate that the routing is wired up correctly in the App.tsx\n            try {\n              useRouteRef(mountPoint);\n            } catch (error) {\n              if (typeof error === 'object' && error !== null) {\n                const { message } = error as { message?: unknown };\n                if (\n                  typeof message === 'string' &&\n                  message.startsWith('No path for ')\n                ) {\n                  throw new Error(\n                    `Routable extension component with mount point ${mountPoint} was not discovered in the app element tree. ` +\n                      'Routable extension components may not be rendered by other components and must be ' +\n                      'directly available as an element within the App provider component.',\n                  );\n                }\n              }\n              throw error;\n            }\n\n            // This event, never exposed to end-users of the analytics API,\n            // helps inform which extension metadata gets associated with a\n            // navigation event when the route navigated to is a gathered\n            // mountpoint.\n            useEffect(() => {\n              analytics.captureEvent(routableExtensionRenderedEvent, '');\n            }, [analytics]);\n\n            return <InnerComponent {...props} />;\n          };\n\n          const componentName =\n            name ||\n            (InnerComponent as { displayName?: string }).displayName ||\n            InnerComponent.name ||\n            'LazyComponent';\n\n          RoutableExtensionWrapper.displayName = `RoutableExtension(${componentName})`;\n\n          return RoutableExtensionWrapper as T;\n        }),\n    },\n    data: {\n      'core.mountPoint': mountPoint,\n    },\n    name,\n  });\n}\n\n/**\n * Plain React component extension.\n *\n * @remarks\n *\n * We do not use ComponentType as the return type, since it doesn't let us convey the children prop.\n * ComponentType inserts children as an optional prop whether the inner component accepts it or not,\n * making it impossible to make the usage of children type safe.\n *\n * See {@link https://backstage.io/docs/plugins/composability#extensions}.\n *\n * @public\n */\nexport function createComponentExtension<\n  T extends (props: any) => JSX.Element | null,\n>(options: {\n  /**\n   * A loader or synchronously supplied component that is rendered by this extension.\n   */\n  component: ComponentLoader<T>;\n\n  /**\n   * The name of this extension that will represent it at runtime. It is for example\n   * used to identify this extension in analytics data.\n   *\n   * If possible the name should always be the same as the name of the exported\n   * variable for this extension.\n   */\n  name?: string;\n}): Extension<T> {\n  const { component, name } = options;\n  return createReactExtension({ component, name });\n}\n\n/**\n * Used by {@link createComponentExtension} and {@link createRoutableExtension}.\n *\n * @remarks\n *\n * We do not use ComponentType as the return type, since it doesn't let us convey the children prop.\n * ComponentType inserts children as an optional prop whether the inner component accepts it or not,\n * making it impossible to make the usage of children type safe.\n *\n * See {@link https://backstage.io/docs/plugins/composability#extensions}.\n *\n * @public\n */\nexport function createReactExtension<\n  T extends (props: any) => JSX.Element | null,\n>(options: {\n  /**\n   * A loader or synchronously supplied component that is rendered by this extension.\n   */\n  component: ComponentLoader<T>;\n\n  /**\n   * Additional component data that is attached to the top-level extension component.\n   */\n  data?: Record<string, unknown>;\n\n  /**\n   * The name of this extension that will represent it at runtime. It is for example\n   * used to identify this extension in analytics data.\n   *\n   * If possible the name should always be the same as the name of the exported\n   * variable for this extension.\n   */\n  name?: string;\n}): Extension<T> {\n  const { data = {}, name } = options;\n  if (!name) {\n    // eslint-disable-next-line no-console\n    console.warn(\n      'Declaring extensions without name is DEPRECATED. ' +\n        'Make sure that all usages of createReactExtension, createComponentExtension and createRoutableExtension provide a name.',\n    );\n  }\n\n  let Component: T;\n  if ('lazy' in options.component) {\n    const lazyLoader = options.component.lazy;\n    Component = lazy(() =>\n      lazyLoader().then(\n        component => ({ default: component }),\n        error => {\n          const ofExtension = name ? ` of the ${name} extension` : '';\n          throw new ForwardedError(\n            `Failed lazy loading${ofExtension}, try to reload the page`,\n            error,\n          );\n        },\n      ),\n    ) as unknown as T;\n  } else {\n    Component = options.component.sync;\n  }\n  const componentName =\n    name ||\n    (Component as { displayName?: string }).displayName ||\n    Component.name ||\n    'Component';\n\n  return {\n    expose(plugin: BackstagePlugin) {\n      const Result: any = (props: any) => {\n        const app = useApp();\n        const { Progress } = app.getComponents();\n        // todo(iamEAP): Account for situations where this is attached via\n        // separate calls to attachComponentData().\n        const mountPoint = data?.['core.mountPoint'] as\n          | { id?: string }\n          | undefined;\n\n        return (\n          <Suspense fallback={<Progress />}>\n            <PluginErrorBoundary app={app} plugin={plugin}>\n              <AnalyticsContext\n                attributes={{\n                  pluginId: plugin.getId(),\n                  ...(name && { extension: name }),\n                  ...(mountPoint && { routeRef: mountPoint.id }),\n                }}\n              >\n                <Component {...props} />\n              </AnalyticsContext>\n            </PluginErrorBoundary>\n          </Suspense>\n        );\n      };\n\n      attachComponentData(Result, 'core.plugin', plugin);\n      attachComponentData(Result, 'core.extensionName', name);\n      for (const [key, value] of Object.entries(data)) {\n        attachComponentData(Result, key, value);\n      }\n\n      Result.displayName = `Extension(${componentName})`;\n      return Result;\n    },\n  };\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"extensions.esm.js","sources":["../../src/extensions/extensions.tsx"],"sourcesContent":["/*\n * Copyright 2020 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 { lazy, Suspense, useEffect } from 'react';\nimport { AnalyticsContext, useAnalytics } from '../analytics';\nimport { useApp } from '../app';\nimport { RouteRef, useRouteRef } from '../routing';\nimport { attachComponentData } from './componentData';\nimport { Extension, BackstagePlugin } from '../plugin';\nimport { PluginErrorBoundary } from './PluginErrorBoundary';\nimport { routableExtensionRenderedEvent } from '../analytics/Tracker';\nimport { ForwardedError } from '@backstage/errors';\n\n/**\n * Lazy or synchronous retrieving of extension components.\n *\n * @public\n */\nexport type ComponentLoader<T> =\n  | {\n      lazy: () => Promise<T>;\n    }\n  | {\n      sync: T;\n    };\n\n/**\n * Extension for components that can have its own URL route (top-level pages, tabs etc.).\n *\n * @remarks\n *\n * We do not use ComponentType as the return type, since it doesn't let us convey the children prop.\n * ComponentType inserts children as an optional prop whether the inner component accepts it or not,\n * making it impossible to make the usage of children type safe.\n *\n * See {@link https://backstage.io/docs/plugins/composability#extensions}.\n *\n * @public\n */\nexport function createRoutableExtension<\n  T extends (props: any) => JSX.Element | null,\n>(options: {\n  /**\n   * A loader for the component that is rendered by this extension.\n   */\n  component: () => Promise<T>;\n\n  /**\n   * The mount point to bind this routable extension to.\n   *\n   * If this extension is placed somewhere in the app element tree of a Backstage\n   * app, callers will be able to route to this extensions by calling,\n   * `useRouteRef` with this mount point.\n   */\n  mountPoint: RouteRef;\n\n  /**\n   * The name of this extension that will represent it at runtime. It is for example\n   * used to identify this extension in analytics data.\n   *\n   * If possible the name should always be the same as the name of the exported\n   * variable for this extension.\n   */\n  name?: string;\n}): Extension<T> {\n  const { component, mountPoint, name } = options;\n  return createReactExtension({\n    component: {\n      lazy: () =>\n        component().then(InnerComponent => {\n          const RoutableExtensionWrapper: any = (props: any) => {\n            const analytics = useAnalytics();\n\n            // Validate that the routing is wired up correctly in the App.tsx\n            try {\n              useRouteRef(mountPoint);\n            } catch (error) {\n              if (typeof error === 'object' && error !== null) {\n                const { message } = error as { message?: unknown };\n                if (\n                  typeof message === 'string' &&\n                  message.startsWith('No path for ')\n                ) {\n                  throw new Error(\n                    `Routable extension component with mount point ${mountPoint} was not discovered in the app element tree. ` +\n                      'Routable extension components may not be rendered by other components and must be ' +\n                      'directly available as an element within the App provider component.',\n                  );\n                }\n              }\n              throw error;\n            }\n\n            // This event, never exposed to end-users of the analytics API,\n            // helps inform which extension metadata gets associated with a\n            // navigation event when the route navigated to is a gathered\n            // mountpoint.\n            useEffect(() => {\n              analytics.captureEvent(routableExtensionRenderedEvent, '');\n            }, [analytics]);\n\n            return <InnerComponent {...props} />;\n          };\n\n          const componentName =\n            name ||\n            (InnerComponent as { displayName?: string }).displayName ||\n            InnerComponent.name ||\n            'LazyComponent';\n\n          RoutableExtensionWrapper.displayName = `RoutableExtension(${componentName})`;\n\n          return RoutableExtensionWrapper as T;\n        }),\n    },\n    data: {\n      'core.mountPoint': mountPoint,\n    },\n    name,\n  });\n}\n\n/**\n * Plain React component extension.\n *\n * @remarks\n *\n * We do not use ComponentType as the return type, since it doesn't let us convey the children prop.\n * ComponentType inserts children as an optional prop whether the inner component accepts it or not,\n * making it impossible to make the usage of children type safe.\n *\n * See {@link https://backstage.io/docs/plugins/composability#extensions}.\n *\n * @public\n */\nexport function createComponentExtension<\n  T extends (props: any) => JSX.Element | null,\n>(options: {\n  /**\n   * A loader or synchronously supplied component that is rendered by this extension.\n   */\n  component: ComponentLoader<T>;\n\n  /**\n   * The name of this extension that will represent it at runtime. It is for example\n   * used to identify this extension in analytics data.\n   *\n   * If possible the name should always be the same as the name of the exported\n   * variable for this extension.\n   */\n  name?: string;\n}): Extension<T> {\n  const { component, name } = options;\n  return createReactExtension({ component, name });\n}\n\n/**\n * Used by {@link createComponentExtension} and {@link createRoutableExtension}.\n *\n * @remarks\n *\n * We do not use ComponentType as the return type, since it doesn't let us convey the children prop.\n * ComponentType inserts children as an optional prop whether the inner component accepts it or not,\n * making it impossible to make the usage of children type safe.\n *\n * See {@link https://backstage.io/docs/plugins/composability#extensions}.\n *\n * @public\n */\nexport function createReactExtension<\n  T extends (props: any) => JSX.Element | null,\n>(options: {\n  /**\n   * A loader or synchronously supplied component that is rendered by this extension.\n   */\n  component: ComponentLoader<T>;\n\n  /**\n   * Additional component data that is attached to the top-level extension component.\n   */\n  data?: Record<string, unknown>;\n\n  /**\n   * The name of this extension that will represent it at runtime. It is for example\n   * used to identify this extension in analytics data.\n   *\n   * If possible the name should always be the same as the name of the exported\n   * variable for this extension.\n   */\n  name?: string;\n}): Extension<T> {\n  const { data = {}, name } = options;\n  if (!name) {\n    // eslint-disable-next-line no-console\n    console.warn(\n      'Declaring extensions without name is DEPRECATED. ' +\n        'Make sure that all usages of createReactExtension, createComponentExtension and createRoutableExtension provide a name.',\n    );\n  }\n\n  let Component: T;\n  if ('lazy' in options.component) {\n    const lazyLoader = options.component.lazy;\n    Component = lazy(() =>\n      lazyLoader().then(\n        component => ({ default: component }),\n        error => {\n          const ofExtension = name ? ` of the ${name} extension` : '';\n          throw new ForwardedError(\n            `Failed lazy loading${ofExtension}, try to reload the page`,\n            error,\n          );\n        },\n      ),\n    ) as unknown as T;\n  } else {\n    Component = options.component.sync;\n  }\n  const componentName =\n    name ||\n    (Component as { displayName?: string }).displayName ||\n    Component.name ||\n    'Component';\n\n  return {\n    expose(plugin: BackstagePlugin) {\n      const Result: any = (props: any) => {\n        const app = useApp();\n        const { Progress } = app.getComponents();\n        // todo(iamEAP): Account for situations where this is attached via\n        // separate calls to attachComponentData().\n        const mountPoint = data?.['core.mountPoint'] as\n          | { id?: string }\n          | undefined;\n\n        return (\n          <Suspense fallback={<Progress />}>\n            <PluginErrorBoundary app={app} plugin={plugin}>\n              <AnalyticsContext\n                attributes={{\n                  pluginId: plugin.getId(),\n                  ...(name && { extension: name }),\n                  ...(mountPoint && { routeRef: mountPoint.id }),\n                }}\n              >\n                <Component {...props} />\n              </AnalyticsContext>\n            </PluginErrorBoundary>\n          </Suspense>\n        );\n      };\n\n      attachComponentData(Result, 'core.plugin', plugin);\n      attachComponentData(Result, 'core.extensionName', name);\n      for (const [key, value] of Object.entries(data)) {\n        attachComponentData(Result, key, value);\n      }\n\n      Result.displayName = `Extension(${componentName})`;\n      return Result;\n    },\n  };\n}\n"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-import React$1, { ReactNode, PropsWithChildren, ComponentType, ReactElement } from 'react';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode, ComponentType, PropsWithChildren, ReactElement } from 'react';
 import { Observable, JsonValue } from '@backstage/types';
 import { Config } from '@backstage/config';
 import { IdentityApi as IdentityApi$1, BackstagePlugin as BackstagePlugin$1, IconComponent as IconComponent$1 } from '@backstage/core-plugin-api';
@@ -45,7 +46,7 @@ type AnalyticsContextValue = CommonAnalyticsContext & {
 declare const AnalyticsContext: (options: {
     attributes: Partial<AnalyticsContextValue>;
     children: ReactNode;
-}) => React$1.JSX.Element;
+}) => react_jsx_runtime.JSX.Element;
 
 /**
  * API reference.
@@ -118,8 +119,8 @@ declare function useApi<T>(apiRef: ApiRef<T>): T;
  * @param apis - APIs for the context.
  * @public
  */
-declare function withApis<T extends {}>(apis: TypesToApiRefs<T>): <TProps extends T>(WrappedComponent: React$1.ComponentType<TProps>) => {
-    (props: PropsWithChildren<Omit<TProps, keyof T>>): React$1.JSX.Element;
+declare function withApis<T extends {}>(apis: TypesToApiRefs<T>): <TProps extends T>(WrappedComponent: ComponentType<TProps>) => {
+    (props: PropsWithChildren<Omit<TProps, keyof T>>): react_jsx_runtime.JSX.Element;
     displayName: string;
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backstage/core-plugin-api",
-  "version": "1.10.5",
+  "version": "1.10.6-next.0",
   "description": "Core API used by Backstage plugins",
   "backstage": {
     "role": "web-library"
@@ -36,11 +36,11 @@
   "types": "./dist/index.d.ts",
   "typesVersions": {
     "*": {
-      "*": [
-        "dist/index.d.ts"
-      ],
       "alpha": [
         "dist/alpha.d.ts"
+      ],
+      "package.json": [
+        "package.json"
       ]
     }
   },
@@ -57,16 +57,16 @@
     "test": "backstage-cli package test"
   },
   "dependencies": {
-    "@backstage/config": "^1.3.2",
-    "@backstage/errors": "^1.2.7",
-    "@backstage/types": "^1.2.1",
-    "@backstage/version-bridge": "^1.0.11",
+    "@backstage/config": "1.3.2",
+    "@backstage/errors": "1.2.7",
+    "@backstage/types": "1.2.1",
+    "@backstage/version-bridge": "1.0.11",
     "history": "^5.0.0"
   },
   "devDependencies": {
-    "@backstage/cli": "^0.31.0",
-    "@backstage/core-app-api": "^1.16.0",
-    "@backstage/test-utils": "^1.7.6",
+    "@backstage/cli": "0.32.0-next.2",
+    "@backstage/core-app-api": "1.16.1-next.0",
+    "@backstage/test-utils": "1.7.7-next.0",
     "@testing-library/dom": "^10.0.0",
     "@testing-library/jest-dom": "^6.0.0",
     "@testing-library/react": "^16.0.0",