@backstage/frontend-plugin-api 0.8.0 → 0.9.0-next.0

package/CHANGELOG.md

@@ -1,5 +1,55 @@
 # @backstage/frontend-plugin-api
 
+## 0.9.0-next.0
+
+### Minor Changes
+
+- 4a5ba19: Removed deprecated `namespace` option from `createExtension` and `createExtensionBlueprint`, including `.make` and `.makeWithOverides`, it's no longer necessary and will use the `pluginId` instead.
+
+  Removed deprecated `createExtensionOverrides` this should be replaced with `createFrontendModule` instead.
+
+  Removed deprecated `BackstagePlugin` type, use `FrontendPlugin` type instead from this same package.
+
+- bfd4bec: **BREAKING PRODUCERS**: The `IconComponent` no longer accepts `fontSize="default"`. This has effectively been removed from Material-UI since its last two major versions, and has not worked properly for them in a long time.
+
+  This change should not have an effect on neither users of MUI4 nor MUI5/6, since the updated interface should still let you send the respective `SvgIcon` types into interfaces where relevant (e.g. as app icons).
+
+### Patch Changes
+
+- 873e424: Internal refactor of usage of opaque types.
+- 323aae8: It is now possible to override the blueprint parameters when overriding an extension created from a blueprint:
+
+  ```ts
+  const myExtension = MyBlueprint.make({
+    params: {
+      myParam: 'myDefault',
+    },
+  });
+
+  const myOverride = myExtension.override({
+    params: {
+      myParam: 'myOverride',
+    },
+  });
+  const myFactoryOverride = myExtension.override({
+    factory(origFactory) {
+      return origFactory({
+        params: {
+          myParam: 'myOverride',
+        },
+      });
+    },
+  });
+  ```
+
+  The provided parameters will be merged with the original parameters of the extension.
+
+- Updated dependencies
+  - @backstage/core-components@0.15.1-next.0
+  - @backstage/core-plugin-api@1.10.0-next.0
+  - @backstage/types@1.1.1
+  - @backstage/version-bridge@1.0.9
+
 ## 0.8.0
 
 ### Minor Changes

package/dist/apis/definitions/AppTreeApi.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"AppTreeApi.esm.js","sources":["../../../src/apis/definitions/AppTreeApi.ts"],"sourcesContent":["/*\n * Copyright 2023 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 { createApiRef } from '@backstage/core-plugin-api';\nimport { BackstagePlugin, Extension, ExtensionDataRef } from '../../wiring';\n\n/**\n * The specification for this {@link AppNode} in the {@link AppTree}.\n *\n * @public\n * @remarks\n *\n * The specifications for a collection of app nodes is all the information needed\n * to build the tree and instantiate the nodes.\n */\nexport interface AppNodeSpec {\n  readonly id: string;\n  readonly attachTo: { id: string; input: string };\n  readonly extension: Extension<unknown, unknown>;\n  readonly disabled: boolean;\n  readonly config?: unknown;\n  readonly source?: BackstagePlugin;\n}\n\n/**\n * The connections from this {@link AppNode} to other nodes.\n *\n * @public\n * @remarks\n *\n * The app node edges are resolved based on the app node specs, regardless of whether\n * adjacent nodes are disabled or not. If no parent attachment is present or\n */\nexport interface AppNodeEdges {\n  readonly attachedTo?: { node: AppNode; input: string };\n  readonly attachments: ReadonlyMap<string, AppNode[]>;\n}\n\n/**\n * The instance of this {@link AppNode} in the {@link AppTree}.\n *\n * @public\n * @remarks\n *\n * The app node instance is created when the `factory` function of an extension is called.\n * Instances will only be present for nodes in the app that are connected to the root\n * node and not disabled\n */\nexport interface AppNodeInstance {\n  /** Returns a sequence of all extension data refs that were output by this instance */\n  getDataRefs(): Iterable<ExtensionDataRef<unknown>>;\n  /** Get the output data for a single extension data ref */\n  getData<T>(ref: ExtensionDataRef<T>): T | undefined;\n}\n\n/**\n * A node in the {@link AppTree}.\n *\n * @public\n */\nexport interface AppNode {\n  /** The specification for how this node should be instantiated */\n  readonly spec: AppNodeSpec;\n  /** The edges from this node to other nodes in the app tree */\n  readonly edges: AppNodeEdges;\n  /** The instance of this node, if it was instantiated */\n  readonly instance?: AppNodeInstance;\n}\n\n/**\n * The app tree containing all {@link AppNode}s of the app.\n *\n * @public\n */\nexport interface AppTree {\n  /** The root node of the app */\n  readonly root: AppNode;\n  /** A map of all nodes in the app by ID, including orphaned or disabled nodes */\n  readonly nodes: ReadonlyMap<string /* id */, AppNode>;\n  /** A sequence of all nodes with a parent that is not reachable from the app root node */\n  readonly orphans: Iterable<AppNode>;\n}\n\n/**\n * The API for interacting with the {@link AppTree}.\n *\n * @public\n */\nexport interface AppTreeApi {\n  /**\n   * Get the {@link AppTree} for the app.\n   */\n  getTree(): { tree: AppTree };\n}\n\n/**\n * The `ApiRef` of {@link AppTreeApi}.\n *\n * @public\n */\nexport const appTreeApiRef = createApiRef<AppTreeApi>({ id: 'core.app-tree' });\n"],"names":[],"mappings":";;AAiHO,MAAM,aAAgB,GAAA,YAAA,CAAyB,EAAE,EAAA,EAAI,iBAAiB;;;;"}
+{"version":3,"file":"AppTreeApi.esm.js","sources":["../../../src/apis/definitions/AppTreeApi.ts"],"sourcesContent":["/*\n * Copyright 2023 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 { createApiRef } from '@backstage/core-plugin-api';\nimport { FrontendPlugin, Extension, ExtensionDataRef } from '../../wiring';\n\n/**\n * The specification for this {@link AppNode} in the {@link AppTree}.\n *\n * @public\n * @remarks\n *\n * The specifications for a collection of app nodes is all the information needed\n * to build the tree and instantiate the nodes.\n */\nexport interface AppNodeSpec {\n  readonly id: string;\n  readonly attachTo: { id: string; input: string };\n  readonly extension: Extension<unknown, unknown>;\n  readonly disabled: boolean;\n  readonly config?: unknown;\n  readonly source?: FrontendPlugin;\n}\n\n/**\n * The connections from this {@link AppNode} to other nodes.\n *\n * @public\n * @remarks\n *\n * The app node edges are resolved based on the app node specs, regardless of whether\n * adjacent nodes are disabled or not. If no parent attachment is present or\n */\nexport interface AppNodeEdges {\n  readonly attachedTo?: { node: AppNode; input: string };\n  readonly attachments: ReadonlyMap<string, AppNode[]>;\n}\n\n/**\n * The instance of this {@link AppNode} in the {@link AppTree}.\n *\n * @public\n * @remarks\n *\n * The app node instance is created when the `factory` function of an extension is called.\n * Instances will only be present for nodes in the app that are connected to the root\n * node and not disabled\n */\nexport interface AppNodeInstance {\n  /** Returns a sequence of all extension data refs that were output by this instance */\n  getDataRefs(): Iterable<ExtensionDataRef<unknown>>;\n  /** Get the output data for a single extension data ref */\n  getData<T>(ref: ExtensionDataRef<T>): T | undefined;\n}\n\n/**\n * A node in the {@link AppTree}.\n *\n * @public\n */\nexport interface AppNode {\n  /** The specification for how this node should be instantiated */\n  readonly spec: AppNodeSpec;\n  /** The edges from this node to other nodes in the app tree */\n  readonly edges: AppNodeEdges;\n  /** The instance of this node, if it was instantiated */\n  readonly instance?: AppNodeInstance;\n}\n\n/**\n * The app tree containing all {@link AppNode}s of the app.\n *\n * @public\n */\nexport interface AppTree {\n  /** The root node of the app */\n  readonly root: AppNode;\n  /** A map of all nodes in the app by ID, including orphaned or disabled nodes */\n  readonly nodes: ReadonlyMap<string /* id */, AppNode>;\n  /** A sequence of all nodes with a parent that is not reachable from the app root node */\n  readonly orphans: Iterable<AppNode>;\n}\n\n/**\n * The API for interacting with the {@link AppTree}.\n *\n * @public\n */\nexport interface AppTreeApi {\n  /**\n   * Get the {@link AppTree} for the app.\n   */\n  getTree(): { tree: AppTree };\n}\n\n/**\n * The `ApiRef` of {@link AppTreeApi}.\n *\n * @public\n */\nexport const appTreeApiRef = createApiRef<AppTreeApi>({ id: 'core.app-tree' });\n"],"names":[],"mappings":";;AAiHO,MAAM,aAAgB,GAAA,YAAA,CAAyB,EAAE,EAAA,EAAI,iBAAiB;;;;"}

