From 04df3c4130629863cdc7b116f55bb8973badc92e Mon Sep 17 00:00:00 2001
From: Danial Raza <danialrazafb@gmail.com>
Date: Sun, 6 Oct 2024 16:19:50 +0200
Subject: [PATCH] feat: add linked roles formatters (#10461)

* feat: add linked roles formatters

* docs: requested changes

Co-authored-by: Almeida <github@almeidx.dev>

* docs: remove locale

---------

Co-authored-by: Almeida <github@almeidx.dev>
Co-authored-by: kodiakhq[bot] <49736102+kodiakhq[bot]@users.noreply.github.com>
---
 packages/formatters/__tests__/formatters.test.ts |  7 +++++++
 packages/formatters/src/formatters.ts            | 14 ++++++++++++++
 2 files changed, 21 insertions(+)

diff --git a/packages/formatters/__tests__/formatters.test.ts b/packages/formatters/__tests__/formatters.test.ts
index 32cb8b398..1b7454399 100644
--- a/packages/formatters/__tests__/formatters.test.ts
+++ b/packages/formatters/__tests__/formatters.test.ts
@@ -17,6 +17,7 @@ import {
 	hyperlink,
 	inlineCode,
 	italic,
+	linkedRoleMention,
 	messageLink,
 	orderedList,
 	quote,
@@ -145,6 +146,12 @@ describe('Message formatters', () => {
 			});
 		});
 
+		describe('linkedRoleMention', () => {
+			test('GIVEN roleId THEN returns "<id:linked-roles:[roleId]>"', () => {
+				expect(linkedRoleMention('815434166602170409')).toEqual('<id:linked-roles:815434166602170409>');
+			});
+		});
+
 		describe('chatInputApplicationCommandMention', () => {
 			test('GIVEN commandName and commandId THEN returns "</[commandName]:[commandId]>"', () => {
 				expect(chatInputApplicationCommandMention('airhorn', '815434166602170409')).toEqual(
diff --git a/packages/formatters/src/formatters.ts b/packages/formatters/src/formatters.ts
index 5ffa2a9e2..9c4e11932 100644
--- a/packages/formatters/src/formatters.ts
+++ b/packages/formatters/src/formatters.ts
@@ -225,6 +225,16 @@ export function roleMention<RoleId extends Snowflake>(roleId: RoleId): `<@&${Rol
 	return `<@&${roleId}>`;
 }
 
+/**
+ * Formats a role id into a linked role mention.
+ *
+ * @typeParam RoleId - This is inferred by the supplied role id
+ * @param roleId - The role id to format
+ */
+export function linkedRoleMention<RoleId extends Snowflake>(roleId: RoleId): `<id:linked-roles:${RoleId}>` {
+	return `<id:linked-roles:${roleId}>`;
+}
+
 /**
  * Formats an application command name, subcommand group name, subcommand name, and id into an application command mention.
  *
@@ -754,4 +764,8 @@ export enum GuildNavigationMentions {
 	 * {@link https://support.discord.com/hc/articles/13497665141655 | Server Guide} tab.
 	 */
 	Guide = '<id:guide>',
+	/**
+	 * {@link https://support.discord.com/hc/articles/10388356626711 | Linked Roles} tab.
+	 */
+	LinkedRoles = '<id:linked-roles>',
 }