@backstage/frontend-plugin-api 0.16.0-next.2 → 0.16.1

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # @backstage/frontend-plugin-api
 
+## 0.16.1
+
+### Patch Changes
+
+- 6b60bd7: Replaced old config schema values from existing extensions and blueprints.
+
+## 0.16.0
+
+### Minor Changes
+
+- fa55078: **BREAKING**: Removed the deprecated `createSchemaFromZod` helper. Use the new `configSchema` option instead. See the [1.50 migration documentation](https://backstage.io/docs/frontend-system/architecture/migrations#150) for more information.
+- 49397c1: Simplified the type signature of `createRouteRef` by replacing the dual `TParams`/`TParamKeys` type parameters with a single `TParamKey` parameter. This is a breaking change for callers that explicitly provided type arguments, but most usage that relies on inference is unaffected.
+
+### Patch Changes
+
+- 4c09967: Fixed the duplicate extension error message in `createFrontendModule` to correctly say "Module" instead of "Plugin".
+- e4804ab: Added `open` method to `DialogApi` that renders dialogs without any built-in dialog chrome, giving the caller full control over the dialog presentation. This avoids focus trap conflicts that occur when mixing components from different design libraries. The existing `show` and `showModal` methods are now deprecated in favor of `open`.
+- ddc5247: Fixed `FlattenedMessages` type to avoid excessive type instantiation depth in TypeScript 6 when using `createTranslationRef` with the `translations` option.
+- a2a6c3b: Added a new `configSchema` option for `createExtension` and `createExtensionBlueprint` that accepts direct schema values from any [Standard Schema](https://github.com/standard-schema/standard-schema) compatible library with JSON Schema support, such as zod v4 or the `zod/v4` subpath from zod v3. The old `config.schema` option is now deprecated. Note that direct zod v3 schemas are not supported by the new `configSchema` option — use `import { z } from 'zod/v4'` from the zod v3 package, or upgrade to zod v4. See the [1.50 migration documentation](https://backstage.io/docs/frontend-system/architecture/migrations#150) for more information.
+- d66a3ec: Added `titleLink` prop to `PageLayoutProps` so the plugin header title can link back to the plugin root.
+- e220589: Removed the unnecessary need to use `defineParams` callback from `PluginHeaderActionBlueprint`. It still works, but is no longer required.
+- Updated dependencies
+  - @backstage/errors@1.3.0
+  - @backstage/filter-predicates@0.1.2
+
 ## 0.16.0-next.2
 
 ### Patch Changes

package/dist/alpha.d.ts

@@ -1,4 +1,5 @@
-export { A as AnyRouteRefParams, e as ApiHolder, d as ApiRef, b as AppNode, i as AppNodeEdges, j as AppNodeInstance, k as AppNodeSpec, l as AppTree, C as ConfigurableExtensionDataRef, r as Extension, s as ExtensionAttachTo, t as ExtensionBlueprint, u as ExtensionBlueprintDefineParams, v as ExtensionBlueprintParameters, w as ExtensionBlueprintParams, x as ExtensionDataContainer, y as ExtensionDataRef, z as ExtensionDataValue, B as ExtensionDefinition, D as ExtensionDefinitionAttachTo, G as ExtensionDefinitionParameters, J as ExtensionInput, E as ExternalRouteRef, c as FrontendPlugin, M as FrontendPluginInfo, I as IconElement, O as OverridableExtensionDefinition, U as PluginWrapperApi, V as PluginWrapperBlueprint, W as PluginWrapperDefinition, X as PortableSchema, R as RouteRef, S as SubRouteRef, $ as createExtensionBlueprintParams, a7 as pluginWrapperApiRef } from './types/alpha.d-CfDtkom8.js';
+export { A as AnyRouteRefParams, e as ApiHolder, d as ApiRef, b as AppNode, i as AppNodeEdges, j as AppNodeInstance, k as AppNodeSpec, l as AppTree, C as ConfigurableExtensionDataRef, r as Extension, s as ExtensionAttachTo, t as ExtensionBlueprint, u as ExtensionBlueprintDefineParams, v as ExtensionBlueprintParameters, w as ExtensionBlueprintParams, x as ExtensionDataContainer, y as ExtensionDataRef, z as ExtensionDataValue, B as ExtensionDefinition, D as ExtensionDefinitionAttachTo, G as ExtensionDefinitionParameters, J as ExtensionInput, E as ExternalRouteRef, c as FrontendPlugin, M as FrontendPluginInfo, I as IconElement, O as OverridableExtensionDefinition, U as PluginWrapperApi, V as PluginWrapperBlueprint, W as PluginWrapperDefinition, X as PortableSchema, R as RouteRef, S as SubRouteRef, $ as createExtensionBlueprintParams, a7 as pluginWrapperApiRef } from './types/alpha.d-D3gnSOzm.js';
+export { StandardSchemaV1 } from '@standard-schema/spec';
 import '@backstage/frontend-plugin-api';
 import 'react';
 import '@backstage/types';

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

@@ -1 +1 @@
-{"version":3,"file":"DialogApi.esm.js","sources":["../../../src/apis/definitions/DialogApi.ts"],"sourcesContent":["/*\n * Copyright 2025 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 '../system';\n\n/**\n * A handle for an open dialog that can be used to interact with it.\n *\n * @remarks\n *\n * Dialogs can be opened using either {@link DialogApi.show} or {@link DialogApi.showModal}.\n *\n * @public\n */\nexport interface DialogApiDialog<TResult = void> {\n  /**\n   * Closes the dialog with that provided result.\n   *\n   * @remarks\n   *\n   * If the dialog is a modal dialog a result must always be provided. If it's a regular dialog then passing a result is optional.\n   */\n  close(\n    ...args: undefined extends TResult ? [result?: TResult] : [result: TResult]\n  ): void;\n\n  /**\n   * Replaces the content of the dialog with the provided element or component, causing it to be rerenedered.\n   */\n  update(\n    elementOrComponent:\n      | JSX.Element\n      | ((props: { dialog: DialogApiDialog<TResult> }) => JSX.Element),\n  ): void;\n\n  /**\n   * Wait until the dialog is closed and return the result.\n   *\n   * @remarks\n   *\n   * If the dialog is a modal dialog a result will always be returned. If it's a regular dialog then the result may be `undefined`.\n   */\n  result(): Promise<TResult>;\n}\n\n/**\n * A Utility API for showing dialogs that render in the React tree and return a result.\n *\n * @public\n */\nexport interface DialogApi {\n  /**\n   * Opens a modal dialog and returns a handle to it.\n   *\n   * @remarks\n   *\n   * This dialog can be closed by calling the `close` method on the returned handle, optionally providing a result.\n   * The dialog can also be closed by the user by clicking the backdrop or pressing the escape key.\n   *\n   * If the dialog is closed without a result, the result will be `undefined`.\n   *\n   * @example\n   *\n   * ### Example with inline dialog content\n   * ```tsx\n   * const dialog = dialogApi.show<boolean>(\n   *   <DialogContent>\n   *     <DialogTitle>Are you sure?</DialogTitle>\n   *     <DialogActions>\n   *       <Button onClick={() => dialog.close(true)}>Yes</Button>\n   *       <Button onClick={() => dialog.close(false)}>No</Button>\n   *     </DialogActions>\n   *   </DialogContent>\n   * );\n   * const result = await dialog.result();\n   * ```\n   *\n   * @example\n   *\n   * ### Example with separate dialog component\n   * ```tsx\n   * function CustomDialog({ dialog }: { dialog: DialogApiDialog<boolean | undefined> }) {\n   *   return (\n   *     <DialogContent>\n   *       <DialogTitle>Are you sure?</DialogTitle>\n   *       <DialogActions>\n   *         <Button onClick={() => dialog.close(true)}>Yes</Button>\n   *         <Button onClick={() => dialog.close(false)}>No</Button>\n   *       </DialogActions>\n   *     </DialogContent>\n   *   )\n   * }\n   * const result = await dialogApi.show(CustomDialog).result();\n   * ```\n   *\n   * @param elementOrComponent - The element or component to render in the dialog. If a component is provided, it will be provided with a `dialog` prop that contains the dialog handle.\n   * @public\n   */\n  show<TResult = void>(\n    elementOrComponent:\n      | JSX.Element\n      | ((props: {\n          dialog: DialogApiDialog<TResult | undefined>;\n        }) => JSX.Element),\n  ): DialogApiDialog<TResult | undefined>;\n\n  /**\n   * Opens a modal dialog and returns a handle to it.\n   *\n   * @remarks\n   *\n   * This dialog can not be closed in any other way than calling the `close` method on the returned handle and providing a result.\n   *\n   * @example\n   *\n   * ### Example with inline dialog content\n   * ```tsx\n   * const dialog = dialogApi.showModal<boolean>(\n   *   <DialogContent>\n   *     <DialogTitle>Are you sure?</DialogTitle>\n   *     <DialogActions>\n   *       <Button onClick={() => dialog.close(true)}>Yes</Button>\n   *       <Button onClick={() => dialog.close(false)}>No</Button>\n   *     </DialogActions>\n   *   </DialogContent>\n   * );\n   * const result = await dialog.result();\n   * ```\n   *\n   * @example\n   *\n   * ### Example with separate dialog component\n   * ```tsx\n   * function CustomDialog({ dialog }: { dialog: DialogApiDialog<boolean> }) {\n   *   return (\n   *     <DialogContent>\n   *       <DialogTitle>Are you sure?</DialogTitle>\n   *       <DialogActions>\n   *         <Button onClick={() => dialog.close(true)}>Yes</Button>\n   *         <Button onClick={() => dialog.close(false)}>No</Button>\n   *       </DialogActions>\n   *     </DialogContent>\n   *   )\n   * }\n   * const result = await dialogApi.showModal(CustomDialog).result();\n   * ```\n   *\n   * @param elementOrComponent - The element or component to render in the dialog. If a component is provided, it will be provided with a `dialog` prop that contains the dialog handle.\n   * @public\n   */\n  showModal<TResult = void>(\n    elementOrComponent:\n      | JSX.Element\n      | ((props: { dialog: DialogApiDialog<TResult> }) => JSX.Element),\n  ): DialogApiDialog<TResult>;\n}\n\n/**\n * The `ApiRef` of {@link DialogApi}.\n *\n * @public\n */\nexport const dialogApiRef = createApiRef<DialogApi>().with({\n  id: 'core.dialog',\n  pluginId: 'app',\n});\n"],"names":[],"mappings":";;;;;AA+KO,MAAM,YAAA,GAAe,YAAA,EAAwB,CAAE,IAAA,CAAK;AAAA,EACzD,EAAA,EAAI,aAAA;AAAA,EACJ,QAAA,EAAU;AACZ,CAAC;;;;"}
+{"version":3,"file":"DialogApi.esm.js","sources":["../../../src/apis/definitions/DialogApi.ts"],"sourcesContent":["/*\n * Copyright 2025 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 '../system';\n\n/**\n * A handle for an open dialog that can be used to interact with it.\n *\n * @remarks\n *\n * Dialogs are opened using {@link DialogApi.open}.\n *\n * @public\n */\nexport interface DialogApiDialog<TResult = void> {\n  /**\n   * Closes the dialog with the provided result.\n   *\n   * @remarks\n   *\n   * Whether a result is required depends on the `TResult` type parameter\n   * chosen when the dialog was opened. If the type includes `undefined`,\n   * calling `close()` without a result is allowed.\n   */\n  close(\n    ...args: undefined extends TResult ? [result?: TResult] : [result: TResult]\n  ): void;\n\n  /**\n   * Replaces the rendered dialog with the provided element or component.\n   *\n   * @remarks\n   *\n   * Just like the element or component passed to {@link DialogApi.open}, the\n   * caller is responsible for providing the full dialog including all chrome.\n   */\n  update(\n    elementOrComponent:\n      | JSX.Element\n      | ((props: { dialog: DialogApiDialog<TResult> }) => JSX.Element),\n  ): void;\n\n  /**\n   * Wait until the dialog is closed and return the result.\n   */\n  result(): Promise<TResult>;\n}\n\n/**\n * A Utility API for showing dialogs that render in the React tree and return a result.\n *\n * @public\n */\nexport interface DialogApi {\n  /**\n   * Opens a dialog and returns a handle to it.\n   *\n   * @remarks\n   *\n   * The provided element or component is rendered as-is in the app's React tree.\n   * It is the caller's responsibility to provide all dialog chrome, such as an\n   * overlay, backdrop, and dialog surface. This makes the method agnostic to the\n   * design library used for the dialog.\n   *\n   * @example\n   *\n   * ### Example with inline dialog element\n   * ```tsx\n   * const dialog = dialogApi.open<boolean>(\n   *   <Dialog isOpen onOpenChange={isOpen => !isOpen && dialog.close()}>\n   *     <DialogHeader>Are you sure?</DialogHeader>\n   *     <DialogBody>This action cannot be undone.</DialogBody>\n   *     <DialogFooter>\n   *       <Button onPress={() => dialog.close(false)}>Cancel</Button>\n   *       <Button onPress={() => dialog.close(true)}>Confirm</Button>\n   *     </DialogFooter>\n   *   </Dialog>\n   * );\n   * const result = await dialog.result();\n   * ```\n   *\n   * @example\n   *\n   * ### Example with a dialog component\n   * ```tsx\n   * function ConfirmDialog({ dialog }: { dialog: DialogApiDialog<boolean> }) {\n   *   return (\n   *     <Dialog isOpen onOpenChange={isOpen => !isOpen && dialog.close()}>\n   *       <DialogHeader>Are you sure?</DialogHeader>\n   *       <DialogBody>This action cannot be undone.</DialogBody>\n   *       <DialogFooter>\n   *         <Button onPress={() => dialog.close(false)}>Cancel</Button>\n   *         <Button onPress={() => dialog.close(true)}>Confirm</Button>\n   *       </DialogFooter>\n   *     </Dialog>\n   *   );\n   * }\n   * const result = await dialogApi.open(ConfirmDialog).result();\n   * ```\n   *\n   * @param elementOrComponent - The element or component to render. If a component is provided, it will be provided with a `dialog` prop that contains the dialog handle.\n   */\n  open<TResult = void>(\n    elementOrComponent:\n      | JSX.Element\n      | ((props: { dialog: DialogApiDialog<TResult> }) => JSX.Element),\n  ): DialogApiDialog<TResult>;\n\n  /**\n   * Opens a dialog with built-in dialog chrome and returns a handle to it.\n   *\n   * @deprecated Use {@link DialogApi.open} instead. The `open` method does not\n   * render any dialog chrome, giving the caller full control over the dialog\n   * presentation. This avoids focus trap conflicts across design libraries.\n   *\n   * @param elementOrComponent - The element or component to render in the dialog. If a component is provided, it will be provided with a `dialog` prop that contains the dialog handle.\n   */\n  show<TResult = void>(\n    elementOrComponent:\n      | JSX.Element\n      | ((props: {\n          dialog: DialogApiDialog<TResult | undefined>;\n        }) => JSX.Element),\n  ): DialogApiDialog<TResult | undefined>;\n\n  /**\n   * Opens a modal dialog with built-in dialog chrome and returns a handle to it.\n   *\n   * @deprecated Use {@link DialogApi.open} instead. The `open` method does not\n   * render any dialog chrome, giving the caller full control over the dialog\n   * presentation. This avoids focus trap conflicts across design libraries.\n   *\n   * @param elementOrComponent - The element or component to render in the dialog. If a component is provided, it will be provided with a `dialog` prop that contains the dialog handle.\n   */\n  showModal<TResult = void>(\n    elementOrComponent:\n      | JSX.Element\n      | ((props: { dialog: DialogApiDialog<TResult> }) => JSX.Element),\n  ): DialogApiDialog<TResult>;\n}\n\n/**\n * The `ApiRef` of {@link DialogApi}.\n *\n * @public\n */\nexport const dialogApiRef = createApiRef<DialogApi>().with({\n  id: 'core.dialog',\n  pluginId: 'app',\n});\n"],"names":[],"mappings":";;;;;AA+JO,MAAM,YAAA,GAAe,YAAA,EAAwB,CAAE,IAAA,CAAK;AAAA,EACzD,EAAA,EAAI,aAAA;AAAA,EACJ,QAAA,EAAU;AACZ,CAAC;;;;"}

package/dist/blueprints/NavItemBlueprint.esm.js

@@ -1,3 +1,4 @@
+import { z } from 'zod/v4';
 import '../wiring/coreExtensionData.esm.js';
 import 'zod/v3';
 import 'zod-to-json-schema';
@@ -23,10 +24,8 @@ const NavItemBlueprint = createExtensionBlueprint({
       routeRef
     })
   ],
-  config: {
-    schema: {
-      title: (z) => z.string().optional()
-    }
+  configSchema: {
+    title: z.string().optional()
   }
 });
 

