Promote translation refs from alpha to stable entry points

Add each plugin and package translation ref to the corresponding stable
entry point, changing the JSDoc tag from @alpha to @public. The alpha
entry points now re-export with a @deprecated annotation so existing
consumers continue to work.

Affected packages: core-components, api-docs, catalog, catalog-graph,
catalog-import, catalog-react, home, home-react, kubernetes,
kubernetes-cluster, kubernetes-react, notifications, org, scaffolder,
scaffolder-react, search, search-react, user-settings.

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

plugins/api-docs/report-alpha.api.md

@@ -26,7 +26,7 @@ import { RouteRef } from '@backstage/core-plugin-api';
 import { RouteRef as RouteRef_2 } from '@backstage/frontend-plugin-api';
 import { TranslationRef } from '@backstage/frontend-plugin-api';
 
-// @alpha (undocumented)
+// @public @deprecated (undocumented)
 export const apiDocsTranslationRef: TranslationRef<
   'api-docs',
   {

plugins/api-docs/report.api.md

@@ -19,6 +19,7 @@ import { RouteRef } from '@backstage/core-plugin-api';
 import { TableColumn } from '@backstage/core-components';
 import { TableOptions } from '@backstage/core-components';
 import { TableProps } from '@backstage/core-components';
+import { TranslationRef } from '@backstage/frontend-plugin-api';
 import { UserListFilterKind } from '@backstage/plugin-catalog-react';
 
 // @public (undocumented)
@@ -62,6 +63,42 @@ const apiDocsPlugin: BackstagePlugin<
 export { apiDocsPlugin };
 export { apiDocsPlugin as plugin };
 
+// @public (undocumented)
+export const apiDocsTranslationRef: TranslationRef<
+  'api-docs',
+  {
+    readonly 'apiDefinitionCard.error.title': 'Could not fetch the API';
+    readonly 'apiDefinitionCard.rawButtonTitle': 'Raw';
+    readonly 'apiDefinitionDialog.closeButtonTitle': 'Close';
+    readonly 'apiDefinitionDialog.tabsAriaLabel': 'API definition options';
+    readonly 'apiDefinitionDialog.rawButtonTitle': 'Raw';
+    readonly 'apiDefinitionDialog.toggleButtonAriaLabel': 'Toggle API Definition Dialog';
+    readonly 'defaultApiExplorerPage.title': 'APIs';
+    readonly 'defaultApiExplorerPage.subtitle': '{{orgName}} API Explorer';
+    readonly 'defaultApiExplorerPage.pageTitleOverride': 'APIs';
+    readonly 'defaultApiExplorerPage.createButtonTitle': 'Register Existing API';
+    readonly 'defaultApiExplorerPage.supportButtonTitle': 'All your APIs';
+    readonly 'consumedApisCard.error.title': 'Could not load APIs';
+    readonly 'consumedApisCard.title': 'Consumed APIs';
+    readonly 'consumedApisCard.emptyContent.title': 'This {{entity}} does not consume any APIs.';
+    readonly 'hasApisCard.error.title': 'Could not load APIs';
+    readonly 'hasApisCard.title': 'APIs';
+    readonly 'hasApisCard.emptyContent.title': 'This {{entity}} does not contain any APIs.';
+    readonly 'providedApisCard.error.title': 'Could not load APIs';
+    readonly 'providedApisCard.title': 'Provided APIs';
+    readonly 'providedApisCard.emptyContent.title': 'This {{entity}} does not provide any APIs.';
+    readonly 'apiEntityColumns.typeTitle': 'Type';
+    readonly 'apiEntityColumns.apiDefinitionTitle': 'API Definition';
+    readonly 'consumingComponentsCard.error.title': 'Could not load components';
+    readonly 'consumingComponentsCard.title': 'Consumers';
+    readonly 'consumingComponentsCard.emptyContent.title': 'No component consumes this API.';
+    readonly 'providingComponentsCard.error.title': 'Could not load components';
+    readonly 'providingComponentsCard.title': 'Providers';
+    readonly 'providingComponentsCard.emptyContent.title': 'No component provides this API.';
+    readonly apisCardHelpLinkTitle: 'Learn how to change this.';
+  }
+>;
+
 // @public
 export const ApiExplorerIndexPage: (
   props: DefaultApiExplorerPageProps,

plugins/api-docs/src/alpha.tsx

@@ -234,4 +234,10 @@ export default createFrontendPlugin({
   ],
 });
 
-export { apiDocsTranslationRef } from './translation';
+import { apiDocsTranslationRef as _apiDocsTranslationRef } from './translation';
+
+/**
+ * @public
+ * @deprecated Import from `@backstage/plugin-api-docs` instead.
+ */
+export const apiDocsTranslationRef = _apiDocsTranslationRef;

plugins/api-docs/src/index.ts

@@ -34,3 +34,4 @@ export {
   EntityProvidedApisCard,
   EntityProvidingComponentsCard,
 } from './plugin';
+export { apiDocsTranslationRef } from './translation';

plugins/api-docs/src/translation.ts

@@ -17,7 +17,7 @@
 import { createTranslationRef } from '@backstage/frontend-plugin-api';
 
 /**
- * @alpha
+ * @public
  */
 export const apiDocsTranslationRef = createTranslationRef({
   id: 'api-docs',