package/dist/components/ErrorBoundary.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"ErrorBoundary.esm.js","sources":["../../src/components/ErrorBoundary.tsx"],"sourcesContent":["/*\n * Copyright 2023 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, { Component, ComponentType, PropsWithChildren } from 'react';\nimport { BackstagePlugin } from '../wiring';\nimport { CoreErrorBoundaryFallbackProps } from '../types';\n\ntype ErrorBoundaryProps = PropsWithChildren<{\n  plugin?: BackstagePlugin;\n  Fallback: ComponentType<CoreErrorBoundaryFallbackProps>;\n}>;\ntype ErrorBoundaryState = { error?: Error };\n\n/** @internal */\nexport class ErrorBoundary extends Component<\n  ErrorBoundaryProps,\n  ErrorBoundaryState\n> {\n  static getDerivedStateFromError(error: Error) {\n    return { error };\n  }\n\n  state: ErrorBoundaryState = { error: undefined };\n\n  handleErrorReset = () => {\n    this.setState({ error: undefined });\n  };\n\n  render() {\n    const { error } = this.state;\n    const { plugin, children, Fallback } = this.props;\n\n    if (error) {\n      return (\n        <Fallback\n          plugin={plugin}\n          error={error}\n          resetError={this.handleErrorReset}\n        />\n      );\n    }\n\n    return children;\n  }\n}\n"],"names":[],"mappings":";;AA2BO,MAAM,sBAAsB,SAGjC,CAAA;AAAA,EACA,OAAO,yBAAyB,KAAc,EAAA;AAC5C,IAAA,OAAO,EAAE,KAAM,EAAA,CAAA;AAAA,GACjB;AAAA,EAEA,KAAA,GAA4B,EAAE,KAAA,EAAO,KAAU,CAAA,EAAA,CAAA;AAAA,EAE/C,mBAAmB,MAAM;AACvB,IAAA,IAAA,CAAK,QAAS,CAAA,EAAE,KAAO,EAAA,KAAA,CAAA,EAAW,CAAA,CAAA;AAAA,GACpC,CAAA;AAAA,EAEA,MAAS,GAAA;AACP,IAAM,MAAA,EAAE,KAAM,EAAA,GAAI,IAAK,CAAA,KAAA,CAAA;AACvB,IAAA,MAAM,EAAE,MAAA,EAAQ,QAAU,EAAA,QAAA,KAAa,IAAK,CAAA,KAAA,CAAA;AAE5C,IAAA,IAAI,KAAO,EAAA;AACT,MACE,uBAAA,KAAA,CAAA,aAAA;AAAA,QAAC,QAAA;AAAA,QAAA;AAAA,UACC,MAAA;AAAA,UACA,KAAA;AAAA,UACA,YAAY,IAAK,CAAA,gBAAA;AAAA,SAAA;AAAA,OACnB,CAAA;AAAA,KAEJ;AAEA,IAAO,OAAA,QAAA,CAAA;AAAA,GACT;AACF;;;;"}
+{"version":3,"file":"ErrorBoundary.esm.js","sources":["../../src/components/ErrorBoundary.tsx"],"sourcesContent":["/*\n * Copyright 2023 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, { Component, ComponentType, PropsWithChildren } from 'react';\nimport { FrontendPlugin } from '../wiring';\nimport { CoreErrorBoundaryFallbackProps } from '../types';\n\ntype ErrorBoundaryProps = PropsWithChildren<{\n  plugin?: FrontendPlugin;\n  Fallback: ComponentType<CoreErrorBoundaryFallbackProps>;\n}>;\ntype ErrorBoundaryState = { error?: Error };\n\n/** @internal */\nexport class ErrorBoundary extends Component<\n  ErrorBoundaryProps,\n  ErrorBoundaryState\n> {\n  static getDerivedStateFromError(error: Error) {\n    return { error };\n  }\n\n  state: ErrorBoundaryState = { error: undefined };\n\n  handleErrorReset = () => {\n    this.setState({ error: undefined });\n  };\n\n  render() {\n    const { error } = this.state;\n    const { plugin, children, Fallback } = this.props;\n\n    if (error) {\n      return (\n        <Fallback\n          plugin={plugin}\n          error={error}\n          resetError={this.handleErrorReset}\n        />\n      );\n    }\n\n    return children;\n  }\n}\n"],"names":[],"mappings":";;AA2BO,MAAM,sBAAsB,SAGjC,CAAA;AAAA,EACA,OAAO,yBAAyB,KAAc,EAAA;AAC5C,IAAA,OAAO,EAAE,KAAM,EAAA,CAAA;AAAA,GACjB;AAAA,EAEA,KAAA,GAA4B,EAAE,KAAA,EAAO,KAAU,CAAA,EAAA,CAAA;AAAA,EAE/C,mBAAmB,MAAM;AACvB,IAAA,IAAA,CAAK,QAAS,CAAA,EAAE,KAAO,EAAA,KAAA,CAAA,EAAW,CAAA,CAAA;AAAA,GACpC,CAAA;AAAA,EAEA,MAAS,GAAA;AACP,IAAM,MAAA,EAAE,KAAM,EAAA,GAAI,IAAK,CAAA,KAAA,CAAA;AACvB,IAAA,MAAM,EAAE,MAAA,EAAQ,QAAU,EAAA,QAAA,KAAa,IAAK,CAAA,KAAA,CAAA;AAE5C,IAAA,IAAI,KAAO,EAAA;AACT,MACE,uBAAA,KAAA,CAAA,aAAA;AAAA,QAAC,QAAA;AAAA,QAAA;AAAA,UACC,MAAA;AAAA,UACA,KAAA;AAAA,UACA,YAAY,IAAK,CAAA,gBAAA;AAAA,SAAA;AAAA,OACnB,CAAA;AAAA,KAEJ;AAEA,IAAO,OAAA,QAAA,CAAA;AAAA,GACT;AACF;;;;"}

