@buape/carbon 0.10.0 → 0.12.0

package/dist/src/classes/components/ModalMentionableSelectMenu.d.ts

@@ -0,0 +1,58 @@
+import { type APIMentionableSelectComponent, ComponentType } from "discord-api-types/v10";
+import { BaseModalComponent } from "../../abstracts/BaseModalComponent.js";
+import type { MentionableSelectMenuInteraction } from "../../internals/MentionableSelectMenuInteraction.js";
+import type { ComponentParserResult } from "../../types/index.js";
+import type { ComponentData } from "../../types/index.js";
+export declare abstract class ModalMentionableSelectMenu extends BaseModalComponent {
+    readonly type: ComponentType.MentionableSelect;
+    readonly isV2 = false;
+    /**
+     * The custom ID of the component.
+     * If you want to provide a custom ID with additional data, you should either follow the default parser's format or implement your own custom parser.
+     *
+     * @see {@link customIdParser}
+     */
+    abstract customId: string;
+    /**
+     * This function is called by the handler when a component is received, and is used to parse the custom ID into a key and data object.
+     * By default, the ID is parsed in this format: `key:arg1=true;arg2=2;arg3=cheese`, where `arg1`, `arg2`, and `arg3` are the data arguments.
+     * It will also automatically parse `true` and `false` as booleans, and will parse numbers as numbers.
+     *
+     * You can override this to parse the ID in a different format as you see fit, but it must follow these rules:
+     * - The ID must have a `key` somewhere in the ID that can be returned by the parser. This key is what Carbon's component handler will use to identify the component and pass an interaction to the correct component.
+     * - The data must be able to be arbitrary as far as Carbon's handler is concerned, meaning that any component with the same base key can be treated as the same component with logic within the component's logic methods to handle the data.
+     *
+     * @param id - The custom ID of the component as received from an interaction event
+     * @returns The base key and the data object
+     */
+    customIdParser: (id: string) => ComponentParserResult;
+    /**
+     * The minimum number of values that must be selected
+     */
+    minValues?: number;
+    /**
+     * The maximum number of values that can be selected
+     */
+    maxValues?: number;
+    /**
+     * Whether this component is required (defaults to true in modals)
+     */
+    required?: boolean;
+    /**
+     * The placeholder text for the select menu
+     */
+    placeholder?: string;
+    /**
+     * Default values for the select menu
+     */
+    defaultValues?: APIMentionableSelectComponent["default_values"];
+    abstract run(interaction: MentionableSelectMenuInteraction, data: ComponentData): unknown | Promise<unknown>;
+    serialize: () => APIMentionableSelectComponent;
+    /**
+     * The disabled field is not allowed on modal select components
+     * @throws Error when trying to set disabled to true
+     */
+    set disabled(value: boolean | undefined);
+    get disabled(): boolean | undefined;
+}
+//# sourceMappingURL=ModalMentionableSelectMenu.d.ts.map

package/dist/src/classes/components/ModalMentionableSelectMenu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModalMentionableSelectMenu.d.ts","sourceRoot":"","sources":["../../../../src/classes/components/ModalMentionableSelectMenu.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,6BAA6B,EAClC,aAAa,EACb,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAA;AAC1E,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,qDAAqD,CAAA;AAC3G,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAGzD,8BAAsB,0BAA2B,SAAQ,kBAAkB;IAC1E,QAAQ,CAAC,IAAI,kCAA2C;IACxD,QAAQ,CAAC,IAAI,SAAQ;IAErB;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IAEzB;;;;;;;;;;;OAWG;IACH,cAAc,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,qBAAqB,CAAgB;IAErE;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAElB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB;;OAEG;IACH,aAAa,CAAC,EAAE,6BAA6B,CAAC,gBAAgB,CAAC,CAAA;IAE/D,QAAQ,CAAC,GAAG,CACX,WAAW,EAAE,gCAAgC,EAC7C,IAAI,EAAE,aAAa,GACjB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAE7B,SAAS,QAAO,6BAA6B,CAgB5C;IAED;;;OAGG;IACH,IAAI,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,EAMtC;IAED,IAAI,QAAQ,IAAI,OAAO,GAAG,SAAS,CAElC;CACD"}

package/dist/src/classes/components/ModalMentionableSelectMenu.js

