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/notifications/report-alpha.api.md

@@ -120,7 +120,7 @@ const _default: OverridableFrontendPlugin<
 >;
 export default _default;
 
-// @alpha (undocumented)
+// @public @deprecated (undocumented)
 export const notificationsTranslationRef: TranslationRef<
   'plugin.notifications',
   {

plugins/notifications/report.api.md

@@ -15,6 +15,7 @@ import { NotificationSeverity } from '@backstage/plugin-notifications-common';
 import { NotificationStatus } from '@backstage/plugin-notifications-common';
 import { RouteRef } from '@backstage/core-plugin-api';
 import { TableProps } from '@backstage/core-components';
+import { TranslationRef } from '@backstage/frontend-plugin-api';
 
 // @public (undocumented)
 export type GetNotificationsCommonOptions = {
@@ -187,6 +188,71 @@ export type NotificationsTableProps = Pick<
   pageSize: number;
 };
 
+// @public (undocumented)
+export const notificationsTranslationRef: TranslationRef<
+  'plugin.notifications',
+  {
+    readonly 'table.errors.markAllReadFailed': 'Failed to mark all notifications as read';
+    readonly 'table.pagination.labelDisplayedRows': '{from}-{to} of {count}';
+    readonly 'table.pagination.firstTooltip': 'First Page';
+    readonly 'table.pagination.labelRowsSelect': 'rows';
+    readonly 'table.pagination.lastTooltip': 'Last Page';
+    readonly 'table.pagination.nextTooltip': 'Next Page';
+    readonly 'table.pagination.previousTooltip': 'Previous Page';
+    readonly 'table.emptyMessage': 'No records to display';
+    readonly 'table.bulkActions.markAllRead': 'Mark all read';
+    readonly 'table.bulkActions.markSelectedAsRead': 'Mark selected as read';
+    readonly 'table.bulkActions.returnSelectedAmongUnread': 'Return selected among unread';
+    readonly 'table.bulkActions.saveSelectedForLater': 'Save selected for later';
+    readonly 'table.bulkActions.undoSaveForSelected': 'Undo save for selected';
+    readonly 'table.confirmDialog.title': 'Are you sure?';
+    readonly 'table.confirmDialog.markAllReadDescription': 'Mark <b>all</b> notifications as <b>read</b>.';
+    readonly 'table.confirmDialog.markAllReadConfirmation': 'Mark All';
+    readonly 'filters.view.all': 'All';
+    readonly 'filters.view.label': 'View';
+    readonly 'filters.view.read': 'Read notifications';
+    readonly 'filters.view.saved': 'Saved';
+    readonly 'filters.view.unread': 'Unread notifications';
+    readonly 'filters.title': 'Filters';
+    readonly 'filters.severity.normal': 'Normal';
+    readonly 'filters.severity.high': 'High';
+    readonly 'filters.severity.low': 'Low';
+    readonly 'filters.severity.label': 'Min severity';
+    readonly 'filters.severity.critical': 'Critical';
+    readonly 'filters.topic.label': 'Topic';
+    readonly 'filters.topic.anyTopic': 'Any topic';
+    readonly 'filters.createdAfter.label': 'Sent out';
+    readonly 'filters.createdAfter.placeholder': 'Notifications since';
+    readonly 'filters.createdAfter.last24h': 'Last 24h';
+    readonly 'filters.createdAfter.lastWeek': 'Last week';
+    readonly 'filters.createdAfter.anyTime': 'Any time';
+    readonly 'filters.sortBy.origin': 'Origin';
+    readonly 'filters.sortBy.label': 'Sort by';
+    readonly 'filters.sortBy.placeholder': 'Field to sort by';
+    readonly 'filters.sortBy.newest': 'Newest on top';
+    readonly 'filters.sortBy.oldest': 'Oldest on top';
+    readonly 'filters.sortBy.topic': 'Topic';
+    readonly 'settings.table.origin': 'Origin';
+    readonly 'settings.table.topic': 'Topic';
+    readonly 'settings.title': 'Notification settings';
+    readonly 'settings.errors.useNotificationFormat': 'useNotificationFormat must be used within a NotificationFormatProvider';
+    readonly 'settings.errorTitle': 'Failed to load settings';
+    readonly 'settings.noSettingsAvailable': 'No notification settings available, check back later';
+    readonly 'sidebar.title': 'Notifications';
+    readonly 'sidebar.errors.markAsReadFailed': 'Failed to mark notification as read';
+    readonly 'sidebar.errors.fetchNotificationFailed': 'Failed to fetch notification';
+    readonly 'notificationsPage.title': 'Notifications';
+    readonly 'notificationsPage.tableTitle.all_one': 'All notifications ({{count}})';
+    readonly 'notificationsPage.tableTitle.all_other': 'All notifications ({{count}})';
+    readonly 'notificationsPage.tableTitle.saved_one': 'Saved notifications ({{count}})';
+    readonly 'notificationsPage.tableTitle.saved_other': 'Saved notifications ({{count}})';
+    readonly 'notificationsPage.tableTitle.unread_one': 'Unread notifications ({{count}})';
+    readonly 'notificationsPage.tableTitle.unread_other': 'Unread notifications ({{count}})';
+    readonly 'notificationsPage.tableTitle.read_one': 'Read notifications ({{count}})';
+    readonly 'notificationsPage.tableTitle.read_other': 'Read notifications ({{count}})';
+  }
+>;
+
 // @public (undocumented)
 export type UpdateNotificationsOptions = {
   ids: string[];

plugins/notifications/src/alpha.tsx

@@ -56,4 +56,10 @@ export default createFrontendPlugin({
   extensions: [page, api],
 });
 
-export { notificationsTranslationRef } from './translation';
+import { notificationsTranslationRef as _notificationsTranslationRef } from './translation';
+
+/**
+ * @public
+ * @deprecated Import from `@backstage/plugin-notifications` instead.
+ */
+export const notificationsTranslationRef = _notificationsTranslationRef;

plugins/notifications/src/index.ts

@@ -17,3 +17,4 @@ export { notificationsPlugin, NotificationsPage } from './plugin';
 export * from './api';
 export { useNotificationsApi } from './hooks';
 export * from './components';
+export { notificationsTranslationRef } from './translation';

plugins/notifications/src/translation.ts

@@ -16,7 +16,7 @@
 
 import { createTranslationRef } from '@backstage/frontend-plugin-api';
 
-/** @alpha */
+/** @public */
 export const notificationsTranslationRef = createTranslationRef({
   id: 'plugin.notifications',
   messages: {