package/dist/blueprints/NavItemBlueprint.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"NavItemBlueprint.esm.js","sources":["../../src/blueprints/NavItemBlueprint.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 { IconComponent } from '../icons/types';\nimport { RouteRef } from '../routing';\nimport { createExtensionBlueprint, createExtensionDataRef } from '../wiring';\n\n// TODO(Rugvip): Should this be broken apart into separate refs? title/icon/routeRef\nconst targetDataRef = createExtensionDataRef<{\n  title: string;\n  icon: IconComponent;\n  routeRef: RouteRef<undefined>;\n}>().with({ id: 'core.nav-item.target' });\n\n/**\n * Creates extensions that make up the items of the nav bar.\n *\n * @public\n * @deprecated Nav items are now automatically inferred from `PageBlueprint`\n * extensions based on their `title` and `icon` params. You can remove your\n * `NavItemBlueprint` usage and instead pass `title` and `icon` directly to\n * the `PageBlueprint`.\n */\nexport const NavItemBlueprint = createExtensionBlueprint({\n  kind: 'nav-item',\n  attachTo: { id: 'app/nav', input: 'items' },\n  output: [targetDataRef],\n  dataRefs: {\n    target: targetDataRef,\n  },\n  factory: (\n    {\n      icon,\n      routeRef,\n      title,\n    }: {\n      title: string;\n      icon: IconComponent;\n      routeRef: RouteRef<undefined>;\n    },\n    { config },\n  ) => [\n    targetDataRef({\n      title: config.title ?? title,\n      icon,\n      routeRef,\n    }),\n  ],\n  config: {\n    schema: {\n      title: z => z.string().optional(),\n    },\n  },\n});\n"],"names":[],"mappings":";;;;;;AAqBA,MAAM,gBAAgB,sBAAA,EAInB,CAAE,KAAK,EAAE,EAAA,EAAI,wBAAwB,CAAA;AAWjC,MAAM,mBAAmB,wBAAA,CAAyB;AAAA,EACvD,IAAA,EAAM,UAAA;AAAA,EACN,QAAA,EAAU,EAAE,EAAA,EAAI,SAAA,EAAW,OAAO,OAAA,EAAQ;AAAA,EAC1C,MAAA,EAAQ,CAAC,aAAa,CAAA;AAAA,EACtB,QAAA,EAAU;AAAA,IACR,MAAA,EAAQ;AAAA,GACV;AAAA,EACA,SAAS,CACP;AAAA,IACE,IAAA;AAAA,IACA,QAAA;AAAA,IACA;AAAA,GACF,EAKA,EAAE,MAAA,EAAO,KACN;AAAA,IACH,aAAA,CAAc;AAAA,MACZ,KAAA,EAAO,OAAO,KAAA,IAAS,KAAA;AAAA,MACvB,IAAA;AAAA,MACA;AAAA,KACD;AAAA,GACH;AAAA,EACA,MAAA,EAAQ;AAAA,IACN,MAAA,EAAQ;AAAA,MACN,KAAA,EAAO,CAAA,CAAA,KAAK,CAAA,CAAE,MAAA,GAAS,QAAA;AAAS;AAClC;AAEJ,CAAC;;;;"}
+{"version":3,"file":"NavItemBlueprint.esm.js","sources":["../../src/blueprints/NavItemBlueprint.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 { z } from 'zod/v4';\nimport { IconComponent } from '../icons/types';\nimport { RouteRef } from '../routing';\nimport { createExtensionBlueprint, createExtensionDataRef } from '../wiring';\n\n// TODO(Rugvip): Should this be broken apart into separate refs? title/icon/routeRef\nconst targetDataRef = createExtensionDataRef<{\n  title: string;\n  icon: IconComponent;\n  routeRef: RouteRef<undefined>;\n}>().with({ id: 'core.nav-item.target' });\n\n/**\n * Creates extensions that make up the items of the nav bar.\n *\n * @public\n * @deprecated Nav items are now automatically inferred from `PageBlueprint`\n * extensions based on their `title` and `icon` params. You can remove your\n * `NavItemBlueprint` usage and instead pass `title` and `icon` directly to\n * the `PageBlueprint`.\n */\nexport const NavItemBlueprint = createExtensionBlueprint({\n  kind: 'nav-item',\n  attachTo: { id: 'app/nav', input: 'items' },\n  output: [targetDataRef],\n  dataRefs: {\n    target: targetDataRef,\n  },\n  factory: (\n    {\n      icon,\n      routeRef,\n      title,\n    }: {\n      title: string;\n      icon: IconComponent;\n      routeRef: RouteRef<undefined>;\n    },\n    { config },\n  ) => [\n    targetDataRef({\n      title: config.title ?? title,\n      icon,\n      routeRef,\n    }),\n  ],\n  configSchema: {\n    title: z.string().optional(),\n  },\n});\n"],"names":[],"mappings":";;;;;;;AAsBA,MAAM,gBAAgB,sBAAA,EAInB,CAAE,KAAK,EAAE,EAAA,EAAI,wBAAwB,CAAA;AAWjC,MAAM,mBAAmB,wBAAA,CAAyB;AAAA,EACvD,IAAA,EAAM,UAAA;AAAA,EACN,QAAA,EAAU,EAAE,EAAA,EAAI,SAAA,EAAW,OAAO,OAAA,EAAQ;AAAA,EAC1C,MAAA,EAAQ,CAAC,aAAa,CAAA;AAAA,EACtB,QAAA,EAAU;AAAA,IACR,MAAA,EAAQ;AAAA,GACV;AAAA,EACA,SAAS,CACP;AAAA,IACE,IAAA;AAAA,IACA,QAAA;AAAA,IACA;AAAA,GACF,EAKA,EAAE,MAAA,EAAO,KACN;AAAA,IACH,aAAA,CAAc;AAAA,MACZ,KAAA,EAAO,OAAO,KAAA,IAAS,KAAA;AAAA,MACvB,IAAA;AAAA,MACA;AAAA,KACD;AAAA,GACH;AAAA,EACA,YAAA,EAAc;AAAA,IACZ,KAAA,EAAO,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA;AAAS;AAE/B,CAAC;;;;"}