@@ -0,0 +1,68 @@
+import { ComponentType } from "discord-api-types/v10";
+import { BaseModalComponent } from "../../abstracts/BaseModalComponent.js";
+import { parseCustomId } from "../../utils/customIdParser.js";
+export class ModalMentionableSelectMenu extends BaseModalComponent {
+    type = ComponentType.MentionableSelect;
+    isV2 = false;
+    /**
+     * This function is called by the handler when a component is received, and is used to parse the custom ID into a key and data object.
+     * By default, the ID is parsed in this format: `key:arg1=true;arg2=2;arg3=cheese`, where `arg1`, `arg2`, and `arg3` are the data arguments.
+     * It will also automatically parse `true` and `false` as booleans, and will parse numbers as numbers.
+     *
+     * You can override this to parse the ID in a different format as you see fit, but it must follow these rules:
+     * - The ID must have a `key` somewhere in the ID that can be returned by the parser. This key is what Carbon's component handler will use to identify the component and pass an interaction to the correct component.
+     * - The data must be able to be arbitrary as far as Carbon's handler is concerned, meaning that any component with the same base key can be treated as the same component with logic within the component's logic methods to handle the data.
+     *
+     * @param id - The custom ID of the component as received from an interaction event
+     * @returns The base key and the data object
+     */
+    customIdParser = parseCustomId;
+    /**
+     * The minimum number of values that must be selected
+     */
+    minValues;
+    /**
+     * The maximum number of values that can be selected
+     */
+    maxValues;
+    /**
+     * Whether this component is required (defaults to true in modals)
+     */
+    required;
+    /**
+     * The placeholder text for the select menu
+     */
+    placeholder;
+    /**
+     * Default values for the select menu
+     */
+    defaultValues;
+    serialize = () => {
+        const data = {
+            type: this.type,
+            custom_id: this.customId,
+            placeholder: this.placeholder,
+            min_values: this.minValues,
+            max_values: this.maxValues,
+            default_values: this.defaultValues
+        };
+        // In modals, required defaults to true
+        if (this.required !== undefined) {
+            data.required = this.required;
+        }
+        return data;
+    };
+    /**
+     * The disabled field is not allowed on modal select components
+     * @throws Error when trying to set disabled to true
+     */
+    set disabled(value) {
+        if (value === true) {
+            throw new Error("The 'disabled' field is not allowed on modal select components");
+        }
+    }
+    get disabled() {
+        return undefined;
+    }
+}
+//# sourceMappingURL=ModalMentionableSelectMenu.js.map

package/dist/src/classes/components/ModalMentionableSelectMenu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModalMentionableSelectMenu.js","sourceRoot":"","sources":["../../../../src/classes/components/ModalMentionableSelectMenu.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,aAAa,EACb,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAA;AAI1E,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAE7D,MAAM,OAAgB,0BAA2B,SAAQ,kBAAkB;IACjE,IAAI,GAAG,aAAa,CAAC,iBAA0B,CAAA;IAC/C,IAAI,GAAG,KAAK,CAAA;IAUrB;;;;;;;;;;;OAWG;IACH,cAAc,GAA0C,aAAa,CAAA;IAErE;;OAEG;IACH,SAAS,CAAS;IAElB;;OAEG;IACH,SAAS,CAAS;IAElB;;OAEG;IACH,QAAQ,CAAU;IAElB;;OAEG;IACH,WAAW,CAAS;IAEpB;;OAEG;IACH,aAAa,CAAkD;IAO/D,SAAS,GAAG,GAAkC,EAAE;QAC/C,MAAM,IAAI,GAAkC;YAC3C,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,SAAS,EAAE,IAAI,CAAC,QAAQ;YACxB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,UAAU,EAAE,IAAI,CAAC,SAAS;YAC1B,UAAU,EAAE,IAAI,CAAC,SAAS;YAC1B,cAAc,EAAE,IAAI,CAAC,aAAa;SAClC,CAAA;QAED,uCAAuC;QACvC,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAA;QAC9B,CAAC;QAED,OAAO,IAAI,CAAA;IACZ,CAAC,CAAA;IAED;;;OAGG;IACH,IAAI,QAAQ,CAAC,KAA0B;QACtC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CACd,gEAAgE,CAChE,CAAA;QACF,CAAC;IACF,CAAC;IAED,IAAI,QAAQ;QACX,OAAO,SAAS,CAAA;IACjB,CAAC;CACD"}

package/dist/src/classes/components/ModalRoleSelectMenu.d.ts

@@ -0,0 +1,58 @@
+import { type APIRoleSelectComponent, ComponentType } from "discord-api-types/v10";
+import { BaseModalComponent } from "../../abstracts/BaseModalComponent.js";
+import type { RoleSelectMenuInteraction } from "../../internals/RoleSelectMenuInteraction.js";
+import type { ComponentParserResult } from "../../types/index.js";
+import type { ComponentData } from "../../types/index.js";
+export declare abstract class ModalRoleSelectMenu extends BaseModalComponent {
+    readonly type: ComponentType.RoleSelect;
+    readonly isV2 = false;
+    /**
+     * The custom ID of the component.
+     * If you want to provide a custom ID with additional data, you should either follow the default parser's format or implement your own custom parser.
+     *
+     * @see {@link customIdParser}
+     */
+    abstract customId: string;
+    /**
+     * This function is called by the handler when a component is received, and is used to parse the custom ID into a key and data object.
+     * By default, the ID is parsed in this format: `key:arg1=true;arg2=2;arg3=cheese`, where `arg1`, `arg2`, and `arg3` are the data arguments.
+     * It will also automatically parse `true` and `false` as booleans, and will parse numbers as numbers.
+     *
+     * You can override this to parse the ID in a different format as you see fit, but it must follow these rules:
+     * - The ID must have a `key` somewhere in the ID that can be returned by the parser. This key is what Carbon's component handler will use to identify the component and pass an interaction to the correct component.
+     * - The data must be able to be arbitrary as far as Carbon's handler is concerned, meaning that any component with the same base key can be treated as the same component with logic within the component's logic methods to handle the data.
+     *
+     * @param id - The custom ID of the component as received from an interaction event
+     * @returns The base key and the data object
+     */
+    customIdParser: (id: string) => ComponentParserResult;
+    /**
+     * The minimum number of values that must be selected
+     */
+    minValues?: number;
+    /**
+     * The maximum number of values that can be selected
+     */
+    maxValues?: number;
+    /**
+     * Whether this component is required (defaults to true in modals)
+     */
+    required?: boolean;
+    /**
+     * The placeholder text for the select menu
+     */
+    placeholder?: string;
+    /**
+     * Default values for the select menu
+     */
+    defaultValues?: APIRoleSelectComponent["default_values"];
+    abstract run(interaction: RoleSelectMenuInteraction, data: ComponentData): unknown | Promise<unknown>;
+    serialize: () => APIRoleSelectComponent;
+    /**
+     * The disabled field is not allowed on modal select components
+     * @throws Error when trying to set disabled to true
+     */
+    set disabled(value: boolean | undefined);
+    get disabled(): boolean | undefined;
+}
+//# sourceMappingURL=ModalRoleSelectMenu.d.ts.map

