meocord 4.1.2 → 4.2.0

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

@@ -1,10 +1,10 @@
 import { ServiceIdentifier, Container } from 'inversify';
-import { Client, Interaction, Message, MessageReaction, PartialMessageReaction, User, PartialUser, ClientEvents, Base, Locale, GuildMember, Role, GuildBasedChannel, Guild, APIMessageTopLevelComponent, JSONEncodable, APIEmbed, MessageFlagsResolvable, TextBasedChannel, BaseChannel, APIAuthorizingIntegrationOwnersMap, CacheType, CommandInteractionOptionResolver, ThreadChannel, AnyThreadChannel, ChatInputCommandInteraction, AutocompleteInteraction, MessageContextMenuCommandInteraction, UserContextMenuCommandInteraction, PrimaryEntryPointCommandInteraction, ContextMenuCommandInteraction, CommandInteraction, ButtonInteraction, StringSelectMenuInteraction, UserSelectMenuInteraction, RoleSelectMenuInteraction, MentionableSelectMenuInteraction, ChannelSelectMenuInteraction, MessageComponentInteraction, ModalSubmitInteraction, BaseInteraction, DMChannel, PartialGroupDMChannel, OmitPartialGroupDMChannel, Attachment, ModalSubmitFields, MessagePayload, InteractionReplyOptions, InteractionUpdateOptions, InteractionEditReplyOptions, MessageEditOptions, APIModalInteractionResponseCallbackData, ModalComponentData, InteractionDeferReplyOptions, InteractionDeferUpdateOptions, MessageResolvable, DiscordAPIError } from 'discord.js';
+import { Client, Interaction, Message, MessageReaction, PartialMessageReaction, User, PartialUser, ClientEvents, Base, Locale, GuildMember, Role, GuildBasedChannel, Guild, APIMessageTopLevelComponent, JSONEncodable, APIEmbed, MessageFlagsResolvable, TextBasedChannel, BaseChannel, APIAuthorizingIntegrationOwnersMap, APIInteractionGuildMember, PermissionResolvable, APIUser, CacheType, CommandInteractionOptionResolver, ThreadChannel, AnyThreadChannel, ChatInputCommandInteraction, AutocompleteInteraction, MessageContextMenuCommandInteraction, UserContextMenuCommandInteraction, PrimaryEntryPointCommandInteraction, ContextMenuCommandInteraction, CommandInteraction, ButtonInteraction, StringSelectMenuInteraction, UserSelectMenuInteraction, RoleSelectMenuInteraction, MentionableSelectMenuInteraction, ChannelSelectMenuInteraction, MessageComponentInteraction, ModalSubmitInteraction, BaseInteraction, DMChannel, PartialGroupDMChannel, OmitPartialGroupDMChannel, Attachment, ModalSubmitFields, MessagePayload, InteractionReplyOptions, InteractionUpdateOptions, InteractionEditReplyOptions, MessageEditOptions, APIModalInteractionResponseCallbackData, ModalComponentData, InteractionDeferReplyOptions, InteractionDeferUpdateOptions, MessageResolvable, DiscordAPIError } from 'discord.js';
 import { ReactionHandlerAction, CommandType } from '../enum/index.js';
-import { a8 as Provider, P as ProviderToken } from '../index-D7n0FBMm.js';
+import { a8 as Provider, P as ProviderToken } from '../index-CdXsFgjE.js';
 import { CooldownStore, ExecutionContextType, ExecutionContext, CooldownScope, MetadataDecorator, ResponsePhase, ResponseCall } from '../common/index.js';
 import { DispatchObserver, GuardInterface, InterceptorInterface, ExceptionFilter, ThemeOverride, ThemeResolvers, ThemeResolver, MessageCommandOptions, MessagePrefix, RootTheme, DeepReadonly, MeoCordTheme } from '../interface/index.js';
