meocord 4.2.0 → 4.2.1

package/dist/esm/util/tsconfig.util.js

@@ -3,6 +3,7 @@ import { existsSync, readFileSync, writeFileSync, mkdtempSync, rmSync, readlinkS
 import { tmpdir, hostname } from 'os';
 import { createRequire } from 'module';
 import { parseJsonc } from './json.util.js';
+import { projectPaths } from './tsconfig-paths.util.js';
 
 /**
  * An `extends` made to work from another directory: a relative path made absolute, and a package
@@ -89,10 +90,11 @@ function isRunning(pid) {
 }
 /**
  * Writes a copy of the project's tsconfig.json for the bundler and returns its path: comments and trailing commas
- * removed, paths made absolute (a `paths` target from `baseUrl` when set), `noEmit` dropped. One file per call in this
+ * removed, paths made absolute (`paths` as {@link projectPaths} reads them), `noEmit` dropped. One file per call in this
  * process's directory, removed at exit; the project's file is never written.
  * @throws When `tsconfig.json` is missing or cannot be parsed.
  */ function prepareModifiedTsConfig() {
+    var _parsedConfig;
     const tsConfigPath = path.resolve(process.cwd(), 'tsconfig.json');
     // Ensure tsconfig.json exists
     if (!existsSync(tsConfigPath)) {
@@ -109,12 +111,15 @@ function isRunning(pid) {
     // The copy lives in the temp directory, so every path in it is made absolute from the project
     const cwd = process.cwd();
     if (parsedConfig?.extends) parsedConfig.extends = resolveExtends(parsedConfig.extends, cwd);
+    // `${configDir}` is the project, which the copy's own directory would otherwise stand for
     for (const key of [
         'include',
         'exclude',
         'files'
     ]){
-        if (Array.isArray(parsedConfig?.[key])) parsedConfig[key] = parsedConfig[key].map((p)=>path.resolve(cwd, p));
+        if (Array.isArray(parsedConfig?.[key])) {
+            parsedConfig[key] = parsedConfig[key].map((p)=>path.resolve(cwd, p.replaceAll('${configDir}', cwd)));
+        }
     }
     // Process compilerOptions
     if (parsedConfig?.compilerOptions) {
@@ -133,19 +138,14 @@ function isRunning(pid) {
         if (Array.isArray(parsedConfig.compilerOptions.typeRoots)) {
             parsedConfig.compilerOptions.typeRoots = parsedConfig.compilerOptions.typeRoots.map((p)=>path.resolve(cwd, p));
         }
-        // A `paths` target is relative to baseUrl when there is one, made absolute above, and else to the project. Only
-        // this file's own baseUrl counts: one inherited through `extends` isn't applied, so paths are the project's own.
-        if (parsedConfig.compilerOptions.paths) {
-            const base = parsedConfig.compilerOptions.baseUrl ?? cwd;
-            Object.keys(parsedConfig.compilerOptions.paths).forEach((alias)=>{
-                parsedConfig.compilerOptions.paths[alias] = parsedConfig.compilerOptions.paths[alias].map((p)=>path.resolve(base, p));
-            });
-        }
         // Remove `noEmit` option if it exists
         if ('noEmit' in parsedConfig.compilerOptions) {
             delete parsedConfig.compilerOptions.noEmit;
         }
     }
+    // The paths as tsc reads them, inherited ones included, written absolute so the copy in the temp directory keeps them
+    const paths = projectPaths(cwd);
+    if (paths) ((_parsedConfig = parsedConfig).compilerOptions ?? (_parsedConfig.compilerOptions = {})).paths = paths;
     const tempTsConfigPath = path.join(copiesDirectory(), `modified-tsconfig-${++copies}.json`);
     writeFileSync(tempTsConfigPath, JSON.stringify(parsedConfig, null, 2));
     return tempTsConfigPath;

package/dist/esm/util/value.util.js

@@ -8,5 +8,16 @@ import { quoteForLog } from './user-text.util.js';
     return typeof value === 'object' ? 'an object' : `a ${typeof value}`;
 }
 /** A class's name after its article, such as `an AutocompleteInteraction`; a `U` name reads as "you", so takes `a`. */ const withArticle = (name)=>`${/^[AEIO]/i.test(name) ? 'an' : 'a'} ${name}`;
+/**
+ * Sets `key` on `target` as an own, enumerable data property: unlike `target[key] = value`, a key named `__proto__`
+ * is a key like any other rather than the object's prototype.
+ */ function setOwn(target, key, value) {
+    Object.defineProperty(target, key, {
+        value,
+        enumerable: true,
+        writable: true,
+        configurable: true
+    });
+}
 
-export { describeValue, isConstructor, withArticle };
+export { describeValue, isConstructor, setOwn, withArticle };

package/dist/types/common/index.d.cts

@@ -1,11 +1,11 @@
 import { ColorResolvable, Interaction, Message, Locale } from 'discord.js';
-import { C as CooldownStore, a as CooldownLimit, b as CooldownVerdict, c as CooldownEntry, d as CooldownBatchVerdict } from '../index-nn5p7OoX.cjs';
+import { C as CooldownStore, a as CooldownLimit, b as CooldownVerdict, c as CooldownEntry, d as CooldownBatchVerdict } from '../index-Dlf0ZZtS.cjs';
 import { Token, ProviderToken, FactoryProvider, DeepReadonly, MeoCordTheme } from '../interface/index.cjs';
-export { e as CommandNotFoundError, f as CooldownError, g as CooldownScope, h as CooldownStoreError, E as ExecutionContext, i as ExecutionContextType, G as GuardDeniedError, I as InstallContext, j as MemoryCooldownStore, k as MessageUsageError, l as MessageUsageIssue, m as MetadataDecorator, R as ResponseCall, n as ResponseEditFlags, o as ResponseEditPayload, p as ResponseErrorOptions, q as ResponseFlags, r as ResponseLockOptions, s as ResponsePayload, t as ResponsePhase, u as ResponseSendOptions, v as ResponseState, U as UserError, w as UserErrorOptions, V as ValidationError, x as ValidationIssue, y as cooldownMessage, z as cooldownStoreMessage, A as createMetadata, B as getInstallContext, H as respond } from '../index-nn5p7OoX.cjs';
-export { R as Route, a as RouteParams, b as RouteValue, c as RouteValues, r as route } from '../route-BZgFoNeB.cjs';
-import { T as Translator } from '../translator-DHMkkCpg.cjs';
-export { C as CatalogDefinition, a as CatalogShape, L as LocaleCatalog, b as LocalizationKey, M as MessageKey, c as MessageParams, P as PluralCategory, d as PluralMessage, S as StringMessageKey, e as Translate, f as TranslatorOptions, g as createTranslator, h as defineCatalog } from '../translator-DHMkkCpg.cjs';
-export { T as ThemeCache } from '../theme-resolvers-UKr3-6Ys.cjs';
+export { e as CommandNotFoundError, f as CooldownError, g as CooldownScope, h as CooldownStoreError, E as ExecutionContext, i as ExecutionContextType, G as GuardDeniedError, I as InstallContext, j as MemoryCooldownStore, k as MessageUsageError, l as MessageUsageIssue, m as MetadataDecorator, R as ResponseCall, n as ResponseEditFlags, o as ResponseEditPayload, p as ResponseErrorOptions, q as ResponseFlags, r as ResponseLockOptions, s as ResponsePayload, t as ResponsePhase, u as ResponseSendOptions, v as ResponseState, U as UserError, w as UserErrorOptions, V as ValidationError, x as ValidationIssue, y as cooldownMessage, z as cooldownStoreMessage, A as createMetadata, B as getInstallContext, H as respond } from '../index-Dlf0ZZtS.cjs';
+export { R as Route, a as RouteParams, b as RouteValue, c as RouteValues, r as route } from '../route-Bh1U13yy.cjs';
+import { T as Translator } from '../translator-Bg7hwxDF.cjs';
+export { C as CatalogDefinition, a as CatalogShape, L as LocaleCatalog, b as LocalizationKey, M as MessageKey, c as MessageParams, P as PluralCategory, d as PluralMessage, S as StringMessageKey, e as Translate, f as TranslatorOptions, g as createTranslator, h as defineCatalog } from '../translator-Bg7hwxDF.cjs';
+export { T as ThemeCache } from '../theme-resolvers-CyEz9pnv.cjs';
 import '@rsbuild/core';
 import '../controller.enum-DTDn69N9.cjs';
 

package/dist/types/common/index.d.ts

@@ -1,11 +1,11 @@
 import { ColorResolvable, Interaction, Message, Locale } from 'discord.js';
-import { C as CooldownStore, a as CooldownLimit, b as CooldownVerdict, c as CooldownEntry, d as CooldownBatchVerdict } from '../index-CdXsFgjE.js';
+import { C as CooldownStore, a as CooldownLimit, b as CooldownVerdict, c as CooldownEntry, d as CooldownBatchVerdict } from '../index-DKJclIi-.js';
 import { Token, ProviderToken, FactoryProvider, DeepReadonly, MeoCordTheme } from '../interface/index.js';
-export { e as CommandNotFoundError, f as CooldownError, g as CooldownScope, h as CooldownStoreError, E as ExecutionContext, i as ExecutionContextType, G as GuardDeniedError, I as InstallContext, j as MemoryCooldownStore, k as MessageUsageError, l as MessageUsageIssue, m as MetadataDecorator, R as ResponseCall, n as ResponseEditFlags, o as ResponseEditPayload, p as ResponseErrorOptions, q as ResponseFlags, r as ResponseLockOptions, s as ResponsePayload, t as ResponsePhase, u as ResponseSendOptions, v as ResponseState, U as UserError, w as UserErrorOptions, V as ValidationError, x as ValidationIssue, y as cooldownMessage, z as cooldownStoreMessage, A as createMetadata, B as getInstallContext, H as respond } from '../index-CdXsFgjE.js';
-export { R as Route, a as RouteParams, b as RouteValue, c as RouteValues, r as route } from '../route-BZgFoNeB.js';
-import { T as Translator } from '../translator-BViWKtLJ.js';
-export { C as CatalogDefinition, a as CatalogShape, L as LocaleCatalog, b as LocalizationKey, M as MessageKey, c as MessageParams, P as PluralCategory, d as PluralMessage, S as StringMessageKey, e as Translate, f as TranslatorOptions, g as createTranslator, h as defineCatalog } from '../translator-BViWKtLJ.js';
-export { T as ThemeCache } from '../theme-resolvers-BcOJVzR9.js';
+export { e as CommandNotFoundError, f as CooldownError, g as CooldownScope, h as CooldownStoreError, E as ExecutionContext, i as ExecutionContextType, G as GuardDeniedError, I as InstallContext, j as MemoryCooldownStore, k as MessageUsageError, l as MessageUsageIssue, m as MetadataDecorator, R as ResponseCall, n as ResponseEditFlags, o as ResponseEditPayload, p as ResponseErrorOptions, q as ResponseFlags, r as ResponseLockOptions, s as ResponsePayload, t as ResponsePhase, u as ResponseSendOptions, v as ResponseState, U as UserError, w as UserErrorOptions, V as ValidationError, x as ValidationIssue, y as cooldownMessage, z as cooldownStoreMessage, A as createMetadata, B as getInstallContext, H as respond } from '../index-DKJclIi-.js';
+export { R as Route, a as RouteParams, b as RouteValue, c as RouteValues, r as route } from '../route-Bh1U13yy.js';
+import { T as Translator } from '../translator-CeP4bCzp.js';
+export { C as CatalogDefinition, a as CatalogShape, L as LocaleCatalog, b as LocalizationKey, M as MessageKey, c as MessageParams, P as PluralCategory, d as PluralMessage, S as StringMessageKey, e as Translate, f as TranslatorOptions, g as createTranslator, h as defineCatalog } from '../translator-CeP4bCzp.js';
+export { T as ThemeCache } from '../theme-resolvers-DA204O-q.js';
 import '@rsbuild/core';
 import '../controller.enum-DTDn69N9.js';
 

package/dist/types/core/index.d.cts

@@ -1,5 +1,5 @@
 import { ServiceIdentifier } from 'inversify';
-import { J as MeoCordApplication } from '../index-nn5p7OoX.cjs';
+import { J as MeoCordApplication } from '../index-Dlf0ZZtS.cjs';
 import { MetadataDecorator } from '../common/index.cjs';
 import { MessageScope, MessageCommandOptions, MessageHelp } from '../interface/index.cjs';
 import { RESTPostAPIApplicationCommandsJSONBody, ClientEvents, Message, Client } from 'discord.js';
@@ -44,7 +44,8 @@ declare class MeoCordFactory {
      * @returns The application, which `start()` logs in.
      * @throws Error when the class has no `@MeoCord`, when the compiled config is missing beside the bundle or fails to
      *   load, naming the file and the reason, with what to do about it, when a provider cannot
-     *   be bound, such as one for a token MeoCord binds itself, when two handlers take one command, or two builder
+     *   be bound, such as one for a token MeoCord binds itself (a provider for `ThemeCache` or `ExecutionContext` is warned
+     *   about instead, and refused from the next major version, 5.0), when two handlers take one command, or two builder
      *   classes build one, naming both, and for any other mistake it refuses as the app loads, such as two component
      *   patterns that match the same customIds. Each check reports every error it finds, and the first is thrown,
      *   unchanged. When there are several, each is logged first, with where in the source it comes from; a lone one is

package/dist/types/core/index.d.ts

@@ -1,5 +1,5 @@
 import { ServiceIdentifier } from 'inversify';
-import { J as MeoCordApplication } from '../index-CdXsFgjE.js';
+import { J as MeoCordApplication } from '../index-DKJclIi-.js';
 import { MetadataDecorator } from '../common/index.js';
 import { MessageScope, MessageCommandOptions, MessageHelp } from '../interface/index.js';
 import { RESTPostAPIApplicationCommandsJSONBody, ClientEvents, Message, Client } from 'discord.js';
@@ -44,7 +44,8 @@ declare class MeoCordFactory {
      * @returns The application, which `start()` logs in.
      * @throws Error when the class has no `@MeoCord`, when the compiled config is missing beside the bundle or fails to
      *   load, naming the file and the reason, with what to do about it, when a provider cannot
-     *   be bound, such as one for a token MeoCord binds itself, when two handlers take one command, or two builder
+     *   be bound, such as one for a token MeoCord binds itself (a provider for `ThemeCache` or `ExecutionContext` is warned
+     *   about instead, and refused from the next major version, 5.0), when two handlers take one command, or two builder
      *   classes build one, naming both, and for any other mistake it refuses as the app loads, such as two component
      *   patterns that match the same customIds. Each check reports every error it finds, and the first is thrown,
      *   unchanged. When there are several, each is logged first, with where in the source it comes from; a lone one is

package/dist/types/decorator/index.d.cts

@@ -1045,6 +1045,7 @@ interface CooldownByDecorator<P> {
  * @param options - The limit, whose calls count together, and how to exempt or tell calls apart.
  * @throws Error when `seconds` is not from `0.001` to `4320000000000`, `uses` is not a whole number of at least 1,
  * `per` is not a scope or `by` is not a function, as the decorator applies; `CooldownError` to a call over the limit.
+ * A `bypass` given but not a function, and a `seconds` that is not a number, are warned about as the decorator applies.
  *
  * @example
  * ```ts

package/dist/types/decorator/index.d.ts

@@ -1045,6 +1045,7 @@ interface CooldownByDecorator<P> {
  * @param options - The limit, whose calls count together, and how to exempt or tell calls apart.
  * @throws Error when `seconds` is not from `0.001` to `4320000000000`, `uses` is not a whole number of at least 1,
  * `per` is not a scope or `by` is not a function, as the decorator applies; `CooldownError` to a call over the limit.
+ * A `bypass` given but not a function, and a `seconds` that is not a number, are warned about as the decorator applies.
  *
  * @example
  * ```ts

package/dist/types/{index-CdXsFgjE.d.ts → index-DKJclIi-.d.ts}

@@ -1,4 +1,4 @@
-import { BaseInteraction, Message, APIEmbed, InteractionReplyOptions, BitFieldResolvable, MessageFlags, InteractionEditReplyOptions, JSONEncodable, APIModalInteractionResponseCallbackData, ModalComponentData, Interaction, ColorResolvable, ButtonStyle, MessageReaction, PartialMessageReaction, ContextMenuCommandType, UserContextMenuCommandInteraction, MessageContextMenuCommandInteraction, ApplicationCommandType, SlashCommandBuilder, SlashCommandOptionsOnlyBuilder, SlashCommandSubcommandsOnlyBuilder, ContextMenuCommandBuilder, RESTPostAPIPrimaryEntryPointApplicationCommandJSONBody, ChatInputCommandInteraction, PrimaryEntryPointCommandInteraction, ButtonInteraction, StringSelectMenuInteraction, UserSelectMenuInteraction, RoleSelectMenuInteraction, MentionableSelectMenuInteraction, ChannelSelectMenuInteraction, ModalSubmitInteraction, APIComponentInContainer, AttachmentBuilder, MessageReplyOptions, GuildMember, User, Role, GuildBasedChannel, PartialUser, Client } from 'discord.js';
+import { BaseInteraction, Message, APIMessageTopLevelComponent, APIEmbed, InteractionReplyOptions, BitFieldResolvable, MessageFlags, InteractionEditReplyOptions, JSONEncodable, APIModalInteractionResponseCallbackData, ModalComponentData, Interaction, ColorResolvable, ButtonStyle, MessageReaction, PartialMessageReaction, ContextMenuCommandType, UserContextMenuCommandInteraction, MessageContextMenuCommandInteraction, ApplicationCommandType, SlashCommandBuilder, SlashCommandOptionsOnlyBuilder, SlashCommandSubcommandsOnlyBuilder, ContextMenuCommandBuilder, RESTPostAPIPrimaryEntryPointApplicationCommandJSONBody, ChatInputCommandInteraction, PrimaryEntryPointCommandInteraction, ButtonInteraction, StringSelectMenuInteraction, UserSelectMenuInteraction, RoleSelectMenuInteraction, MentionableSelectMenuInteraction, ChannelSelectMenuInteraction, ModalSubmitInteraction, APIComponentInContainer, AttachmentBuilder, MessageReplyOptions, GuildMember, User, Role, GuildBasedChannel, PartialUser, Client } from 'discord.js';
 import { RsbuildConfig as RsbuildConfig$1 } from '@rsbuild/core';
 import { C as CommandType, R as ReactionHandlerAction } from './controller.enum-DTDn69N9.js';
 
@@ -329,13 +329,14 @@ interface ResponseState {
     /** Where the answer stands, re-read from the interaction so answers made around this state count. */
     readonly state: ResponsePhase;
     /**
-     * The message this state last replied with, updated or edited, never a follow-up, or the message a component is on.
-     * Read-only: edit through the state.
+     * The answer's message: the one this state last replied with, updated or edited, or the message a component is on. A
+     * follow-up is it only once it is the answer, after replacing a public deferral or after `delete()`; after `delete()`
+     * it is `undefined` until something is sent. Read-only: edit through the state.
      */
     readonly message: Message | undefined;
     /** The components and embeds of the message before `@Defer` locked it; `undefined` until then. */
     readonly original: {
-        readonly components: readonly unknown[];
+        readonly components: readonly APIMessageTopLevelComponent[];
         readonly embeds: readonly APIEmbed[];
     } | undefined;
     /**
@@ -366,6 +367,9 @@ interface ResponseState {
      * A reply Discord refuses as already acknowledged elsewhere still throws, and the next `send()` edits.
      * After `modal()` it throws: a modal has no message, and the modal's submit is answered instead.
      *
+     * After a private `followUp()` replaced a public deferral, it edits that follow-up. After `delete()` it sends a
+     * follow-up, private when the deleted answer was unless `flags` say otherwise, and that follow-up is the answer.
+     *
      * After `@Defer` locked a message, omitting `components` puts back its components as they were
      * before the lock, and omitting `embeds` drops the loading view; `components: []` clears them.
      *
@@ -375,7 +379,8 @@ interface ResponseState {
      */
     send(payload: ResponsePayload, options?: ResponseSendOptions): Promise<Message | undefined>;
     /**
-     * Edits the answer, routed as `send()` is: an edit once the interaction is answered.
+     * Edits the answer, routed as `send()` is: an edit once the interaction is answered, of the follow-up that replaced
+     * a public deferral, or, after `delete()`, a follow-up that becomes the answer.
      *
      * @param payload - Text, or edit options.
      * @param options - `fill: false` leaves this edit's embeds and containers uncoloured.
@@ -386,8 +391,9 @@ interface ResponseState {
      * Sends another message after the answer. Before any answer it is the first reply. While a command's
      * reply is deferred and nothing is sent yet, Discord turns a follow-up into the deferred reply and
      * ignores its flags, so it is sent as that edit; a private follow-up on a public deferral deletes the
-     * deferral first and is sent privately. After `modal()` it is sent as made, and Discord decides whether it
-     * accepts a follow-up there; the modal's submit is the interaction to answer.
+     * deferral first, is sent privately, and is the answer `send()`, `edit()` and `delete()` act on. After `delete()`,
+     * it is the answer too. After `modal()` it is sent as made, and Discord decides whether it accepts a follow-up
+     * there; the modal's submit is the interaction to answer.
      *
      * @param payload - Text, or reply options; `Ephemeral` makes the follow-up private.
      * @param options - `fill: false` leaves this follow-up's embeds and containers uncoloured.
@@ -395,8 +401,9 @@ interface ResponseState {
      */
     followUp(payload: ResponsePayload, options?: ResponseSendOptions): Promise<Message | undefined>;
     /**
-     * Deletes the answer: the reply, or for a component deferred without a reply of its own, its message.
-     * Throws before any answer, and after `modal()`, which leaves no message.
+     * Deletes the answer: the reply, the follow-up that replaced a public deferral, or for a component deferred
+     * without a reply of its own, its message. `message` is then `undefined` until something is sent. Throws before any
+     * answer, after `modal()`, which leaves no message, and again with nothing sent since the last `delete()`.
      */
     delete(): Promise<void>;
     /**
@@ -1243,7 +1250,10 @@ declare class MemoryCooldownStore extends CooldownStore {
     peekMany(entries: readonly CooldownEntry[]): Promise<CooldownBatchVerdict>;
     /** Each entry's call times, trimmed to its window, and whether it allows one more call now. */
     private check;
-    /** Drops the keys whose calls have all left their window, once a minute from the store's first call. */
+    /**
+     * Drops the keys whose calls have all left their window, once a minute from a call, until a sweep leaves none: an
+     * idle store then holds no timer, so one nothing references is collected, and its next call starts the sweep again.
+     */
     private startSweeping;
 }
 
@@ -2105,10 +2115,14 @@ interface MeoCordApplication {
      */
     start(): Promise<void>;
     /**
-     * Stops the bot: runs the `onShutdown` hooks under the configured `shutdownTimeout` and closes the client, or with
-     * process sharding, asks every shard to shut down and waits for it. It ends no process of its own accord, except that
-     * called in a shard, it asks the manager to stop every shard, which then shuts that shard's process down too. A stop
-     * while the bot starts ends that start, a call after the first waits for it, and a stopped app does not start again.
+     * Stops the bot: stops taking events, waits for the calls under way, runs the `onShutdown` hooks under the configured
+     * `shutdownTimeout` and closes the client, or with process sharding, asks every shard to shut down and waits for it.
+     * It ends no process of its own accord, except that called in a shard, it asks the manager to stop every shard, which
+     * then shuts that shard's process down too. A call that awaits `stop()`, as an owner-only shutdown command does, is
+     * not waited for.
+     *
+     * A stop while the bot starts ends that start: it waits for the providers being made, at most `shutdownTimeout`, and
+     * nothing more is made after it. A call after the first waits for it, and a stopped app does not start again.
      *
      * @returns A promise that resolves once the bot is stopped. It never rejects: a failure to close is logged, and sets
      *   `process.exitCode` to 1 unless another code is already set.
@@ -2188,9 +2202,11 @@ interface OnReady {
  * it injects. The whole sequence is limited by `shutdownTimeout` in `meocord.config.ts`; shutdown then goes on
  * whether or not it finished. A hook that throws is logged and the next one still runs.
  *
- * It runs only for a class whose `onReady` has finished, or that has none: a signal that arrives
- * while the ready hooks are running skips the class still starting and those not reached yet, and no
- * further `onReady` starts. An `onReady` that threw counts as finished, so its partial setup is cleaned up.
+ * It runs only for a class whose `onReady` has finished, or that has none. A stop while the ready hooks
+ * are running waits for the `onReady` in progress, within `shutdownTimeout`, then shuts that class down too;
+ * those not reached yet are skipped, and no further `onReady` starts. An `onReady` still running once only the
+ * hooks' share of the timeout is left is named in a warning and skipped. An `onReady` that threw counts as
+ * finished, so its partial setup is cleaned up.
  *
  * @example
  * ```ts
@@ -2355,7 +2371,11 @@ interface MessageResponseContext {
  * @category Presenters
  */
 interface PresentedError {
-    /** What the user is told. */
+    /**
+     * What the user is told, fitted to Discord's limit for the answer's `mode`: at most 4096 characters for an embed and
+     * 4000 for a Components V2 Text Display, cut to end in `…`. An empty or whitespace-only message comes as MeoCord's generic error text.
+     * So a presenter that writes it as its view's text renders, whatever the error's message.
+     */
     message: string;
     /** The error being answered, so a presenter can style it by kind. */
     error: unknown;
@@ -3186,9 +3206,13 @@ interface MeoCordConfig {
      */
     startupErrors?: 'first' | 'all';
     /**
-     * How long, in milliseconds, shutdown waits for the `onShutdown` hooks before destroying the client
-     * anyway: from 0 to 2147478647, the longest a timer keeps less the margin the shard manager waits on top. The limit covers the whole sequence, not each hook,
-     * including the calls under way that the cooldown store's shutdown waits for.
+     * How long, in milliseconds, shutdown waits for the calls under way and the `onShutdown` hooks before destroying the
+     * client anyway: from 0 to 2147478647, the longest a timer keeps less the margin the shard manager waits on top. The
+     * limit covers the whole sequence, not each hook.
+     *
+     * The calls are waited for first, but no longer than the timeout less a reserve kept for the hooks: a quarter of it,
+     * at least 1 second and never more than half. A call still running then is named in a warning, and the hooks run in
+     * the time left.
      *
      * @defaultValue `10_000`
      */

package/dist/types/{index-nn5p7OoX.d.cts → index-Dlf0ZZtS.d.cts}

@@ -1,4 +1,4 @@
-import { BaseInteraction, Message, APIEmbed, InteractionReplyOptions, BitFieldResolvable, MessageFlags, InteractionEditReplyOptions, JSONEncodable, APIModalInteractionResponseCallbackData, ModalComponentData, Interaction, ColorResolvable, ButtonStyle, MessageReaction, PartialMessageReaction, ContextMenuCommandType, UserContextMenuCommandInteraction, MessageContextMenuCommandInteraction, ApplicationCommandType, SlashCommandBuilder, SlashCommandOptionsOnlyBuilder, SlashCommandSubcommandsOnlyBuilder, ContextMenuCommandBuilder, RESTPostAPIPrimaryEntryPointApplicationCommandJSONBody, ChatInputCommandInteraction, PrimaryEntryPointCommandInteraction, ButtonInteraction, StringSelectMenuInteraction, UserSelectMenuInteraction, RoleSelectMenuInteraction, MentionableSelectMenuInteraction, ChannelSelectMenuInteraction, ModalSubmitInteraction, APIComponentInContainer, AttachmentBuilder, MessageReplyOptions, GuildMember, User, Role, GuildBasedChannel, PartialUser, Client } from 'discord.js';
+import { BaseInteraction, Message, APIMessageTopLevelComponent, APIEmbed, InteractionReplyOptions, BitFieldResolvable, MessageFlags, InteractionEditReplyOptions, JSONEncodable, APIModalInteractionResponseCallbackData, ModalComponentData, Interaction, ColorResolvable, ButtonStyle, MessageReaction, PartialMessageReaction, ContextMenuCommandType, UserContextMenuCommandInteraction, MessageContextMenuCommandInteraction, ApplicationCommandType, SlashCommandBuilder, SlashCommandOptionsOnlyBuilder, SlashCommandSubcommandsOnlyBuilder, ContextMenuCommandBuilder, RESTPostAPIPrimaryEntryPointApplicationCommandJSONBody, ChatInputCommandInteraction, PrimaryEntryPointCommandInteraction, ButtonInteraction, StringSelectMenuInteraction, UserSelectMenuInteraction, RoleSelectMenuInteraction, MentionableSelectMenuInteraction, ChannelSelectMenuInteraction, ModalSubmitInteraction, APIComponentInContainer, AttachmentBuilder, MessageReplyOptions, GuildMember, User, Role, GuildBasedChannel, PartialUser, Client } from 'discord.js';
 import { RsbuildConfig as RsbuildConfig$1 } from '@rsbuild/core';
 import { C as CommandType, R as ReactionHandlerAction } from './controller.enum-DTDn69N9.cjs';
 
@@ -329,13 +329,14 @@ interface ResponseState {
     /** Where the answer stands, re-read from the interaction so answers made around this state count. */
     readonly state: ResponsePhase;
     /**
-     * The message this state last replied with, updated or edited, never a follow-up, or the message a component is on.
-     * Read-only: edit through the state.
+     * The answer's message: the one this state last replied with, updated or edited, or the message a component is on. A
+     * follow-up is it only once it is the answer, after replacing a public deferral or after `delete()`; after `delete()`
+     * it is `undefined` until something is sent. Read-only: edit through the state.
      */
     readonly message: Message | undefined;
     /** The components and embeds of the message before `@Defer` locked it; `undefined` until then. */
     readonly original: {
-        readonly components: readonly unknown[];
+        readonly components: readonly APIMessageTopLevelComponent[];
         readonly embeds: readonly APIEmbed[];
     } | undefined;
     /**
@@ -366,6 +367,9 @@ interface ResponseState {
      * A reply Discord refuses as already acknowledged elsewhere still throws, and the next `send()` edits.
      * After `modal()` it throws: a modal has no message, and the modal's submit is answered instead.
      *
+     * After a private `followUp()` replaced a public deferral, it edits that follow-up. After `delete()` it sends a
+     * follow-up, private when the deleted answer was unless `flags` say otherwise, and that follow-up is the answer.
+     *
      * After `@Defer` locked a message, omitting `components` puts back its components as they were
      * before the lock, and omitting `embeds` drops the loading view; `components: []` clears them.
      *
@@ -375,7 +379,8 @@ interface ResponseState {
      */
     send(payload: ResponsePayload, options?: ResponseSendOptions): Promise<Message | undefined>;
     /**
-     * Edits the answer, routed as `send()` is: an edit once the interaction is answered.
+     * Edits the answer, routed as `send()` is: an edit once the interaction is answered, of the follow-up that replaced
+     * a public deferral, or, after `delete()`, a follow-up that becomes the answer.
      *
      * @param payload - Text, or edit options.
      * @param options - `fill: false` leaves this edit's embeds and containers uncoloured.
@@ -386,8 +391,9 @@ interface ResponseState {
      * Sends another message after the answer. Before any answer it is the first reply. While a command's
      * reply is deferred and nothing is sent yet, Discord turns a follow-up into the deferred reply and
      * ignores its flags, so it is sent as that edit; a private follow-up on a public deferral deletes the
-     * deferral first and is sent privately. After `modal()` it is sent as made, and Discord decides whether it
-     * accepts a follow-up there; the modal's submit is the interaction to answer.
+     * deferral first, is sent privately, and is the answer `send()`, `edit()` and `delete()` act on. After `delete()`,
+     * it is the answer too. After `modal()` it is sent as made, and Discord decides whether it accepts a follow-up
+     * there; the modal's submit is the interaction to answer.
      *
      * @param payload - Text, or reply options; `Ephemeral` makes the follow-up private.
      * @param options - `fill: false` leaves this follow-up's embeds and containers uncoloured.
@@ -395,8 +401,9 @@ interface ResponseState {
      */
     followUp(payload: ResponsePayload, options?: ResponseSendOptions): Promise<Message | undefined>;
     /**
-     * Deletes the answer: the reply, or for a component deferred without a reply of its own, its message.
-     * Throws before any answer, and after `modal()`, which leaves no message.
+     * Deletes the answer: the reply, the follow-up that replaced a public deferral, or for a component deferred
+     * without a reply of its own, its message. `message` is then `undefined` until something is sent. Throws before any
+     * answer, after `modal()`, which leaves no message, and again with nothing sent since the last `delete()`.
      */
     delete(): Promise<void>;
     /**
@@ -1243,7 +1250,10 @@ declare class MemoryCooldownStore extends CooldownStore {
     peekMany(entries: readonly CooldownEntry[]): Promise<CooldownBatchVerdict>;
     /** Each entry's call times, trimmed to its window, and whether it allows one more call now. */
     private check;
-    /** Drops the keys whose calls have all left their window, once a minute from the store's first call. */
+    /**
+     * Drops the keys whose calls have all left their window, once a minute from a call, until a sweep leaves none: an
+     * idle store then holds no timer, so one nothing references is collected, and its next call starts the sweep again.
+     */
     private startSweeping;
 }
 
@@ -2105,10 +2115,14 @@ interface MeoCordApplication {
      */
     start(): Promise<void>;
     /**
-     * Stops the bot: runs the `onShutdown` hooks under the configured `shutdownTimeout` and closes the client, or with
-     * process sharding, asks every shard to shut down and waits for it. It ends no process of its own accord, except that
-     * called in a shard, it asks the manager to stop every shard, which then shuts that shard's process down too. A stop
-     * while the bot starts ends that start, a call after the first waits for it, and a stopped app does not start again.
+     * Stops the bot: stops taking events, waits for the calls under way, runs the `onShutdown` hooks under the configured
+     * `shutdownTimeout` and closes the client, or with process sharding, asks every shard to shut down and waits for it.
+     * It ends no process of its own accord, except that called in a shard, it asks the manager to stop every shard, which
+     * then shuts that shard's process down too. A call that awaits `stop()`, as an owner-only shutdown command does, is
+     * not waited for.
+     *
+     * A stop while the bot starts ends that start: it waits for the providers being made, at most `shutdownTimeout`, and
+     * nothing more is made after it. A call after the first waits for it, and a stopped app does not start again.
      *
      * @returns A promise that resolves once the bot is stopped. It never rejects: a failure to close is logged, and sets
      *   `process.exitCode` to 1 unless another code is already set.
@@ -2188,9 +2202,11 @@ interface OnReady {
  * it injects. The whole sequence is limited by `shutdownTimeout` in `meocord.config.ts`; shutdown then goes on
  * whether or not it finished. A hook that throws is logged and the next one still runs.
  *
- * It runs only for a class whose `onReady` has finished, or that has none: a signal that arrives
- * while the ready hooks are running skips the class still starting and those not reached yet, and no
- * further `onReady` starts. An `onReady` that threw counts as finished, so its partial setup is cleaned up.
+ * It runs only for a class whose `onReady` has finished, or that has none. A stop while the ready hooks
+ * are running waits for the `onReady` in progress, within `shutdownTimeout`, then shuts that class down too;
+ * those not reached yet are skipped, and no further `onReady` starts. An `onReady` still running once only the
+ * hooks' share of the timeout is left is named in a warning and skipped. An `onReady` that threw counts as
+ * finished, so its partial setup is cleaned up.
  *
  * @example
  * ```ts
@@ -2355,7 +2371,11 @@ interface MessageResponseContext {
  * @category Presenters
  */
 interface PresentedError {
-    /** What the user is told. */
+    /**
+     * What the user is told, fitted to Discord's limit for the answer's `mode`: at most 4096 characters for an embed and
+     * 4000 for a Components V2 Text Display, cut to end in `…`. An empty or whitespace-only message comes as MeoCord's generic error text.
+     * So a presenter that writes it as its view's text renders, whatever the error's message.
+     */
     message: string;
     /** The error being answered, so a presenter can style it by kind. */
     error: unknown;
@@ -3186,9 +3206,13 @@ interface MeoCordConfig {
      */
     startupErrors?: 'first' | 'all';
     /**
-     * How long, in milliseconds, shutdown waits for the `onShutdown` hooks before destroying the client
-     * anyway: from 0 to 2147478647, the longest a timer keeps less the margin the shard manager waits on top. The limit covers the whole sequence, not each hook,
-     * including the calls under way that the cooldown store's shutdown waits for.
+     * How long, in milliseconds, shutdown waits for the calls under way and the `onShutdown` hooks before destroying the
+     * client anyway: from 0 to 2147478647, the longest a timer keeps less the margin the shard manager waits on top. The
+     * limit covers the whole sequence, not each hook.
+     *
+     * The calls are waited for first, but no longer than the timeout less a reserve kept for the hooks: a quarter of it,
+     * at least 1 second and never more than half. A call still running then is named in a warning, and the hooks run in
+     * the time left.
      *
      * @defaultValue `10_000`
      */

package/dist/types/interface/index.d.cts

@@ -1,4 +1,4 @@
 import 'discord.js';
 import '@rsbuild/core';
 import '../controller.enum-DTDn69N9.cjs';
-export { ar as AutocompleteMetadata, O as BuildableCommandType, as as CallHandler, _ as CheckedParams, ao as ClassProvider, at as CommandBuildResult, S as CommandBuilderBase, X as CommandBuilderConstructor, Q as CommandBuilderOptions, Y as CommandInteractionType, au as CommandMetadata, av as CommandRegistrationConfig, a1 as ControllerOptions, ak as CooldownOptions, a9 as CooldownStoreFailure, aw as DeepPartial, D as DeepReadonly, ab as DispatchObserver, ax as DispatchOutcome, ay as DispatchResult, az as EntityRef, a7 as ExceptionFilter, F as FactoryProvider, a4 as GuardInterface, a3 as GuardOptions, aA as GuildThemeTarget, aj as InferSchemaOutput, a6 as InterceptorInterface, a5 as InterceptorOptions, J as MeoCordApplication, aB as MeoCordConfig, aq as MeoCordMessages, M as MeoCordTheme, L as MessageCommandOptions, Z as MessageHandlerOptions, N as MessageHelp, aC as MessageHelpEntry, aD as MessageHelpOptions, aE as MessageHelpParam, aF as MessageParamType, aG as MessageParamTypes, an as MessagePrefix, aH as MessageResponseContext, K as MessageScope, al as ObserverOptions, aI as OnReady, aJ as OnShutdown, W as PIPED_BRAND, aK as ParamRefsOf, aL as ParamsOf, af as PipeInterface, aM as Piped, aN as PresentedError, aO as PrimaryEntryPointCommandData, a8 as Provider, P as ProviderToken, a0 as ReactionEvent, aP as ReactionHandlerOptions, $ as ReactionHandlerSettings, aQ as ReadyInfo, aR as ReservedThemeRole, aS as ResponseContext, aT as ResponseFile, aa as ResponsePresenter, aU as ResponseView, ac as RootTheme, aV as RsbuildConfig, aW as ShardingConfig, a2 as StageParams, ag as StandardSchemaV1, aX as StandardSchemaV1Issue, aY as StandardSchemaV1Props, aZ as StandardSchemaV1Result, a_ as ThemeButtonStyle, a$ as ThemeButtons, b0 as ThemeColors, b1 as ThemeEmojis, am as ThemeOverride, ae as ThemeResolver, ad as ThemeResolvers, T as Token, b2 as UserThemeTarget, ai as ValidateOptions, ah as ValidatePipes, ap as ValueProvider } from '../index-nn5p7OoX.cjs';
+export { ar as AutocompleteMetadata, O as BuildableCommandType, as as CallHandler, _ as CheckedParams, ao as ClassProvider, at as CommandBuildResult, S as CommandBuilderBase, X as CommandBuilderConstructor, Q as CommandBuilderOptions, Y as CommandInteractionType, au as CommandMetadata, av as CommandRegistrationConfig, a1 as ControllerOptions, ak as CooldownOptions, a9 as CooldownStoreFailure, aw as DeepPartial, D as DeepReadonly, ab as DispatchObserver, ax as DispatchOutcome, ay as DispatchResult, az as EntityRef, a7 as ExceptionFilter, F as FactoryProvider, a4 as GuardInterface, a3 as GuardOptions, aA as GuildThemeTarget, aj as InferSchemaOutput, a6 as InterceptorInterface, a5 as InterceptorOptions, J as MeoCordApplication, aB as MeoCordConfig, aq as MeoCordMessages, M as MeoCordTheme, L as MessageCommandOptions, Z as MessageHandlerOptions, N as MessageHelp, aC as MessageHelpEntry, aD as MessageHelpOptions, aE as MessageHelpParam, aF as MessageParamType, aG as MessageParamTypes, an as MessagePrefix, aH as MessageResponseContext, K as MessageScope, al as ObserverOptions, aI as OnReady, aJ as OnShutdown, W as PIPED_BRAND, aK as ParamRefsOf, aL as ParamsOf, af as PipeInterface, aM as Piped, aN as PresentedError, aO as PrimaryEntryPointCommandData, a8 as Provider, P as ProviderToken, a0 as ReactionEvent, aP as ReactionHandlerOptions, $ as ReactionHandlerSettings, aQ as ReadyInfo, aR as ReservedThemeRole, aS as ResponseContext, aT as ResponseFile, aa as ResponsePresenter, aU as ResponseView, ac as RootTheme, aV as RsbuildConfig, aW as ShardingConfig, a2 as StageParams, ag as StandardSchemaV1, aX as StandardSchemaV1Issue, aY as StandardSchemaV1Props, aZ as StandardSchemaV1Result, a_ as ThemeButtonStyle, a$ as ThemeButtons, b0 as ThemeColors, b1 as ThemeEmojis, am as ThemeOverride, ae as ThemeResolver, ad as ThemeResolvers, T as Token, b2 as UserThemeTarget, ai as ValidateOptions, ah as ValidatePipes, ap as ValueProvider } from '../index-Dlf0ZZtS.cjs';

package/dist/types/interface/index.d.ts

@@ -1,4 +1,4 @@
 import 'discord.js';
 import '@rsbuild/core';
 import '../controller.enum-DTDn69N9.js';
-export { ar as AutocompleteMetadata, O as BuildableCommandType, as as CallHandler, _ as CheckedParams, ao as ClassProvider, at as CommandBuildResult, S as CommandBuilderBase, X as CommandBuilderConstructor, Q as CommandBuilderOptions, Y as CommandInteractionType, au as CommandMetadata, av as CommandRegistrationConfig, a1 as ControllerOptions, ak as CooldownOptions, a9 as CooldownStoreFailure, aw as DeepPartial, D as DeepReadonly, ab as DispatchObserver, ax as DispatchOutcome, ay as DispatchResult, az as EntityRef, a7 as ExceptionFilter, F as FactoryProvider, a4 as GuardInterface, a3 as GuardOptions, aA as GuildThemeTarget, aj as InferSchemaOutput, a6 as InterceptorInterface, a5 as InterceptorOptions, J as MeoCordApplication, aB as MeoCordConfig, aq as MeoCordMessages, M as MeoCordTheme, L as MessageCommandOptions, Z as MessageHandlerOptions, N as MessageHelp, aC as MessageHelpEntry, aD as MessageHelpOptions, aE as MessageHelpParam, aF as MessageParamType, aG as MessageParamTypes, an as MessagePrefix, aH as MessageResponseContext, K as MessageScope, al as ObserverOptions, aI as OnReady, aJ as OnShutdown, W as PIPED_BRAND, aK as ParamRefsOf, aL as ParamsOf, af as PipeInterface, aM as Piped, aN as PresentedError, aO as PrimaryEntryPointCommandData, a8 as Provider, P as ProviderToken, a0 as ReactionEvent, aP as ReactionHandlerOptions, $ as ReactionHandlerSettings, aQ as ReadyInfo, aR as ReservedThemeRole, aS as ResponseContext, aT as ResponseFile, aa as ResponsePresenter, aU as ResponseView, ac as RootTheme, aV as RsbuildConfig, aW as ShardingConfig, a2 as StageParams, ag as StandardSchemaV1, aX as StandardSchemaV1Issue, aY as StandardSchemaV1Props, aZ as StandardSchemaV1Result, a_ as ThemeButtonStyle, a$ as ThemeButtons, b0 as ThemeColors, b1 as ThemeEmojis, am as ThemeOverride, ae as ThemeResolver, ad as ThemeResolvers, T as Token, b2 as UserThemeTarget, ai as ValidateOptions, ah as ValidatePipes, ap as ValueProvider } from '../index-CdXsFgjE.js';
+export { ar as AutocompleteMetadata, O as BuildableCommandType, as as CallHandler, _ as CheckedParams, ao as ClassProvider, at as CommandBuildResult, S as CommandBuilderBase, X as CommandBuilderConstructor, Q as CommandBuilderOptions, Y as CommandInteractionType, au as CommandMetadata, av as CommandRegistrationConfig, a1 as ControllerOptions, ak as CooldownOptions, a9 as CooldownStoreFailure, aw as DeepPartial, D as DeepReadonly, ab as DispatchObserver, ax as DispatchOutcome, ay as DispatchResult, az as EntityRef, a7 as ExceptionFilter, F as FactoryProvider, a4 as GuardInterface, a3 as GuardOptions, aA as GuildThemeTarget, aj as InferSchemaOutput, a6 as InterceptorInterface, a5 as InterceptorOptions, J as MeoCordApplication, aB as MeoCordConfig, aq as MeoCordMessages, M as MeoCordTheme, L as MessageCommandOptions, Z as MessageHandlerOptions, N as MessageHelp, aC as MessageHelpEntry, aD as MessageHelpOptions, aE as MessageHelpParam, aF as MessageParamType, aG as MessageParamTypes, an as MessagePrefix, aH as MessageResponseContext, K as MessageScope, al as ObserverOptions, aI as OnReady, aJ as OnShutdown, W as PIPED_BRAND, aK as ParamRefsOf, aL as ParamsOf, af as PipeInterface, aM as Piped, aN as PresentedError, aO as PrimaryEntryPointCommandData, a8 as Provider, P as ProviderToken, a0 as ReactionEvent, aP as ReactionHandlerOptions, $ as ReactionHandlerSettings, aQ as ReadyInfo, aR as ReservedThemeRole, aS as ResponseContext, aT as ResponseFile, aa as ResponsePresenter, aU as ResponseView, ac as RootTheme, aV as RsbuildConfig, aW as ShardingConfig, a2 as StageParams, ag as StandardSchemaV1, aX as StandardSchemaV1Issue, aY as StandardSchemaV1Props, aZ as StandardSchemaV1Result, a_ as ThemeButtonStyle, a$ as ThemeButtons, b0 as ThemeColors, b1 as ThemeEmojis, am as ThemeOverride, ae as ThemeResolver, ad as ThemeResolvers, T as Token, b2 as UserThemeTarget, ai as ValidateOptions, ah as ValidatePipes, ap as ValueProvider } from '../index-DKJclIi-.js';

package/dist/types/{route-BZgFoNeB.d.cts → route-Bh1U13yy.d.cts}

@@ -58,7 +58,7 @@ interface Route<T extends string = string> {
      * encoded, and the handler receives the value as it was given.
      *
      * @throws TypeError for a missing, empty or unknown value or one not of its param's type, and RangeError for an id
-     *   over 100 characters.
+     *   that is empty or over 100 characters.
      */
     build(...values: [RouteParams<T>] extends [never] ? [] : [values: RouteValues<T>]): string;
     /** The pattern, so a route reads as its pattern in a template string. */
@@ -76,7 +76,8 @@ interface Route<T extends string = string> {
  * fails to compile, and a typed param takes a value of its type.
  *
  * @param pattern - The customId pattern, where `{name}` captures one `/`-separated segment and `{name:int}` a
- *   typed one.
+ *   typed one. A param's name is ASCII letters, digits and _: a brace pair such as `{café}` is literal text, and is
+ *   warned about.
  * @returns A route whose `build` takes a value for each param.
  * @throws Error when the pattern cannot be read, as `@Command` would throw for it.
  *

package/dist/types/{route-BZgFoNeB.d.ts → route-Bh1U13yy.d.ts}

@@ -58,7 +58,7 @@ interface Route<T extends string = string> {
      * encoded, and the handler receives the value as it was given.
      *
      * @throws TypeError for a missing, empty or unknown value or one not of its param's type, and RangeError for an id
-     *   over 100 characters.
+     *   that is empty or over 100 characters.
      */
     build(...values: [RouteParams<T>] extends [never] ? [] : [values: RouteValues<T>]): string;
     /** The pattern, so a route reads as its pattern in a template string. */
@@ -76,7 +76,8 @@ interface Route<T extends string = string> {
  * fails to compile, and a typed param takes a value of its type.
  *
  * @param pattern - The customId pattern, where `{name}` captures one `/`-separated segment and `{name:int}` a
- *   typed one.
+ *   typed one. A param's name is ASCII letters, digits and _: a brace pair such as `{café}` is literal text, and is
+ *   warned about.
  * @returns A route whose `build` takes a value for each param.
  * @throws Error when the pattern cannot be read, as `@Command` would throw for it.
  *