package/dist/src/classes/components/ModalRoleSelectMenu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModalRoleSelectMenu.d.ts","sourceRoot":"","sources":["../../../../src/classes/components/ModalRoleSelectMenu.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,sBAAsB,EAC3B,aAAa,EACb,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAA;AAC1E,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,8CAA8C,CAAA;AAC7F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAGzD,8BAAsB,mBAAoB,SAAQ,kBAAkB;IACnE,QAAQ,CAAC,IAAI,2BAAoC;IACjD,QAAQ,CAAC,IAAI,SAAQ;IAErB;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IAEzB;;;;;;;;;;;OAWG;IACH,cAAc,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,qBAAqB,CAAgB;IAErE;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAElB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB;;OAEG;IACH,aAAa,CAAC,EAAE,sBAAsB,CAAC,gBAAgB,CAAC,CAAA;IAExD,QAAQ,CAAC,GAAG,CACX,WAAW,EAAE,yBAAyB,EACtC,IAAI,EAAE,aAAa,GACjB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAE7B,SAAS,QAAO,sBAAsB,CAgBrC;IAED;;;OAGG;IACH,IAAI,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,EAMtC;IAED,IAAI,QAAQ,IAAI,OAAO,GAAG,SAAS,CAElC;CACD"}

package/dist/src/classes/components/ModalRoleSelectMenu.js

@@ -0,0 +1,68 @@
+import { ComponentType } from "discord-api-types/v10";
+import { BaseModalComponent } from "../../abstracts/BaseModalComponent.js";
+import { parseCustomId } from "../../utils/customIdParser.js";
+export class ModalRoleSelectMenu extends BaseModalComponent {
+    type = ComponentType.RoleSelect;
+    isV2 = false;
+    /**
+     * This function is called by the handler when a component is received, and is used to parse the custom ID into a key and data object.
+     * By default, the ID is parsed in this format: `key:arg1=true;arg2=2;arg3=cheese`, where `arg1`, `arg2`, and `arg3` are the data arguments.
+     * It will also automatically parse `true` and `false` as booleans, and will parse numbers as numbers.
+     *
+     * You can override this to parse the ID in a different format as you see fit, but it must follow these rules:
+     * - The ID must have a `key` somewhere in the ID that can be returned by the parser. This key is what Carbon's component handler will use to identify the component and pass an interaction to the correct component.
+     * - The data must be able to be arbitrary as far as Carbon's handler is concerned, meaning that any component with the same base key can be treated as the same component with logic within the component's logic methods to handle the data.
+     *
+     * @param id - The custom ID of the component as received from an interaction event
+     * @returns The base key and the data object
+     */
+    customIdParser = parseCustomId;
+    /**
+     * The minimum number of values that must be selected
+     */
+    minValues;
+    /**
+     * The maximum number of values that can be selected
+     */
+    maxValues;
+    /**
+     * Whether this component is required (defaults to true in modals)
+     */
+    required;
+    /**
+     * The placeholder text for the select menu
+     */
+    placeholder;
+    /**
+     * Default values for the select menu
+     */
+    defaultValues;
+    serialize = () => {
+        const data = {
+            type: this.type,
+            custom_id: this.customId,
+            placeholder: this.placeholder,
+            min_values: this.minValues,
+            max_values: this.maxValues,
+            default_values: this.defaultValues
+        };
+        // In modals, required defaults to true
+        if (this.required !== undefined) {
+            data.required = this.required;
+        }
+        return data;
+    };
+    /**
+     * The disabled field is not allowed on modal select components
+     * @throws Error when trying to set disabled to true
+     */
+    set disabled(value) {
+        if (value === true) {
+            throw new Error("The 'disabled' field is not allowed on modal select components");
+        }
+    }
+    get disabled() {
+        return undefined;
+    }
+}
+//# sourceMappingURL=ModalRoleSelectMenu.js.map

package/dist/src/classes/components/ModalRoleSelectMenu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModalRoleSelectMenu.js","sourceRoot":"","sources":["../../../../src/classes/components/ModalRoleSelectMenu.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,aAAa,EACb,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAA;AAI1E,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAE7D,MAAM,OAAgB,mBAAoB,SAAQ,kBAAkB;IAC1D,IAAI,GAAG,aAAa,CAAC,UAAmB,CAAA;IACxC,IAAI,GAAG,KAAK,CAAA;IAUrB;;;;;;;;;;;OAWG;IACH,cAAc,GAA0C,aAAa,CAAA;IAErE;;OAEG;IACH,SAAS,CAAS;IAElB;;OAEG;IACH,SAAS,CAAS;IAElB;;OAEG;IACH,QAAQ,CAAU;IAElB;;OAEG;IACH,WAAW,CAAS;IAEpB;;OAEG;IACH,aAAa,CAA2C;IAOxD,SAAS,GAAG,GAA2B,EAAE;QACxC,MAAM,IAAI,GAA2B;YACpC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,SAAS,EAAE,IAAI,CAAC,QAAQ;YACxB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,UAAU,EAAE,IAAI,CAAC,SAAS;YAC1B,UAAU,EAAE,IAAI,CAAC,SAAS;YAC1B,cAAc,EAAE,IAAI,CAAC,aAAa;SAClC,CAAA;QAED,uCAAuC;QACvC,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAA;QAC9B,CAAC;QAED,OAAO,IAAI,CAAA;IACZ,CAAC,CAAA;IAED;;;OAGG;IACH,IAAI,QAAQ,CAAC,KAA0B;QACtC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CACd,gEAAgE,CAChE,CAAA;QACF,CAAC;IACF,CAAC;IAED,IAAI,QAAQ;QACX,OAAO,SAAS,CAAA;IACjB,CAAC;CACD"}