package/dist/blueprints/PageBlueprint.esm.js

@@ -1,4 +1,5 @@
 import { jsx, jsxs } from 'react/jsx-runtime';
+import { z } from 'zod/v4';
 import { Routes, Route, Navigate } from 'react-router-dom';
 import { coreExtensionData } from '../wiring/coreExtensionData.esm.js';
 import 'zod/v3';
@@ -63,11 +64,9 @@ const PageBlueprint = createExtensionBlueprint({
     coreExtensionData.title.optional(),
     coreExtensionData.icon.optional()
   ],
-  config: {
-    schema: {
-      path: (z) => z.string().optional(),
-      title: (z) => z.string().optional()
-    }
+  configSchema: {
+    path: z.string().optional(),
+    title: z.string().optional()
   },
   *factory(params, { config, node, inputs }) {
     const title = config.title ?? params.title;

package/dist/blueprints/PageBlueprint.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"PageBlueprint.esm.js","sources":["../../src/blueprints/PageBlueprint.tsx"],"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 { JSX } from 'react';\nimport { Routes, Route, Navigate } from 'react-router-dom';\nimport { IconElement } from '../icons/types';\nimport { RouteRef } from '../routing';\nimport {\n  coreExtensionData,\n  createExtensionBlueprint,\n  createExtensionInput,\n} from '../wiring';\nimport { ExtensionBoundary, PageLayout, PageLayoutTab } from '../components';\nimport { useApi } from '../apis/system';\nimport { routeResolutionApiRef } from '../apis/definitions/RouteResolutionApi';\nimport { pluginHeaderActionsApiRef } from '../apis/definitions/PluginHeaderActionsApi';\nimport { RouteResolutionApi } from '../apis/definitions/RouteResolutionApi';\n\nfunction resolveTitleLink(\n  routeResolutionApi: RouteResolutionApi,\n  routeRef: RouteRef | undefined,\n): string | undefined {\n  if (!routeRef) {\n    return undefined;\n  }\n  try {\n    return routeResolutionApi.resolve(routeRef)?.();\n  } catch {\n    // Route ref may require params not available in the current context\n    return undefined;\n  }\n}\n\n/**\n * Creates extensions that are routable React page components.\n *\n * @public\n */\nexport const PageBlueprint = createExtensionBlueprint({\n  kind: 'page',\n  attachTo: { id: 'app/routes', input: 'routes' },\n  inputs: {\n    pages: createExtensionInput([\n      coreExtensionData.routePath,\n      coreExtensionData.routeRef.optional(),\n      coreExtensionData.reactElement,\n      coreExtensionData.title.optional(),\n      coreExtensionData.icon.optional(),\n    ]),\n  },\n  output: [\n    coreExtensionData.routePath,\n    coreExtensionData.reactElement,\n    coreExtensionData.routeRef.optional(),\n    coreExtensionData.title.optional(),\n    coreExtensionData.icon.optional(),\n  ],\n  config: {\n    schema: {\n      path: z => z.string().optional(),\n      title: z => z.string().optional(),\n    },\n  },\n  *factory(\n    params: {\n      path: string;\n      title?: string;\n      icon?: IconElement;\n      loader?: () => Promise<JSX.Element>;\n      routeRef?: RouteRef;\n      /**\n       * Hide the default plugin page header, making the page fill up all available space.\n       */\n      noHeader?: boolean;\n    },\n    { config, node, inputs },\n  ) {\n    const title = config.title ?? params.title;\n    const icon = params.icon;\n    const pluginId = node.spec.plugin.pluginId;\n    const noHeader = params.noHeader ?? false;\n    const resolvedTitle =\n      title ?? node.spec.plugin.title ?? node.spec.plugin.pluginId;\n    const resolvedIcon = icon ?? node.spec.plugin.icon;\n    const titleRouteRef =\n      (node.spec.plugin.routes as { root?: RouteRef }).root ?? params.routeRef;\n\n    yield coreExtensionData.routePath(config.path ?? params.path);\n    if (params.loader) {\n      const loader = params.loader;\n      const PageContent = () => {\n        const routeResolutionApi = useApi(routeResolutionApiRef);\n        const titleLink = resolveTitleLink(routeResolutionApi, titleRouteRef);\n        const headerActionsApi = useApi(pluginHeaderActionsApiRef);\n        const headerActions = headerActionsApi.getPluginHeaderActions(pluginId);\n\n        return (\n          <PageLayout\n            title={resolvedTitle}\n            icon={resolvedIcon}\n            noHeader={noHeader}\n            titleLink={titleLink}\n            headerActions={headerActions}\n          >\n            {ExtensionBoundary.lazy(node, loader)}\n          </PageLayout>\n        );\n      };\n      yield coreExtensionData.reactElement(<PageContent />);\n    } else if (inputs.pages.length > 0) {\n      // Parent page with sub-pages - render header with tabs\n      const tabs: PageLayoutTab[] = inputs.pages.map(page => {\n        const path = page.get(coreExtensionData.routePath);\n        const tabTitle = page.get(coreExtensionData.title);\n        const tabIcon = page.get(coreExtensionData.icon);\n        return {\n          id: path,\n          label: tabTitle || path,\n          icon: tabIcon,\n          href: path,\n        };\n      });\n\n      const PageContent = () => {\n        const firstPagePath = inputs.pages[0]?.get(coreExtensionData.routePath);\n        const routeResolutionApi = useApi(routeResolutionApiRef);\n        const titleLink = resolveTitleLink(routeResolutionApi, titleRouteRef);\n\n        const headerActionsApi = useApi(pluginHeaderActionsApiRef);\n        const headerActions = headerActionsApi.getPluginHeaderActions(pluginId);\n\n        return (\n          <PageLayout\n            title={resolvedTitle}\n            icon={resolvedIcon}\n            tabs={tabs}\n            titleLink={titleLink}\n            headerActions={headerActions}\n          >\n            <Routes>\n              {firstPagePath && (\n                <Route\n                  index\n                  element={<Navigate to={firstPagePath} replace />}\n                />\n              )}\n              {inputs.pages.map((page, index) => {\n                const path = page.get(coreExtensionData.routePath);\n                const element = page.get(coreExtensionData.reactElement);\n                return (\n                  <Route key={index} path={`${path}/*`} element={element} />\n                );\n              })}\n            </Routes>\n          </PageLayout>\n        );\n      };\n\n      yield coreExtensionData.reactElement(<PageContent />);\n    } else {\n      const PageContent = () => {\n        const routeResolutionApi = useApi(routeResolutionApiRef);\n        const titleLink = resolveTitleLink(routeResolutionApi, titleRouteRef);\n        const headerActionsApi = useApi(pluginHeaderActionsApiRef);\n        const headerActions = headerActionsApi.getPluginHeaderActions(pluginId);\n        return (\n          <PageLayout\n            title={resolvedTitle}\n            icon={resolvedIcon}\n            titleLink={titleLink}\n            headerActions={headerActions}\n          />\n        );\n      };\n      yield coreExtensionData.reactElement(<PageContent />);\n    }\n    if (params.routeRef) {\n      yield coreExtensionData.routeRef(params.routeRef);\n    }\n    if (title) {\n      yield coreExtensionData.title(title);\n    }\n    if (icon) {\n      yield coreExtensionData.icon(icon);\n    }\n  },\n});\n"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,SAAS,gBAAA,CACP,oBACA,QAAA,EACoB;AACpB,EAAA,IAAI,CAAC,QAAA,EAAU;AACb,IAAA,OAAO,MAAA;AAAA,EACT;AACA,EAAA,IAAI;AACF,IAAA,OAAO,kBAAA,CAAmB,OAAA,CAAQ,QAAQ,CAAA,IAAI;AAAA,EAChD,CAAA,CAAA,MAAQ;AAEN,IAAA,OAAO,MAAA;AAAA,EACT;AACF;AAOO,MAAM,gBAAgB,wBAAA,CAAyB;AAAA,EACpD,IAAA,EAAM,MAAA;AAAA,EACN,QAAA,EAAU,EAAE,EAAA,EAAI,YAAA,EAAc,OAAO,QAAA,EAAS;AAAA,EAC9C,MAAA,EAAQ;AAAA,IACN,OAAO,oBAAA,CAAqB;AAAA,MAC1B,iBAAA,CAAkB,SAAA;AAAA,MAClB,iBAAA,CAAkB,SAAS,QAAA,EAAS;AAAA,MACpC,iBAAA,CAAkB,YAAA;AAAA,MAClB,iBAAA,CAAkB,MAAM,QAAA,EAAS;AAAA,MACjC,iBAAA,CAAkB,KAAK,QAAA;AAAS,KACjC;AAAA,GACH;AAAA,EACA,MAAA,EAAQ;AAAA,IACN,iBAAA,CAAkB,SAAA;AAAA,IAClB,iBAAA,CAAkB,YAAA;AAAA,IAClB,iBAAA,CAAkB,SAAS,QAAA,EAAS;AAAA,IACpC,iBAAA,CAAkB,MAAM,QAAA,EAAS;AAAA,IACjC,iBAAA,CAAkB,KAAK,QAAA;AAAS,GAClC;AAAA,EACA,MAAA,EAAQ;AAAA,IACN,MAAA,EAAQ;AAAA,MACN,IAAA,EAAM,CAAA,CAAA,KAAK,CAAA,CAAE,MAAA,GAAS,QAAA,EAAS;AAAA,MAC/B,KAAA,EAAO,CAAA,CAAA,KAAK,CAAA,CAAE,MAAA,GAAS,QAAA;AAAS;AAClC,GACF;AAAA,EACA,CAAC,OAAA,CACC,MAAA,EAWA,EAAE,MAAA,EAAQ,IAAA,EAAM,QAAO,EACvB;AACA,IAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,KAAA,IAAS,MAAA,CAAO,KAAA;AACrC,IAAA,MAAM,OAAO,MAAA,CAAO,IAAA;AACpB,IAAA,MAAM,QAAA,GAAW,IAAA,CAAK,IAAA,CAAK,MAAA,CAAO,QAAA;AAClC,IAAA,MAAM,QAAA,GAAW,OAAO,QAAA,IAAY,KAAA;AACpC,IAAA,MAAM,aAAA,GACJ,SAAS,IAAA,CAAK,IAAA,CAAK,OAAO,KAAA,IAAS,IAAA,CAAK,KAAK,MAAA,CAAO,QAAA;AACtD,IAAA,MAAM,YAAA,GAAe,IAAA,IAAQ,IAAA,CAAK,IAAA,CAAK,MAAA,CAAO,IAAA;AAC9C,IAAA,MAAM,gBACH,IAAA,CAAK,IAAA,CAAK,MAAA,CAAO,MAAA,CAA+B,QAAQ,MAAA,CAAO,QAAA;AAElE,IAAA,MAAM,iBAAA,CAAkB,SAAA,CAAU,MAAA,CAAO,IAAA,IAAQ,OAAO,IAAI,CAAA;AAC5D,IAAA,IAAI,OAAO,MAAA,EAAQ;AACjB,MAAA,MAAM,SAAS,MAAA,CAAO,MAAA;AACtB,MAAA,MAAM,cAAc,MAAM;AACxB,QAAA,MAAM,kBAAA,GAAqB,OAAO,qBAAqB,CAAA;AACvD,QAAA,MAAM,SAAA,GAAY,gBAAA,CAAiB,kBAAA,EAAoB,aAAa,CAAA;AACpE,QAAA,MAAM,gBAAA,GAAmB,OAAO,yBAAyB,CAAA;AACzD,QAAA,MAAM,aAAA,GAAgB,gBAAA,CAAiB,sBAAA,CAAuB,QAAQ,CAAA;AAEtE,QAAA,uBACE,GAAA;AAAA,UAAC,UAAA;AAAA,UAAA;AAAA,YACC,KAAA,EAAO,aAAA;AAAA,YACP,IAAA,EAAM,YAAA;AAAA,YACN,QAAA;AAAA,YACA,SAAA;AAAA,YACA,aAAA;AAAA,YAEC,QAAA,EAAA,iBAAA,CAAkB,IAAA,CAAK,IAAA,EAAM,MAAM;AAAA;AAAA,SACtC;AAAA,MAEJ,CAAA;AACA,MAAA,MAAM,iBAAA,CAAkB,YAAA,iBAAa,GAAA,CAAC,WAAA,EAAA,EAAY,CAAE,CAAA;AAAA,IACtD,CAAA,MAAA,IAAW,MAAA,CAAO,KAAA,CAAM,MAAA,GAAS,CAAA,EAAG;AAElC,MAAA,MAAM,IAAA,GAAwB,MAAA,CAAO,KAAA,CAAM,GAAA,CAAI,CAAA,IAAA,KAAQ;AACrD,QAAA,MAAM,IAAA,GAAO,IAAA,CAAK,GAAA,CAAI,iBAAA,CAAkB,SAAS,CAAA;AACjD,QAAA,MAAM,QAAA,GAAW,IAAA,CAAK,GAAA,CAAI,iBAAA,CAAkB,KAAK,CAAA;AACjD,QAAA,MAAM,OAAA,GAAU,IAAA,CAAK,GAAA,CAAI,iBAAA,CAAkB,IAAI,CAAA;AAC/C,QAAA,OAAO;AAAA,UACL,EAAA,EAAI,IAAA;AAAA,UACJ,OAAO,QAAA,IAAY,IAAA;AAAA,UACnB,IAAA,EAAM,OAAA;AAAA,UACN,IAAA,EAAM;AAAA,SACR;AAAA,MACF,CAAC,CAAA;AAED,MAAA,MAAM,cAAc,MAAM;AACxB,QAAA,MAAM,gBAAgB,MAAA,CAAO,KAAA,CAAM,CAAC,CAAA,EAAG,GAAA,CAAI,kBAAkB,SAAS,CAAA;AACtE,QAAA,MAAM,kBAAA,GAAqB,OAAO,qBAAqB,CAAA;AACvD,QAAA,MAAM,SAAA,GAAY,gBAAA,CAAiB,kBAAA,EAAoB,aAAa,CAAA;AAEpE,QAAA,MAAM,gBAAA,GAAmB,OAAO,yBAAyB,CAAA;AACzD,QAAA,MAAM,aAAA,GAAgB,gBAAA,CAAiB,sBAAA,CAAuB,QAAQ,CAAA;AAEtE,QAAA,uBACE,GAAA;AAAA,UAAC,UAAA;AAAA,UAAA;AAAA,YACC,KAAA,EAAO,aAAA;AAAA,YACP,IAAA,EAAM,YAAA;AAAA,YACN,IAAA;AAAA,YACA,SAAA;AAAA,YACA,aAAA;AAAA,YAEA,+BAAC,MAAA,EAAA,EACE,QAAA,EAAA;AAAA,cAAA,aAAA,oBACC,GAAA;AAAA,gBAAC,KAAA;AAAA,gBAAA;AAAA,kBACC,KAAA,EAAK,IAAA;AAAA,kBACL,yBAAS,GAAA,CAAC,QAAA,EAAA,EAAS,EAAA,EAAI,aAAA,EAAe,SAAO,IAAA,EAAC;AAAA;AAAA,eAChD;AAAA,cAED,MAAA,CAAO,KAAA,CAAM,GAAA,CAAI,CAAC,MAAM,KAAA,KAAU;AACjC,gBAAA,MAAM,IAAA,GAAO,IAAA,CAAK,GAAA,CAAI,iBAAA,CAAkB,SAAS,CAAA;AACjD,gBAAA,MAAM,OAAA,GAAU,IAAA,CAAK,GAAA,CAAI,iBAAA,CAAkB,YAAY,CAAA;AACvD,gBAAA,2BACG,KAAA,EAAA,EAAkB,IAAA,EAAM,GAAG,IAAI,CAAA,EAAA,CAAA,EAAM,WAA1B,KAA4C,CAAA;AAAA,cAE5D,CAAC;AAAA,aAAA,EACH;AAAA;AAAA,SACF;AAAA,MAEJ,CAAA;AAEA,MAAA,MAAM,iBAAA,CAAkB,YAAA,iBAAa,GAAA,CAAC,WAAA,EAAA,EAAY,CAAE,CAAA;AAAA,IACtD,CAAA,MAAO;AACL,MAAA,MAAM,cAAc,MAAM;AACxB,QAAA,MAAM,kBAAA,GAAqB,OAAO,qBAAqB,CAAA;AACvD,QAAA,MAAM,SAAA,GAAY,gBAAA,CAAiB,kBAAA,EAAoB,aAAa,CAAA;AACpE,QAAA,MAAM,gBAAA,GAAmB,OAAO,yBAAyB,CAAA;AACzD,QAAA,MAAM,aAAA,GAAgB,gBAAA,CAAiB,sBAAA,CAAuB,QAAQ,CAAA;AACtE,QAAA,uBACE,GAAA;AAAA,UAAC,UAAA;AAAA,UAAA;AAAA,YACC,KAAA,EAAO,aAAA;AAAA,YACP,IAAA,EAAM,YAAA;AAAA,YACN,SAAA;AAAA,YACA;AAAA;AAAA,SACF;AAAA,MAEJ,CAAA;AACA,MAAA,MAAM,iBAAA,CAAkB,YAAA,iBAAa,GAAA,CAAC,WAAA,EAAA,EAAY,CAAE,CAAA;AAAA,IACtD;AACA,IAAA,IAAI,OAAO,QAAA,EAAU;AACnB,MAAA,MAAM,iBAAA,CAAkB,QAAA,CAAS,MAAA,CAAO,QAAQ,CAAA;AAAA,IAClD;AACA,IAAA,IAAI,KAAA,EAAO;AACT,MAAA,MAAM,iBAAA,CAAkB,MAAM,KAAK,CAAA;AAAA,IACrC;AACA,IAAA,IAAI,IAAA,EAAM;AACR,MAAA,MAAM,iBAAA,CAAkB,KAAK,IAAI,CAAA;AAAA,IACnC;AAAA,EACF;AACF,CAAC;;;;"}
+{"version":3,"file":"PageBlueprint.esm.js","sources":["../../src/blueprints/PageBlueprint.tsx"],"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 { z } from 'zod/v4';\nimport { JSX } from 'react';\nimport { Routes, Route, Navigate } from 'react-router-dom';\nimport { IconElement } from '../icons/types';\nimport { RouteRef } from '../routing';\nimport {\n  coreExtensionData,\n  createExtensionBlueprint,\n  createExtensionInput,\n} from '../wiring';\nimport { ExtensionBoundary, PageLayout, PageLayoutTab } from '../components';\nimport { useApi } from '../apis/system';\nimport { routeResolutionApiRef } from '../apis/definitions/RouteResolutionApi';\nimport { pluginHeaderActionsApiRef } from '../apis/definitions/PluginHeaderActionsApi';\nimport { RouteResolutionApi } from '../apis/definitions/RouteResolutionApi';\n\nfunction resolveTitleLink(\n  routeResolutionApi: RouteResolutionApi,\n  routeRef: RouteRef | undefined,\n): string | undefined {\n  if (!routeRef) {\n    return undefined;\n  }\n  try {\n    return routeResolutionApi.resolve(routeRef)?.();\n  } catch {\n    // Route ref may require params not available in the current context\n    return undefined;\n  }\n}\n\n/**\n * Creates extensions that are routable React page components.\n *\n * @public\n */\nexport const PageBlueprint = createExtensionBlueprint({\n  kind: 'page',\n  attachTo: { id: 'app/routes', input: 'routes' },\n  inputs: {\n    pages: createExtensionInput([\n      coreExtensionData.routePath,\n      coreExtensionData.routeRef.optional(),\n      coreExtensionData.reactElement,\n      coreExtensionData.title.optional(),\n      coreExtensionData.icon.optional(),\n    ]),\n  },\n  output: [\n    coreExtensionData.routePath,\n    coreExtensionData.reactElement,\n    coreExtensionData.routeRef.optional(),\n    coreExtensionData.title.optional(),\n    coreExtensionData.icon.optional(),\n  ],\n  configSchema: {\n    path: z.string().optional(),\n    title: z.string().optional(),\n  },\n  *factory(\n    params: {\n      path: string;\n      title?: string;\n      icon?: IconElement;\n      loader?: () => Promise<JSX.Element>;\n      routeRef?: RouteRef;\n      /**\n       * Hide the default plugin page header, making the page fill up all available space.\n       */\n      noHeader?: boolean;\n    },\n    { config, node, inputs },\n  ) {\n    const title = config.title ?? params.title;\n    const icon = params.icon;\n    const pluginId = node.spec.plugin.pluginId;\n    const noHeader = params.noHeader ?? false;\n    const resolvedTitle =\n      title ?? node.spec.plugin.title ?? node.spec.plugin.pluginId;\n    const resolvedIcon = icon ?? node.spec.plugin.icon;\n    const titleRouteRef =\n      (node.spec.plugin.routes as { root?: RouteRef }).root ?? params.routeRef;\n\n    yield coreExtensionData.routePath(config.path ?? params.path);\n    if (params.loader) {\n      const loader = params.loader;\n      const PageContent = () => {\n        const routeResolutionApi = useApi(routeResolutionApiRef);\n        const titleLink = resolveTitleLink(routeResolutionApi, titleRouteRef);\n        const headerActionsApi = useApi(pluginHeaderActionsApiRef);\n        const headerActions = headerActionsApi.getPluginHeaderActions(pluginId);\n\n        return (\n          <PageLayout\n            title={resolvedTitle}\n            icon={resolvedIcon}\n            noHeader={noHeader}\n            titleLink={titleLink}\n            headerActions={headerActions}\n          >\n            {ExtensionBoundary.lazy(node, loader)}\n          </PageLayout>\n        );\n      };\n      yield coreExtensionData.reactElement(<PageContent />);\n    } else if (inputs.pages.length > 0) {\n      // Parent page with sub-pages - render header with tabs\n      const tabs: PageLayoutTab[] = inputs.pages.map(page => {\n        const path = page.get(coreExtensionData.routePath);\n        const tabTitle = page.get(coreExtensionData.title);\n        const tabIcon = page.get(coreExtensionData.icon);\n        return {\n          id: path,\n          label: tabTitle || path,\n          icon: tabIcon,\n          href: path,\n        };\n      });\n\n      const PageContent = () => {\n        const firstPagePath = inputs.pages[0]?.get(coreExtensionData.routePath);\n        const routeResolutionApi = useApi(routeResolutionApiRef);\n        const titleLink = resolveTitleLink(routeResolutionApi, titleRouteRef);\n\n        const headerActionsApi = useApi(pluginHeaderActionsApiRef);\n        const headerActions = headerActionsApi.getPluginHeaderActions(pluginId);\n\n        return (\n          <PageLayout\n            title={resolvedTitle}\n            icon={resolvedIcon}\n            tabs={tabs}\n            titleLink={titleLink}\n            headerActions={headerActions}\n          >\n            <Routes>\n              {firstPagePath && (\n                <Route\n                  index\n                  element={<Navigate to={firstPagePath} replace />}\n                />\n              )}\n              {inputs.pages.map((page, index) => {\n                const path = page.get(coreExtensionData.routePath);\n                const element = page.get(coreExtensionData.reactElement);\n                return (\n                  <Route key={index} path={`${path}/*`} element={element} />\n                );\n              })}\n            </Routes>\n          </PageLayout>\n        );\n      };\n\n      yield coreExtensionData.reactElement(<PageContent />);\n    } else {\n      const PageContent = () => {\n        const routeResolutionApi = useApi(routeResolutionApiRef);\n        const titleLink = resolveTitleLink(routeResolutionApi, titleRouteRef);\n        const headerActionsApi = useApi(pluginHeaderActionsApiRef);\n        const headerActions = headerActionsApi.getPluginHeaderActions(pluginId);\n        return (\n          <PageLayout\n            title={resolvedTitle}\n            icon={resolvedIcon}\n            titleLink={titleLink}\n            headerActions={headerActions}\n          />\n        );\n      };\n      yield coreExtensionData.reactElement(<PageContent />);\n    }\n    if (params.routeRef) {\n      yield coreExtensionData.routeRef(params.routeRef);\n    }\n    if (title) {\n      yield coreExtensionData.title(title);\n    }\n    if (icon) {\n      yield coreExtensionData.icon(icon);\n    }\n  },\n});\n"],"names":[],"mappings":"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"}

package/dist/blueprints/SubPageBlueprint.esm.js

@@ -1,3 +1,4 @@
+import { z } from 'zod/v4';
 import { coreExtensionData } from '../wiring/coreExtensionData.esm.js';
 import 'zod/v3';
 import 'zod-to-json-schema';
@@ -43,11 +44,9 @@ const SubPageBlueprint = createExtensionBlueprint({
     coreExtensionData.routeRef.optional(),
     coreExtensionData.icon.optional()
   ],
-  config: {
-    schema: {
-      path: (z) => z.string().optional(),
-      title: (z) => z.string().optional()
-    }
+  configSchema: {
+    path: z.string().optional(),
+    title: z.string().optional()
   },
   *factory(params, { config, node }) {
     yield coreExtensionData.routePath(config.path ?? params.path);

package/dist/blueprints/SubPageBlueprint.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"SubPageBlueprint.esm.js","sources":["../../src/blueprints/SubPageBlueprint.tsx"],"sourcesContent":["/*\n * Copyright 2026 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 { IconElement } from '../icons/types';\nimport { RouteRef } from '../routing';\nimport { coreExtensionData, createExtensionBlueprint } from '../wiring';\nimport { ExtensionBoundary } from '../components';\n\n/**\n * Creates extensions that are sub-page React components attached to a parent page.\n * Sub-pages are rendered as tabs within the parent page's header.\n *\n * @public\n * @example\n * ```tsx\n * const overviewRouteRef = createRouteRef();\n *\n * const mySubPage = SubPageBlueprint.make({\n *   attachTo: { id: 'page:my-plugin', input: 'pages' },\n *   name: 'overview',\n *   params: {\n *     path: 'overview',\n *     title: 'Overview',\n *     routeRef: overviewRouteRef,\n *     loader: () => import('./components/Overview').then(m => <m.Overview />),\n *   },\n * });\n * ```\n */\nexport const SubPageBlueprint = createExtensionBlueprint({\n  kind: 'sub-page',\n  attachTo: { relative: { kind: 'page' }, input: 'pages' },\n  output: [\n    coreExtensionData.routePath,\n    coreExtensionData.reactElement,\n    coreExtensionData.title,\n    coreExtensionData.routeRef.optional(),\n    coreExtensionData.icon.optional(),\n  ],\n  config: {\n    schema: {\n      path: z => z.string().optional(),\n      title: z => z.string().optional(),\n    },\n  },\n  *factory(\n    params: {\n      /**\n       * The path for this sub-page, relative to the parent page. Must **not** start with '/'.\n       *\n       * @example 'overview', 'settings', 'details'\n       */\n      path: string;\n      /**\n       * The title displayed in the tab for this sub-page.\n       */\n      title: string;\n      /**\n       * Optional icon for this sub-page, displayed in the tab.\n       */\n      icon?: IconElement;\n      /**\n       * A function that returns a promise resolving to the React element to render.\n       * This enables lazy loading of the sub-page content.\n       */\n      loader: () => Promise<JSX.Element>;\n      /**\n       * Optional route reference for this sub-page.\n       */\n      routeRef?: RouteRef;\n    },\n    { config, node },\n  ) {\n    yield coreExtensionData.routePath(config.path ?? params.path);\n    yield coreExtensionData.title(config.title ?? params.title);\n    yield coreExtensionData.reactElement(\n      ExtensionBoundary.lazy(node, params.loader),\n    );\n    if (params.routeRef) {\n      yield coreExtensionData.routeRef(params.routeRef);\n    }\n    if (params.icon) {\n      yield coreExtensionData.icon(params.icon);\n    }\n  },\n});\n"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0CO,MAAM,mBAAmB,wBAAA,CAAyB;AAAA,EACvD,IAAA,EAAM,UAAA;AAAA,EACN,QAAA,EAAU,EAAE,QAAA,EAAU,EAAE,MAAM,MAAA,EAAO,EAAG,OAAO,OAAA,EAAQ;AAAA,EACvD,MAAA,EAAQ;AAAA,IACN,iBAAA,CAAkB,SAAA;AAAA,IAClB,iBAAA,CAAkB,YAAA;AAAA,IAClB,iBAAA,CAAkB,KAAA;AAAA,IAClB,iBAAA,CAAkB,SAAS,QAAA,EAAS;AAAA,IACpC,iBAAA,CAAkB,KAAK,QAAA;AAAS,GAClC;AAAA,EACA,MAAA,EAAQ;AAAA,IACN,MAAA,EAAQ;AAAA,MACN,IAAA,EAAM,CAAA,CAAA,KAAK,CAAA,CAAE,MAAA,GAAS,QAAA,EAAS;AAAA,MAC/B,KAAA,EAAO,CAAA,CAAA,KAAK,CAAA,CAAE,MAAA,GAAS,QAAA;AAAS;AAClC,GACF;AAAA,EACA,CAAC,OAAA,CACC,MAAA,EAyBA,EAAE,MAAA,EAAQ,MAAK,EACf;AACA,IAAA,MAAM,iBAAA,CAAkB,SAAA,CAAU,MAAA,CAAO,IAAA,IAAQ,OAAO,IAAI,CAAA;AAC5D,IAAA,MAAM,iBAAA,CAAkB,KAAA,CAAM,MAAA,CAAO,KAAA,IAAS,OAAO,KAAK,CAAA;AAC1D,IAAA,MAAM,iBAAA,CAAkB,YAAA;AAAA,MACtB,iBAAA,CAAkB,IAAA,CAAK,IAAA,EAAM,MAAA,CAAO,MAAM;AAAA,KAC5C;AACA,IAAA,IAAI,OAAO,QAAA,EAAU;AACnB,MAAA,MAAM,iBAAA,CAAkB,QAAA,CAAS,MAAA,CAAO,QAAQ,CAAA;AAAA,IAClD;AACA,IAAA,IAAI,OAAO,IAAA,EAAM;AACf,MAAA,MAAM,iBAAA,CAAkB,IAAA,CAAK,MAAA,CAAO,IAAI,CAAA;AAAA,IAC1C;AAAA,EACF;AACF,CAAC;;;;"}
+{"version":3,"file":"SubPageBlueprint.esm.js","sources":["../../src/blueprints/SubPageBlueprint.tsx"],"sourcesContent":["/*\n * Copyright 2026 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 { z } from 'zod/v4';\nimport { IconElement } from '../icons/types';\nimport { RouteRef } from '../routing';\nimport { coreExtensionData, createExtensionBlueprint } from '../wiring';\nimport { ExtensionBoundary } from '../components';\n\n/**\n * Creates extensions that are sub-page React components attached to a parent page.\n * Sub-pages are rendered as tabs within the parent page's header.\n *\n * @public\n * @example\n * ```tsx\n * const overviewRouteRef = createRouteRef();\n *\n * const mySubPage = SubPageBlueprint.make({\n *   attachTo: { id: 'page:my-plugin', input: 'pages' },\n *   name: 'overview',\n *   params: {\n *     path: 'overview',\n *     title: 'Overview',\n *     routeRef: overviewRouteRef,\n *     loader: () => import('./components/Overview').then(m => <m.Overview />),\n *   },\n * });\n * ```\n */\nexport const SubPageBlueprint = createExtensionBlueprint({\n  kind: 'sub-page',\n  attachTo: { relative: { kind: 'page' }, input: 'pages' },\n  output: [\n    coreExtensionData.routePath,\n    coreExtensionData.reactElement,\n    coreExtensionData.title,\n    coreExtensionData.routeRef.optional(),\n    coreExtensionData.icon.optional(),\n  ],\n  configSchema: {\n    path: z.string().optional(),\n    title: z.string().optional(),\n  },\n  *factory(\n    params: {\n      /**\n       * The path for this sub-page, relative to the parent page. Must **not** start with '/'.\n       *\n       * @example 'overview', 'settings', 'details'\n       */\n      path: string;\n      /**\n       * The title displayed in the tab for this sub-page.\n       */\n      title: string;\n      /**\n       * Optional icon for this sub-page, displayed in the tab.\n       */\n      icon?: IconElement;\n      /**\n       * A function that returns a promise resolving to the React element to render.\n       * This enables lazy loading of the sub-page content.\n       */\n      loader: () => Promise<JSX.Element>;\n      /**\n       * Optional route reference for this sub-page.\n       */\n      routeRef?: RouteRef;\n    },\n    { config, node },\n  ) {\n    yield coreExtensionData.routePath(config.path ?? params.path);\n    yield coreExtensionData.title(config.title ?? params.title);\n    yield coreExtensionData.reactElement(\n      ExtensionBoundary.lazy(node, params.loader),\n    );\n    if (params.routeRef) {\n      yield coreExtensionData.routeRef(params.routeRef);\n    }\n    if (params.icon) {\n      yield coreExtensionData.icon(params.icon);\n    }\n  },\n});\n"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2CO,MAAM,mBAAmB,wBAAA,CAAyB;AAAA,EACvD,IAAA,EAAM,UAAA;AAAA,EACN,QAAA,EAAU,EAAE,QAAA,EAAU,EAAE,MAAM,MAAA,EAAO,EAAG,OAAO,OAAA,EAAQ;AAAA,EACvD,MAAA,EAAQ;AAAA,IACN,iBAAA,CAAkB,SAAA;AAAA,IAClB,iBAAA,CAAkB,YAAA;AAAA,IAClB,iBAAA,CAAkB,KAAA;AAAA,IAClB,iBAAA,CAAkB,SAAS,QAAA,EAAS;AAAA,IACpC,iBAAA,CAAkB,KAAK,QAAA;AAAS,GAClC;AAAA,EACA,YAAA,EAAc;AAAA,IACZ,IAAA,EAAM,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,IAC1B,KAAA,EAAO,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA;AAAS,GAC7B;AAAA,EACA,CAAC,OAAA,CACC,MAAA,EAyBA,EAAE,MAAA,EAAQ,MAAK,EACf;AACA,IAAA,MAAM,iBAAA,CAAkB,SAAA,CAAU,MAAA,CAAO,IAAA,IAAQ,OAAO,IAAI,CAAA;AAC5D,IAAA,MAAM,iBAAA,CAAkB,KAAA,CAAM,MAAA,CAAO,KAAA,IAAS,OAAO,KAAK,CAAA;AAC1D,IAAA,MAAM,iBAAA,CAAkB,YAAA;AAAA,MACtB,iBAAA,CAAkB,IAAA,CAAK,IAAA,EAAM,MAAA,CAAO,MAAM;AAAA,KAC5C;AACA,IAAA,IAAI,OAAO,QAAA,EAAU;AACnB,MAAA,MAAM,iBAAA,CAAkB,QAAA,CAAS,MAAA,CAAO,QAAQ,CAAA;AAAA,IAClD;AACA,IAAA,IAAI,OAAO,IAAA,EAAM;AACf,MAAA,MAAM,iBAAA,CAAkB,IAAA,CAAK,MAAA,CAAO,IAAI,CAAA;AAAA,IAC1C;AAAA,EACF;AACF,CAAC;;;;"}

package/dist/index.d.ts

@@ -2,10 +2,11 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { ReactNode, JSX as JSX$1, ComponentType, PropsWithChildren } from 'react';
 import * as _backstage_frontend_plugin_api from '@backstage/frontend-plugin-api';
-import { I as IconElement, R as RouteRef, A as AnyRouteRefParams, S as SubRouteRef, E as ExternalRouteRef, F as FrontendFeature, a as IconComponent, b as AppNode, c as FrontendPlugin, d as ApiRef, e as ApiHolder, T as TypesToApiRefs, f as ApiFactory, g as AnyApiFactory } from './types/alpha.d-CfDtkom8.js';
-export { h as AnyApiRef, i as AppNodeEdges, j as AppNodeInstance, k as AppNodeSpec, l as AppTree, m as AppTreeApi, C as ConfigurableExtensionDataRef, n as CreateExtensionBlueprintOptions, o as CreateExtensionOptions, p as CreateFrontendModuleOptions, q as CreateFrontendPluginOptions, r as Extension, s as ExtensionAttachTo, t as ExtensionBlueprint, u as ExtensionBlueprintDefineParams, v as ExtensionBlueprintParameters, w as ExtensionBlueprintParams, x as ExtensionDataContainer, y as ExtensionDataRef, z as ExtensionDataValue, B as ExtensionDefinition, D as ExtensionDefinitionAttachTo, G as ExtensionDefinitionParameters, H as ExtensionFactoryMiddleware, J as ExtensionInput, K as FeatureFlagConfig, L as FrontendModule, M as FrontendPluginInfo, N as FrontendPluginInfoOptions, O as OverridableExtensionDefinition, P as OverridableFrontendPlugin, Q as PluginOptions, U as PluginWrapperApi, V as PluginWrapperBlueprint, W as PluginWrapperDefinition, X as PortableSchema, Y as appTreeApiRef, Z as createExtension, _ as createExtensionBlueprint, $ as createExtensionBlueprintParams, a0 as createExtensionDataRef, a1 as createExtensionInput, a2 as createExternalRouteRef, a3 as createFrontendModule, a4 as createFrontendPlugin, a5 as createRouteRef, a6 as createSubRouteRef, a7 as pluginWrapperApiRef } from './types/alpha.d-CfDtkom8.js';
+import { I as IconElement, R as RouteRef, A as AnyRouteRefParams, S as SubRouteRef, E as ExternalRouteRef, F as FrontendFeature, a as IconComponent, b as AppNode, c as FrontendPlugin, d as ApiRef, e as ApiHolder, T as TypesToApiRefs, f as ApiFactory, g as AnyApiFactory } from './types/alpha.d-D3gnSOzm.js';
+export { h as AnyApiRef, i as AppNodeEdges, j as AppNodeInstance, k as AppNodeSpec, l as AppTree, m as AppTreeApi, C as ConfigurableExtensionDataRef, n as CreateExtensionBlueprintOptions, o as CreateExtensionOptions, p as CreateFrontendModuleOptions, q as CreateFrontendPluginOptions, r as Extension, s as ExtensionAttachTo, t as ExtensionBlueprint, u as ExtensionBlueprintDefineParams, v as ExtensionBlueprintParameters, w as ExtensionBlueprintParams, x as ExtensionDataContainer, y as ExtensionDataRef, z as ExtensionDataValue, B as ExtensionDefinition, D as ExtensionDefinitionAttachTo, G as ExtensionDefinitionParameters, H as ExtensionFactoryMiddleware, J as ExtensionInput, K as FeatureFlagConfig, L as FrontendModule, M as FrontendPluginInfo, N as FrontendPluginInfoOptions, O as OverridableExtensionDefinition, P as OverridableFrontendPlugin, Q as PluginOptions, U as PluginWrapperApi, V as PluginWrapperBlueprint, W as PluginWrapperDefinition, X as PortableSchema, Y as appTreeApiRef, Z as createExtension, _ as createExtensionBlueprint, $ as createExtensionBlueprintParams, a0 as createExtensionDataRef, a1 as createExtensionInput, a2 as createExternalRouteRef, a3 as createFrontendModule, a4 as createFrontendPlugin, a5 as createRouteRef, a6 as createSubRouteRef, a7 as pluginWrapperApiRef } from './types/alpha.d-D3gnSOzm.js';
 import { Observable, JsonValue, Expand, ExpandRecursive } from '@backstage/types';
 import { Config } from '@backstage/config';
+export { StandardSchemaV1 } from '@standard-schema/spec';
 import '@backstage/filter-predicates';
 import 'zod/v3';
 
@@ -1106,31 +1107,34 @@ declare const identityApiRef: _backstage_frontend_plugin_api.ApiRef<IdentityApi,
  *
  * @remarks
  *
- * Dialogs can be opened using either {@link DialogApi.show} or {@link DialogApi.showModal}.
+ * Dialogs are opened using {@link DialogApi.open}.
  *
  * @public
  */
 interface DialogApiDialog<TResult = void> {
     /**
-     * Closes the dialog with that provided result.
+     * Closes the dialog with the provided result.
      *
      * @remarks
      *
-     * If the dialog is a modal dialog a result must always be provided. If it's a regular dialog then passing a result is optional.
+     * Whether a result is required depends on the `TResult` type parameter
+     * chosen when the dialog was opened. If the type includes `undefined`,
+     * calling `close()` without a result is allowed.
      */
     close(...args: undefined extends TResult ? [result?: TResult] : [result: TResult]): void;
     /**
-     * Replaces the content of the dialog with the provided element or component, causing it to be rerenedered.
+     * Replaces the rendered dialog with the provided element or component.
+     *
+     * @remarks
+     *
+     * Just like the element or component passed to {@link DialogApi.open}, the
+     * caller is responsible for providing the full dialog including all chrome.
      */
     update(elementOrComponent: JSX.Element | ((props: {
         dialog: DialogApiDialog<TResult>;
     }) => JSX.Element)): void;
     /**
      * Wait until the dialog is closed and return the result.
-     *
-     * @remarks
-     *
-     * If the dialog is a modal dialog a result will always be returned. If it's a regular dialog then the result may be `undefined`.
      */
     result(): Promise<TResult>;
 }
@@ -1141,98 +1145,76 @@ interface DialogApiDialog<TResult = void> {
  */
 interface DialogApi {
     /**
-     * Opens a modal dialog and returns a handle to it.
+     * Opens a dialog and returns a handle to it.
      *
      * @remarks
      *
-     * This dialog can be closed by calling the `close` method on the returned handle, optionally providing a result.
-     * The dialog can also be closed by the user by clicking the backdrop or pressing the escape key.
-     *
-     * If the dialog is closed without a result, the result will be `undefined`.
+     * The provided element or component is rendered as-is in the app's React tree.
+     * It is the caller's responsibility to provide all dialog chrome, such as an
+     * overlay, backdrop, and dialog surface. This makes the method agnostic to the
+     * design library used for the dialog.
      *
      * @example
      *
-     * ### Example with inline dialog content
+     * ### Example with inline dialog element
      * ```tsx
-     * const dialog = dialogApi.show<boolean>(
-     *   <DialogContent>
-     *     <DialogTitle>Are you sure?</DialogTitle>
-     *     <DialogActions>
-     *       <Button onClick={() => dialog.close(true)}>Yes</Button>
-     *       <Button onClick={() => dialog.close(false)}>No</Button>
-     *     </DialogActions>
-     *   </DialogContent>
+     * const dialog = dialogApi.open<boolean>(
+     *   <Dialog isOpen onOpenChange={isOpen => !isOpen && dialog.close()}>
+     *     <DialogHeader>Are you sure?</DialogHeader>
+     *     <DialogBody>This action cannot be undone.</DialogBody>
+     *     <DialogFooter>
+     *       <Button onPress={() => dialog.close(false)}>Cancel</Button>
+     *       <Button onPress={() => dialog.close(true)}>Confirm</Button>
+     *     </DialogFooter>
+     *   </Dialog>
      * );
      * const result = await dialog.result();
      * ```
      *
      * @example
      *
-     * ### Example with separate dialog component
+     * ### Example with a dialog component
      * ```tsx
-     * function CustomDialog({ dialog }: { dialog: DialogApiDialog<boolean | undefined> }) {
+     * function ConfirmDialog({ dialog }: { dialog: DialogApiDialog<boolean> }) {
      *   return (
-     *     <DialogContent>
-     *       <DialogTitle>Are you sure?</DialogTitle>
-     *       <DialogActions>
-     *         <Button onClick={() => dialog.close(true)}>Yes</Button>
-     *         <Button onClick={() => dialog.close(false)}>No</Button>
-     *       </DialogActions>
-     *     </DialogContent>
-     *   )
+     *     <Dialog isOpen onOpenChange={isOpen => !isOpen && dialog.close()}>
+     *       <DialogHeader>Are you sure?</DialogHeader>
+     *       <DialogBody>This action cannot be undone.</DialogBody>
+     *       <DialogFooter>
+     *         <Button onPress={() => dialog.close(false)}>Cancel</Button>
+     *         <Button onPress={() => dialog.close(true)}>Confirm</Button>
+     *       </DialogFooter>
+     *     </Dialog>
+     *   );
      * }
-     * const result = await dialogApi.show(CustomDialog).result();
+     * const result = await dialogApi.open(ConfirmDialog).result();
      * ```
      *
+     * @param elementOrComponent - The element or component to render. If a component is provided, it will be provided with a `dialog` prop that contains the dialog handle.
+     */
+    open<TResult = void>(elementOrComponent: JSX.Element | ((props: {
+        dialog: DialogApiDialog<TResult>;
+    }) => JSX.Element)): DialogApiDialog<TResult>;
+    /**
+     * Opens a dialog with built-in dialog chrome and returns a handle to it.
+     *
+     * @deprecated Use {@link DialogApi.open} instead. The `open` method does not
+     * render any dialog chrome, giving the caller full control over the dialog
+     * presentation. This avoids focus trap conflicts across design libraries.
+     *
      * @param elementOrComponent - The element or component to render in the dialog. If a component is provided, it will be provided with a `dialog` prop that contains the dialog handle.
-     * @public
      */
     show<TResult = void>(elementOrComponent: JSX.Element | ((props: {
         dialog: DialogApiDialog<TResult | undefined>;
     }) => JSX.Element)): DialogApiDialog<TResult | undefined>;
     /**
-     * Opens a modal dialog and returns a handle to it.
-     *
-     * @remarks
-     *
-     * This dialog can not be closed in any other way than calling the `close` method on the returned handle and providing a result.
+     * Opens a modal dialog with built-in dialog chrome and returns a handle to it.
      *
-     * @example
-     *
-     * ### Example with inline dialog content
-     * ```tsx
-     * const dialog = dialogApi.showModal<boolean>(
-     *   <DialogContent>
-     *     <DialogTitle>Are you sure?</DialogTitle>
-     *     <DialogActions>
-     *       <Button onClick={() => dialog.close(true)}>Yes</Button>
-     *       <Button onClick={() => dialog.close(false)}>No</Button>
-     *     </DialogActions>
-     *   </DialogContent>
-     * );
-     * const result = await dialog.result();
-     * ```
-     *
-     * @example
-     *
-     * ### Example with separate dialog component
-     * ```tsx
-     * function CustomDialog({ dialog }: { dialog: DialogApiDialog<boolean> }) {
-     *   return (
-     *     <DialogContent>
-     *       <DialogTitle>Are you sure?</DialogTitle>
-     *       <DialogActions>
-     *         <Button onClick={() => dialog.close(true)}>Yes</Button>
-     *         <Button onClick={() => dialog.close(false)}>No</Button>
-     *       </DialogActions>
-     *     </DialogContent>
-     *   )
-     * }
-     * const result = await dialogApi.showModal(CustomDialog).result();
-     * ```
+     * @deprecated Use {@link DialogApi.open} instead. The `open` method does not
+     * render any dialog chrome, giving the caller full control over the dialog
+     * presentation. This avoids focus trap conflicts across design libraries.
      *
      * @param elementOrComponent - The element or component to render in the dialog. If a component is provided, it will be provided with a `dialog` prop that contains the dialog handle.
-     * @public
      */
     showModal<TResult = void>(elementOrComponent: JSX.Element | ((props: {
         dialog: DialogApiDialog<TResult>;
@@ -2286,8 +2268,12 @@ declare const NavItemBlueprint: _backstage_frontend_plugin_api.ExtensionBlueprin
         routeRef: RouteRef<undefined>;
     }, "core.nav-item.target", {}>;
     inputs: {};
-    config: {};
-    configInput: {};
+    config: {
+        title: string | undefined;
+    };
+    configInput: {
+        title?: string | undefined;
+    };
     dataRefs: {
         target: _backstage_frontend_plugin_api.ConfigurableExtensionDataRef<{
             title: string;
@@ -2340,8 +2326,8 @@ declare const PageBlueprint: _backstage_frontend_plugin_api.ExtensionBlueprint<{
         title: string | undefined;
     };
     configInput: {
-        title?: string | undefined;
         path?: string | undefined;
+        title?: string | undefined;
     };
     dataRefs: never;
 }>;
@@ -2405,8 +2391,8 @@ declare const SubPageBlueprint: _backstage_frontend_plugin_api.ExtensionBlueprin
         title: string | undefined;
     };
     configInput: {
-        title?: string | undefined;
         path?: string | undefined;
+        title?: string | undefined;
     };
     dataRefs: never;
 }>;