frontend-plugin-api: add coreExtensionData.title

Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>

.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 availble 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',
   }),

plugins/catalog-react/report-alpha.api.md

@@ -92,12 +92,12 @@ export const catalogReactTranslationRef: TranslationRef<
     readonly 'entityTableColumnTitle.title': 'Title';
     readonly 'entityTableColumnTitle.description': 'Description';
     readonly 'entityTableColumnTitle.domain': 'Domain';
+    readonly 'entityTableColumnTitle.system': 'System';
+    readonly 'entityTableColumnTitle.tags': 'Tags';
     readonly 'entityTableColumnTitle.namespace': 'Namespace';
     readonly 'entityTableColumnTitle.lifecycle': 'Lifecycle';
     readonly 'entityTableColumnTitle.owner': 'Owner';
-    readonly 'entityTableColumnTitle.system': 'System';
     readonly 'entityTableColumnTitle.targets': 'Targets';
-    readonly 'entityTableColumnTitle.tags': 'Tags';
   }
 >;
 
@@ -533,8 +533,8 @@ export const EntityTableColumnTitle: ({
   translationKey,
 }: EntityTableColumnTitleProps) =>
   | 'Title'
-  | 'Domain'
   | 'System'
+  | 'Domain'
   | 'Lifecycle'
   | 'Namespace'
   | 'Owner'