package/dist/src/classes/components/ModalStringSelectMenu.d.ts

@@ -0,0 +1,58 @@
+import { type APIStringSelectComponent, ComponentType } from "discord-api-types/v10";
+import { BaseModalComponent } from "../../abstracts/BaseModalComponent.js";
+import type { StringSelectMenuInteraction } from "../../internals/StringSelectMenuInteraction.js";
+import type { ComponentParserResult } from "../../types/index.js";
+import type { ComponentData } from "../../types/index.js";
+export declare abstract class ModalStringSelectMenu extends BaseModalComponent {
+    readonly type: ComponentType.StringSelect;
+    readonly isV2 = false;
+    /**
+     * The custom ID of the component.
+     * If you want to provide a custom ID with additional data, you should either follow the default parser's format or implement your own custom parser.
+     *
+     * @see {@link customIdParser}
+     */
+    abstract customId: string;
+    /**
+     * This function is called by the handler when a component is received, and is used to parse the custom ID into a key and data object.
+     * By default, the ID is parsed in this format: `key:arg1=true;arg2=2;arg3=cheese`, where `arg1`, `arg2`, and `arg3` are the data arguments.
+     * It will also automatically parse `true` and `false` as booleans, and will parse numbers as numbers.
+     *
+     * You can override this to parse the ID in a different format as you see fit, but it must follow these rules:
+     * - The ID must have a `key` somewhere in the ID that can be returned by the parser. This key is what Carbon's component handler will use to identify the component and pass an interaction to the correct component.
+     * - The data must be able to be arbitrary as far as Carbon's handler is concerned, meaning that any component with the same base key can be treated as the same component with logic within the component's logic methods to handle the data.
+     *
+     * @param id - The custom ID of the component as received from an interaction event
+     * @returns The base key and the data object
+     */
+    customIdParser: (id: string) => ComponentParserResult;
+    /**
+     * The minimum number of values that must be selected
+     */
+    minValues?: number;
+    /**
+     * The maximum number of values that can be selected
+     */
+    maxValues?: number;
+    /**
+     * Whether this component is required (defaults to true in modals)
+     */
+    required?: boolean;
+    /**
+     * The placeholder text for the select menu
+     */
+    placeholder?: string;
+    /**
+     * The options for the select menu
+     */
+    abstract options: APIStringSelectComponent["options"];
+    abstract run(interaction: StringSelectMenuInteraction, data: ComponentData): unknown | Promise<unknown>;
+    serialize: () => APIStringSelectComponent;
+    /**
+     * The disabled field is not allowed on modal select components
+     * @throws Error when trying to set disabled to true
+     */
+    set disabled(value: boolean | undefined);
+    get disabled(): boolean | undefined;
+}
+//# sourceMappingURL=ModalStringSelectMenu.d.ts.map

package/dist/src/classes/components/ModalStringSelectMenu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModalStringSelectMenu.d.ts","sourceRoot":"","sources":["../../../../src/classes/components/ModalStringSelectMenu.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,wBAAwB,EAC7B,aAAa,EACb,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAA;AAC1E,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,gDAAgD,CAAA;AACjG,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAGzD,8BAAsB,qBAAsB,SAAQ,kBAAkB;IACrE,QAAQ,CAAC,IAAI,6BAAsC;IACnD,QAAQ,CAAC,IAAI,SAAQ;IAErB;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IAEzB;;;;;;;;;;;OAWG;IACH,cAAc,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,qBAAqB,CAAgB;IAErE;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAElB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,wBAAwB,CAAC,SAAS,CAAC,CAAA;IAErD,QAAQ,CAAC,GAAG,CACX,WAAW,EAAE,2BAA2B,EACxC,IAAI,EAAE,aAAa,GACjB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAE7B,SAAS,QAAO,wBAAwB,CAgBvC;IAED;;;OAGG;IACH,IAAI,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,EAMtC;IAED,IAAI,QAAQ,IAAI,OAAO,GAAG,SAAS,CAElC;CACD"}

package/dist/src/classes/components/ModalStringSelectMenu.js

