SONAR-21973 Add deprecation notices on all MIUI icons that now have an Echoes replacement

server/sonar-web/design-system/src/components/icons/AddNewIcon.tsx

@@ -17,10 +17,17 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { useTheme } from '@emotion/react';
 import { themeColor } from '../../helpers';
 import { CustomIcon, IconProps } from './Icon';
 
+/** @deprecated Use IconPlus from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export function AddNewIcon({ fill = 'currentColor', ...iconProps }: Readonly<IconProps>) {
   const theme = useTheme();
 

server/sonar-web/design-system/src/components/icons/BranchIcon.tsx

@@ -17,7 +17,14 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { GitBranchIcon } from '@primer/octicons-react';
 import { OcticonHoc } from './Icon';
 
+/** @deprecated Use IconGitBranch from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export const BranchIcon = OcticonHoc(GitBranchIcon, 'BranchIcon');

server/sonar-web/design-system/src/components/icons/BugIcon.tsx

@@ -17,10 +17,17 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { useTheme } from '@emotion/react';
 import { themeColor } from '../../helpers/theme';
 import { CustomIcon, IconProps } from './Icon';
 
+/** @deprecated Use IconBug from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export function BugIcon({ fill = 'currentColor', ...iconProps }: IconProps) {
   const theme = useTheme();
 

server/sonar-web/design-system/src/components/icons/CalendarIcon.tsx

@@ -17,7 +17,14 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { CalendarIcon as Octicon } from '@primer/octicons-react';
 import { OcticonHoc } from './Icon';
 
+/** @deprecated Use IconCalendar from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export const CalendarIcon = OcticonHoc(Octicon);

server/sonar-web/design-system/src/components/icons/CheckIcon.tsx

@@ -17,10 +17,17 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { useTheme } from '@emotion/react';
 import { themeColor } from '../../helpers/theme';
 import { CustomIcon, IconProps } from './Icon';
 
+/** @deprecated Use IconCheck from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export function CheckIcon({ fill = 'iconCheck', ...iconProps }: IconProps) {
   const theme = useTheme();
   return (

server/sonar-web/design-system/src/components/icons/ChevronDownIcon.tsx

@@ -17,10 +17,17 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { useTheme } from '@emotion/react';
 import { themeColor } from '../../helpers/theme';
 import { CustomIcon, IconProps } from './Icon';
 
+/** @deprecated Use IconChevronDown from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export function ChevronDownIcon({ fill = 'currentColor', ...iconProps }: IconProps) {
   const theme = useTheme();
   return (

server/sonar-web/design-system/src/components/icons/ClockIcon.tsx

@@ -17,7 +17,14 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { ClockIcon as OcticonClockIcon } from '@primer/octicons-react';
 import { OcticonHoc } from './Icon';
 
+/** @deprecated Use IconClock from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export const ClockIcon = OcticonHoc(OcticonClockIcon, 'ClockIcon');

server/sonar-web/design-system/src/components/icons/CloseIcon.tsx

@@ -17,7 +17,14 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { XIcon } from '@primer/octicons-react';
 import { OcticonHoc } from './Icon';
 
+/** @deprecated Use IconX from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export const CloseIcon = OcticonHoc(XIcon, 'CloseIcon');

server/sonar-web/design-system/src/components/icons/CodeSmellIcon.tsx

@@ -17,10 +17,17 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { useTheme } from '@emotion/react';
 import { themeColor } from '../../helpers/theme';
 import { CustomIcon, IconProps } from './Icon';
 
+/** @deprecated Use IconCodeSmell from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export function CodeSmellIcon({ fill = 'currentColor', ...iconProps }: IconProps) {
   const theme = useTheme();
 

server/sonar-web/design-system/src/components/icons/CollapseIcon.tsx

@@ -17,10 +17,17 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { useTheme } from '@emotion/react';
 import { themeColor } from '../../helpers/theme';
 import { CustomIcon, IconProps } from './Icon';
 
+/** @deprecated Use IconCollapse from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export function CollapseIcon({ fill = 'currentColor', ...iconProps }: Readonly<IconProps>) {
   const theme = useTheme();
   return (

server/sonar-web/design-system/src/components/icons/CommentIcon.tsx

@@ -17,7 +17,14 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { CommentIcon as OcticonCommentIcon } from '@primer/octicons-react';
 import { OcticonHoc } from './Icon';
 
+/** @deprecated Use IconComment from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export const CommentIcon = OcticonHoc(OcticonCommentIcon, 'CommentIcon');

server/sonar-web/design-system/src/components/icons/CopyIcon.tsx

@@ -17,7 +17,14 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { CopyIcon as OcticonCopyIcon } from '@primer/octicons-react';
 import { OcticonHoc } from './Icon';
 
+/** @deprecated Use IconCopy from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export const CopyIcon = OcticonHoc(OcticonCopyIcon, 'CopyIcon');

server/sonar-web/design-system/src/components/icons/DirectoryIcon.tsx

@@ -17,7 +17,14 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { FileDirectoryIcon } from '@primer/octicons-react';
 import { OcticonHoc } from './Icon';
 
+/** @deprecated Use IconDirectory from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export const DirectoryIcon = OcticonHoc(FileDirectoryIcon, 'DirectoryIcon');

server/sonar-web/design-system/src/components/icons/DotFillIcon.tsx

@@ -21,4 +21,10 @@
 import { DotFillIcon as OcticonDotFillIcon } from '@primer/octicons-react';
 import { OcticonHoc } from './Icon';
 
+/** @deprecated Use IconDot with the isFilled prop from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export const DotFillIcon = OcticonHoc(OcticonDotFillIcon, 'DotFillIcon');

server/sonar-web/design-system/src/components/icons/ExpandIcon.tsx

@@ -17,10 +17,17 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { useTheme } from '@emotion/react';
 import { themeColor } from '../../helpers/theme';
 import { CustomIcon, IconProps } from './Icon';
 
+/** @deprecated Use IconExpand from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export function ExpandIcon({ fill = 'currentColor', ...iconProps }: Readonly<IconProps>) {
   const theme = useTheme();
   return (

server/sonar-web/design-system/src/components/icons/FileIcon.tsx

@@ -17,7 +17,14 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { FileIcon as OcticonFileIcon } from '@primer/octicons-react';
 import { OcticonHoc } from './Icon';
 
+/** @deprecated Use IconFile from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export const FileIcon = OcticonHoc(OcticonFileIcon, 'FileIcon');

server/sonar-web/design-system/src/components/icons/FilterIcon.tsx

@@ -17,7 +17,14 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { FilterIcon as Icon } from '@primer/octicons-react';
 import { OcticonHoc } from './Icon';
 
+/** @deprecated Use IconFilter from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export const FilterIcon = OcticonHoc(Icon, 'FilterIcon');

server/sonar-web/design-system/src/components/icons/FlagErrorIcon.tsx

@@ -17,10 +17,17 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { useTheme } from '@emotion/react';
 import { themeColor } from '../../helpers/theme';
 import { CustomIcon, IconProps } from './Icon';
 
+/** @deprecated Use IconError from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export function FlagErrorIcon({ fill = 'iconError', ...iconProps }: IconProps) {
   const theme = useTheme();
   return (

server/sonar-web/design-system/src/components/icons/FlagInfoIcon.tsx

@@ -17,10 +17,17 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { useTheme } from '@emotion/react';
 import { themeColor } from '../../helpers/theme';
 import { CustomIcon, IconProps } from './Icon';
 
+/** @deprecated Use IconInfo from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export function FlagInfoIcon({ fill = 'iconInfo', ...iconProps }: IconProps) {
   const theme = useTheme();
   return (

server/sonar-web/design-system/src/components/icons/FlagSuccessIcon.tsx

@@ -17,10 +17,17 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { useTheme } from '@emotion/react';
 import { themeColor } from '../../helpers/theme';
 import { CustomIcon, IconProps } from './Icon';
 
+/** @deprecated Use IconCheckCircle from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export function FlagSuccessIcon({ fill = 'iconSuccess', ...iconProps }: IconProps) {
   const theme = useTheme();
   return (

server/sonar-web/design-system/src/components/icons/FlagWarningIcon.tsx

@@ -17,10 +17,17 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { useTheme } from '@emotion/react';
 import { themeColor } from '../../helpers/theme';
 import { CustomIcon, IconProps } from './Icon';
 
+/** @deprecated Use IconWarning from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export function FlagWarningIcon({ fill = 'iconWarning', ...iconProps }: IconProps) {
   const theme = useTheme();
   return (
@@ -32,3 +39,4 @@ export function FlagWarningIcon({ fill = 'iconWarning', ...iconProps }: IconProp
     </CustomIcon>
   );
 }
+FlagWarningIcon.displayName = 'FlagWarningIcon';

server/sonar-web/design-system/src/components/icons/HelperHintIcon.tsx

@@ -17,6 +17,7 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { useTheme } from '@emotion/react';
 import { Fragment } from 'react';
 import { themeColor, themeContrast } from '../../helpers/theme';
@@ -26,6 +27,12 @@ type Props = IconProps & {
   raised?: boolean;
 };
 
+/** @deprecated Use IconQuestionMark from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export function HelperHintIcon({ raised, ...iconProps }: Props) {
   const theme = useTheme();
   return (

server/sonar-web/design-system/src/components/icons/HomeFillIcon.tsx

@@ -17,10 +17,17 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { useTheme } from '@emotion/react';
 import { themeColor } from '../../helpers/theme';
 import { CustomIcon, IconProps } from './Icon';
 
+/** @deprecated Use IconHome with the isFilled prop from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export function HomeFillIcon({ fill = 'iconFavorite', ...iconProps }: IconProps) {
   const theme = useTheme();
   const fillColor = themeColor(fill)({ theme });

server/sonar-web/design-system/src/components/icons/HomeIcon.tsx

@@ -17,7 +17,14 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { HomeIcon as OcticonHomeIcon } from '@primer/octicons-react';
 import { OcticonHoc } from './Icon';
 
+/** @deprecated Use IconHome from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export const HomeIcon = OcticonHoc(OcticonHomeIcon, 'HomeIcon');

server/sonar-web/design-system/src/components/icons/InheritanceIcon.tsx

@@ -17,10 +17,17 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { useTheme } from '@emotion/react';
 import { themeColor } from '../../helpers/theme';
 import { CustomIcon, IconProps } from './Icon';
 
+/** @deprecated Use IconInheritance from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export function InheritanceIcon({ fill = 'currentColor', ...iconProps }: Readonly<IconProps>) {
   const theme = useTheme();
   const fillColor = themeColor(fill)({ theme });

server/sonar-web/design-system/src/components/icons/IssueLocationIcon.tsx

@@ -17,10 +17,17 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { useTheme } from '@emotion/react';
 import { themeColor } from '../../helpers/theme';
 import { CustomIcon, IconProps } from './Icon';
 
+/** @deprecated Use IconDot with the isFilled prop from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export function IssueLocationIcon({ fill = 'currentColor', ...iconProps }: IconProps) {
   const theme = useTheme();
   const fillColor = themeColor(fill)({ theme });

server/sonar-web/design-system/src/components/icons/LinkIcon.tsx

@@ -17,7 +17,14 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { LinkIcon as Icon } from '@primer/octicons-react';
 import { OcticonHoc } from './Icon';
 
+/** @deprecated Use IconLink from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export const LinkIcon = OcticonHoc(Icon, 'LinkIcon');

server/sonar-web/design-system/src/components/icons/LockIcon.tsx

@@ -17,7 +17,14 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { LockIcon as OcticonLockIcon } from '@primer/octicons-react';
 import { OcticonHoc } from './Icon';
 
+/** @deprecated Use IconLock from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export const LockIcon = OcticonHoc(OcticonLockIcon, 'LockIcon');

server/sonar-web/design-system/src/components/icons/MainBranchIcon.tsx

@@ -17,10 +17,17 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { useTheme } from '@emotion/react';
 import { themeColor } from '../../helpers/theme';
 import { CustomIcon, IconProps } from './Icon';
 
+/** @deprecated Use IconBranch from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export function MainBranchIcon({ fill = 'currentColor', ...iconProps }: IconProps) {
   const theme = useTheme();
   return (

server/sonar-web/design-system/src/components/icons/MenuHelpIcon.tsx

@@ -17,10 +17,17 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { useTheme } from '@emotion/react';
 import { themeColor } from '../../helpers/theme';
 import { CustomIcon, IconProps } from './Icon';
 
+/** @deprecated Use IconQuestionMark from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export function MenuHelpIcon({ fill = 'currentColor', ...iconProps }: IconProps) {
   const theme = useTheme();
   return (

server/sonar-web/design-system/src/components/icons/MenuIcon.tsx

@@ -17,10 +17,17 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import styled from '@emotion/styled';
 import { KebabHorizontalIcon } from '@primer/octicons-react';
 import { OcticonHoc } from './Icon';
 
+/** @deprecated Use IconMoreVertical from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export const MenuIcon = styled(OcticonHoc(KebabHorizontalIcon, 'MenuIcon'))`
   transform: rotate(90deg);
 `;

server/sonar-web/design-system/src/components/icons/MenuSearchIcon.tsx

@@ -17,10 +17,17 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { useTheme } from '@emotion/react';
 import { themeColor } from '../../helpers/theme';
 import { CustomIcon, IconProps } from './Icon';
 
+/** @deprecated Use IconSearch from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export function MenuSearchIcon({ fill = 'currentColor', ...iconProps }: IconProps) {
   const theme = useTheme();
 

server/sonar-web/design-system/src/components/icons/MinimizeIcon.tsx

@@ -17,10 +17,17 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { useTheme } from '@emotion/react';
 import { themeColor } from '../../helpers/theme';
 import { CustomIcon, IconProps } from './Icon';
 
+/** @deprecated Use IconDash from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export function MinimizeIcon({ fill = 'currentColor', ...iconProps }: Readonly<IconProps>) {
   const theme = useTheme();
   return (

server/sonar-web/design-system/src/components/icons/OpenNewTabIcon.tsx

@@ -17,7 +17,14 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { LinkExternalIcon } from '@primer/octicons-react';
 import { OcticonHoc } from './Icon';
 
+/** @deprecated Use IconLinkExternal from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export const OpenNewTabIcon = OcticonHoc(LinkExternalIcon, 'OpenNewTabIcon');

server/sonar-web/design-system/src/components/icons/PinIcon.tsx

@@ -17,7 +17,14 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { PinIcon as OcticonPinIcon } from '@primer/octicons-react';
 import { OcticonHoc } from './Icon';
 
+/** @deprecated Use IconPin from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export const PinIcon = OcticonHoc(OcticonPinIcon, 'PinIcon');

server/sonar-web/design-system/src/components/icons/ProjectIcon.tsx

@@ -17,7 +17,14 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { ProjectIcon as OcticonProjectIcon } from '@primer/octicons-react';
 import { OcticonHoc } from './Icon';
 
+/** @deprecated Use IconProject from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export const ProjectIcon = OcticonHoc(OcticonProjectIcon, 'ProjectIcon');

server/sonar-web/design-system/src/components/icons/PullRequestIcon.tsx

@@ -17,7 +17,14 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { GitPullRequestIcon } from '@primer/octicons-react';
 import { OcticonHoc } from './Icon';
 
+/** @deprecated Use IconPullrequest from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export const PullRequestIcon = OcticonHoc(GitPullRequestIcon, 'PullRequestIcon');

server/sonar-web/design-system/src/components/icons/RecommendedIcon.tsx

@@ -17,7 +17,14 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { VerifiedIcon } from '@primer/octicons-react';
 import { OcticonHoc } from './Icon';
 
+/** @deprecated Use IconRecommended from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export const RecommendedIcon = OcticonHoc(VerifiedIcon, 'RecommendedIcon');

server/sonar-web/design-system/src/components/icons/SearchIcon.tsx

@@ -17,7 +17,14 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { SearchIcon as OcticonSearchIcon } from '@primer/octicons-react';
 import { OcticonHoc } from './Icon';
 
+/** @deprecated Use IconSearch from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export const SearchIcon = OcticonHoc(OcticonSearchIcon, 'SearchIcon');

server/sonar-web/design-system/src/components/icons/SecurityFindingIcon.tsx

@@ -17,10 +17,17 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { useTheme } from '@emotion/react';
 import { themeColor } from '../../helpers/theme';
 import { CustomIcon, IconProps } from './Icon';
 
+/** @deprecated Use IconSecurityFinding from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export function SecurityFindingIcon({ fill = 'currentColor', ...iconProps }: IconProps) {
   const theme = useTheme();
   const fillColor = themeColor(fill)({ theme });

server/sonar-web/design-system/src/components/icons/SecurityHotspotIcon.tsx

@@ -17,10 +17,17 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { useTheme } from '@emotion/react';
 import { themeColor } from '../../helpers/theme';
 import { CustomIcon, IconProps } from './Icon';
 
+/** @deprecated Use IconSecurityFinding from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export function SecurityHotspotIcon({ fill = 'currentColor', ...iconProps }: IconProps) {
   const theme = useTheme();
 

server/sonar-web/design-system/src/components/icons/SeverityInfoIcon.tsx

@@ -17,10 +17,17 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { useTheme } from '@emotion/react';
 import { themeColor, themeContrast } from '../../helpers/theme';
 import { CustomIcon, IconProps } from './Icon';
 
+/** @deprecated Use IconInfo from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export function SeverityInfoIcon({ fill = 'iconSeverityInfo', ...iconProps }: IconProps) {
   const theme = useTheme();
 

server/sonar-web/design-system/src/components/icons/StarFillIcon.tsx

@@ -17,13 +17,20 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import styled from '@emotion/styled';
 import { StarFillIcon as OcticonStarFillIcon } from '@primer/octicons-react';
 import { themeColor } from '../../helpers';
 import { OcticonHoc } from './Icon';
 
-// provide a default fill color that is different from the default icon
+/** @deprecated Use IconStar with the isFilled prop from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export const StarFillIcon = styled(OcticonHoc(OcticonStarFillIcon))`
+  // provide a default fill color that is different from the default icon
   fill: ${themeColor('iconFavorite')};
 `;
 

server/sonar-web/design-system/src/components/icons/StarIcon.tsx

@@ -17,7 +17,14 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { StarIcon as OcticonStarIcon } from '@primer/octicons-react';
 import { OcticonHoc } from './Icon';
 
+/** @deprecated Use IconStar from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export const StarIcon = OcticonHoc(OcticonStarIcon, 'StarIcon');

server/sonar-web/design-system/src/components/icons/StatusConfirmedIcon.tsx

@@ -17,10 +17,17 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { useTheme } from '@emotion/react';
 import { themeColor } from '../../helpers/theme';
 import { CustomIcon, IconProps } from './Icon';
 
+/** @deprecated Use IconStatusConfirmed from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export function StatusConfirmedIcon({ fill = 'iconStatus', ...iconProps }: IconProps) {
   const theme = useTheme();
   const fillColor = themeColor(fill)({ theme });

server/sonar-web/design-system/src/components/icons/StatusOpenIcon.tsx

@@ -17,10 +17,17 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { useTheme } from '@emotion/react';
 import { themeColor } from '../../helpers/theme';
 import { CustomIcon, IconProps } from './Icon';
 
+/** @deprecated Use IconStatusOpen from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export function StatusOpenIcon({ fill = 'iconStatus', ...iconProps }: IconProps) {
   const theme = useTheme();
 

server/sonar-web/design-system/src/components/icons/StatusReopenedIcon.tsx

@@ -17,10 +17,17 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { useTheme } from '@emotion/react';
 import { themeColor } from '../../helpers/theme';
 import { CustomIcon, IconProps } from './Icon';
 
+/** @deprecated Use IconStatusReopened from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export function StatusReopenedIcon({ fill = 'iconStatus', ...iconProps }: IconProps) {
   const theme = useTheme();
   const fillColor = themeColor(fill)({ theme });

server/sonar-web/design-system/src/components/icons/StatusResolvedIcon.tsx

@@ -17,10 +17,17 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { useTheme } from '@emotion/react';
 import { themeColor, themeContrast } from '../../helpers/theme';
 import { CustomIcon, IconProps } from './Icon';
 
+/** @deprecated Use IconStatusResolved from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export function StatusResolvedIcon({ fill = 'iconStatusResolved', ...iconProps }: IconProps) {
   const theme = useTheme();
 

server/sonar-web/design-system/src/components/icons/TestFileIcon.tsx

@@ -17,10 +17,17 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { useTheme } from '@emotion/react';
 import { themeColor } from '../../helpers/theme';
 import { CustomIcon, IconProps } from './Icon';
 
+/** @deprecated Use IconFileCode from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export function TestFileIcon({ fill = 'currentColor', ...iconProps }: IconProps) {
   const theme = useTheme();
   const fillColor = themeColor(fill)({ theme });

server/sonar-web/design-system/src/components/icons/UnfoldDownIcon.tsx

@@ -17,7 +17,14 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { FoldDownIcon } from '@primer/octicons-react';
 import { OcticonHoc } from './Icon';
 
+/** @deprecated Use IconUnfoldDown from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export const UnfoldDownIcon = OcticonHoc(FoldDownIcon, 'UnfoldDownIcon');

server/sonar-web/design-system/src/components/icons/UnfoldIcon.tsx

@@ -17,7 +17,14 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { UnfoldIcon as OcticonUnfoldIcon } from '@primer/octicons-react';
 import { OcticonHoc } from './Icon';
 
+/** @deprecated Use IconUnfold from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export const UnfoldIcon = OcticonHoc(OcticonUnfoldIcon, 'UnfoldIcon');

server/sonar-web/design-system/src/components/icons/UnfoldUpIcon.tsx

@@ -17,7 +17,14 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { FoldUpIcon } from '@primer/octicons-react';
 import { OcticonHoc } from './Icon';
 
+/** @deprecated Use IconUnfoldUp from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export const UnfoldUpIcon = OcticonHoc(FoldUpIcon, 'UnfoldUpIcon');

server/sonar-web/design-system/src/components/icons/UserGroupIcon.tsx

@@ -17,7 +17,14 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { PeopleIcon } from '@primer/octicons-react';
 import { OcticonHoc } from './Icon';
 
+/** @deprecated Use IconPeople from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export const UserGroupIcon = OcticonHoc(PeopleIcon, 'UserGroupIcon');

server/sonar-web/design-system/src/components/icons/VulnerabilityIcon.tsx

@@ -17,10 +17,17 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  */
+
 import { useTheme } from '@emotion/react';
 import { themeColor } from '../../helpers/theme';
 import { CustomIcon, IconProps } from './Icon';
 
+/** @deprecated Use IconVulnerability from Echoes instead, if possible.
+ *
+ * Be aware that the full icon set is not yet available in Echoes, and therefore you may not be able
+ * to replace all of the icons yet. There are situations where it is OK to ignore this deprecation
+ * warning when revisiting old code, but all new code should use the icons from Echoes.
+ */
 export function VulnerabilityIcon({ fill = 'currentColor', ...iconProps }: IconProps) {
   const theme = useTheme();