package/dist/frontend-internal/src/wiring/InternalExtensionDefinition.esm.js

@@ -1,18 +1,9 @@
-function toInternalExtensionDefinition(overrides) {
-  const internal = overrides;
-  if (internal.$$type !== "@backstage/ExtensionDefinition") {
-    throw new Error(
-      `Invalid extension definition instance, bad type '${internal.$$type}'`
-    );
-  }
-  const version = internal.version;
-  if (version !== "v1" && version !== "v2") {
-    throw new Error(
-      `Invalid extension definition instance, bad version '${version}'`
-    );
-  }
-  return internal;
-}
+import { OpaqueType } from '../../../opaque-internal/src/OpaqueType.esm.js';
 
-export { toInternalExtensionDefinition };
+const OpaqueExtensionDefinition = OpaqueType.create({
+  type: "@backstage/ExtensionDefinition",
+  versions: ["v1", "v2"]
+});
+
+export { OpaqueExtensionDefinition };
 //# sourceMappingURL=InternalExtensionDefinition.esm.js.map

package/dist/frontend-internal/src/wiring/InternalExtensionDefinition.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"InternalExtensionDefinition.esm.js","sources":["../../../../../frontend-internal/src/wiring/InternalExtensionDefinition.ts"],"sourcesContent":["/*\n * Copyright 2024 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  AnyExtensionDataRef,\n  ApiHolder,\n  AppNode,\n  ExtensionDataValue,\n  ExtensionDefinition,\n  ExtensionDefinitionParameters,\n  ExtensionInput,\n  PortableSchema,\n  ResolvedExtensionInputs,\n} from '@backstage/frontend-plugin-api';\n\nexport type InternalExtensionDefinition<\n  T extends ExtensionDefinitionParameters = ExtensionDefinitionParameters,\n> = ExtensionDefinition<T> & {\n  readonly kind?: string;\n  readonly namespace?: string;\n  readonly name?: string;\n  readonly attachTo: { id: string; input: string };\n  readonly disabled: boolean;\n  readonly configSchema?: PortableSchema<T['config'], T['configInput']>;\n} & (\n    | {\n        readonly version: 'v1';\n        readonly inputs: {\n          [inputName in string]: {\n            $$type: '@backstage/ExtensionInput';\n            extensionData: {\n              [name in string]: AnyExtensionDataRef;\n            };\n            config: { optional: boolean; singleton: boolean };\n          };\n        };\n        readonly output: {\n          [name in string]: AnyExtensionDataRef;\n        };\n        factory(context: {\n          node: AppNode;\n          apis: ApiHolder;\n          config: object;\n          inputs: {\n            [inputName in string]: unknown;\n          };\n        }): {\n          [inputName in string]: unknown;\n        };\n      }\n    | {\n        readonly version: 'v2';\n        readonly inputs: {\n          [inputName in string]: ExtensionInput<\n            AnyExtensionDataRef,\n            { optional: boolean; singleton: boolean }\n          >;\n        };\n        readonly output: Array<AnyExtensionDataRef>;\n        factory(context: {\n          node: AppNode;\n          apis: ApiHolder;\n          config: object;\n          inputs: ResolvedExtensionInputs<{\n            [inputName in string]: ExtensionInput<\n              AnyExtensionDataRef,\n              { optional: boolean; singleton: boolean }\n            >;\n          }>;\n        }): Iterable<ExtensionDataValue<any, any>>;\n      }\n  );\n\n/** @internal */\nexport function toInternalExtensionDefinition<\n  T extends ExtensionDefinitionParameters,\n>(overrides: ExtensionDefinition<T>): InternalExtensionDefinition<T> {\n  const internal = overrides as InternalExtensionDefinition<T>;\n  if (internal.$$type !== '@backstage/ExtensionDefinition') {\n    throw new Error(\n      `Invalid extension definition instance, bad type '${internal.$$type}'`,\n    );\n  }\n  const version = internal.version;\n  if (version !== 'v1' && version !== 'v2') {\n    throw new Error(\n      `Invalid extension definition instance, bad version '${version}'`,\n    );\n  }\n  return internal;\n}\n"],"names":[],"mappings":"AAuFO,SAAS,8BAEd,SAAmE,EAAA;AACnE,EAAA,MAAM,QAAW,GAAA,SAAA,CAAA;AACjB,EAAI,IAAA,QAAA,CAAS,WAAW,gCAAkC,EAAA;AACxD,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,CAAA,iDAAA,EAAoD,SAAS,MAAM,CAAA,CAAA,CAAA;AAAA,KACrE,CAAA;AAAA,GACF;AACA,EAAA,MAAM,UAAU,QAAS,CAAA,OAAA,CAAA;AACzB,EAAI,IAAA,OAAA,KAAY,IAAQ,IAAA,OAAA,KAAY,IAAM,EAAA;AACxC,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,uDAAuD,OAAO,CAAA,CAAA,CAAA;AAAA,KAChE,CAAA;AAAA,GACF;AACA,EAAO,OAAA,QAAA,CAAA;AACT;;;;"}
+{"version":3,"file":"InternalExtensionDefinition.esm.js","sources":["../../../../../frontend-internal/src/wiring/InternalExtensionDefinition.ts"],"sourcesContent":["/*\n * Copyright 2024 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  AnyExtensionDataRef,\n  ApiHolder,\n  AppNode,\n  ExtensionDataValue,\n  ExtensionDefinition,\n  ExtensionDefinitionParameters,\n  ExtensionInput,\n  PortableSchema,\n  ResolvedExtensionInputs,\n} from '@backstage/frontend-plugin-api';\nimport { OpaqueType } from '@internal/opaque';\n\nexport const OpaqueExtensionDefinition = OpaqueType.create<{\n  public: ExtensionDefinition<ExtensionDefinitionParameters>;\n  versions:\n    | {\n        readonly version: 'v1';\n        readonly kind?: string;\n        readonly namespace?: string;\n        readonly name?: string;\n        readonly attachTo: { id: string; input: string };\n        readonly disabled: boolean;\n        readonly configSchema?: PortableSchema<any, any>;\n        readonly inputs: {\n          [inputName in string]: {\n            $$type: '@backstage/ExtensionInput';\n            extensionData: {\n              [name in string]: AnyExtensionDataRef;\n            };\n            config: { optional: boolean; singleton: boolean };\n          };\n        };\n        readonly output: {\n          [name in string]: AnyExtensionDataRef;\n        };\n        factory(context: {\n          node: AppNode;\n          apis: ApiHolder;\n          config: object;\n          inputs: {\n            [inputName in string]: unknown;\n          };\n        }): {\n          [inputName in string]: unknown;\n        };\n      }\n    | {\n        readonly version: 'v2';\n        readonly kind?: string;\n        readonly namespace?: string;\n        readonly name?: string;\n        readonly attachTo: { id: string; input: string };\n        readonly disabled: boolean;\n        readonly configSchema?: PortableSchema<any, any>;\n        readonly inputs: {\n          [inputName in string]: ExtensionInput<\n            AnyExtensionDataRef,\n            { optional: boolean; singleton: boolean }\n          >;\n        };\n        readonly output: Array<AnyExtensionDataRef>;\n        factory(context: {\n          node: AppNode;\n          apis: ApiHolder;\n          config: object;\n          inputs: ResolvedExtensionInputs<{\n            [inputName in string]: ExtensionInput<\n              AnyExtensionDataRef,\n              { optional: boolean; singleton: boolean }\n            >;\n          }>;\n        }): Iterable<ExtensionDataValue<any, any>>;\n      };\n}>({\n  type: '@backstage/ExtensionDefinition',\n  versions: ['v1', 'v2'],\n});\n"],"names":[],"mappings":";;AA6Ba,MAAA,yBAAA,GAA4B,WAAW,MA6DjD,CAAA;AAAA,EACD,IAAM,EAAA,gCAAA;AAAA,EACN,QAAA,EAAU,CAAC,IAAA,EAAM,IAAI,CAAA;AACvB,CAAC;;;;"}