@@ -0,0 +1,64 @@
+import { ComponentType } from "discord-api-types/v10";
+import { BaseModalComponent } from "../../abstracts/BaseModalComponent.js";
+import { parseCustomId } from "../../utils/customIdParser.js";
+export class ModalStringSelectMenu extends BaseModalComponent {
+    type = ComponentType.StringSelect;
+    isV2 = false;
+    /**
+     * This function is called by the handler when a component is received, and is used to parse the custom ID into a key and data object.
+     * By default, the ID is parsed in this format: `key:arg1=true;arg2=2;arg3=cheese`, where `arg1`, `arg2`, and `arg3` are the data arguments.
+     * It will also automatically parse `true` and `false` as booleans, and will parse numbers as numbers.
+     *
+     * You can override this to parse the ID in a different format as you see fit, but it must follow these rules:
+     * - The ID must have a `key` somewhere in the ID that can be returned by the parser. This key is what Carbon's component handler will use to identify the component and pass an interaction to the correct component.
+     * - The data must be able to be arbitrary as far as Carbon's handler is concerned, meaning that any component with the same base key can be treated as the same component with logic within the component's logic methods to handle the data.
+     *
+     * @param id - The custom ID of the component as received from an interaction event
+     * @returns The base key and the data object
+     */
+    customIdParser = parseCustomId;
+    /**
+     * The minimum number of values that must be selected
+     */
+    minValues;
+    /**
+     * The maximum number of values that can be selected
+     */
+    maxValues;
+    /**
+     * Whether this component is required (defaults to true in modals)
+     */
+    required;
+    /**
+     * The placeholder text for the select menu
+     */
+    placeholder;
+    serialize = () => {
+        const data = {
+            type: this.type,
+            custom_id: this.customId,
+            placeholder: this.placeholder,
+            min_values: this.minValues,
+            max_values: this.maxValues,
+            options: this.options
+        };
+        // In modals, required defaults to true
+        if (this.required !== undefined) {
+            data.required = this.required;
+        }
+        return data;
+    };
+    /**
+     * The disabled field is not allowed on modal select components
+     * @throws Error when trying to set disabled to true
+     */
+    set disabled(value) {
+        if (value === true) {
+            throw new Error("The 'disabled' field is not allowed on modal select components");
+        }
+    }
+    get disabled() {
+        return undefined;
+    }
+}
+//# sourceMappingURL=ModalStringSelectMenu.js.map

package/dist/src/classes/components/ModalStringSelectMenu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModalStringSelectMenu.js","sourceRoot":"","sources":["../../../../src/classes/components/ModalStringSelectMenu.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,aAAa,EACb,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAA;AAI1E,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAE7D,MAAM,OAAgB,qBAAsB,SAAQ,kBAAkB;IAC5D,IAAI,GAAG,aAAa,CAAC,YAAqB,CAAA;IAC1C,IAAI,GAAG,KAAK,CAAA;IAUrB;;;;;;;;;;;OAWG;IACH,cAAc,GAA0C,aAAa,CAAA;IAErE;;OAEG;IACH,SAAS,CAAS;IAElB;;OAEG;IACH,SAAS,CAAS;IAElB;;OAEG;IACH,QAAQ,CAAU;IAElB;;OAEG;IACH,WAAW,CAAS;IAYpB,SAAS,GAAG,GAA6B,EAAE;QAC1C,MAAM,IAAI,GAA6B;YACtC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,SAAS,EAAE,IAAI,CAAC,QAAQ;YACxB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,UAAU,EAAE,IAAI,CAAC,SAAS;YAC1B,UAAU,EAAE,IAAI,CAAC,SAAS;YAC1B,OAAO,EAAE,IAAI,CAAC,OAAO;SACrB,CAAA;QAED,uCAAuC;QACvC,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAA;QAC9B,CAAC;QAED,OAAO,IAAI,CAAA;IACZ,CAAC,CAAA;IAED;;;OAGG;IACH,IAAI,QAAQ,CAAC,KAA0B;QACtC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CACd,gEAAgE,CAChE,CAAA;QACF,CAAC;IACF,CAAC;IAED,IAAI,QAAQ;QACX,OAAO,SAAS,CAAA;IACjB,CAAC;CACD"}

package/dist/src/classes/components/ModalUserSelectMenu.d.ts

@@ -0,0 +1,58 @@
+import { type APIUserSelectComponent, ComponentType } from "discord-api-types/v10";
+import { BaseModalComponent } from "../../abstracts/BaseModalComponent.js";
+import type { UserSelectMenuInteraction } from "../../internals/UserSelectMenuInteraction.js";
+import type { ComponentParserResult } from "../../types/index.js";
+import type { ComponentData } from "../../types/index.js";
+export declare abstract class ModalUserSelectMenu extends BaseModalComponent {
+    readonly type: ComponentType.UserSelect;
+    readonly isV2 = false;
+    /**
+     * The custom ID of the component.
+     * If you want to provide a custom ID with additional data, you should either follow the default parser's format or implement your own custom parser.
+     *
+     * @see {@link customIdParser}
+     */
+    abstract customId: string;
+    /**
+     * This function is called by the handler when a component is received, and is used to parse the custom ID into a key and data object.
+     * By default, the ID is parsed in this format: `key:arg1=true;arg2=2;arg3=cheese`, where `arg1`, `arg2`, and `arg3` are the data arguments.
+     * It will also automatically parse `true` and `false` as booleans, and will parse numbers as numbers.
+     *
+     * You can override this to parse the ID in a different format as you see fit, but it must follow these rules:
+     * - The ID must have a `key` somewhere in the ID that can be returned by the parser. This key is what Carbon's component handler will use to identify the component and pass an interaction to the correct component.
+     * - The data must be able to be arbitrary as far as Carbon's handler is concerned, meaning that any component with the same base key can be treated as the same component with logic within the component's logic methods to handle the data.
+     *
+     * @param id - The custom ID of the component as received from an interaction event
+     * @returns The base key and the data object
+     */
+    customIdParser: (id: string) => ComponentParserResult;
+    /**
+     * The minimum number of values that must be selected
+     */
+    minValues?: number;
+    /**
+     * The maximum number of values that can be selected
+     */
+    maxValues?: number;
+    /**
+     * Whether this component is required (defaults to true in modals)
+     */
+    required?: boolean;
+    /**
+     * The placeholder text for the select menu
+     */
+    placeholder?: string;
+    /**
+     * Default values for the select menu
+     */
+    defaultValues?: APIUserSelectComponent["default_values"];
+    abstract run(interaction: UserSelectMenuInteraction, data: ComponentData): unknown | Promise<unknown>;
+    serialize: () => APIUserSelectComponent;
+    /**
+     * The disabled field is not allowed on modal select components
+     * @throws Error when trying to set disabled to true
+     */
+    set disabled(value: boolean | undefined);
+    get disabled(): boolean | undefined;
+}
+//# sourceMappingURL=ModalUserSelectMenu.d.ts.map

