proper JSDoc typing in examples

.gitignore

@@ -3,5 +3,4 @@ node_modules
 .env
 .env.*
 !.env.example
-commands/examples
 docs

README.md

@@ -4,8 +4,8 @@
 
 - Create a new repository from this template.
 - Remove example commands:
-    - Either permanently delete directory `commands/examples/`
-    - Or move `commands/examples/` elsewhere, commit deletion, add to [`.gitignore`](.gitignore) and move back in
+  - Either permanently delete directory `commands/examples/`
+  - Or move `commands/examples/` elsewhere, commit deletion, add to [`.gitignore`](.gitignore) and move back in
 - Look through, copy and/or modify the [examples](commands/examples/).
 - Either read a [guide](https://discordjs.guide/)!
 - Or read the [docs](https://discord.js.org/docs)!

commands/examples/login.example.js

@@ -9,9 +9,11 @@ import {
 export const data = new SlashCommandBuilder()
 	.setName('login')
 	.setDescription('Opens a login pop-up.');
+/** @param {ModalSubmitInteraction} interaction */
 export async function modalSubmit(interaction) {
 	await interaction.reply({ content: 'Successfully submitted Form!', ephemeral: true });
 }
+/** @param {ChatInputCommandInteraction} interaction */
 export async function execute(interaction) {
 	const modal = new ModalBuilder().setCustomId('login-modal').setTitle('Login Form');
 

commands/examples/ping.example.js

@@ -1,6 +1,7 @@
 import { SlashCommandBuilder } from 'discord.js';
 
 export const data = new SlashCommandBuilder().setName('ping').setDescription('Replies with Pong!');
+/** @param {ChatInputCommandInteraction} interaction */
 export async function execute(interaction) {
 	await interaction.reply({ content: 'Pong!', ephemeral: true });
 }

commands/examples/role.example.js

@@ -1,4 +1,5 @@
 import {
+	ChatInputCommandInteraction,
 	ActionRowBuilder,
 	ComponentType,
 	RoleSelectMenuBuilder,
@@ -9,6 +10,7 @@ export const data = new SlashCommandBuilder()
 	.setName('role')
 	.setDMPermission(false)
 	.setDescription('Provides a role selector.');
+/** @param {ChatInputCommandInteraction} interaction */
 export async function execute(interaction) {
 	const roles = await interaction.guild.roles.fetch();
 	const choices = roles.filter((r) => r.name.startsWith('test')).map((r) => r.id);