-export { ao as ClassProvider, F as FactoryProvider, ap as ValueProvider } from '../index-D7n0FBMm.js';
+export { ao as ClassProvider, F as FactoryProvider, ap as ValueProvider } from '../index-CdXsFgjE.js';
 import { ThemeCache } from '../common/index.js';
 import { Translator } from '../common/index.js';
 import '@rsbuild/core';
@@ -194,7 +194,7 @@ interface EmitResult {
  * @category Module
  * @see {@link MeoCordTestingModule}
  * @see {@link getResponse}
- * @see {@link https://meocord.dev/docs/4.1/invoke-and-dispatch | Invoke and dispatch}
+ * @see {@link https://meocord.dev/docs/4.2/invoke-and-dispatch | Invoke and dispatch}
  */
 declare class TestingModule {
     private readonly container;
@@ -470,7 +470,7 @@ declare class TestingModule {
  * @group Testing
  * @category Module
  * @see {@link MeoCordTestingModule}
- * @see {@link https://meocord.dev/docs/4.1/testing | The testing module}
+ * @see {@link https://meocord.dev/docs/4.2/testing | The testing module}
  */
 declare class TestingModuleBuilder {
     private readonly options;
@@ -578,7 +578,12 @@ declare class TestingModuleBuilder {
      * its command's builder does not register, a customId pattern given as a command name, a builder that registers
      * another name, and component patterns that can match the same customId are named, as the bot names them.
      *
+     * Each check reports every startup error it finds, and the first is thrown, unchanged; when there are several, each
+     * is logged first, with the file it comes from. After {@link reportAllStartupErrors}, the errors decorators kept on
+     * the classes the module runs are among them.
+     *
      * @returns The compiled module.
+     * @throws Error for the first startup error the checks find.
      */
     compile(): TestingModule;
 }
@@ -609,7 +614,7 @@ declare class TestingModuleBuilder {
  * @category Module
  * @see {@link TestingModuleBuilder}
  * @see {@link TestingModule}
- * @see {@link https://meocord.dev/docs/4.1/testing | The testing module}
+ * @see {@link https://meocord.dev/docs/4.2/testing | The testing module}
  */
 declare class MeoCordTestingModule {
     /**
@@ -805,12 +810,76 @@ type Mock<T extends (...args: any[]) => any = (...args: any[]) => any> = MockedF
  * @see {@link createMockFn}
  */
 declare function isMockFunction(fn: unknown): fn is MockInstance;
+/**
+ * A mock function a test runner makes, as {@link useMockFn} takes it.
+ *
+ * It is callable, records its calls in `mock.calls`, and has `mockImplementation`, `mockClear` and `mockReset`.
+ * Vitest's `vi.fn`, jest's `jest.fn` and bun's `mock` make one.
+ *
+ * @group Testing
+ * @category Mocks
+ * @see {@link MockFnFactory}
+ */
+interface RunnerMock {
+    (...args: any[]): any;
+    /** The calls the mock has recorded, each an array of its arguments. */
+    mock: {
+        calls: readonly unknown[][];
+    };
+    /** Sets the implementation the mock runs. */
+    mockImplementation(fn: (...args: any[]) => any): unknown;
+    /** Forgets the calls the mock has recorded. */
+    mockClear(): unknown;
+    /** Forgets the calls and what the mock was told to do. */
+    mockReset(): unknown;
+}
+/**
+ * A test runner's mock function factory, such as `vi.fn`.
+ *
+ * Called with the implementation a mock starts with, it returns the runner's mock. See {@link useMockFn}.
+ *
+ * @group Testing
+ * @category Mocks
+ */
+type MockFnFactory = (impl?: (...args: any[]) => any) => RunnerMock;
+/**
+ * Makes every mock `meocord/testing` creates with the test runner's own mock function, such as Vitest's `vi.fn`.
+ *
+ * Call it once in the runner's setup file. The runner then treats meocord's mocks as its own: its `clearMocks` and
+ * `mockReset` config and `vi.clearAllMocks()` reach them, its matchers read them, and its whole mock API is there.
+ * Without it, mocks are {@link createMockFn}'s own, which jest's and Vitest's `expect` read too.
+ *
+ * @remarks
+ * Each mock starts with the runner's mock holding meocord's behaviour, such as an interaction's replies, as its own
+ * implementation. {@link resetAllMocks} puts that behaviour back where the runner's `mockReset` drops it, as jest's and
+ * bun's do; a runner's own reset-all, such as jest's `resetMocks`, can't, so under jest and bun reset with
+ * {@link resetAllMocks}. node:test's `mock.fn` records calls in a shape of its own, so under node:test leave meocord's
+ * own function in place. Calling it again with the same factory does nothing; another, once a mock exists, throws.
+ *
+ * @param factory - The runner's mock function factory: `vi.fn`, `jest.fn` or bun's `mock`.
+ * @throws Error when a mock already exists from another factory, or when `factory` doesn't make a mock with jest's and
+ *   Vitest's API.
+ *
+ * @example
+ * ```ts
+ * // vitest.setup.ts
+ * import { vi } from 'vitest'
+ *
+ * useMockFn(vi.fn)
+ * ```
+ *
+ * @group Testing
+ * @category Mocks
+ * @see {@link createMockFn}
+ */
+declare function useMockFn(factory: MockFnFactory): void;
 /**
  * Clears the calls every mock from `meocord/testing` has recorded, keeping what each was told to do.
  *
- * Vitest's `clearMocks` and jest's `clearAllMocks()` reach only their own `vi.fn()` and `jest.fn()` mocks. This one
- * covers `createMockFn` and everything built on it, such as `createMockInteraction` and `createMockClient`. To also
- * undo what a test set, use {@link resetAllMocks}.
+ * Vitest's `clearMocks` and jest's `clearAllMocks()` reach only their own `vi.fn()` and `jest.fn()` mocks, and
+ * meocord's too once {@link useMockFn} makes them with the runner's function. This one covers `createMockFn` and
+ * everything built on it, such as `createMockInteraction` and `createMockClient`, either way. To also undo what a test
+ * set, use {@link resetAllMocks}.
  *
  * @example
  * ```ts
@@ -850,7 +919,8 @@ declare function resetAllMocks(): void;
  * Creates a mock function that jest's and Vitest's `expect` both read.
  *
  * Use it for a function double in code that must not depend on one test runner, such as a shared test helper; in a
- * Vitest test, `vi.fn()` works as well. {@link clearAllMocks} and {@link resetAllMocks} reach it.
+ * Vitest test, `vi.fn()` works as well. {@link clearAllMocks} and {@link resetAllMocks} reach it. Once
+ * {@link useMockFn} registers a runner's function, it returns that runner's mock.
  *
  * @remarks
  * `mockReturnValue`, `mockResolvedValue`, `mockRejectedValue` and `mockImplementation` share one implementation, so
@@ -973,9 +1043,35 @@ type OutsideServer = {
  * @category Mocks
  * @see {@link MockProps}
  * @see {@link createChatInputOptions}
- * @see {@link https://meocord.dev/docs/4.1/mocks | Mocks}
+ * @see {@link https://meocord.dev/docs/4.2/mocks | Mocks}
  */
 declare function createMockInteraction<T extends object>(Class: InteractionClass<T>, props?: MockProps<T>): DeepMocked<T>;
+/**
+ * Creates a mock interaction from a server the bot isn't in: one given a {@link createMockRawMember | raw member} and
+ * that server's `guildId`, as a user-installed command run there arrives.
+ *
+ * It is typed as discord.js types an interaction from such a server, `'raw'`: its `guild` is `null` and its `member`
+ * the raw member. Everything else is as {@link createMockInteraction} builds it.
+ *
+ * @param Class - The discord.js interaction class to mock.
+ * @param props - The interaction's properties, with the raw `member` and the server's `guildId`; see {@link MockProps}.
+ *
+ * @example
+ * ```ts
+ * import { expect } from 'vitest'
+ *
+ * const command = createMockInteraction(ChatInputCommandInteraction, { guildId: '100000000000000001', member: createMockRawMember() })
+ * expect(command.inRawGuild()).toBe(true)
+ * ```
+ *
+ * @group Testing
+ * @category Mocks
+ */
+declare function createMockInteraction<T extends object>(Class: InteractionClass<T>, props: Omit<MockProps<WithCache<T, 'raw'>>, 'options'> & {
+    options?: object;
+    guildId: string;
+    member: APIInteractionGuildMember;
+}): DeepMocked<WithCache<T, 'raw'>>;
 /**
  * Creates a mock interaction from outside a server: one given `guild: null`, `member: null` or a DM channel, as from a
  * direct message or a server the bot isn't in.
@@ -1171,6 +1267,48 @@ type ChannelOf<T> = T extends ThreadChannel ? AnyThreadChannel : T;
  * @see {@link createMockGuild}
  */
 declare function createMockChannel<T extends BaseChannel>(Class: InteractionClass<T>, props?: MockProps<T>): DeepMocked<ChannelOf<T>>;
+/**
+ * What {@link createMockRawMember} builds a member with: any field Discord sends, with `permissions` as a permission
+ * set and `user` as the fields of the user given.
+ *
+ * @group Testing
+ * @category Mocks
+ */
+type MockRawMemberOverrides = Partial<Omit<APIInteractionGuildMember, 'permissions' | 'user'>> & {
+    /** The member's permissions in the channel; unless given, what @everyone has in a server Discord makes today. */
+    permissions?: PermissionResolvable;
+    /** The member's user; a new person, `username` `'user'`, unless given. */
+    user?: Partial<APIUser>;
+};
+/**
+ * Creates the member Discord sends with an interaction from a server the bot isn't in, as discord.js keeps it.
+ *
+ * Give it as an interaction's `member`, with the server's `guildId` and no `guild`, to test a user-installed command
+ * run there: the interaction reads `inRawGuild()` true, `guild` and `channel` null, `user` the member's user and
+ * `memberPermissions` the member's, and a user option's member is the plain member Discord resolves too.
+ *
+ * @remarks
+ * It is plain data, not a `GuildMember`: `roles` are role ids, `permissions` is the permission bitfield as a string,
+ * and the rest are as Discord sends them, `null` for what may be absent and `false` for a flag. Code that reads
+ * `member.roles.cache` throws on it, as it does in Discord.
+ *
+ * @param overrides - Fields for the member; see {@link MockRawMemberOverrides}.
+ * @returns The member, as an `APIInteractionGuildMember`.
+ *
+ * @example
+ * ```ts
+ * import { expect } from 'vitest'
+ *
+ * const member = createMockRawMember({ roles: ['300000000000000001'], permissions: [PermissionFlagsBits.SendMessages] })
+ * const command = createMockInteraction(ChatInputCommandInteraction, { guildId: '100000000000000001', member })
+ * expect(command.inRawGuild()).toBe(true)
+ * ```
+ *
+ * @group Testing
+ * @category Mocks
+ * @see {@link createMockMember}
+ */
+declare function createMockRawMember(overrides?: MockRawMemberOverrides): APIInteractionGuildMember;
 /**
  * What {@link createMockMember} builds a member with.
  *
@@ -1365,6 +1503,60 @@ interface ChatInputOptions {
  */
 declare function createChatInputOptions<Cached extends CacheType = any>(opts?: ChatInputOptions): DeepMocked<CommandInteractionOptionResolver<Cached>>;
 
+/**
+ * Has every mock from `meocord/testing` compute the values discord.js computes, where it reads a placeholder otherwise.
+ *
+ * Call it once in the test runner's setup file. A message's `editable`, `deletable`, `pinnable`, `crosspostable`,
+ * `bulkDeletable`, `hasThread` and `partial`, a member's `manageable`, `kickable`, `bannable` and `moderatable`, a
+ * role's `editable`, a channel's and a thread's `viewable`, `manageable`, `deletable`, `joinable` and the rest, and
+ * `partial` on users, channels and reactions then run discord.js's own getters against the mock, and `message.thread`
+ * is `null` when the channel caches no thread under the message's id. No placeholder warning is logged.
+ *
+ * @remarks
+ * Those getters read what a server holds, so strict mocks also have it as Discord sends it: the bot's member is in
+ * the server's member cache from the start, @everyone has the permissions Discord gives it in a new server, and a
+ * channel or thread made without a server has one of its own, a thread with a text channel as its parent. A message
+ * has empty `content`, a thread is neither archived nor locked, and a reaction's `count` is 1. Give the bot's member
+ * a role to let it do more, such as kick a member its role ranks above. A value the test sets on a mock wins over the
+ * computed one. The next major version (5.0) computes these values without the call.
+ *
+ * @throws Error when a mock already exists, which was made without it.
+ *
+ * @example
+ * ```ts
+ * // vitest.setup.ts
+ * useStrictMocks()
+ * ```
+ *
+ * @group Testing
+ * @category Mocks
+ * @see {@link useMockFn}
+ * @see {@link https://meocord.dev/docs/4.2/mocks | Mocks}
+ */
+declare function useStrictMocks(): void;
+
+/**
+ * Has decorators keep the startup errors they find, as a bot built with `startupErrors: 'all'` does, so a testing
+ * module reports every one at once.
+ *
+ * Call it once in the test runner's setup file, before any test imports a controller: a decorator runs when its class
+ * is defined, as its file is imported. A decorator given what it cannot use then throws nothing as the file loads, and
+ * `MeoCordTestingModule.create(...).compile()` logs every startup error of the classes it runs, each with its handler
+ * and file, then throws the first. Without it, a decorator throws its error as its class is defined.
+ *
+ * @example
+ * ```ts
+ * // vitest.setup.ts
+ * reportAllStartupErrors()
+ * ```
+ *
+ * @group Testing
+ * @category Module
+ * @see {@link MeoCordTestingModule}
+ * @see {@link https://meocord.dev/docs/4.2/configuration | Configuration}
+ */
+declare function reportAllStartupErrors(): void;
+
 /**
  * The command types routed by a `customId` pattern: buttons, select menus and modals.
  *
@@ -1423,9 +1615,16 @@ interface ResolvedRoute {
      * handler receives `params`.
      */
     values?: Record<string, string | number | boolean>;
+    /**
+     * For a component route, the other patterns of its type that match the `customId` too, in the order they rank
+     * behind it: the ones that lost to it. Absent when no other pattern matches. A test reads it; `toEqual` doesn't
+     * compare it, so an assertion on the other fields holds either way.
+     */
+    alsoMatches?: string[];
 }
 /**
- * Two patterns of one component type that can both match a `customId`, as {@link findRouteConflicts} reports them.
+ * Two patterns of one component type that rank equally and can both match a `customId`, as {@link findRouteConflicts}
+ * reports them.
  *
  * @group Testing
  * @category Inspection
@@ -1435,6 +1634,11 @@ interface RouteConflict {
     type: ComponentCommandType;
     /** The two patterns. */
     patterns: [string, string];
+    /**
+     * The pattern that runs for the `customId`s both match: the one listed first. A test reads it; `toEqual` doesn't
+     * compare it, so an assertion on `type` and `patterns` alone holds.
+     */
+    runs: string;
 }
 /**
  * Resolves which handler a component's `customId` or a message's content reaches, as dispatch routes it.
@@ -1471,33 +1675,36 @@ interface RouteConflict {
  * @group Testing
  * @category Inspection
  * @see {@link findRouteConflicts}
- * @see {@link https://meocord.dev/docs/4.1/components | Buttons, selects and modals}
+ * @see {@link https://meocord.dev/docs/4.2/components | Buttons, selects and modals}
  */
 declare function resolveRoute(app: ControllerClass, input: {
     type: ComponentCommandType;
     customId: string;
 } | MessageToResolve): ResolvedRoute | undefined;
 /**
- * Finds component patterns that can match the same `customId`, which MeoCord otherwise only warns about at startup.
+ * Finds component patterns that rank equally and can match the same `customId`, which MeoCord otherwise only warns
+ * about at startup.
  *
- * Use it in a test to keep the warning from reaching production: two patterns that trade a literal for a parameter
- * in opposite places both take one id, and neither is more specific. Patterns are compared within a component type.
+ * Use it in a test to keep the warning from reaching production. Patterns rank segment by segment, a literal before a
+ * param and then the narrower type, so two collide only with the same literals and equally narrow params at each
+ * position, such as `{action:close|reopen}` and `{step:close|confirm}`, which both take `close`; the one listed
+ * first runs. Patterns are compared within a component type.
  *
  * @param app - The application class decorated with `@MeoCord`.
- * @returns Each pair of patterns that can match the same `customId`, with its component type.
+ * @returns Each pair of patterns that rank equally and can match the same `customId`, with its component type.
  *
  * @example
  * ```ts
  * import { expect } from 'vitest'
  *
  * @Controller()
- * class CardController {
- *   @Command('card/{id}/open', CommandType.BUTTON)
- *   async open(interaction: ButtonInteraction) { await respond(interaction).send('Opened.') }
- *   @Command('card/new/{kind}', CommandType.BUTTON)
- *   async create(interaction: ButtonInteraction) { await respond(interaction).send('Created.') }
+ * class TicketController {
+ *   @Command('ticket/{action:close|reopen}', CommandType.BUTTON)
+ *   async act(interaction: ButtonInteraction) { await respond(interaction).send('Done.') }
+ *   @Command('ticket/{step:close|confirm}', CommandType.BUTTON)
+ *   async step(interaction: ButtonInteraction) { await respond(interaction).send('Next.') }
  * }
- * @MeoCord({ controllers: [CardController], clientOptions: { intents: [] } })
+ * @MeoCord({ controllers: [TicketController], clientOptions: { intents: [] } })
  * class App {}
  * expect(findRouteConflicts(App)).toHaveLength(1)
  * ```
@@ -1584,7 +1791,7 @@ declare function createModalFields(values: Record<string, string | string[] | At
  * @group Testing
  * @category Inspection
  * @see {@link createTranslator}
- * @see {@link https://meocord.dev/docs/4.1/localisation | Localisation}
+ * @see {@link https://meocord.dev/docs/4.2/localisation | Localisation}
  */
 declare function expectCompleteCatalog(translator: Translator<any>, options?: {
     meocord?: boolean;
@@ -1622,7 +1829,8 @@ interface CooldownStoreSuiteFramework {
  * The cases cover what a shared store most often gets wrong: a sliding window rather than fixed buckets,
  * `retryAfterMs` from the oldest call still in the window, calls in the same millisecond kept apart, and concurrent
  * calls at the limit where exactly one may pass. They use real time, with windows short enough that the suite takes
- * a few seconds, and each case counts under keys of its own. Each window is a whole number of milliseconds, as
+ * a few seconds and margins wide enough that a correct store passes when timers fire late, as on a busy CI runner,
+ * and each case counts under keys of its own. Each window is a whole number of milliseconds, as
  * `@Cooldown` gives a store: it rounds its `seconds` to the millisecond.
  *
  * @param name - What the store is called in the report.
@@ -1639,7 +1847,7 @@ interface CooldownStoreSuiteFramework {
  * @group Testing
  * @category Inspection
  * @see {@link CooldownStore}
- * @see {@link https://meocord.dev/docs/4.1/recipes/cooldown-stores | Cooldown stores}
+ * @see {@link https://meocord.dev/docs/4.2/recipes/cooldown-stores | Cooldown stores}
  */
 declare function testCooldownStore(name: string, factory: () => CooldownStore | Promise<CooldownStore>, { describe, it, expect }: CooldownStoreSuiteFramework): void;
 
@@ -1751,6 +1959,12 @@ interface HandlerInspection {
     readonly cooldowns: readonly InspectedCooldown[];
     /** The `@MessageHandler` pattern, or `undefined` for a listener and for any other kind of handler. */
     readonly pattern: string | undefined;
+    /**
+     * The routes the handler answers because a class its controller extends declares them, such as `slash "ping"`:
+     * those its own class doesn't declare for it. Empty for a handler that declares all it answers. A test reads it;
+     * `toEqual` doesn't compare it, so an assertion on the other fields holds either way.
+     */
+    readonly inheritedRoutes: readonly string[];
     /** The `app`'s observers, in the order they are told about the call; empty without an `app`. */
     readonly observers: readonly (new (...args: any[]) => DispatchObserver)[];
     /**
@@ -1847,7 +2061,7 @@ interface InspectHandlerOptions {
  * @group Testing
  * @category Inspection
  * @see {@link createExecutionContext}
- * @see {@link https://meocord.dev/docs/4.1/testing-recipes | Testing recipes}
+ * @see {@link https://meocord.dev/docs/4.2/testing-recipes | Testing recipes}
  */
 declare function inspectHandler<C extends new (...args: any[]) => unknown>(controller: C, methodName: keyof InstanceType<C> & string, options?: InspectHandlerOptions): HandlerInspection;
 
@@ -1925,7 +2139,7 @@ interface ResponseReport {
  * @group Testing
  * @category Inspection
  * @see {@link TestingModule}
- * @see {@link https://meocord.dev/docs/4.1/invoke-and-dispatch | Invoke and dispatch}
+ * @see {@link https://meocord.dev/docs/4.2/invoke-and-dispatch | Invoke and dispatch}
  */
 declare function getResponse(interaction: Interaction): ResponseReport;
 /**
@@ -1982,7 +2196,7 @@ type MockThemeArgs = Partial<RootTheme> extends RootTheme ? [overrides?: RootThe
  * @group Testing
  * @category Mocks
  * @see {@link withTheme}
- * @see {@link https://meocord.dev/docs/4.1/theming | Theming}
+ * @see {@link https://meocord.dev/docs/4.2/theming | Theming}
  */
 declare function createMockTheme(...[overrides]: MockThemeArgs): DeepReadonly<MeoCordTheme>;
 /**
@@ -2011,5 +2225,5 @@ declare function createMockTheme(...[overrides]: MockThemeArgs): DeepReadonly<Me
  */
 declare function withTheme<T>(theme: DeepReadonly<MeoCordTheme> | RootTheme, fn: () => T): T;
 
-export { MeoCordTestingModule, Provider, ProviderToken, TestingModule, TestingModuleBuilder, clearAllMocks, createChatInputOptions, createDiscordError, createExecutionContext, createMock, createMockChannel, createMockClient, createMockFn, createMockGuild, createMockInteraction, createMockMember, createMockMessage, createMockTheme, createMockUser, createModalFields, expectCompleteCatalog, findRouteConflicts, getResponse, inspectHandler, isMockFunction, resetAllMocks, resolveRoute, testCooldownStore, withTheme };
-export type { ChatInputOptions, ComponentCommandType, CooldownStoreSuiteFramework, DeepMocked, DispatchedCall, DispatchedHandler, EmitResult, ExecutionContextOptions, FromAppOptions, HandlerInspection, HandlerName, InspectHandlerOptions, InspectedCooldown, InspectedFilter, InspectedGuard, InspectedInterceptor, InvocationResult, MessageToResolve, Mock, MockGuildOverrides, MockInstance, MockMemberOverrides, MockMessageOverrides, MockProps, MockResult, MockState, MockedFunction, ResolvedRoute, ResponseReport, RouteConflict, TestingModuleInitOptions, TestingModuleOptions };
+export { MeoCordTestingModule, Provider, ProviderToken, TestingModule, TestingModuleBuilder, clearAllMocks, createChatInputOptions, createDiscordError, createExecutionContext, createMock, createMockChannel, createMockClient, createMockFn, createMockGuild, createMockInteraction, createMockMember, createMockMessage, createMockRawMember, createMockTheme, createMockUser, createModalFields, expectCompleteCatalog, findRouteConflicts, getResponse, inspectHandler, isMockFunction, reportAllStartupErrors, resetAllMocks, resolveRoute, testCooldownStore, useMockFn, useStrictMocks, withTheme };
+export type { ChatInputOptions, ComponentCommandType, CooldownStoreSuiteFramework, DeepMocked, DispatchedCall, DispatchedHandler, EmitResult, ExecutionContextOptions, FromAppOptions, HandlerInspection, HandlerName, InspectHandlerOptions, InspectedCooldown, InspectedFilter, InspectedGuard, InspectedInterceptor, InvocationResult, MessageToResolve, Mock, MockFnFactory, MockGuildOverrides, MockInstance, MockMemberOverrides, MockMessageOverrides, MockProps, MockRawMemberOverrides, MockResult, MockState, MockedFunction, ResolvedRoute, ResponseReport, RouteConflict, RunnerMock, TestingModuleInitOptions, TestingModuleOptions };

package/dist/types/{theme-resolvers-DedxyscT.d.ts → theme-resolvers-BcOJVzR9.d.ts}

@@ -1,4 +1,4 @@
-import './index-D7n0FBMm.js';
+import './index-CdXsFgjE.js';
 
 /**
  * An app's cache of the themes `@MeoCord({ themeFor })` looked up, by server and by user.

package/dist/types/{theme-resolvers-COHdX5g6.d.cts → theme-resolvers-UKr3-6Ys.d.cts}

@@ -1,4 +1,4 @@
-import './index-DEP0NYrU.cjs';
+import './index-nn5p7OoX.cjs';
 
 /**
  * An app's cache of the themes `@MeoCord({ themeFor })` looked up, by server and by user.

package/dist/types/{translator-J6tIUfdp.d.ts → translator-BViWKtLJ.d.ts}

@@ -1,5 +1,5 @@
 import { Locale, Interaction, Guild } from 'discord.js';
-import { aq as MeoCordMessages } from './index-D7n0FBMm.js';
+import { aq as MeoCordMessages } from './index-CdXsFgjE.js';
 
 /**
  * The plural categories `Intl.PluralRules` selects between.

package/dist/types/{translator-B4mc1lzJ.d.cts → translator-DHMkkCpg.d.cts}

@@ -1,5 +1,5 @@
 import { Locale, Interaction, Guild } from 'discord.js';
-import { aq as MeoCordMessages } from './index-DEP0NYrU.cjs';
+import { aq as MeoCordMessages } from './index-nn5p7OoX.cjs';
 
 /**
  * The plural categories `Intl.PluralRules` selects between.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "meocord",
   "description": "Decorator-based framework for Discord bots on discord.js, with dependency injection, guards, a CLI and a testing toolkit.",
-  "version": "4.1.2",
+  "version": "4.2.0",
   "type": "module",
   "engines": {
     "node": ">=22.13"
@@ -24,11 +24,12 @@
     "bench:messages": "bun scripts/bench-messages.ts",
     "bench:theme": "bun scripts/bench-theme.ts",
     "changeset": "changeset",
-    "release:version": "changeset version && bun scripts/release-notes.ts && prettier --write CHANGELOG.md",
+    "release:version": "changeset version && bun scripts/check-jsdoc-examples.ts --fix && bun scripts/release-notes.ts && prettier --write CHANGELOG.md",
     "notices": "bun scripts/third-party-notices.ts",
     "notices:check": "bun scripts/third-party-notices.ts --check",
     "check:jsdoc-examples": "bun scripts/check-jsdoc-examples.ts",
     "check:dist-types": "bun scripts/check-dist-types.ts",
+    "check:api-compat": "bun scripts/check-api-compat.ts",
     "check:dist-cjs": "bun scripts/check-dist-cjs.ts",
     "brand": "bun tools/brand/brand.ts"
   },