package/dist/src/classes/components/ModalUserSelectMenu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModalUserSelectMenu.d.ts","sourceRoot":"","sources":["../../../../src/classes/components/ModalUserSelectMenu.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,sBAAsB,EAC3B,aAAa,EACb,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAA;AAC1E,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,8CAA8C,CAAA;AAC7F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAGzD,8BAAsB,mBAAoB,SAAQ,kBAAkB;IACnE,QAAQ,CAAC,IAAI,2BAAoC;IACjD,QAAQ,CAAC,IAAI,SAAQ;IAErB;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IAEzB;;;;;;;;;;;OAWG;IACH,cAAc,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,qBAAqB,CAAgB;IAErE;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAElB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB;;OAEG;IACH,aAAa,CAAC,EAAE,sBAAsB,CAAC,gBAAgB,CAAC,CAAA;IAExD,QAAQ,CAAC,GAAG,CACX,WAAW,EAAE,yBAAyB,EACtC,IAAI,EAAE,aAAa,GACjB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAE7B,SAAS,QAAO,sBAAsB,CAgBrC;IAED;;;OAGG;IACH,IAAI,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,EAMtC;IAED,IAAI,QAAQ,IAAI,OAAO,GAAG,SAAS,CAElC;CACD"}

package/dist/src/classes/components/ModalUserSelectMenu.js

@@ -0,0 +1,68 @@
+import { ComponentType } from "discord-api-types/v10";
+import { BaseModalComponent } from "../../abstracts/BaseModalComponent.js";
+import { parseCustomId } from "../../utils/customIdParser.js";
+export class ModalUserSelectMenu extends BaseModalComponent {
+    type = ComponentType.UserSelect;
+    isV2 = false;
+    /**
+     * This function is called by the handler when a component is received, and is used to parse the custom ID into a key and data object.
+     * By default, the ID is parsed in this format: `key:arg1=true;arg2=2;arg3=cheese`, where `arg1`, `arg2`, and `arg3` are the data arguments.
+     * It will also automatically parse `true` and `false` as booleans, and will parse numbers as numbers.
+     *
+     * You can override this to parse the ID in a different format as you see fit, but it must follow these rules:
+     * - The ID must have a `key` somewhere in the ID that can be returned by the parser. This key is what Carbon's component handler will use to identify the component and pass an interaction to the correct component.
+     * - The data must be able to be arbitrary as far as Carbon's handler is concerned, meaning that any component with the same base key can be treated as the same component with logic within the component's logic methods to handle the data.
+     *
+     * @param id - The custom ID of the component as received from an interaction event
+     * @returns The base key and the data object
+     */
+    customIdParser = parseCustomId;
+    /**
+     * The minimum number of values that must be selected
+     */
+    minValues;
+    /**
+     * The maximum number of values that can be selected
+     */
+    maxValues;
+    /**
+     * Whether this component is required (defaults to true in modals)
+     */
+    required;
+    /**
+     * The placeholder text for the select menu
+     */
+    placeholder;
+    /**
+     * Default values for the select menu
+     */
+    defaultValues;
+    serialize = () => {
+        const data = {
+            type: this.type,
+            custom_id: this.customId,
+            placeholder: this.placeholder,
+            min_values: this.minValues,
+            max_values: this.maxValues,
+            default_values: this.defaultValues
+        };
+        // In modals, required defaults to true
+        if (this.required !== undefined) {
+            data.required = this.required;
+        }
+        return data;
+    };
+    /**
+     * The disabled field is not allowed on modal select components
+     * @throws Error when trying to set disabled to true
+     */
+    set disabled(value) {
+        if (value === true) {
+            throw new Error("The 'disabled' field is not allowed on modal select components");
+        }
+    }
+    get disabled() {
+        return undefined;
+    }
+}
+//# sourceMappingURL=ModalUserSelectMenu.js.map

