meocord 4.1.2 → 4.2.0

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

@@ -32,7 +32,7 @@ import '@rsbuild/core';
  * @group Decorators
  * @category App
  * @see {@link Inject}
- * @see {@link https://meocord.dev/docs/4.1/services | Services}
+ * @see {@link https://meocord.dev/docs/4.2/services | Services}
  */
 declare function Service<T>(): (target: new (...args: any[]) => T, propertyKey?: string | symbol) => void;
 
@@ -63,7 +63,7 @@ declare function Service<T>(): (target: new (...args: any[]) => T, propertyKey?:
  * @group Decorators
  * @category Handlers
  * @see {@link Command}
- * @see {@link https://meocord.dev/docs/4.1/slash-commands | Slash commands}
+ * @see {@link https://meocord.dev/docs/4.2/slash-commands | Slash commands}
  */
 declare function CommandBuilder<T extends BuildableCommandType>(commandType: T, options?: CommandBuilderOptions): (target: new () => CommandBuilderBase<T>, propertyKey?: string | symbol) => void;
 
@@ -141,7 +141,7 @@ type ParamsFit<P, Given> = [Given] extends [Unpiped<P>] ? unknown : [Misfits<P,
  * @group Decorators
  * @category Handlers
  * @see {@link ReactionHandler}
- * @see {@link https://meocord.dev/docs/4.1/message-commands | Message commands}
+ * @see {@link https://meocord.dev/docs/4.2/message-commands | Message commands}
  */
 declare function MessageHandler<T extends OmitPartialGroupDMChannel<Message<boolean>>, R>(): (target: object, propertyKey: string, _descriptor: TypedPropertyDescriptor<(message: T) => R> | TypedPropertyDescriptor<() => R>) => void;
 /**
@@ -179,7 +179,7 @@ declare function MessageHandler<T extends OmitPartialGroupDMChannel<Message<bool
  * @group Decorators
  * @category Handlers
  * @see {@link ParamsOf}
- * @see {@link https://meocord.dev/docs/4.1/message-commands | Message commands}
+ * @see {@link https://meocord.dev/docs/4.2/message-commands | Message commands}
  */
 declare function MessageHandler<T extends OmitPartialGroupDMChannel<Message<boolean>>, R, const Pattern extends string = string>(pattern: Pattern, options?: MessageHandlerOptions): PatternedMessageHandlerDecorator<T, R, Pattern>;
 type ReactionHandlerDecorator<T extends MessageReaction | PartialMessageReaction, R> = (target: object, propertyKey: string, descriptor: TypedPropertyDescriptor<(reaction: T, options: ReactionEvent) => R> | TypedPropertyDescriptor<(reaction: T) => R> | TypedPropertyDescriptor<() => R>) => void;
@@ -215,7 +215,7 @@ type ReactionHandlerDecorator<T extends MessageReaction | PartialMessageReaction
  * @group Decorators
  * @category Handlers
  * @see {@link ReactionEvent}
- * @see {@link https://meocord.dev/docs/4.1/reactions | Reactions}
+ * @see {@link https://meocord.dev/docs/4.2/reactions | Reactions}
  */
 declare function ReactionHandler<T extends MessageReaction | PartialMessageReaction, R>(emoji?: string, settings?: ReactionHandlerSettings): ReactionHandlerDecorator<T, R>;
 /**
@@ -307,10 +307,11 @@ type TypedParamsAccept<N, T, P> = T extends CommandType ? string extends Pattern
  * the keys the handler's params require are checked against the pattern or route, a typed segment's value against
  * its type, and a select menu's choices, such as `values: string[]`, against what discord.js gives; a key a pipe
  * produces is declared `Piped<T>`, and left to the pipe. Two component handlers of one type whose patterns match
- * exactly the same ids stop the bot at startup; patterns that only overlap are warned about, naming the one that
- * runs: the more specific, or between equally specific ones, the one listed first. In the next major version (5.0),
- * the one that spells out the first segment where two equally specific patterns differ runs instead, and the warning
- * names the pairs that changes. A context menu handler receives the kind its builder's `setType()` names, and one
+ * exactly the same ids stop the bot at startup. Patterns that both match an id rank segment by segment, left to
+ * right: at the first segment one spells out as literal text and the other leaves to a param, the literal one runs,
+ * so `profile/me/{section}` takes `profile/me/edit` from `profile/{userId}/edit`; between patterns that leaves tied,
+ * the narrower type at the first param where they differ. Two still tied are warned about as the bot starts, and the
+ * one listed first runs. A context menu handler receives the kind its builder's `setType()` names, and one
  * declaring the other kind fails to compile; when the compiler cannot tell the kind, `@Command` checks the parameter
  * type it emits as it applies. A subclass that re-declares an inherited handler on the same name or pattern takes its
  * own builder and options; on another it still answers the inherited one too, which the bot warns about as it
@@ -343,8 +344,8 @@ type TypedParamsAccept<N, T, P> = T extends CommandType ? string extends Pattern
  * @category Handlers
  * @see {@link CommandBuilder}
  * @see {@link route}
- * @see {@link https://meocord.dev/docs/4.1/slash-commands | Slash commands}
- * @see {@link https://meocord.dev/docs/4.1/components | Buttons, selects and modals}
+ * @see {@link https://meocord.dev/docs/4.2/slash-commands | Slash commands}
+ * @see {@link https://meocord.dev/docs/4.2/components | Buttons, selects and modals}
  */
 declare function Command<CBC extends BuildableCommandType, T extends CommandBuilderConstructor<CBC> | CommandType, N extends string | Route = string>(name: N, builderOrType: T): <P extends Record<string, any>, R>(target: object, propertyKey: string, _descriptor: (TypedPropertyDescriptor<Handles<CommandInteractionType<CBC, T>, [params: P], R>> | TypedPropertyDescriptor<Handles<CommandInteractionType<CBC, T>, [], R>> | TypedPropertyDescriptor<() => R>) & RouteAccepts<N, T, P> & TypedParamsAccept<N, T, P> & ChoicesAccept<N, T, P>) => void;
 /**
@@ -383,7 +384,7 @@ declare function Command<CBC extends BuildableCommandType, T extends CommandBuil
  * @group Decorators
  * @category Handlers
  * @see {@link Command}
- * @see {@link https://meocord.dev/docs/4.1/autocomplete | Autocomplete}
+ * @see {@link https://meocord.dev/docs/4.2/autocomplete | Autocomplete}
  */
 declare function Autocomplete<_R = unknown>(commandPath: string, optionName?: string): <P extends Record<string, any>, R>(target: object, propertyKey: string, _descriptor: TypedPropertyDescriptor<(interaction: AutocompleteInteraction, params: P) => R> | TypedPropertyDescriptor<(interaction: AutocompleteInteraction) => R> | TypedPropertyDescriptor<() => R>) => void;
 
@@ -419,7 +420,7 @@ declare function Autocomplete<_R = unknown>(commandPath: string, optionName?: st
  * @category Controllers
  * @see {@link Command}
  * @see {@link ControllerOptions}
- * @see {@link https://meocord.dev/docs/4.1/how-a-call-runs | How a call runs}
+ * @see {@link https://meocord.dev/docs/4.2/how-a-call-runs | How a call runs}
  */
 declare function Controller(options?: ControllerOptions): (target: abstract new (...args: any[]) => unknown, propertyKey?: string | symbol) => void;
 
@@ -449,7 +450,7 @@ declare function Controller(options?: ControllerOptions): (target: abstract new
  * @group Decorators
  * @category Handlers
  * @see {@link Once}
- * @see {@link https://meocord.dev/docs/4.1/gateway-events | Gateway events}
+ * @see {@link https://meocord.dev/docs/4.2/gateway-events | Gateway events}
  */
 declare function On<E extends keyof ClientEvents>(event: E): <F extends (...args: ClientEvents[E]) => unknown>(target: object, propertyKey: string, _descriptor: TypedPropertyDescriptor<F>) => void;
 /**
@@ -475,7 +476,7 @@ declare function On<E extends keyof ClientEvents>(event: E): <F extends (...args
  * @group Decorators
  * @category Handlers
  * @see {@link On}
- * @see {@link https://meocord.dev/docs/4.1/gateway-events | Gateway events}
+ * @see {@link https://meocord.dev/docs/4.2/gateway-events | Gateway events}
  */
 declare function Once<E extends keyof ClientEvents>(event: E): <F extends (...args: ClientEvents[E]) => unknown>(target: object, propertyKey: string, _descriptor: TypedPropertyDescriptor<F>) => void;
 
@@ -525,7 +526,7 @@ type CheckedEntry<E, Base extends abstract new (...args: any[]) => unknown> = E
  * @see {@link UseGuard}
  * @see {@link GuardDeniedError}
  * @see {@link ExecutionContext}
- * @see {@link https://meocord.dev/docs/4.1/guards | Guards}
+ * @see {@link https://meocord.dev/docs/4.2/guards | Guards}
  */
 declare function Guard(options?: GuardOptions): (target: any, propertyKey?: string | symbol) => void;
 /**
@@ -557,7 +558,7 @@ declare function Guard(options?: GuardOptions): (target: any, propertyKey?: stri
  * @see {@link Guard}
  * @see {@link GuardDeniedError}
  * @see {@link ExecutionContext}
- * @see {@link https://meocord.dev/docs/4.1/guards | Guards}
+ * @see {@link https://meocord.dev/docs/4.2/guards | Guards}
  */
 declare function UseGuard<const T extends readonly unknown[]>(...entries: {
     [K in keyof T]: CheckedEntry<T[K], new (...args: any[]) => GuardInterface>;
@@ -595,7 +596,7 @@ declare function UseGuard<const T extends readonly unknown[]>(...entries: {
  * @group Decorators
  * @category Pipeline stages
  * @see {@link UseInterceptor}
- * @see {@link https://meocord.dev/docs/4.1/interceptors | Interceptors}
+ * @see {@link https://meocord.dev/docs/4.2/interceptors | Interceptors}
  */
 declare function Interceptor(options?: InterceptorOptions): (target: new (...args: any[]) => InterceptorInterface, propertyKey?: string | symbol) => void;
 /**
@@ -627,7 +628,7 @@ declare function Interceptor(options?: InterceptorOptions): (target: new (...arg
  * @group Decorators
  * @category Pipeline stages
  * @see {@link Interceptor}
- * @see {@link https://meocord.dev/docs/4.1/interceptors | Interceptors}
+ * @see {@link https://meocord.dev/docs/4.2/interceptors | Interceptors}
  */
 declare function UseInterceptor<const T extends readonly unknown[]>(...interceptors: {
     [K in keyof T]: CheckedEntry<T[K], new (...args: any[]) => InterceptorInterface>;
@@ -660,7 +661,7 @@ declare function UseInterceptor<const T extends readonly unknown[]>(...intercept
  * @group Decorators
  * @category Pipeline stages
  * @see {@link UseFilter}
- * @see {@link https://meocord.dev/docs/4.1/exception-filters | Exception filters}
+ * @see {@link https://meocord.dev/docs/4.2/exception-filters | Exception filters}
  */
 declare function Catch(...errorTypes: (abstract new (...args: any[]) => unknown)[]): (target: new (...args: any[]) => ExceptionFilter<any>, propertyKey?: string | symbol) => void;
 /**
@@ -693,7 +694,7 @@ declare function Catch(...errorTypes: (abstract new (...args: any[]) => unknown)
  * @group Decorators
  * @category Pipeline stages
  * @see {@link Catch}
- * @see {@link https://meocord.dev/docs/4.1/exception-filters | Exception filters}
+ * @see {@link https://meocord.dev/docs/4.2/exception-filters | Exception filters}
  */
 declare function UseFilter<const T extends readonly unknown[]>(...filters: {
     [K in keyof T]: CheckedEntry<T[K], new (...args: any[]) => ExceptionFilter<any>>;
@@ -888,7 +889,7 @@ interface MeoCordOptions<G extends readonly unknown[] = readonly unknown[], I ex
  * @see {@link MeoCordOptions}
  * @see {@link MeoCordFactory}
  * @see {@link MeoCordConfig}
- * @see {@link https://meocord.dev/docs/4.1/configuration | Configuration}
+ * @see {@link https://meocord.dev/docs/4.2/configuration | Configuration}
  */
 declare function MeoCord<const G extends readonly unknown[] = [], const I extends readonly unknown[] = [], const F extends readonly unknown[] = []>(options: MeoCordOptions<G, I, F>): (target: any, propertyKey?: string | symbol) => void;
 
@@ -948,7 +949,7 @@ type AcceptsInput<P, Input> = [P] extends [NoInput] ? unknown : [Input] extends
  * @category Pipeline stages
  * @see {@link UsePipe}
  * @see {@link ValidationError}
- * @see {@link https://meocord.dev/docs/4.1/validation | Validation and pipes}
+ * @see {@link https://meocord.dev/docs/4.2/validation | Validation and pipes}
  */
 declare function Validate<S extends StandardSchemaV1, const Pipes extends ValidatePipes<S> = Record<never, never>>(schema: S, options?: ValidateOptions<Pipes>): <M extends Handler>(target: object, propertyKey: string, _descriptor: TypedPropertyDescriptor<M> & AcceptsInput<ParamsOf<M>, ValidatedInput<S, Pipes>>) => void;
 /** Allows the descriptor when the handler's params take the pipe's output at `key`. */
@@ -983,7 +984,7 @@ type AcceptsPiped<P, K extends string, Out> = [P] extends [NoInput] ? unknown :
  * @category Pipeline stages
  * @see {@link Pipe}
  * @see {@link Validate}
- * @see {@link https://meocord.dev/docs/4.1/validation | Validation and pipes}
+ * @see {@link https://meocord.dev/docs/4.2/validation | Validation and pipes}
  */
 declare function UsePipe<K extends string, const Pipes extends readonly [PipeEntryOf, ...PipeEntryOf[]]>(key: K, ...pipes: Pipes & {
     [I in keyof Pipes]: CheckedEntry<Pipes[I], new (...args: any[]) => PipeInterface>;
@@ -1012,7 +1013,7 @@ declare function UsePipe<K extends string, const Pipes extends readonly [PipeEnt
  * @group Decorators
  * @category Pipeline stages
  * @see {@link UsePipe}
- * @see {@link https://meocord.dev/docs/4.1/validation | Validation and pipes}
+ * @see {@link https://meocord.dev/docs/4.2/validation | Validation and pipes}
  */
 declare function Pipe(): (target: new (...args: any[]) => PipeInterface, propertyKey?: string | symbol) => void;
 
@@ -1068,7 +1069,7 @@ interface CooldownByDecorator<P> {
  * @see {@link CooldownOptions}
  * @see {@link CooldownError}
  * @see {@link CooldownStore}
- * @see {@link https://meocord.dev/docs/4.1/cooldowns | Cooldowns}
+ * @see {@link https://meocord.dev/docs/4.2/cooldowns | Cooldowns}
  */
 declare function Cooldown(options: CooldownOptions & {
     by?: undefined;
@@ -1162,7 +1163,7 @@ interface DeferOptions {
  * @category Pipeline stages
  * @see {@link DeferOptions}
  * @see {@link respond}
- * @see {@link https://meocord.dev/docs/4.1/defer | Deferring}
+ * @see {@link https://meocord.dev/docs/4.2/defer | Deferring}
  */
 declare function Defer(options?: DeferOptions): MethodDecorator;
 
@@ -1189,7 +1190,7 @@ declare function Defer(options?: DeferOptions): MethodDecorator;
  * @category Params
  * @see {@link Service}
  * @see {@link createToken}
- * @see {@link https://meocord.dev/docs/4.1/services | Services}
+ * @see {@link https://meocord.dev/docs/4.2/services | Services}
  */
 declare function Inject(token: ProviderToken): (target: object, propertyKey: string | symbol | undefined, parameterIndex: number) => void;
 
@@ -1224,7 +1225,7 @@ declare function Inject(token: ProviderToken): (target: object, propertyKey: str
  * @pipeline observers-settled once the call has settled and been answered, however it ended
  * @group Decorators
  * @category Pipeline stages
- * @see {@link https://meocord.dev/docs/4.1/observers | Observers}
+ * @see {@link https://meocord.dev/docs/4.2/observers | Observers}
  */
 declare function Observer(options?: ObserverOptions): (target: new (...args: any[]) => DispatchObserver, propertyKey?: string | symbol) => void;
 

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

@@ -48,7 +48,7 @@ interface MetadataDecorator<T> {
  *
  * @group Utilities
  * @see {@link ExecutionContext}
- * @see {@link https://meocord.dev/docs/4.1/guards | Guards}
+ * @see {@link https://meocord.dev/docs/4.2/guards | Guards}
  */
 declare function createMetadata<T>(description?: string): MetadataDecorator<T>;
 
@@ -781,7 +781,7 @@ type ExecutionContextType = 'interaction' | 'autocomplete' | 'message' | 'reacti
  * @group Utilities
  * @see {@link createMetadata}
  * @see {@link StageParams}
- * @see {@link https://meocord.dev/docs/4.1/guards | Guards}
+ * @see {@link https://meocord.dev/docs/4.2/guards | Guards}
  */
 declare abstract class ExecutionContext {
     /**
@@ -1348,7 +1348,7 @@ declare class UserError extends Error {
  * @group Responses
  * @category Errors
  * @see {@link Catch}
- * @see {@link https://meocord.dev/docs/4.1/exception-filters | Exception filters}
+ * @see {@link https://meocord.dev/docs/4.2/exception-filters | Exception filters}
  */
 declare class CommandNotFoundError extends Error {
     /** @param message - What the error says, `No handler matched the interaction.` unless given. */
@@ -1439,7 +1439,7 @@ interface MessageUsageIssue {
  * @category Errors
  * @see {@link MessageHandler}
  * @see {@link translateError}
- * @see {@link https://meocord.dev/docs/4.1/message-commands | Message commands}
+ * @see {@link https://meocord.dev/docs/4.2/message-commands | Message commands}
  */
 declare class MessageUsageError extends Error {
     readonly usage: string;
@@ -1956,8 +1956,10 @@ interface CommandMeta<T extends string = string> {
     /** The params a component's customId pattern captures, in the order they appear. */
     dynamicParams?: T[];
     /**
-     * How specific this pattern is; the highest wins when several routes match one customId, so
-     * `gi-profile/summary/{ownerId}/{uid}` beats `gi-profile/{uuid}/{uid}` whatever the declaration order.
+     * How specific this pattern is, as 4.1 ranked patterns: more literal text first.
+     *
+     * @deprecated Since 4.2, and removed in the next major version (5.0). Internal: nothing replaces it. Component routing
+     * ranks patterns segment by segment and doesn't read it.
      */
     specificity?: number;
     /** The builder's own `guilds` option, when it has one. */
@@ -2164,7 +2166,7 @@ interface ReadyInfo {
  *
  * @group Types
  * @see {@link OnShutdown}
- * @see {@link https://meocord.dev/docs/4.1/lifecycle-hooks | Lifecycle hooks}
+ * @see {@link https://meocord.dev/docs/4.2/lifecycle-hooks | Lifecycle hooks}
  */
 interface OnReady {
     /**
@@ -2211,7 +2213,7 @@ interface OnReady {
  *
  * @group Types
  * @see {@link OnReady}
- * @see {@link https://meocord.dev/docs/4.1/lifecycle-hooks | Lifecycle hooks}
+ * @see {@link https://meocord.dev/docs/4.2/lifecycle-hooks | Lifecycle hooks}
  */
 interface OnShutdown {
     /** Runs before the client is destroyed. */
@@ -2546,6 +2548,15 @@ interface ControllerOptions {
      * @defaultValue `true`
      */
     inheritStages?: boolean;
+    /**
+     * What a handler this class re-decorates answers of the routes its base classes declare for it. `'keep'` answers
+     * them as well as its own; `'replace'` answers only the routes this class declares for it, of every kind: commands,
+     * component patterns, message patterns, reactions and autocompletes. A command no handler answers any more is not
+     * registered. A method overridden without decorators keeps every route it inherits either way.
+     *
+     * @defaultValue `'keep'`; the next major version (5.0) replaces them by default
+     */
+    inheritedRoutes?: 'keep' | 'replace';
 }
 /**
  * One prefix or several that start a message command, such as `'!'` or `['!', '?']`; `''` stands for none.
@@ -2583,7 +2594,7 @@ type MessagePrefix = string | readonly string[];
  * @group Configuration
  * @category App options
  * @see {@link MessageHandler}
- * @see {@link https://meocord.dev/docs/4.1/message-commands | Message commands}
+ * @see {@link https://meocord.dev/docs/4.2/message-commands | Message commands}
  */
 interface MessageCommandOptions {
     /**
@@ -2656,6 +2667,28 @@ interface MessageCommandOptions {
      * @defaultValue `false`
      */
     help?: boolean | MessageHelpOptions;
+    /**
+     * How a message's handlers run: the patterned handler it matched, then every `@MessageHandler()` listener.
+     * `'sequential'` runs each once the one before it has settled, so a slow command delays the listeners after it.
+     * `'concurrent'` starts them together and settles once all have: each keeps its own guards, interceptors, filters
+     * and observers, and no order holds between them, so a listener can run before the command has written what it
+     * reads. The built-in help and a command's usage are answered first either way.
+     * @defaultValue `'sequential'`; the next major version (5.0) may run them concurrently by default
+     *
+     * @example
+     * ```ts
+     * @MeoCord({ controllers: [Commands, Moderation], messages: { prefix: '!', handlers: 'concurrent' } })
+     * class App {}
+     * ```
+     */
+    handlers?: 'sequential' | 'concurrent';
+    /**
+     * Warns, once per handler, when a message's handler takes 5 seconds or more with listeners waiting after it, under
+     * `handlers: 'sequential'`, naming the handler and how many it held back. A testing module warns only when this is
+     * `true`, since a test's fake clock can pass 5 seconds inside a handler.
+     * @defaultValue `true` in a running bot, `false` in a `MeoCordTestingModule`
+     */
+    slowHandlerWarning?: boolean;
 }
 /**
  * The words the built-in help command answers to, as `@MeoCord({ messages: { help } })` takes them.
@@ -2775,7 +2808,7 @@ interface MessageHelpParam {
  * ```
  *
  * @group Types
- * @see {@link https://meocord.dev/docs/4.1/localisation | Localisation}
+ * @see {@link https://meocord.dev/docs/4.2/localisation | Localisation}
  */
 type MeoCordMessages = (typeof MEOCORD_MESSAGES)['meocord'];
 /**
@@ -2806,7 +2839,7 @@ type MeoCordMessages = (typeof MEOCORD_MESSAGES)['meocord'];
  *
  * @group Configuration
  * @category App options
- * @see {@link https://meocord.dev/docs/4.1/message-params | Message params}
+ * @see {@link https://meocord.dev/docs/4.2/message-params | Message params}
  */
 interface MessageParamType<T = unknown> {
     /** A noun such as `hex colour`, read in "is not a valid hex colour". Defaults to the type's key. */
@@ -3019,7 +3052,7 @@ type MessageScope = 'guild' | 'dm' | 'any';
  * @group Configuration
  * @category App options
  * @see {@link MessageHandler}
- * @see {@link https://meocord.dev/docs/4.1/message-commands | Message commands}
+ * @see {@link https://meocord.dev/docs/4.2/message-commands | Message commands}
  */
 interface MessageHandlerOptions {
     /**
@@ -3077,7 +3110,7 @@ interface MessageHandlerOptions {
  * @group Configuration
  * @category Config file
  * @see {@link MeoCord}
- * @see {@link https://meocord.dev/docs/4.1/configuration | Configuration}
+ * @see {@link https://meocord.dev/docs/4.2/configuration | Configuration}
  */
 interface MeoCordConfig {
     /** Shown as a prefix on every log line. Omitted when unset. */
@@ -3138,6 +3171,20 @@ interface MeoCordConfig {
      * @defaultValue `true`
      */
     sourceMappedStacks?: boolean;
+    /**
+     * How a startup error a decorator finds, such as an invalid customId pattern, is reported.
+     *
+     * With `'first'`, a decorator throws its error as its class is defined, when its file is imported, so a bot with
+     * three mistakes shows one per run. With `'all'`, decorators keep their errors, and `MeoCordFactory.create()` logs
+     * every one, each with its handler and file, alongside the errors its own checks find, then throws the first. The
+     * built bot reads it before your modules load. In a test, call `reportAllStartupErrors()` from `meocord/testing` in
+     * the setup file instead.
+     *
+     * Whichever you choose, `create()` reports every error its own checks find, such as two handlers of one command.
+     *
+     * @defaultValue `'first'`; `'all'` in the next major version (5.0)
+     */
+    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,
@@ -3196,7 +3243,7 @@ interface MeoCordConfig {
  * @group Configuration
  * @category Config file
  * @see {@link ShardContext}
- * @see {@link https://meocord.dev/docs/4.1/sharding | Sharding}
+ * @see {@link https://meocord.dev/docs/4.2/sharding | Sharding}
  */
 interface ShardingConfig {
     /**
@@ -3239,7 +3286,7 @@ interface ShardingConfig {
  *
  * @group Configuration
  * @category Config file
- * @see {@link https://meocord.dev/docs/4.1/slash-commands | Slash commands}
+ * @see {@link https://meocord.dev/docs/4.2/slash-commands | Slash commands}
  */
 interface CommandRegistrationConfig {
     /**

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

@@ -48,7 +48,7 @@ interface MetadataDecorator<T> {
  *
  * @group Utilities
  * @see {@link ExecutionContext}
- * @see {@link https://meocord.dev/docs/4.1/guards | Guards}
+ * @see {@link https://meocord.dev/docs/4.2/guards | Guards}
  */
 declare function createMetadata<T>(description?: string): MetadataDecorator<T>;
 
@@ -781,7 +781,7 @@ type ExecutionContextType = 'interaction' | 'autocomplete' | 'message' | 'reacti
  * @group Utilities
  * @see {@link createMetadata}
  * @see {@link StageParams}
- * @see {@link https://meocord.dev/docs/4.1/guards | Guards}
+ * @see {@link https://meocord.dev/docs/4.2/guards | Guards}
  */
 declare abstract class ExecutionContext {
     /**
@@ -1348,7 +1348,7 @@ declare class UserError extends Error {
  * @group Responses
  * @category Errors
  * @see {@link Catch}
- * @see {@link https://meocord.dev/docs/4.1/exception-filters | Exception filters}
+ * @see {@link https://meocord.dev/docs/4.2/exception-filters | Exception filters}
  */
 declare class CommandNotFoundError extends Error {
     /** @param message - What the error says, `No handler matched the interaction.` unless given. */
@@ -1439,7 +1439,7 @@ interface MessageUsageIssue {
  * @category Errors
  * @see {@link MessageHandler}
  * @see {@link translateError}
- * @see {@link https://meocord.dev/docs/4.1/message-commands | Message commands}
+ * @see {@link https://meocord.dev/docs/4.2/message-commands | Message commands}
  */
 declare class MessageUsageError extends Error {
     readonly usage: string;
@@ -1956,8 +1956,10 @@ interface CommandMeta<T extends string = string> {
     /** The params a component's customId pattern captures, in the order they appear. */
     dynamicParams?: T[];
     /**
-     * How specific this pattern is; the highest wins when several routes match one customId, so
-     * `gi-profile/summary/{ownerId}/{uid}` beats `gi-profile/{uuid}/{uid}` whatever the declaration order.
+     * How specific this pattern is, as 4.1 ranked patterns: more literal text first.
+     *
+     * @deprecated Since 4.2, and removed in the next major version (5.0). Internal: nothing replaces it. Component routing
+     * ranks patterns segment by segment and doesn't read it.
      */
     specificity?: number;
     /** The builder's own `guilds` option, when it has one. */
@@ -2164,7 +2166,7 @@ interface ReadyInfo {
  *
  * @group Types
  * @see {@link OnShutdown}
- * @see {@link https://meocord.dev/docs/4.1/lifecycle-hooks | Lifecycle hooks}
+ * @see {@link https://meocord.dev/docs/4.2/lifecycle-hooks | Lifecycle hooks}
  */
 interface OnReady {
     /**
@@ -2211,7 +2213,7 @@ interface OnReady {
  *
  * @group Types
  * @see {@link OnReady}
- * @see {@link https://meocord.dev/docs/4.1/lifecycle-hooks | Lifecycle hooks}
+ * @see {@link https://meocord.dev/docs/4.2/lifecycle-hooks | Lifecycle hooks}
  */
 interface OnShutdown {
     /** Runs before the client is destroyed. */
@@ -2546,6 +2548,15 @@ interface ControllerOptions {
      * @defaultValue `true`
      */
     inheritStages?: boolean;
+    /**
+     * What a handler this class re-decorates answers of the routes its base classes declare for it. `'keep'` answers
+     * them as well as its own; `'replace'` answers only the routes this class declares for it, of every kind: commands,
+     * component patterns, message patterns, reactions and autocompletes. A command no handler answers any more is not
+     * registered. A method overridden without decorators keeps every route it inherits either way.
+     *
+     * @defaultValue `'keep'`; the next major version (5.0) replaces them by default
+     */
+    inheritedRoutes?: 'keep' | 'replace';
 }
 /**
  * One prefix or several that start a message command, such as `'!'` or `['!', '?']`; `''` stands for none.
@@ -2583,7 +2594,7 @@ type MessagePrefix = string | readonly string[];
  * @group Configuration
  * @category App options
  * @see {@link MessageHandler}
- * @see {@link https://meocord.dev/docs/4.1/message-commands | Message commands}
+ * @see {@link https://meocord.dev/docs/4.2/message-commands | Message commands}
  */
 interface MessageCommandOptions {
     /**
@@ -2656,6 +2667,28 @@ interface MessageCommandOptions {
      * @defaultValue `false`
      */
     help?: boolean | MessageHelpOptions;
+    /**
+     * How a message's handlers run: the patterned handler it matched, then every `@MessageHandler()` listener.
+     * `'sequential'` runs each once the one before it has settled, so a slow command delays the listeners after it.
+     * `'concurrent'` starts them together and settles once all have: each keeps its own guards, interceptors, filters
+     * and observers, and no order holds between them, so a listener can run before the command has written what it
+     * reads. The built-in help and a command's usage are answered first either way.
+     * @defaultValue `'sequential'`; the next major version (5.0) may run them concurrently by default
+     *
+     * @example
+     * ```ts
+     * @MeoCord({ controllers: [Commands, Moderation], messages: { prefix: '!', handlers: 'concurrent' } })
+     * class App {}
+     * ```
+     */
+    handlers?: 'sequential' | 'concurrent';
+    /**
+     * Warns, once per handler, when a message's handler takes 5 seconds or more with listeners waiting after it, under
+     * `handlers: 'sequential'`, naming the handler and how many it held back. A testing module warns only when this is
+     * `true`, since a test's fake clock can pass 5 seconds inside a handler.
+     * @defaultValue `true` in a running bot, `false` in a `MeoCordTestingModule`
+     */
+    slowHandlerWarning?: boolean;
 }
 /**
  * The words the built-in help command answers to, as `@MeoCord({ messages: { help } })` takes them.
@@ -2775,7 +2808,7 @@ interface MessageHelpParam {
  * ```
  *
  * @group Types
- * @see {@link https://meocord.dev/docs/4.1/localisation | Localisation}
+ * @see {@link https://meocord.dev/docs/4.2/localisation | Localisation}
  */
 type MeoCordMessages = (typeof MEOCORD_MESSAGES)['meocord'];
 /**
@@ -2806,7 +2839,7 @@ type MeoCordMessages = (typeof MEOCORD_MESSAGES)['meocord'];
  *
  * @group Configuration
  * @category App options
- * @see {@link https://meocord.dev/docs/4.1/message-params | Message params}
+ * @see {@link https://meocord.dev/docs/4.2/message-params | Message params}
  */
 interface MessageParamType<T = unknown> {
     /** A noun such as `hex colour`, read in "is not a valid hex colour". Defaults to the type's key. */
@@ -3019,7 +3052,7 @@ type MessageScope = 'guild' | 'dm' | 'any';
  * @group Configuration
  * @category App options
  * @see {@link MessageHandler}
- * @see {@link https://meocord.dev/docs/4.1/message-commands | Message commands}
+ * @see {@link https://meocord.dev/docs/4.2/message-commands | Message commands}
  */
 interface MessageHandlerOptions {
     /**
@@ -3077,7 +3110,7 @@ interface MessageHandlerOptions {
  * @group Configuration
  * @category Config file
  * @see {@link MeoCord}
- * @see {@link https://meocord.dev/docs/4.1/configuration | Configuration}
+ * @see {@link https://meocord.dev/docs/4.2/configuration | Configuration}
  */
 interface MeoCordConfig {
     /** Shown as a prefix on every log line. Omitted when unset. */
@@ -3138,6 +3171,20 @@ interface MeoCordConfig {
      * @defaultValue `true`
      */
     sourceMappedStacks?: boolean;
+    /**
+     * How a startup error a decorator finds, such as an invalid customId pattern, is reported.
+     *
+     * With `'first'`, a decorator throws its error as its class is defined, when its file is imported, so a bot with
+     * three mistakes shows one per run. With `'all'`, decorators keep their errors, and `MeoCordFactory.create()` logs
+     * every one, each with its handler and file, alongside the errors its own checks find, then throws the first. The
+     * built bot reads it before your modules load. In a test, call `reportAllStartupErrors()` from `meocord/testing` in
+     * the setup file instead.
+     *
+     * Whichever you choose, `create()` reports every error its own checks find, such as two handlers of one command.
+     *
+     * @defaultValue `'first'`; `'all'` in the next major version (5.0)
+     */
+    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,
@@ -3196,7 +3243,7 @@ interface MeoCordConfig {
  * @group Configuration
  * @category Config file
  * @see {@link ShardContext}
- * @see {@link https://meocord.dev/docs/4.1/sharding | Sharding}
+ * @see {@link https://meocord.dev/docs/4.2/sharding | Sharding}
  */
 interface ShardingConfig {
     /**
@@ -3239,7 +3286,7 @@ interface ShardingConfig {
  *
  * @group Configuration
  * @category Config file
- * @see {@link https://meocord.dev/docs/4.1/slash-commands | Slash commands}
+ * @see {@link https://meocord.dev/docs/4.2/slash-commands | Slash commands}
  */
 interface CommandRegistrationConfig {
     /**

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-DEP0NYrU.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';

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-D7n0FBMm.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';