docs: add missing, fix existing

Author: almeidx

packages/builders/src/components/ActionRow.ts

@@ -43,10 +43,11 @@ export interface ActionRowBuilderData
 
 /**
  * A builder that creates API-compatible JSON data for action rows.
- *
- * @typeParam ComponentType - The types of components this action row holds
  */
 export class ActionRowBuilder extends ComponentBuilder<APIActionRowComponent<APIComponentInActionRow>> {
+	/**
+	 * @internal
+	 */
 	protected readonly data: ActionRowBuilderData;
 
 	/**
@@ -94,8 +95,8 @@ export class ActionRowBuilder extends ComponentBuilder<APIActionRowComponent<API
 		super();
 		this.data = {
 			...structuredClone(data),
-			type: ComponentType.ActionRow,
 			components: components.map((component) => createComponentBuilder(component)),
+			type: ComponentType.ActionRow,
 		};
 	}
 

packages/builders/src/components/Component.ts

@@ -13,6 +13,9 @@ export interface ComponentBuilderBaseData {
 export abstract class ComponentBuilder<Component extends APIBaseComponent<ComponentType>>
 	implements JSONEncodable<Component>
 {
+	/**
+	 * @internal
+	 */
 	protected abstract readonly data: ComponentBuilderBaseData;
 
 	/**

packages/builders/src/components/button/Button.ts

@@ -7,6 +7,9 @@ import { ComponentBuilder } from '../Component.js';
  * A builder that creates API-compatible JSON data for buttons.
  */
 export abstract class BaseButtonBuilder<ButtonData extends APIButtonComponent> extends ComponentBuilder<ButtonData> {
+	/**
+	 * @internal
+	 */
 	declare protected readonly data: Partial<ButtonData>;
 
 	/**

packages/builders/src/components/button/CustomIdButton.ts

@@ -7,6 +7,9 @@ export type CustomIdButtonStyle = APIButtonComponentWithCustomId['style'];
 
 /**
  * A builder that creates API-compatible JSON data for buttons with custom IDs.
+ *
+ * @mixes BaseButtonBuilder<APIButtonComponentWithCustomId>
+ * @mixes EmojiOrLabelButtonMixin
  */
 export abstract class CustomIdButtonBuilder extends Mixin(
 	BaseButtonBuilder<APIButtonComponentWithCustomId>,

packages/builders/src/components/button/LinkButton.ts

@@ -10,6 +10,9 @@ import { EmojiOrLabelButtonMixin } from './mixins/EmojiOrLabelButtonMixin.js';
 
 /**
  * A builder that creates API-compatible JSON data for buttons with links.
+ *
+ * @mixes BaseButtonBuilder<APIButtonComponentWithURL>
+ * @mixes EmojiOrLabelButtonMixin
  */
 export class LinkButtonBuilder extends Mixin(BaseButtonBuilder<APIButtonComponentWithURL>, EmojiOrLabelButtonMixin) {
 	protected override readonly data: Partial<APIButtonComponentWithURL>;

packages/builders/src/components/button/mixins/EmojiOrLabelButtonMixin.ts

@@ -3,7 +3,13 @@ import type { APIButtonComponent, APIButtonComponentWithSKUId, APIMessageCompone
 export interface EmojiOrLabelButtonData
 	extends Pick<Exclude<APIButtonComponent, APIButtonComponentWithSKUId>, 'emoji' | 'label'> {}
 
+/**
+ * A mixin that adds emoji and label symbols to a button builder.
+ */
 export class EmojiOrLabelButtonMixin {
+	/**
+	 * @internal
+	 */
 	declare protected readonly data: EmojiOrLabelButtonData;
 
 	/**

packages/builders/src/components/selectMenu/BaseSelectMenu.ts

@@ -5,12 +5,15 @@ import { ComponentBuilder } from '../Component.js';
 /**
  * The base select menu builder that contains common symbols for select menu builders.
  *
- * @typeParam SelectMenuType - The type of select menu this would be instantiated for.
+ * @typeParam Data - The type of API data that is stored within the builder
  */
 export abstract class BaseSelectMenuBuilder<Data extends APISelectMenuComponent>
 	extends ComponentBuilder<Data>
 	implements JSONEncodable<APISelectMenuComponent>
 {
+	/**
+	 * @internal
+	 */
 	protected abstract override readonly data: Partial<
 		Pick<Data, 'custom_id' | 'disabled' | 'id' | 'max_values' | 'min_values' | 'placeholder'>
 	>;

packages/builders/src/components/textInput/TextInput.ts

@@ -7,6 +7,9 @@ import { textInputPredicate } from './Assertions.js';
  * A builder that creates API-compatible JSON data for text inputs.
  */
 export class TextInputBuilder extends ComponentBuilder<APITextInputComponent> {
+	/**
+	 * @internal
+	 */
 	protected readonly data: Partial<APITextInputComponent>;
 
 	/**

packages/builders/src/components/v2/Container.ts

@@ -1,3 +1,5 @@
+/* eslint-disable jsdoc/check-param-names */
+
 import type {
 	APIActionRowComponent,
 	APIFileComponent,
@@ -34,13 +36,31 @@ export interface ContainerBuilderData extends Partial<Omit<APIContainerComponent
 	components: ContainerComponentBuilders[];
 }
 
+/**
+ * A builder that creates API-compatible JSON data for containers.
+ */
 export class ContainerBuilder extends ComponentBuilder<APIContainerComponent> {
+	/**
+	 * @internal
+	 */
 	protected readonly data: ContainerBuilderData;
 
-	public constructor({ components = [], ...rest }: Partial<APIContainerComponent> = {}) {
+	/**
+	 * Gets the components within this container.
+	 */
+	public get components(): readonly ContainerComponentBuilders[] {
+		return this.data.components;
+	}
+
+	/**
+	 * Creates a new container builder.
+	 *
+	 * @param data - The API data to create the container with
+	 */
+	public constructor({ components = [], ...data }: Partial<APIContainerComponent> = {}) {
 		super();
 		this.data = {
-			...structuredClone(rest),
+			...structuredClone(data),
 			components: components.map((component) => createComponentBuilder(component)),
 			type: ComponentType.Container,
 		};

packages/builders/src/components/v2/File.ts

@@ -1,9 +1,17 @@
+/* eslint-disable jsdoc/check-param-names */
+
 import { ComponentType, type APIFileComponent } from 'discord-api-types/v10';
 import { validate } from '../../util/validation.js';
 import { ComponentBuilder } from '../Component.js';
 import { filePredicate } from './Assertions.js';
 
+/**
+ * A builder that creates API-compatible JSON data for files.
+ */
 export class FileBuilder extends ComponentBuilder<APIFileComponent> {
+	/**
+	 * @internal
+	 */
 	protected readonly data: Partial<APIFileComponent>;
 
 	/**
@@ -31,11 +39,11 @@ export class FileBuilder extends ComponentBuilder<APIFileComponent> {
 	 * 	.setSpoiler(false);
 	 * ```
 	 */
-	public constructor(data: Partial<APIFileComponent> = {}) {
+	public constructor({ file, ...rest }: Partial<APIFileComponent> = {}) {
 		super();
 		this.data = {
-			...structuredClone(data),
-			file: data.file ? { url: data.file.url } : undefined,
+			...structuredClone(rest),
+			file: file && { url: file.url },
 			type: ComponentType.File,
 		};
 	}