Merge pull request #31154 from backstage/rugvip/title

frontend-plugin-api: add coreExtensionData.title

.changeset/nasty-moose-rescue.md

@@ -0,0 +1,5 @@
+---
+'@backstage/frontend-plugin-api': patch
+---
+
+Added `coreExtensionData.title`, especially useful for creating extensible layout with tabbed pages, but available for use for other cases too.

docs/frontend-system/building-plugins/04-built-in-data-refs.md

@@ -34,6 +34,14 @@ const examplePage = createExtension({
 });
 ```
 
+### `title`
+
+|      id      |   type   |
+| :----------: | :------: |
+| `core.title` | `string` |
+
+The `title` data reference can be used for defining the extension input/output of string titles.
+
 ### `routePath`
 
 |         id          |   type   |

packages/frontend-plugin-api/report.api.md

@@ -377,6 +377,7 @@ export interface ConfigurableExtensionDataRef<
 
 // @public (undocumented)
 export const coreExtensionData: {
+  title: ConfigurableExtensionDataRef<string, 'core.title', {}>;
   reactElement: ConfigurableExtensionDataRef<
     JSX_3.Element,
     'core.reactElement',

packages/frontend-plugin-api/src/wiring/coreExtensionData.ts

@@ -20,6 +20,7 @@ import { createExtensionDataRef } from './createExtensionDataRef';
 
 /** @public */
 export const coreExtensionData = {
+  title: createExtensionDataRef<string>().with({ id: 'core.title' }),
   reactElement: createExtensionDataRef<JSX.Element>().with({
     id: 'core.reactElement',
   }),