package/dist/frontend-internal/src/wiring/InternalFrontendPlugin.esm.js

@@ -0,0 +1,9 @@
+import { OpaqueType } from '../../../opaque-internal/src/OpaqueType.esm.js';
+
+const OpaqueFrontendPlugin = OpaqueType.create({
+  type: "@backstage/FrontendPlugin",
+  versions: ["v1"]
+});
+
+export { OpaqueFrontendPlugin };
+//# sourceMappingURL=InternalFrontendPlugin.esm.js.map

package/dist/frontend-internal/src/wiring/InternalFrontendPlugin.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InternalFrontendPlugin.esm.js","sources":["../../../../../frontend-internal/src/wiring/InternalFrontendPlugin.ts"],"sourcesContent":["/*\n * Copyright 2024 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  Extension,\n  FeatureFlagConfig,\n  FrontendPlugin,\n} from '@backstage/frontend-plugin-api';\nimport { OpaqueType } from '@internal/opaque';\n\nexport const OpaqueFrontendPlugin = OpaqueType.create<{\n  public: FrontendPlugin;\n  versions: {\n    readonly version: 'v1';\n    readonly extensions: Extension<unknown>[];\n    readonly featureFlags: FeatureFlagConfig[];\n  };\n}>({\n  type: '@backstage/FrontendPlugin',\n  versions: ['v1'],\n});\n"],"names":[],"mappings":";;AAuBa,MAAA,oBAAA,GAAuB,WAAW,MAO5C,CAAA;AAAA,EACD,IAAM,EAAA,2BAAA;AAAA,EACN,QAAA,EAAU,CAAC,IAAI,CAAA;AACjB,CAAC;;;;"}

package/dist/index.d.ts

@@ -277,7 +277,7 @@ type CoreNotFoundErrorPageProps = {
 };
 /** @public */
 type CoreErrorBoundaryFallbackProps = {
-    plugin?: BackstagePlugin;
+    plugin?: FrontendPlugin;
     error: Error;
     resetError: () => void;
 };
@@ -370,7 +370,7 @@ type JoinStringUnion<U, TDiv extends string = ', ', TResult extends string = ''>
 /** @ignore */
 type VerifyExtensionFactoryOutput<UDeclaredOutput extends AnyExtensionDataRef, UFactoryOutput extends ExtensionDataValue<any, any>> = (UDeclaredOutput extends any ? UDeclaredOutput['config']['optional'] extends true ? never : UDeclaredOutput['id'] : never) extends infer IRequiredOutputIds ? [IRequiredOutputIds] extends [UFactoryOutput['id']] ? [UFactoryOutput['id']] extends [UDeclaredOutput['id']] ? {} : `Error: The extension factory has undeclared output(s): ${JoinStringUnion<Exclude<UFactoryOutput['id'], UDeclaredOutput['id']>>}` : `Error: The extension factory is missing the following output(s): ${JoinStringUnion<Exclude<IRequiredOutputIds, UFactoryOutput['id']>>}` : never;
 /** @public */
