Nomchy/discord.js
1
0
Fork 0
mirror of https://github.com/discordjs/discord.js.git synced 2026-03-20 05:23:31 +01:00
Code Issues Packages Projects Releases Wiki Activity

docs(formatters): Enhance the documentation (#9364)

Browse Source
This commit is contained in:
Jiralite
2023-04-10 21:29:06 +01:00
committed by GitHub
parent 8073561824
commit 23e0ac56f4
3 changed files with 173 additions and 111 deletions
Download Patch File Download Diff File Expand all files Collapse all files

19
packages/formatters/__tests__/formatters.test.ts
View File

@@ -240,16 +240,19 @@ describe('Message formatters', () => {
}); });
describe('Faces', () => { describe('Faces', () => {
test('GIVEN Faces.Shrug THEN returns "¯\\_(ツ)\\_/¯"', () => { // prettier-ignore
expect<'¯\\_(ツ)\\_/¯'>(Faces.Shrug).toEqual('¯\\_(ツ)\\_/¯'); /* eslint-disable no-useless-escape */
test('GIVEN Faces.Shrug THEN returns "¯\_(ツ)_/¯"', () => {
expect<'¯\_(ツ)_/¯'>(Faces.Shrug).toEqual('¯\_(ツ)_/¯');
});
/* eslint-enable no-useless-escape */
test('GIVEN Faces.Tableflip THEN returns "(╯°□°)╯︵ ┻━┻"', () => {
expect<'(╯°□°)╯︵ ┻━┻'>(Faces.Tableflip).toEqual('(╯°□°)╯︵ ┻━┻');
}); });
test('GIVEN Faces.Tableflip THEN returns "(╯°□°）╯︵ ┻━┻"', () => { test('GIVEN Faces.Unflip THEN returns "┬─┬ノ( º _ ºノ)"', () => {
expect<'(╯°□°）╯︵ ┻━┻'>(Faces.Tableflip).toEqual('(╯°□°）╯︵ ┻━┻'); expect<'┬─┬ノ( º _ ºノ)'>(Faces.Unflip).toEqual('┬─┬ノ( º _ ºノ)');
});
test('GIVEN Faces.Unflip THEN returns "┬─┬ ノ( ゜-゜ノ)"', () => {
expect<'┬─┬ ノ( ゜-゜ノ)'>(Faces.Unflip).toEqual('┬─┬ ノ( ゜-゜ノ)');
}); });
}); });
}); });

61
packages/formatters/src/escapers.ts
View File