package/dist/src/classes/components/ModalUserSelectMenu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModalUserSelectMenu.js","sourceRoot":"","sources":["../../../../src/classes/components/ModalUserSelectMenu.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,aAAa,EACb,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAA;AAI1E,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAE7D,MAAM,OAAgB,mBAAoB,SAAQ,kBAAkB;IAC1D,IAAI,GAAG,aAAa,CAAC,UAAmB,CAAA;IACxC,IAAI,GAAG,KAAK,CAAA;IAUrB;;;;;;;;;;;OAWG;IACH,cAAc,GAA0C,aAAa,CAAA;IAErE;;OAEG;IACH,SAAS,CAAS;IAElB;;OAEG;IACH,SAAS,CAAS;IAElB;;OAEG;IACH,QAAQ,CAAU;IAElB;;OAEG;IACH,WAAW,CAAS;IAEpB;;OAEG;IACH,aAAa,CAA2C;IAOxD,SAAS,GAAG,GAA2B,EAAE;QACxC,MAAM,IAAI,GAA2B;YACpC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,SAAS,EAAE,IAAI,CAAC,QAAQ;YACxB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,UAAU,EAAE,IAAI,CAAC,SAAS;YAC1B,UAAU,EAAE,IAAI,CAAC,SAAS;YAC1B,cAAc,EAAE,IAAI,CAAC,aAAa;SAClC,CAAA;QAED,uCAAuC;QACvC,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAA;QAC9B,CAAC;QAED,OAAO,IAAI,CAAA;IACZ,CAAC,CAAA;IAED;;;OAGG;IACH,IAAI,QAAQ,CAAC,KAA0B;QACtC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CACd,gEAAgE,CAChE,CAAA;QACF,CAAC;IACF,CAAC;IAED,IAAI,QAAQ;QACX,OAAO,SAAS,CAAA;IACjB,CAAC;CACD"}

package/dist/src/classes/components/Row.d.ts

@@ -1,8 +1,7 @@
-import { ComponentType } from "discord-api-types/v10";
+import { type APIActionRowComponent, type APIComponentInMessageActionRow, ComponentType } from "discord-api-types/v10";
 import { BaseComponent } from "../../abstracts/BaseComponent.js";
 import type { BaseMessageInteractiveComponent } from "../../abstracts/BaseMessageInteractiveComponent.js";
-import type { BaseModalComponent } from "../../abstracts/BaseModalComponent.js";
-export declare class Row<T extends BaseMessageInteractiveComponent | BaseModalComponent = BaseMessageInteractiveComponent> extends BaseComponent {
+export declare class Row<T extends BaseMessageInteractiveComponent> extends BaseComponent {
     readonly type: ComponentType.ActionRow;
     readonly isV2 = false;
     /**
@@ -24,6 +23,6 @@ export declare class Row<T extends BaseMessageInteractiveComponent | BaseModalCo
      * Remove all components from the action row
      */
     removeAllComponents(): void;
-    serialize: () => ReturnType<BaseComponent["serialize"]>;
+    serialize: () => APIActionRowComponent<APIComponentInMessageActionRow>;
 }
 //# sourceMappingURL=Row.d.ts.map

package/dist/src/classes/components/Row.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Row.d.ts","sourceRoot":"","sources":["../../../../src/classes/components/Row.ts"],"names":[],"mappings":"AAAA,OAAO,EAIN,aAAa,EACb,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAA;AAChE,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,oDAAoD,CAAA;AACzG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAA;AAE/E,qBAAa,GAAG,CACf,CAAC,SACE,+BAA+B,GAC/B,kBAAkB,GAAG,+BAA+B,CACtD,SAAQ,aAAa;IACtB,QAAQ,CAAC,IAAI,0BAAmC;IAChD,QAAQ,CAAC,IAAI,SAAQ;IAErB;;OAEG;IACH,UAAU,EAAE,CAAC,EAAE,CAAK;gBAER,UAAU,CAAC,EAAE,CAAC,EAAE;IAK5B;;;OAGG;IACH,YAAY,CAAC,SAAS,EAAE,CAAC;IAIzB;;;OAGG;IACH,eAAe,CAAC,SAAS,EAAE,CAAC;IAM5B;;OAEG;IACH,mBAAmB;IAInB,SAAS,QAAO,UAAU,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,CAQrD;CACD"}
+{"version":3,"file":"Row.d.ts","sourceRoot":"","sources":["../../../../src/classes/components/Row.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,qBAAqB,EAC1B,KAAK,8BAA8B,EACnC,aAAa,EACb,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAA;AAChE,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,oDAAoD,CAAA;AAEzG,qBAAa,GAAG,CACf,CAAC,SAAS,+BAA+B,CACxC,SAAQ,aAAa;IACtB,QAAQ,CAAC,IAAI,0BAAmC;IAChD,QAAQ,CAAC,IAAI,SAAQ;IAErB;;OAEG;IACH,UAAU,EAAE,CAAC,EAAE,CAAK;gBAER,UAAU,CAAC,EAAE,CAAC,EAAE;IAK5B;;;OAGG;IACH,YAAY,CAAC,SAAS,EAAE,CAAC;IAIzB;;;OAGG;IACH,eAAe,CAAC,SAAS,EAAE,CAAC;IAM5B;;OAEG;IACH,mBAAmB;IAInB,SAAS,QAAO,qBAAqB,CAAC,8BAA8B,CAAC,CAKpE;CACD"}

package/dist/src/classes/components/Row.js

@@ -40,7 +40,6 @@ export class Row extends BaseComponent {
             type: ComponentType.ActionRow,
             components: this.components.map((component) => component.serialize())
         };
-        // god i hate these types
     };
 }
 //# sourceMappingURL=Row.js.map

package/dist/src/classes/components/Row.js.map