-type CreateExtensionOptions<TKind extends string | undefined, TNamespace extends string | undefined, TName extends string | undefined, UOutput extends AnyExtensionDataRef, TInputs extends {
+type CreateExtensionOptions<TKind extends string | undefined, TName extends string | undefined, UOutput extends AnyExtensionDataRef, TInputs extends {
     [inputName in string]: ExtensionInput<AnyExtensionDataRef, {
         optional: boolean;
         singleton: boolean;
@@ -379,7 +379,6 @@ type CreateExtensionOptions<TKind extends string | undefined, TNamespace extends
     [key: string]: (zImpl: typeof z) => z.ZodType;
 }, UFactoryOutput extends ExtensionDataValue<any, any>> = {
     kind?: TKind;
-    namespace?: TNamespace;
     name?: TName;
     attachTo: {
         id: string;
@@ -403,7 +402,6 @@ type CreateExtensionOptions<TKind extends string | undefined, TNamespace extends
 /** @public */
 type ExtensionDefinitionParameters = {
     kind?: string;
-    namespace?: string;
     name?: string;
     configInput?: {
         [K in string]: any;
@@ -418,6 +416,7 @@ type ExtensionDefinitionParameters = {
             singleton: boolean;
         }>;
     };
+    params?: object;
 };
 /** @public */
 type ExtensionDefinition<T extends ExtensionDefinitionParameters = ExtensionDefinitionParameters> = {
@@ -430,7 +429,7 @@ type ExtensionDefinition<T extends ExtensionDefinitionParameters = ExtensionDefi
             optional: boolean;
             singleton: boolean;
         }>;
-    }>(args: {
+    }>(args: Expand<{
         attachTo?: {
             id: string;
             input: string;
@@ -445,10 +444,12 @@ type ExtensionDefinition<T extends ExtensionDefinitionParameters = ExtensionDefi
                 [KName in keyof T['config']]?: `Error: Config key '${KName & string}' is already defined in parent schema`;
             };
         };
-        factory?(originalFactory: (context?: {
+        factory?(originalFactory: (context?: Expand<{
             config?: T['config'];
             inputs?: ResolveInputValueOverrides<NonNullable<T['inputs']>>;
-        }) => ExtensionDataContainer<NonNullable<T['output']>>, context: {
+        } & ([T['params']] extends [never] ? {} : {
+            params?: Partial<T['params']>;
+        })>) => ExtensionDataContainer<NonNullable<T['output']>>, context: {
             node: AppNode;
             apis: ApiHolder;
             config: T['config'] & {
@@ -456,9 +457,10 @@ type ExtensionDefinition<T extends ExtensionDefinitionParameters = ExtensionDefi
             };
             inputs: Expand<ResolvedExtensionInputs<T['inputs'] & TExtraInputs>>;
         }): Iterable<UFactoryOutput>;
-    } & VerifyExtensionFactoryOutput<AnyExtensionDataRef extends UNewOutput ? NonNullable<T['output']> : UNewOutput, UFactoryOutput>): ExtensionDefinition<{
+    } & ([T['params']] extends [never] ? {} : {
+        params?: Partial<T['params']>;
+    })> & VerifyExtensionFactoryOutput<AnyExtensionDataRef extends UNewOutput ? NonNullable<T['output']> : UNewOutput, UFactoryOutput>): ExtensionDefinition<{
         kind: T['kind'];
-        namespace: T['namespace'];
         name: T['name'];
         output: AnyExtensionDataRef extends UNewOutput ? T['output'] : UNewOutput;
         inputs: T['inputs'] & TExtraInputs;
@@ -478,31 +480,7 @@ declare function createExtension<UOutput extends AnyExtensionDataRef, TInputs ex
     }>;
 }, TConfigSchema extends {
     [key: string]: (zImpl: typeof z) => z.ZodType;
-}, UFactoryOutput extends ExtensionDataValue<any, any>, const TKind extends string | undefined = undefined, const TNamespace extends string | undefined = undefined, const TName extends string | undefined = undefined>(options: CreateExtensionOptions<TKind, undefined, TName, UOutput, TInputs, TConfigSchema, UFactoryOutput>): ExtensionDefinition<{
-    config: string extends keyof TConfigSchema ? {} : {
-        [key in keyof TConfigSchema]: z.infer<ReturnType<TConfigSchema[key]>>;
-    };
-    configInput: string extends keyof TConfigSchema ? {} : z.input<z.ZodObject<{
-        [key in keyof TConfigSchema]: ReturnType<TConfigSchema[key]>;
-    }>>;
-    output: UOutput;
-    inputs: TInputs;
-    kind: string | undefined extends TKind ? undefined : TKind;
-    namespace: string | undefined extends TNamespace ? undefined : TNamespace;
-    name: string | undefined extends TName ? undefined : TName;
-}>;
-/**
- * @public
- * @deprecated namespace is no longer required, you can safely remove this option and it will default to the `pluginId`. It will be removed in a future release.
- */
-declare function createExtension<UOutput extends AnyExtensionDataRef, TInputs extends {
-    [inputName in string]: ExtensionInput<AnyExtensionDataRef, {
-        optional: boolean;
-        singleton: boolean;
-    }>;
-}, TConfigSchema extends {
-    [key: string]: (zImpl: typeof z) => z.ZodType;
-}, UFactoryOutput extends ExtensionDataValue<any, any>, const TKind extends string | undefined = undefined, const TNamespace extends string | undefined = undefined, const TName extends string | undefined = undefined>(options: CreateExtensionOptions<TKind, TNamespace, TName, UOutput, TInputs, TConfigSchema, UFactoryOutput>): ExtensionDefinition<{
+}, UFactoryOutput extends ExtensionDataValue<any, any>, const TKind extends string | undefined = undefined, const TName extends string | undefined = undefined>(options: CreateExtensionOptions<TKind, TName, UOutput, TInputs, TConfigSchema, UFactoryOutput>): ExtensionDefinition<{
     config: string extends keyof TConfigSchema ? {} : {
         [key in keyof TConfigSchema]: z.infer<ReturnType<TConfigSchema[key]>>;
     };
@@ -511,8 +489,8 @@ declare function createExtension<UOutput extends AnyExtensionDataRef, TInputs ex
     }>>;
     output: UOutput;
     inputs: TInputs;
+    params: never;
     kind: string | undefined extends TKind ? undefined : TKind;
-    namespace: string | undefined extends TNamespace ? undefined : TNamespace;
     name: string | undefined extends TName ? undefined : TName;
 }>;
 
@@ -534,11 +512,10 @@ interface Extension<TConfig, TConfigInput = TConfig> {
     readonly configSchema?: PortableSchema<TConfig, TConfigInput>;
 }
 /** @ignore */
-type ResolveExtensionId<TExtension extends ExtensionDefinition, TDefaultNamespace extends string | undefined> = TExtension extends ExtensionDefinition<{
+type ResolveExtensionId<TExtension extends ExtensionDefinition, TNamespace extends string> = TExtension extends ExtensionDefinition<{
     kind: infer IKind extends string | undefined;
-    namespace: infer INamespace extends string | undefined;
     name: infer IName extends string | undefined;
-}> ? [string | undefined] extends [IKind | INamespace | IName] ? never : ((undefined extends TDefaultNamespace ? INamespace : TDefaultNamespace) extends infer ISelectedNamespace extends string ? undefined extends IName ? ISelectedNamespace : `${ISelectedNamespace}/${IName}` : IName) extends infer INamePart extends string ? IKind extends string ? `${IKind}:${INamePart}` : INamePart : never : never;
+}> ? [string] extends [IKind | IName] ? never : (undefined extends IName ? TNamespace : `${TNamespace}/${IName}`) extends infer INamePart extends string ? IKind extends string ? `${IKind}:${INamePart}` : INamePart : never : never;
 
 /**
  * Feature flag configuration.
@@ -570,7 +547,9 @@ type FrontendFeature = FrontendPlugin | ExtensionOverrides;
 /** @public */
 interface FrontendPlugin<TRoutes extends AnyRoutes = AnyRoutes, TExternalRoutes extends AnyExternalRoutes = AnyExternalRoutes, TExtensionMap extends {
     [id in string]: ExtensionDefinition;
-} = {}> {
+} = {
+    [id in string]: ExtensionDefinition;
+}> {
     readonly $$type: '@backstage/FrontendPlugin';
     readonly id: string;
     readonly routes: TRoutes;
@@ -580,13 +559,6 @@ interface FrontendPlugin<TRoutes extends AnyRoutes = AnyRoutes, TExternalRoutes
         extensions: Array<ExtensionDefinition>;
     }): FrontendPlugin<TRoutes, TExternalRoutes, TExtensionMap>;
 }