@@ -1,106 +1,109 @@
/* eslint-disable prefer-named-capture-group */ /* eslint-disable prefer-named-capture-group */
/**
* The options that affect what will be escaped.
*/
export interface EscapeMarkdownOptions { export interface EscapeMarkdownOptions {
/** /**
* Whether to escape bolds * Whether to escape bold text.
* *
* @defaultValue true * @defaultValue `true`
*/ */
bold?: boolean; bold?: boolean;
/** /**
* Whether to escape bulleted lists * Whether to escape bulleted lists.
* *
* @defaultValue false * @defaultValue `false`
*/ */
bulletedList?: boolean; bulletedList?: boolean;
/** /**
* Whether to escape code blocks * Whether to escape code blocks.
* *
* @defaultValue true * @defaultValue `true`
*/ */
codeBlock?: boolean; codeBlock?: boolean;
/** /**
* Whether to escape text inside code blocks * Whether to escape text inside code blocks.
* *
* @defaultValue true * @defaultValue `true`
*/ */
codeBlockContent?: boolean; codeBlockContent?: boolean;
/** /**
* Whether to escape escape characters * Whether to escape `\`.
* *
* @defaultValue true * @defaultValue `true`
*/ */
escape?: boolean; escape?: boolean;
/** /**
* Whether to escape headings * Whether to escape headings.
* *
* @defaultValue false * @defaultValue `false`
*/ */
heading?: boolean; heading?: boolean;
/** /**
* Whether to escape inline code * Whether to escape inline code.
* *
* @defaultValue true * @defaultValue `true`
*/ */
inlineCode?: boolean; inlineCode?: boolean;
/** /**
* Whether to escape text inside inline code * Whether to escape text inside inline code.
* *
* @defaultValue true * @defaultValue `true`
*/ */
inlineCodeContent?: boolean; inlineCodeContent?: boolean;
/** /**
* Whether to escape italics * Whether to escape italics.
* *
* @defaultValue true * @defaultValue `true`
*/ */
italic?: boolean; italic?: boolean;
/** /**
* Whether to escape masked links * Whether to escape masked links.
* *
* @defaultValue false * @defaultValue `false`
*/ */
maskedLink?: boolean; maskedLink?: boolean;
/** /**
* Whether to escape numbered lists * Whether to escape numbered lists.
* *
* @defaultValue false * @defaultValue `false`
*/ */
numberedList?: boolean; numberedList?: boolean;
/** /**
* Whether to escape spoilers * Whether to escape spoilers.
* *
* @defaultValue true * @defaultValue `true`
*/ */
spoiler?: boolean; spoiler?: boolean;
/** /**
* Whether to escape strikethroughs * Whether to escape strikethroughs.
* *
* @defaultValue true * @defaultValue `true`
*/ */
strikethrough?: boolean; strikethrough?: boolean;
/** /**
* Whether to escape underlines * Whether to escape underlines.
* *
* @defaultValue true * @defaultValue `true`
*/ */
underline?: boolean; underline?: boolean;
} }
/** /**
* Escapes any Discord-flavour markdown in a string. * Escapes any Discord-flavored markdown in a string.
* *
* @param text - Content to escape * @param text - Content to escape
* @param options - Options for escaping the markdown * @param options - Options for escaping the markdown

204
packages/formatters/src/formatters.ts
View File

@@ -2,26 +2,31 @@ import type { URL } from 'node:url';
import type { Snowflake } from 'discord-api-types/globals'; import type { Snowflake } from 'discord-api-types/globals';
/** /**
* Wraps the content inside a codeblock with no language * Wraps the content inside a code block with no language.
* *
* @typeParam C - This is inferred by the supplied content
* @param content - The content to wrap * @param content - The content to wrap
*/ */
export function codeBlock<C extends string>(content: C): `\`\`\`\n${C}\n\`\`\``; export function codeBlock<C extends string>(content: C): `\`\`\`\n${C}\n\`\`\``;
/** /**
* Wraps the content inside a codeblock with the specified language * Wraps the content inside a code block with the specified language.
* *
* @param language - The language for the codeblock * @typeParam L - This is inferred by the supplied language
* @typeParam C - This is inferred by the supplied content
* @param language - The language for the code block
* @param content - The content to wrap * @param content - The content to wrap
*/ */
export function codeBlock<L extends string, C extends string>(language: L, content: C): `\`\`\`${L}\n${C}\n\`\`\``; export function codeBlock<L extends string, C extends string>(language: L, content: C): `\`\`\`${L}\n${C}\n\`\`\``;
export function codeBlock(language: string, content?: string): string { export function codeBlock(language: string, content?: string): string {
return content === undefined ? `\`\`\`\n${language}\n\`\`\`` : `\`\`\`${language}\n${content}\n\`\`\``; return content === undefined ? `\`\`\`\n${language}\n\`\`\`` : `\`\`\`${language}\n${content}\n\`\`\``;
} }
/** /**
* Wraps the content inside \`backticks\`, which formats it as inline code * Wraps the content inside \`backticks\` which formats it as inline code.
* *
* @typeParam C - This is inferred by the supplied content
* @param content - The content to wrap * @param content - The content to wrap
*/ */
export function inlineCode<C extends string>(content: C): `\`${C}\`` { export function inlineCode<C extends string>(content: C): `\`${C}\`` {
@@ -29,8 +34,9 @@ export function inlineCode<C extends string>(content: C): `\`${C}\`` {
} }
/** /**
* Formats the content into italic text * Formats the content into italic text.
* *
* @typeParam C - This is inferred by the supplied content
* @param content - The content to wrap * @param content - The content to wrap
*/ */
export function italic<C extends string>(content: C): `_${C}_` { export function italic<C extends string>(content: C): `_${C}_` {
@@ -38,8 +44,9 @@ export function italic<C extends string>(content: C): `_${C}_` {
} }
/** /**
* Formats the content into bold text * Formats the content into bold text.
* *
* @typeParam C - This is inferred by the supplied content
* @param content - The content to wrap * @param content - The content to wrap
*/ */
export function bold<C extends string>(content: C): `**${C}**` { export function bold<C extends string>(content: C): `**${C}**` {
@@ -47,8 +54,9 @@ export function bold<C extends string>(content: C): `**${C}**` {
} }
/** /**
* Formats the content into underscored text * Formats the content into underscored text.
* *
* @typeParam C - This is inferred by the supplied content
* @param content - The content to wrap * @param content - The content to wrap
*/ */
export function underscore<C extends string>(content: C): `__${C}__` { export function underscore<C extends string>(content: C): `__${C}__` {
@@ -56,8 +64,9 @@ export function underscore<C extends string>(content: C): `__${C}__` {
} }
/** /**
* Formats the content into strike-through text * Formats the content into strike-through text.
* *
* @typeParam C - This is inferred by the supplied content
* @param content - The content to wrap * @param content - The content to wrap
*/ */
export function strikethrough<C extends string>(content: C): `~~${C}~~` { export function strikethrough<C extends string>(content: C): `~~${C}~~` {
@@ -65,8 +74,10 @@ export function strikethrough<C extends string>(content: C): `~~${C}~~` {
} }
/** /**
* Formats the content into a quote. This needs to be at the start of the line for Discord to format it * Formats the content into a quote.
* *
* @remarks This needs to be at the start of the line for Discord to format it.
* @typeParam C - This is inferred by the supplied content
* @param content - The content to wrap * @param content - The content to wrap
*/ */
export function quote<C extends string>(content: C): `> ${C}` { export function quote<C extends string>(content: C): `> ${C}` {
@@ -74,8 +85,10 @@ export function quote<C extends string>(content: C): `> ${C}` {
} }
/** /**
* Formats the content into a block quote. This needs to be at the start of the line for Discord to format it * Formats the content into a block quote.
* *
* @remarks This needs to be at the start of the line for Discord to format it.
* @typeParam C - This is inferred by the supplied content
* @param content - The content to wrap * @param content - The content to wrap
*/ */
export function blockQuote<C extends string>(content: C): `>>> ${C}` { export function blockQuote<C extends string>(content: C): `>>> ${C}` {
@@ -83,41 +96,48 @@ export function blockQuote<C extends string>(content: C): `>>> ${C}` {
} }
/** /**
* Wraps the URL into `<>`, which stops it from embedding * Wraps the URL into `<>` which stops it from embedding.
* *
* @typeParam C - This is inferred by the supplied content
* @param url - The URL to wrap * @param url - The URL to wrap
*/ */
export function hideLinkEmbed<C extends string>(url: C): `<${C}>`; export function hideLinkEmbed<C extends string>(url: C): `<${C}>`;
/** /**
* Wraps the URL into `<>`, which stops it from embedding * Wraps the URL into `<>` which stops it from embedding.
* *
* @param url - The URL to wrap * @param url - The URL to wrap
*/ */
export function hideLinkEmbed(url: URL): `<${string}>`; export function hideLinkEmbed(url: URL): `<${string}>`;
export function hideLinkEmbed(url: URL | string) { export function hideLinkEmbed(url: URL | string) {
return `<${url}>`; return `<${url}>`;
} }
/** /**
* Formats the content and the URL into a masked URL * Formats the content and the URL into a masked URL.
* *
* @typeParam C - This is inferred by the supplied content
* @param content - The content to display * @param content - The content to display
* @param url - The URL the content links to * @param url - The URL the content links to
*/ */
export function hyperlink<C extends string>(content: C, url: URL): `[${C}](${string})`; export function hyperlink<C extends string>(content: C, url: URL): `[${C}](${string})`;
/** /**
* Formats the content and the URL into a masked URL * Formats the content and the URL into a masked URL.
* *
* @typeParam C - This is inferred by the supplied content
* @typeParam U - This is inferred by the supplied URL
* @param content - The content to display * @param content - The content to display
* @param url - The URL the content links to * @param url - The URL the content links to
*/ */
export function hyperlink<C extends string, U extends string>(content: C, url: U): `[${C}](${U})`; export function hyperlink<C extends string, U extends string>(content: C, url: U): `[${C}](${U})`;
/** /**
* Formats the content and the URL into a masked URL * Formats the content and the URL into a masked URL with a custom tooltip.
* *
* @typeParam C - This is inferred by the supplied content
* @typeParam T - This is inferred by the supplied title
* @param content - The content to display * @param content - The content to display
* @param url - The URL the content links to * @param url - The URL the content links to
* @param title - The title shown when hovering on the masked link * @param title - The title shown when hovering on the masked link
@@ -129,8 +149,11 @@ export function hyperlink<C extends string, T extends string>(
): `[${C}](${string} "${T}")`; ): `[${C}](${string} "${T}")`;
/** /**
* Formats the content and the URL into a masked URL * Formats the content and the URL into a masked URL with a custom tooltip.
* *
* @typeParam C - This is inferred by the supplied content
* @typeParam U - This is inferred by the supplied URL
* @typeParam T - This is inferred by the supplied title
* @param content - The content to display * @param content - The content to display
* @param url - The URL the content links to * @param url - The URL the content links to
* @param title - The title shown when hovering on the masked link * @param title - The title shown when hovering on the masked link
@@ -140,13 +163,15 @@ export function hyperlink<C extends string, U extends string, T extends string>(
url: U, url: U,
title: T, title: T,
): `[${C}](${U} "${T}")`; ): `[${C}](${U} "${T}")`;
export function hyperlink(content: string, url: URL | string, title?: string) { export function hyperlink(content: string, url: URL | string, title?: string) {
return title ? `[${content}](${url} "${title}")` : `[${content}](${url})`; return title ? `[${content}](${url} "${title}")` : `[${content}](${url})`;
} }
/** /**
* Wraps the content inside spoiler (hidden text) * Formats the content into a spoiler.
* *
* @typeParam C - This is inferred by the supplied content
* @param content - The content to wrap * @param content - The content to wrap
*/ */
export function spoiler<C extends string>(content: C): `||${C}||` { export function spoiler<C extends string>(content: C): `||${C}||` {
@@ -154,39 +179,46 @@ export function spoiler<C extends string>(content: C): `||${C}||` {
} }
/** /**
* Formats a user ID into a user mention * Formats a user id into a user mention.
* *
* @param userId - The user ID to format * @typeParam C - This is inferred by the supplied user id
* @param userId - The user id to format
*/ */
export function userMention<C extends Snowflake>(userId: C): `<@${C}>` { export function userMention<C extends Snowflake>(userId: C): `<@${C}>` {
return `<@${userId}>`; return `<@${userId}>`;
} }
/** /**
* Formats a channel ID into a channel mention * Formats a channel id into a channel mention.
* *
* @param channelId - The channel ID to format * @typeParam C - This is inferred by the supplied channel id
* @param channelId - The channel id to format
*/ */
export function channelMention<C extends Snowflake>(channelId: C): `<#${C}>` { export function channelMention<C extends Snowflake>(channelId: C): `<#${C}>` {
return `<#${channelId}>`; return `<#${channelId}>`;
} }
/** /**
* Formats a role ID into a role mention * Formats a role id into a role mention.
* *
* @param roleId - The role ID to format * @typeParam C - This is inferred by the supplied role id
* @param roleId - The role id to format
*/ */
export function roleMention<C extends Snowflake>(roleId: C): `<@&${C}>` { export function roleMention<C extends Snowflake>(roleId: C): `<@&${C}>` {
return `<@&${roleId}>`; return `<@&${roleId}>`;
} }
/** /**
* Formats an application command name, subcommand group name, subcommand name, and ID into an application command mention * Formats an application command name, subcommand group name, subcommand name, and id into an application command mention.
* *
* @typeParam N - This is inferred by the supplied command name
* @typeParam G - This is inferred by the supplied subcommand group name
* @typeParam S - This is inferred by the supplied subcommand name
* @typeParam I - This is inferred by the supplied command id
* @param commandName - The application command name to format * @param commandName - The application command name to format
* @param subcommandGroupName - The subcommand group name to format * @param subcommandGroupName - The subcommand group name to format
* @param subcommandName - The subcommand name to format * @param subcommandName - The subcommand name to format
* @param commandId - The application command ID to format * @param commandId - The application command id to format
*/ */
export function chatInputApplicationCommandMention< export function chatInputApplicationCommandMention<
N extends string, N extends string,
@@ -196,11 +228,14 @@ export function chatInputApplicationCommandMention<
>(commandName: N, subcommandGroupName: G, subcommandName: S, commandId: I): `</${N} ${G} ${S}:${I}>`; >(commandName: N, subcommandGroupName: G, subcommandName: S, commandId: I): `</${N} ${G} ${S}:${I}>`;
/** /**
* Formats an application command name, subcommand name, and ID into an application command mention * Formats an application command name, subcommand name, and id into an application command mention.
* *
* @typeParam N - This is inferred by the supplied command name
* @typeParam S - This is inferred by the supplied subcommand name
* @typeParam I - This is inferred by the supplied command id
* @param commandName - The application command name to format * @param commandName - The application command name to format
* @param subcommandName - The subcommand name to format * @param subcommandName - The subcommand name to format
* @param commandId - The application command ID to format * @param commandId - The application command id to format
*/ */
export function chatInputApplicationCommandMention<N extends string, S extends string, I extends Snowflake>( export function chatInputApplicationCommandMention<N extends string, S extends string, I extends Snowflake>(
commandName: N, commandName: N,
@@ -209,24 +244,18 @@ export function chatInputApplicationCommandMention<N extends string, S extends s
): `</${N} ${S}:${I}>`; ): `</${N} ${S}:${I}>`;
/** /**
* Formats an application command name and ID into an application command mention * Formats an application command name and id into an application command mention.
* *
* @typeParam N - This is inferred by the supplied command name
* @typeParam I - This is inferred by the supplied command id
* @param commandName - The application command name to format * @param commandName - The application command name to format
* @param commandId - The application command ID to format * @param commandId - The application command id to format
*/ */
export function chatInputApplicationCommandMention<N extends string, I extends Snowflake>( export function chatInputApplicationCommandMention<N extends string, I extends Snowflake>(
commandName: N, commandName: N,
commandId: I, commandId: I,
): `</${N}:${I}>`; ): `</${N}:${I}>`;
/**
* Formats an application command name, subcommand group name, subcommand name, and ID into an application command mention
*
* @param commandName - The application command name to format
* @param subcommandGroupName - The subcommand group name to format
* @param subcommandName - The subcommand name to format
* @param commandId - The application command ID to format
*/
export function chatInputApplicationCommandMention< export function chatInputApplicationCommandMention<
N extends string, N extends string,
G extends Snowflake | string, G extends Snowflake | string,
@@ -250,34 +279,31 @@ export function chatInputApplicationCommandMention<
} }
/** /**
* Formats an emoji ID into a fully qualified emoji identifier * Formats a non-animated emoji id into a fully qualified emoji identifier.
* *
* @param emojiId - The emoji ID to format * @typeParam C - This is inferred by the supplied emoji id
* @param emojiId - The emoji id to format
*/ */
export function formatEmoji<C extends Snowflake>(emojiId: C, animated?: false): `<:_:${C}>`; export function formatEmoji<C extends Snowflake>(emojiId: C, animated?: false): `<:_:${C}>`;
/** /**
* Formats an emoji ID into a fully qualified emoji identifier * Formats an animated emoji id into a fully qualified emoji identifier.
* *
* @param emojiId - The emoji ID to format * @typeParam C - This is inferred by the supplied emoji id
* @param animated - Whether the emoji is animated or not. Defaults to `false` * @param emojiId - The emoji id to format
* @param animated - Whether the emoji is animated
*/ */
export function formatEmoji<C extends Snowflake>(emojiId: C, animated?: true): `<a:_:${C}>`; export function formatEmoji<C extends Snowflake>(emojiId: C, animated?: true): `<a:_:${C}>`;
/** /**
* Formats an emoji ID into a fully qualified emoji identifier * Formats an emoji id into a fully qualified emoji identifier.
* *
* @param emojiId - The emoji ID to format * @typeParam C - This is inferred by the supplied emoji id
* @param animated - Whether the emoji is animated or not. Defaults to `false` * @param emojiId - The emoji id to format
* @param animated - Whether the emoji is animated
*/ */
export function formatEmoji<C extends Snowflake>(emojiId: C, animated?: boolean): `<:_:${C}>` | `<a:_:${C}>`; export function formatEmoji<C extends Snowflake>(emojiId: C, animated?: boolean): `<:_:${C}>` | `<a:_:${C}>`;
/**
* Formats an emoji ID into a fully qualified emoji identifier
*
* @param emojiId - The emoji ID to format
* @param animated - Whether the emoji is animated or not. Defaults to `false`
*/
export function formatEmoji<C extends Snowflake>(emojiId: C, animated = false): `<:_:${C}>` | `<a:_:${C}>` { export function formatEmoji<C extends Snowflake>(emojiId: C, animated = false): `<:_:${C}>` | `<a:_:${C}>` {
return `<${animated ? 'a' : ''}:_:${emojiId}>`; return `<${animated ? 'a' : ''}:_:${emojiId}>`;
} }
@@ -285,6 +311,7 @@ export function formatEmoji<C extends Snowflake>(emojiId: C, animated = false):
/** /**
* Formats a channel link for a direct message channel. * Formats a channel link for a direct message channel.
* *
* @typeParam C - This is inferred by the supplied channel id
* @param channelId - The channel's id * @param channelId - The channel's id
*/ */
export function channelLink<C extends Snowflake>(channelId: C): `https://discord.com/channels/@me/${C}`; export function channelLink<C extends Snowflake>(channelId: C): `https://discord.com/channels/@me/${C}`;
@@ -292,6 +319,8 @@ export function channelLink<C extends Snowflake>(channelId: C): `https://discord
/** /**
* Formats a channel link for a guild channel. * Formats a channel link for a guild channel.
* *
* @typeParam C - This is inferred by the supplied channel id
* @typeParam G - This is inferred by the supplied guild id
* @param channelId - The channel's id * @param channelId - The channel's id
* @param guildId - The guild's id * @param guildId - The guild's id
*/ */
@@ -310,6 +339,8 @@ export function channelLink<C extends Snowflake, G extends Snowflake>(
/** /**
* Formats a message link for a direct message channel. * Formats a message link for a direct message channel.
* *
* @typeParam C - This is inferred by the supplied channel id
* @typeParam M - This is inferred by the supplied message id
* @param channelId - The channel's id * @param channelId - The channel's id
* @param messageId - The message's id * @param messageId - The message's id
*/ */
@@ -321,6 +352,9 @@ export function messageLink<C extends Snowflake, M extends Snowflake>(
/** /**
* Formats a message link for a guild channel. * Formats a message link for a guild channel.
* *
* @typeParam C - This is inferred by the supplied channel id
* @typeParam M - This is inferred by the supplied message id
* @typeParam G - This is inferred by the supplied guild id
* @param channelId - The channel's id * @param channelId - The channel's id
* @param messageId - The message's id * @param messageId - The message's id
* @param guildId - The guild's id * @param guildId - The guild's id
@@ -340,34 +374,39 @@ export function messageLink<C extends Snowflake, M extends Snowflake, G extends
} }
/** /**
* Formats a date into a short date-time string * Formats a date into a short date-time string.
* *
* @param date - The date to format, defaults to the current time * @param date - The date to format. Defaults to the current time
*/ */
export function time(date?: Date): `<t:${bigint}>`; export function time(date?: Date): `<t:${bigint}>`;
/** /**
* Formats a date given a format style * Formats a date given a format style.
* *
* @typeParam S - This is inferred by the supplied {@link TimestampStylesString}
* @param date - The date to format * @param date - The date to format
* @param style - The style to use * @param style - The style to use
*/ */
export function time<S extends TimestampStylesString>(date: Date, style: S): `<t:${bigint}:${S}>`; export function time<S extends TimestampStylesString>(date: Date, style: S): `<t:${bigint}:${S}>`;
/** /**
* Formats the given timestamp into a short date-time string * Formats the given timestamp into a short date-time string.
* *
* @param seconds - The time to format, represents an UNIX timestamp in seconds * @typeParam C - This is inferred by the supplied timestamp
* @param seconds - A Unix timestamp in seconds
*/ */
export function time<C extends number>(seconds: C): `<t:${C}>`; export function time<C extends number>(seconds: C): `<t:${C}>`;
/** /**
* Formats the given timestamp into a short date-time string * Formats the given timestamp into a short date-time string.
* *
* @param seconds - The time to format, represents an UNIX timestamp in seconds * @typeParam C - This is inferred by the supplied timestamp
* @typeParam S - This is inferred by the supplied {@link TimestampStylesString}
* @param seconds - A Unix timestamp in seconds
* @param style - The style to use * @param style - The style to use
*/ */
export function time<C extends number, S extends TimestampStylesString>(seconds: C, style: S): `<t:${C}:${S}>`; export function time<C extends number, S extends TimestampStylesString>(seconds: C, style: S): `<t:${C}:${S}>`;
export function time(timeOrSeconds?: Date | number, style?: TimestampStylesString): string { export function time(timeOrSeconds?: Date | number, style?: TimestampStylesString): string {
if (typeof timeOrSeconds !== 'number') { if (typeof timeOrSeconds !== 'number') {
// eslint-disable-next-line no-param-reassign // eslint-disable-next-line no-param-reassign
@@ -378,66 +417,83 @@ export function time(timeOrSeconds?: Date | number, style?: TimestampStylesStrin
} }
/** /**
* The {@link https://discord.com/developers/docs/reference#message-formatting-timestamp-styles | message formatting timestamp styles} supported by Discord * The {@link https://discord.com/developers/docs/reference#message-formatting-timestamp-styles | message formatting timestamp styles}
* supported by Discord.
*/ */
export const TimestampStyles = { export const TimestampStyles = {
/** /**
* Short time format, consisting of hours and minutes, e.g. 16:20 * Short time format, consisting of hours and minutes.
*
* @example `16:20`
*/ */
ShortTime: 't', ShortTime: 't',
/** /**
* Long time format, consisting of hours, minutes, and seconds, e.g. 16:20:30 * Long time format, consisting of hours, minutes, and seconds.
*
* @example `16:20:30`
*/ */
LongTime: 'T', LongTime: 'T',
/** /**
* Short date format, consisting of day, month, and year, e.g. 20/04/2021 * Short date format, consisting of day, month, and year.
*
* @example `20/04/2021`
*/ */
ShortDate: 'd', ShortDate: 'd',
/** /**
* Long date format, consisting of day, month, and year, e.g. 20 April 2021 * Long date format, consisting of day, month, and year.
*
* @example `20 April 2021`
*/ */
LongDate: 'D', LongDate: 'D',
/** /**
* Short date-time format, consisting of short date and short time formats, e.g. 20 April 2021 16:20 * Short date-time format, consisting of short date and short time formats.
*
* @example `20 April 2021 16:20`
*/ */
ShortDateTime: 'f', ShortDateTime: 'f',
/** /**
* Long date-time format, consisting of long date and short time formats, e.g. Tuesday, 20 April 2021 16:20 * Long date-time format, consisting of long date and short time formats.
*
* @example `Tuesday, 20 April 2021 16:20`
*/ */
LongDateTime: 'F', LongDateTime: 'F',
/** /**
* Relative time format, consisting of a relative duration format, e.g. 2 months ago * Relative time format, consisting of a relative duration format.
*
* @example `2 months ago`
*/ */
RelativeTime: 'R', RelativeTime: 'R',
} as const satisfies Record<string, string>; } as const satisfies Record<string, string>;
/** /**
* The possible values, see {@link TimestampStyles} for more information * The possible {@link TimestampStyles} values.
*/ */
export type TimestampStylesString = (typeof TimestampStyles)[keyof typeof TimestampStyles]; export type TimestampStylesString = (typeof TimestampStyles)[keyof typeof TimestampStyles];
// prettier-ignore
/** /**
* An enum with all the available faces from Discord's native slash commands * All the available faces from Discord's native slash commands.
*/ */
export enum Faces { export enum Faces {
/** /**
* ¯\\_(ツ)\\_/¯ * `¯\_(ツ)_/¯`
*/ */
Shrug = '¯\\_(ツ)\\_/¯', // eslint-disable-next-line no-useless-escape
Shrug = '¯\_(ツ)_/¯',
/** /**
* (╯°□°）╯︵ ┻━┻ * `(╯°□°)╯︵ ┻━┻`
*/ */
Tableflip = '(╯°□°）╯︵ ┻━┻', Tableflip = '(╯°□°)╯︵ ┻━┻',
/** /**
* ┬─┬ ノ( ゜-゜ノ) * `┬─┬ノ( º _ ºノ)`
*/ */
Unflip = '┬─┬ ノ( ゜-゜ノ)', Unflip = '┬─┬ノ( º _ ºノ)',
} }