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

@@ -155,7 +155,7 @@ export const settingsNavItem: OverridableExtensionDefinition<{
   };
 }>;
 
-// @alpha (undocumented)
+// @public @deprecated (undocumented)
 export const userSettingsTranslationRef: TranslationRef<
   'user-settings',
   {

plugins/user-settings/report.api.md

@@ -26,6 +26,7 @@ import { SignalApi } from '@backstage/plugin-signals-react';
 import { StorageApi } from '@backstage/core-plugin-api';
 import { StorageValueSnapshot } from '@backstage/core-plugin-api';
 import { TabProps } from '@material-ui/core/Tab';
+import { TranslationRef } from '@backstage/frontend-plugin-api';
 
 // @public (undocumented)
 export const DefaultProviderSettings: (props: {
@@ -163,6 +164,63 @@ export type UserSettingsTabProps = PropsWithChildren<{
 // @public (undocumented)
 export const UserSettingsThemeToggle: () => JSX_2.Element;
 
+// @public (undocumented)
+export const userSettingsTranslationRef: TranslationRef<
+  'user-settings',
+  {
+    readonly 'featureFlags.title': 'Feature Flags';
+    readonly 'featureFlags.description': 'Please refresh the page when toggling feature flags';
+    readonly 'featureFlags.filterTitle': 'Filter';
+    readonly 'featureFlags.clearFilter': 'Clear filter';
+    readonly 'featureFlags.emptyFlags.title': 'No Feature Flags';
+    readonly 'featureFlags.emptyFlags.action.title': 'An example for how to add a feature flag is highlighted below:';
+    readonly 'featureFlags.emptyFlags.action.readMoreButtonTitle': 'Read More';
+    readonly 'featureFlags.emptyFlags.description': 'Feature Flags make it possible for plugins to register features in Backstage for users to opt into. You can use this to split out logic in your code for manual A/B testing, etc.';
+    readonly 'featureFlags.flagItem.title.disable': 'Disable';
+    readonly 'featureFlags.flagItem.title.enable': 'Enable';
+    readonly 'featureFlags.flagItem.subtitle.registeredInApplication': 'Registered in the application';
+    readonly 'featureFlags.flagItem.subtitle.registeredInPlugin': 'Registered in {{pluginId}} plugin';
+    readonly 'languageToggle.select': 'Select language {{language}}';
+    readonly 'languageToggle.title': 'Language';
+    readonly 'languageToggle.description': 'Change the language';
+    readonly 'themeToggle.select': 'Select {{theme}}';
+    readonly 'themeToggle.title': 'Theme';
+    readonly 'themeToggle.description': 'Change the theme mode';
+    readonly 'themeToggle.names.auto': 'Auto';
+    readonly 'themeToggle.names.dark': 'Dark';
+    readonly 'themeToggle.names.light': 'Light';
+    readonly 'themeToggle.selectAuto': 'Select Auto Theme';
+    readonly 'signOutMenu.title': 'Sign Out';
+    readonly 'signOutMenu.moreIconTitle': 'more';
+    readonly 'pinToggle.title': 'Pin Sidebar';
+    readonly 'pinToggle.description': 'Prevent the sidebar from collapsing';
+    readonly 'pinToggle.ariaLabelTitle': 'Pin Sidebar Switch';
+    readonly 'pinToggle.switchTitles.unpin': 'Unpin Sidebar';
+    readonly 'pinToggle.switchTitles.pin': 'Pin Sidebar';
+    readonly 'identityCard.title': 'Backstage Identity';
+    readonly 'identityCard.noIdentityTitle': 'No Backstage Identity';
+    readonly 'identityCard.userEntity': 'User Entity';
+    readonly 'identityCard.ownershipEntities': 'Ownership Entities';
+    readonly 'defaultProviderSettings.description': 'Provides authentication towards {{provider}} APIs and identities';
+    readonly 'emptyProviders.title': 'No Authentication Providers';
+    readonly 'emptyProviders.action.title': 'Open app-config.yaml and make the changes as highlighted below:';
+    readonly 'emptyProviders.action.readMoreButtonTitle': 'Read More';
+    readonly 'emptyProviders.description': 'You can add Authentication Providers to Backstage which allows you to use these providers to authenticate yourself.';
+    readonly 'providerSettingsItem.title.signOut': 'Sign out from {{title}}';
+    readonly 'providerSettingsItem.title.signIn': 'Sign in to {{title}}';
+    readonly 'providerSettingsItem.buttonTitle.signOut': 'Sign out';
+    readonly 'providerSettingsItem.buttonTitle.signIn': 'Sign in';
+    readonly 'authProviders.title': 'Available Providers';
+    readonly 'defaultSettingsPage.tabsTitle.featureFlags': 'Feature Flags';
+    readonly 'defaultSettingsPage.tabsTitle.authProviders': 'Authentication Providers';
+    readonly 'defaultSettingsPage.tabsTitle.general': 'General';
+    readonly 'settingsLayout.title': 'Settings';
+    readonly sidebarTitle: 'Settings';
+    readonly 'profileCard.title': 'Profile';
+    readonly 'appearanceCard.title': 'Appearance';
+  }
+>;
+
 // @public (undocumented)
 export const useUserProfile: () =>
   | {

plugins/user-settings/src/alpha.tsx

@@ -23,7 +23,13 @@ import {
 import SettingsIcon from '@material-ui/icons/Settings';
 import { settingsRouteRef } from './plugin';
 
-export * from './translation';
+import { userSettingsTranslationRef as _userSettingsTranslationRef } from './translation';
+
+/**
+ * @public
+ * @deprecated Import from `@backstage/plugin-user-settings` instead.
+ */
+export const userSettingsTranslationRef = _userSettingsTranslationRef;
 
 const userSettingsPage = PageBlueprint.makeWithOverrides({
   inputs: {

plugins/user-settings/src/index.ts

@@ -27,3 +27,4 @@ export {
   UserSettingsPage,
 } from './plugin';
 export * from './components';
+export { userSettingsTranslationRef } from './translation';

plugins/user-settings/src/translation.ts

@@ -16,7 +16,7 @@
 
 import { createTranslationRef } from '@backstage/core-plugin-api/alpha';
 
-/** @alpha */
+/** @public */
 export const userSettingsTranslationRef = createTranslationRef({
   id: 'user-settings',
   messages: {