@@ -1 +1 @@
-{"version":3,"file":"Row.js","sourceRoot":"","sources":["../../../../src/classes/components/Row.ts"],"names":[],"mappings":"AAAA,OAAO,EAIN,aAAa,EACb,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAA;AAIhE,MAAM,OAAO,GAIX,SAAQ,aAAa;IACb,IAAI,GAAG,aAAa,CAAC,SAAkB,CAAA;IACvC,IAAI,GAAG,KAAK,CAAA;IAErB;;OAEG;IACH,UAAU,GAAQ,EAAE,CAAA;IAEpB,YAAY,UAAgB;QAC3B,KAAK,EAAE,CAAA;QACP,IAAI,UAAU;YAAE,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;IAC7C,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,SAAY;QACxB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IAChC,CAAC;IAED;;;OAGG;IACH,eAAe,CAAC,SAAY;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;QAChD,IAAI,KAAK,KAAK,CAAC,CAAC;YAAE,OAAM;QACxB,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;IACjC,CAAC;IAED;;OAEG;IACH,mBAAmB;QAClB,IAAI,CAAC,UAAU,GAAG,EAAE,CAAA;IACrB,CAAC;IAED,SAAS,GAAG,GAA2C,EAAE;QACxD,OAAO;YACN,IAAI,EAAE,aAAa,CAAC,SAAS;YAC7B,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC;SAGhB,CAAA;QACtD,yBAAyB;IAC1B,CAAC,CAAA;CACD"}
+{"version":3,"file":"Row.js","sourceRoot":"","sources":["../../../../src/classes/components/Row.ts"],"names":[],"mappings":"AAAA,OAAO,EAGN,aAAa,EACb,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAA;AAGhE,MAAM,OAAO,GAEX,SAAQ,aAAa;IACb,IAAI,GAAG,aAAa,CAAC,SAAkB,CAAA;IACvC,IAAI,GAAG,KAAK,CAAA;IAErB;;OAEG;IACH,UAAU,GAAQ,EAAE,CAAA;IAEpB,YAAY,UAAgB;QAC3B,KAAK,EAAE,CAAA;QACP,IAAI,UAAU;YAAE,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;IAC7C,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,SAAY;QACxB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IAChC,CAAC;IAED;;;OAGG;IACH,eAAe,CAAC,SAAY;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;QAChD,IAAI,KAAK,KAAK,CAAC,CAAC;YAAE,OAAM;QACxB,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;IACjC,CAAC;IAED;;OAEG;IACH,mBAAmB;QAClB,IAAI,CAAC,UAAU,GAAG,EAAE,CAAA;IACrB,CAAC;IAED,SAAS,GAAG,GAA0D,EAAE;QACvE,OAAO;YACN,IAAI,EAAE,aAAa,CAAC,SAAS;YAC7B,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC;SACrE,CAAA;IACF,CAAC,CAAA;CACD"}

package/dist/src/classes/components/TextInput.d.ts

@@ -1,16 +1,29 @@
 import { type APITextInputComponent, ComponentType, TextInputStyle } from "discord-api-types/v10";
 import { BaseModalComponent } from "../../abstracts/BaseModalComponent.js";
+import type { ComponentParserResult } from "../../types/index.js";
 export declare abstract class TextInput extends BaseModalComponent {
     readonly type: ComponentType.TextInput;
     readonly isV2 = false;
     /**
-     * The custom ID of the text input
+     * The custom ID of the component.
+     * If you want to provide a custom ID with additional data, you should either follow the default parser's format or implement your own custom parser.
+     *
+     * @see {@link customIdParser}
      */
     abstract customId: string;
     /**
-     * The label of the text input
-     */
-    abstract label: string;
+     * This function is called by the handler when a component is received, and is used to parse the custom ID into a key and data object.
+     * By default, the ID is parsed in this format: `key:arg1=true;arg2=2;arg3=cheese`, where `arg1`, `arg2`, and `arg3` are the data arguments.
+     * It will also automatically parse `true` and `false` as booleans, and will parse numbers as numbers.
+     *
+     * You can override this to parse the ID in a different format as you see fit, but it must follow these rules:
+     * - The ID must have a `key` somewhere in the ID that can be returned by the parser. This key is what Carbon's component handler will use to identify the component and pass an interaction to the correct component.
+     * - The data must be able to be arbitrary as far as Carbon's handler is concerned, meaning that any component with the same base key can be treated as the same component with logic within the component's logic methods to handle the data.
+     *
+     * @param id - The custom ID of the component as received from an interaction event
+     * @returns The base key and the data object
+     */
+    customIdParser: (id: string) => ComponentParserResult;
     /**
      * The style of the text input
      * @default TextInputStyle.Short

package/dist/src/classes/components/TextInput.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TextInput.d.ts","sourceRoot":"","sources":["../../../../src/classes/components/TextInput.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,qBAAqB,EAC1B,aAAa,EACb,cAAc,EACd,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAA;AAE1E,8BAAsB,SAAU,SAAQ,kBAAkB;IACzD,QAAQ,CAAC,IAAI,0BAAmC;IAChD,QAAQ,CAAC,IAAI,SAAQ;IAErB;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IAEzB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IAEtB;;;OAGG;IACH,KAAK,EAAE,cAAc,CAAuB;IAE5C;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAElB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB,SAAS,QAAO,qBAAqB,CAYpC;CACD"}
+{"version":3,"file":"TextInput.d.ts","sourceRoot":"","sources":["../../../../src/classes/components/TextInput.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,qBAAqB,EAC1B,aAAa,EACb,cAAc,EACd,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAA;AAC1E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAGjE,8BAAsB,SAAU,SAAQ,kBAAkB;IACzD,QAAQ,CAAC,IAAI,0BAAmC;IAChD,QAAQ,CAAC,IAAI,SAAQ;IAErB;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IAEzB;;;;;;;;;;;OAWG;IACH,cAAc,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,qBAAqB,CAAgB;IAErE;;;OAGG;IACH,KAAK,EAAE,cAAc,CAAuB;IAE5C;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAElB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB,SAAS,QAAO,qBAAqB,CAWpC;CACD"}