-/**
- * @public
- * @deprecated Use {@link FrontendPlugin} instead.
- */
-type BackstagePlugin<TRoutes extends AnyRoutes = AnyRoutes, TExternalRoutes extends AnyExternalRoutes = AnyExternalRoutes, TExtensionMap extends {
-    [id in string]: ExtensionDefinition;
-} = {}> = FrontendPlugin<TRoutes, TExternalRoutes, TExtensionMap>;
 /** @public */
 interface PluginOptions<TId extends string, TRoutes extends AnyRoutes, TExternalRoutes extends AnyExternalRoutes, TExtensions extends readonly ExtensionDefinition[]> {
     id: TId;
@@ -599,11 +571,6 @@ interface PluginOptions<TId extends string, TRoutes extends AnyRoutes, TExternal
 declare function createFrontendPlugin<TId extends string, TRoutes extends AnyRoutes = {}, TExternalRoutes extends AnyExternalRoutes = {}, TExtensions extends readonly ExtensionDefinition[] = []>(options: PluginOptions<TId, TRoutes, TExternalRoutes, TExtensions>): FrontendPlugin<TRoutes, TExternalRoutes, {
     [KExtension in TExtensions[number] as ResolveExtensionId<KExtension, TId>]: KExtension;
 }>;
-/**
- * @public
- * @deprecated Use {@link createFrontendPlugin} instead.
- */
-declare const createPlugin: typeof createFrontendPlugin;
 
 /** @public */
 interface CreateFrontendModuleOptions<TPluginId extends string, TExtensions extends readonly ExtensionDefinition[]> {
@@ -619,24 +586,10 @@ interface FrontendModule {
 /** @public */
 declare function createFrontendModule<TId extends string, TExtensions extends readonly ExtensionDefinition[] = []>(options: CreateFrontendModuleOptions<TId, TExtensions>): FrontendModule;
 
-/**
- * @deprecated Use {@link createFrontendModule} instead.
- * @public
- */
-interface ExtensionOverridesOptions {
-    extensions: ExtensionDefinition[];
-    featureFlags?: FeatureFlagConfig[];
-}
-/**
- * @deprecated Use {@link createFrontendModule} instead.
- * @public
- */
-declare function createExtensionOverrides(options: ExtensionOverridesOptions): ExtensionOverrides;
-
 /**
  * @public
  */
-type CreateExtensionBlueprintOptions<TKind extends string, TNamespace extends string | undefined, TName extends string | undefined, TParams, UOutput extends AnyExtensionDataRef, TInputs extends {
+type CreateExtensionBlueprintOptions<TKind extends string, TName extends string | undefined, TParams, UOutput extends AnyExtensionDataRef, TInputs extends {
     [inputName in string]: ExtensionInput<AnyExtensionDataRef, {
         optional: boolean;
         singleton: boolean;
@@ -647,7 +600,6 @@ type CreateExtensionBlueprintOptions<TKind extends string, TNamespace extends st
     [name in string]: AnyExtensionDataRef;
 }> = {
     kind: TKind;
-    namespace?: TNamespace;
     attachTo: {
         id: string;
         input: string;
@@ -672,7 +624,6 @@ type CreateExtensionBlueprintOptions<TKind extends string, TNamespace extends st
 /** @public */
 type ExtensionBlueprintParameters = {
     kind: string;
-    namespace?: string;
     name?: string;
     params?: object;
     configInput?: {
@@ -697,8 +648,7 @@ type ExtensionBlueprintParameters = {
  */
 interface ExtensionBlueprint<T extends ExtensionBlueprintParameters = ExtensionBlueprintParameters> {
     dataRefs: T['dataRefs'];
-    make<TNewNamespace extends string | undefined, TNewName extends string | undefined>(args: {
-        namespace?: undefined;
+    make<TNewName extends string | undefined>(args: {
         name?: TNewName;
         attachTo?: {
             id: string;
@@ -708,31 +658,12 @@ interface ExtensionBlueprint<T extends ExtensionBlueprintParameters = ExtensionB
         params: T['params'];
     }): ExtensionDefinition<{
         kind: T['kind'];
-        namespace: undefined;
         name: string | undefined extends TNewName ? T['name'] : TNewName;
         config: T['config'];
         configInput: T['configInput'];
         output: T['output'];
         inputs: T['inputs'];
-    }>;
-    /** @deprecated namespace is no longer required, you can safely remove this option and it will default to the `pluginId`. It will be removed in a future release. */
-    make<TNewNamespace extends string | undefined, TNewName extends string | undefined>(args: {
-        namespace?: TNewNamespace;
-        name?: TNewName;
-        attachTo?: {
-            id: string;
-            input: string;
-        };
-        disabled?: boolean;
         params: T['params'];
-    }): ExtensionDefinition<{
-        kind: T['kind'];
-        namespace: string | undefined extends TNewNamespace ? T['namespace'] : TNewNamespace;
-        name: string | undefined extends TNewName ? T['name'] : TNewName;
-        config: T['config'];
-        configInput: T['configInput'];
-        output: T['output'];
-        inputs: T['inputs'];
     }>;
     /**
      * Creates a new extension from the blueprint.
@@ -740,7 +671,7 @@ interface ExtensionBlueprint<T extends ExtensionBlueprintParameters = ExtensionB
      * You must either pass `params` directly, or define a `factory` that can
      * optionally call the original factory with the same params.
      */
-    makeWithOverrides<TNewNamespace extends string | undefined, TNewName extends string | undefined, TExtensionConfigSchema extends {
+    makeWithOverrides<TNewName extends string | undefined, TExtensionConfigSchema extends {
         [key in string]: (zImpl: typeof z) => z.ZodType;
     }, UFactoryOutput extends ExtensionDataValue<any, any>, UNewOutput extends AnyExtensionDataRef, TExtraInputs extends {
         [inputName in string]: ExtensionInput<AnyExtensionDataRef, {
@@ -748,7 +679,6 @@ interface ExtensionBlueprint<T extends ExtensionBlueprintParameters = ExtensionB
             singleton: boolean;
         }>;
     }>(args: {
-        namespace?: undefined;
         name?: TNewName;
         attachTo?: {
             id: string;
@@ -785,57 +715,8 @@ interface ExtensionBlueprint<T extends ExtensionBlueprintParameters = ExtensionB
         output: AnyExtensionDataRef extends UNewOutput ? T['output'] : UNewOutput;
         inputs: T['inputs'] & TExtraInputs;
         kind: T['kind'];
-        namespace: undefined;
-        name: string | undefined extends TNewName ? T['name'] : TNewName;
-    }>;
-    /** @deprecated namespace is no longer required, you can safely remove this option and it will default to the `pluginId`. It will be removed in a future release. */
-    makeWithOverrides<TNewNamespace extends string | undefined, TNewName extends string | undefined, TExtensionConfigSchema extends {
-        [key in string]: (zImpl: typeof z) => z.ZodType;
-    }, UFactoryOutput extends ExtensionDataValue<any, any>, UNewOutput extends AnyExtensionDataRef, TExtraInputs extends {
-        [inputName in string]: ExtensionInput<AnyExtensionDataRef, {
-            optional: boolean;
-            singleton: boolean;
-        }>;
-    }>(args: {
-        namespace: TNewNamespace;
-        name?: TNewName;
-        attachTo?: {
-            id: string;
-            input: string;
-        };
-        disabled?: boolean;
-        inputs?: TExtraInputs & {
-            [KName in keyof T['inputs']]?: `Error: Input '${KName & string}' is already defined in parent definition`;
-        };
-        output?: Array<UNewOutput>;
-        config?: {
-            schema: TExtensionConfigSchema & {
-                [KName in keyof T['config']]?: `Error: Config key '${KName & string}' is already defined in parent schema`;
-            };
-        };
-        factory(originalFactory: (params: T['params'], context?: {
-            config?: T['config'];
-            inputs?: ResolveInputValueOverrides<NonNullable<T['inputs']>>;
-        }) => ExtensionDataContainer<NonNullable<T['output']>>, context: {
-            node: AppNode;
-            apis: ApiHolder;
-            config: T['config'] & {
-                [key in keyof TExtensionConfigSchema]: z.infer<ReturnType<TExtensionConfigSchema[key]>>;
-            };
-            inputs: Expand<ResolvedExtensionInputs<T['inputs'] & TExtraInputs>>;
-        }): Iterable<UFactoryOutput> & VerifyExtensionFactoryOutput<AnyExtensionDataRef extends UNewOutput ? NonNullable<T['output']> : UNewOutput, UFactoryOutput>;
-    }): ExtensionDefinition<{
-        config: (string extends keyof TExtensionConfigSchema ? {} : {
-            [key in keyof TExtensionConfigSchema]: z.infer<ReturnType<TExtensionConfigSchema[key]>>;
-        }) & T['config'];
-        configInput: (string extends keyof TExtensionConfigSchema ? {} : z.input<z.ZodObject<{
-            [key in keyof TExtensionConfigSchema]: ReturnType<TExtensionConfigSchema[key]>;
-        }>>) & T['configInput'];
-        output: AnyExtensionDataRef extends UNewOutput ? T['output'] : UNewOutput;
-        inputs: T['inputs'] & TExtraInputs;
-        kind: T['kind'];
-        namespace: string | undefined extends TNewNamespace ? T['namespace'] : TNewNamespace;
         name: string | undefined extends TNewName ? T['name'] : TNewName;
+        params: T['params'];
     }>;
 }
 /**
@@ -851,39 +732,10 @@ declare function createExtensionBlueprint<TParams extends object, UOutput extend
     }>;
 }, TConfigSchema extends {
     [key in string]: (zImpl: typeof z) => z.ZodType;
-}, UFactoryOutput extends ExtensionDataValue<any, any>, TKind extends string, TNamespace extends undefined = undefined, TName extends string | undefined = undefined, TDataRefs extends {
-    [name in string]: AnyExtensionDataRef;
-} = never>(options: CreateExtensionBlueprintOptions<TKind, undefined, TName, TParams, UOutput, TInputs, TConfigSchema, UFactoryOutput, TDataRefs>): ExtensionBlueprint<{
-    kind: TKind;
-    namespace: undefined;
-    name: TName;
-    params: TParams;
-    output: UOutput;
-    inputs: string extends keyof TInputs ? {} : TInputs;
-    config: string extends keyof TConfigSchema ? {} : {
-        [key in keyof TConfigSchema]: z.infer<ReturnType<TConfigSchema[key]>>;
-    };
-    configInput: string extends keyof TConfigSchema ? {} : z.input<z.ZodObject<{
-        [key in keyof TConfigSchema]: ReturnType<TConfigSchema[key]>;
-    }>>;
-    dataRefs: TDataRefs;
-}>;
-/**
- * @public
- * @deprecated the namespace is no longer required, you can safely remove this option and it will default to the `pluginId`. It will be removed in a future release.
- */
-declare function createExtensionBlueprint<TParams extends object, UOutput extends AnyExtensionDataRef, TInputs extends {
-    [inputName in string]: ExtensionInput<AnyExtensionDataRef, {
-        optional: boolean;
-        singleton: boolean;
-    }>;
-}, TConfigSchema extends {
-    [key in string]: (zImpl: typeof z) => z.ZodType;
-}, UFactoryOutput extends ExtensionDataValue<any, any>, TKind extends string, TNamespace extends string | undefined = undefined, TName extends string | undefined = undefined, TDataRefs extends {
+}, UFactoryOutput extends ExtensionDataValue<any, any>, TKind extends string, TName extends string | undefined = undefined, TDataRefs extends {
     [name in string]: AnyExtensionDataRef;
-} = never>(options: CreateExtensionBlueprintOptions<TKind, TNamespace, TName, TParams, UOutput, TInputs, TConfigSchema, UFactoryOutput, TDataRefs>): ExtensionBlueprint<{
+} = never>(options: CreateExtensionBlueprintOptions<TKind, TName, TParams, UOutput, TInputs, TConfigSchema, UFactoryOutput, TDataRefs>): ExtensionBlueprint<{
     kind: TKind;
-    namespace: TNamespace;
     name: TName;
     params: TParams;
     output: UOutput;
@@ -915,7 +767,7 @@ interface AppNodeSpec {
     readonly extension: Extension<unknown, unknown>;
     readonly disabled: boolean;
     readonly config?: unknown;
-    readonly source?: BackstagePlugin;
+    readonly source?: FrontendPlugin;
 }
 /**
  * The connections from this {@link AppNode} to other nodes.
@@ -1056,7 +908,7 @@ declare function useComponentRef<T extends {}>(ref: ComponentRef<T>): ComponentT
  *
  * @remarks
  *
- * The type is based on SvgIcon from Material UI, but both do not what the plugin-api
+ * The type is based on SvgIcon from Material UI, but we do not want the plugin-api
  * package to have a dependency on Material UI, nor do we want the props to be as broad
  * as the SvgIconProps interface.
  *
@@ -1067,8 +919,6 @@ declare function useComponentRef<T extends {}>(ref: ComponentRef<T>): ComponentT
  * @public
  */
 type IconComponent = ComponentType<{
-    fontSize?: 'large' | 'small' | 'default' | 'inherit';
-} | {
     fontSize?: 'medium' | 'large' | 'small' | 'inherit';
 }>;
 
@@ -1238,7 +1088,6 @@ declare function useAnalytics(): AnalyticsTracker;
  */
 declare const ApiBlueprint: ExtensionBlueprint<{
     kind: "api";
-    namespace: undefined;
     name: undefined;
     params: {
         factory: AnyApiFactory;
@@ -1260,7 +1109,6 @@ declare const ApiBlueprint: ExtensionBlueprint<{
  */
 declare const AppRootElementBlueprint: ExtensionBlueprint<{
     kind: "app-root-element";
-    namespace: undefined;
     name: undefined;
     params: {
         element: JSX.Element | (() => JSX.Element);
@@ -1281,7 +1129,6 @@ declare const AppRootElementBlueprint: ExtensionBlueprint<{
  */
 declare const AppRootWrapperBlueprint: ExtensionBlueprint<{
     kind: "app-root-wrapper";
-    namespace: undefined;
     name: undefined;
     params: {
         Component: ComponentType<PropsWithChildren<{}>>;
@@ -1302,7 +1149,6 @@ declare const AppRootWrapperBlueprint: ExtensionBlueprint<{
 /** @public */
 declare const IconBundleBlueprint: ExtensionBlueprint<{
     kind: "icon-bundle";
-    namespace: undefined;
     name: undefined;
     params: {
         icons: {
@@ -1329,7 +1175,6 @@ declare const IconBundleBlueprint: ExtensionBlueprint<{
  */
 declare const NavItemBlueprint: ExtensionBlueprint<{
     kind: "nav-item";
-    namespace: undefined;
     name: undefined;
     params: {
         title: string;
@@ -1360,7 +1205,6 @@ declare const NavItemBlueprint: ExtensionBlueprint<{
  */
 declare const NavLogoBlueprint: ExtensionBlueprint<{
     kind: "nav-logo";
-    namespace: undefined;
     name: undefined;
     params: {
         logoIcon: JSX.Element;
@@ -1388,7 +1232,6 @@ declare const NavLogoBlueprint: ExtensionBlueprint<{
  */
 declare const PageBlueprint: ExtensionBlueprint<{
     kind: "page";
-    namespace: undefined;
     name: undefined;
     params: {
         defaultPath: string;
@@ -1411,7 +1254,6 @@ declare const PageBlueprint: ExtensionBlueprint<{
 /** @public */
 declare const RouterBlueprint: ExtensionBlueprint<{
     kind: "app-router-component";
-    namespace: undefined;
     name: undefined;
     params: {
         Component: ComponentType<PropsWithChildren<{}>>;
@@ -1436,7 +1278,6 @@ declare const RouterBlueprint: ExtensionBlueprint<{
  */
 declare const SignInPageBlueprint: ExtensionBlueprint<{
     kind: "sign-in-page";
-    namespace: undefined;
     name: undefined;
     params: {
         loader: () => Promise<ComponentType<SignInPageProps>>;
@@ -1457,7 +1298,6 @@ declare const SignInPageBlueprint: ExtensionBlueprint<{
  */
 declare const ThemeBlueprint: ExtensionBlueprint<{
     kind: "theme";
-    namespace: undefined;
     name: undefined;
     params: {
         theme: AppTheme;
@@ -1478,7 +1318,6 @@ declare const ThemeBlueprint: ExtensionBlueprint<{
  */
 declare const TranslationBlueprint: ExtensionBlueprint<{
     kind: "translation";
-    namespace: undefined;
     name: undefined;
     params: {
         resource: TranslationResource | TranslationMessages;
@@ -1519,8 +1358,8 @@ declare function createComponentExtension<TProps extends {}>(options: {
             singleton: boolean;
         }>;
     };
+    params: never;
     kind: "component";
-    namespace: undefined;
     name: string;
 }>;
 /** @public */
@@ -1531,4 +1370,4 @@ declare namespace createComponentExtension {
     }, "core.component.component", {}>;
 }
 
-export { type AnalyticsApi, AnalyticsContext, type AnalyticsContextValue, type AnalyticsEvent, type AnalyticsEventAttributes, type AnalyticsTracker, type AnyExtensionDataRef, type AnyExternalRoutes, type AnyRouteRefParams, type AnyRoutes, ApiBlueprint, type AppNode, type AppNodeEdges, type AppNodeInstance, type AppNodeSpec, AppRootElementBlueprint, AppRootWrapperBlueprint, type AppTree, type AppTreeApi, type BackstagePlugin, type CommonAnalyticsContext, type ComponentRef, type ComponentsApi, type ConfigurableExtensionDataRef, type CoreErrorBoundaryFallbackProps, type CoreNotFoundErrorPageProps, type CoreProgressProps, type CreateExtensionBlueprintOptions, type CreateExtensionOptions, type CreateFrontendModuleOptions, type Extension, type ExtensionBlueprint, type ExtensionBlueprintParameters, ExtensionBoundary, type ExtensionBoundaryProps, type ExtensionDataContainer, type ExtensionDataRef, type ExtensionDataRefToValue, type ExtensionDataValue, type ExtensionDefinition, type ExtensionDefinitionParameters, type ExtensionInput, type ExtensionOverrides, type ExtensionOverridesOptions, type ExternalRouteRef, type FeatureFlagConfig, type FrontendFeature, type FrontendModule, type FrontendPlugin, IconBundleBlueprint, type IconComponent, type IconsApi, NavItemBlueprint, NavLogoBlueprint, PageBlueprint, type PluginOptions, type PortableSchema, type ResolveInputValueOverrides, type ResolvedExtensionInput, type ResolvedExtensionInputs, type RouteFunc, type RouteRef, type RouteResolutionApi, type RouteResolutionApiResolveOptions, RouterBlueprint, SignInPageBlueprint, type SubRouteRef, ThemeBlueprint, TranslationBlueprint, analyticsApiRef, appTreeApiRef, componentsApiRef, coreComponentRefs, coreExtensionData, createComponentExtension, createComponentRef, createExtension, createExtensionBlueprint, createExtensionDataRef, createExtensionInput, createExtensionOverrides, createExternalRouteRef, createFrontendModule, createFrontendPlugin, createPlugin, createRouteRef, createSubRouteRef, iconsApiRef, routeResolutionApiRef, useAnalytics, useComponentRef, useRouteRef, useRouteRefParams };
+export { type AnalyticsApi, AnalyticsContext, type AnalyticsContextValue, type AnalyticsEvent, type AnalyticsEventAttributes, type AnalyticsTracker, type AnyExtensionDataRef, type AnyExternalRoutes, type AnyRouteRefParams, type AnyRoutes, ApiBlueprint, type AppNode, type AppNodeEdges, type AppNodeInstance, type AppNodeSpec, AppRootElementBlueprint, AppRootWrapperBlueprint, type AppTree, type AppTreeApi, type CommonAnalyticsContext, type ComponentRef, type ComponentsApi, type ConfigurableExtensionDataRef, type CoreErrorBoundaryFallbackProps, type CoreNotFoundErrorPageProps, type CoreProgressProps, type CreateExtensionBlueprintOptions, type CreateExtensionOptions, type CreateFrontendModuleOptions, type Extension, type ExtensionBlueprint, type ExtensionBlueprintParameters, ExtensionBoundary, type ExtensionBoundaryProps, type ExtensionDataContainer, type ExtensionDataRef, type ExtensionDataRefToValue, type ExtensionDataValue, type ExtensionDefinition, type ExtensionDefinitionParameters, type ExtensionInput, type ExtensionOverrides, type ExternalRouteRef, type FeatureFlagConfig, type FrontendFeature, type FrontendModule, type FrontendPlugin, IconBundleBlueprint, type IconComponent, type IconsApi, NavItemBlueprint, NavLogoBlueprint, PageBlueprint, type PluginOptions, type PortableSchema, type ResolveInputValueOverrides, type ResolvedExtensionInput, type ResolvedExtensionInputs, type RouteFunc, type RouteRef, type RouteResolutionApi, type RouteResolutionApiResolveOptions, RouterBlueprint, SignInPageBlueprint, type SubRouteRef, ThemeBlueprint, TranslationBlueprint, analyticsApiRef, appTreeApiRef, componentsApiRef, coreComponentRefs, coreExtensionData, createComponentExtension, createComponentRef, createExtension, createExtensionBlueprint, createExtensionDataRef, createExtensionInput, createExternalRouteRef, createFrontendModule, createFrontendPlugin, createRouteRef, createSubRouteRef, iconsApiRef, routeResolutionApiRef, useAnalytics, useComponentRef, useRouteRef, useRouteRefParams };