meocord 4.1.2 → 4.2.0

package/dist/esm/testing/theme.js

@@ -35,7 +35,7 @@ function mockTheme(overrides, where) {
  * @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}
  */ function createMockTheme(...[overrides]) {
     return mockTheme(overrides, 'createMockTheme');
 }

package/dist/esm/util/bundle-entry.util.js

@@ -2,6 +2,7 @@ import { existsSync, realpathSync } from 'node:fs';
 
 /** Where the built bundle's pre-entry records the bundle's own path. */ const BUNDLE_ENTRY_KEY = Symbol.for('meocord.bundleEntry');
 /** Where the built bundle's pre-entry records the mode the bundle was built in. */ const BUILD_MODE_KEY = Symbol.for('meocord.buildMode');
+/** Where the built bot's pre-entry records `startupErrors` from its config, before the application's modules load. */ const STARTUP_ERRORS_KEY = Symbol.for('meocord.startupErrorsMode');
 /**
  * The file a shard process runs: the built bundle, as its pre-entry recorded it, else the script this
  * process was started with; undefined when there is none, as for code run with `node -e` outside a built bundle.
@@ -19,4 +20,4 @@ import { existsSync, realpathSync } from 'node:fs';
     return typeof recorded === 'string' ? recorded : undefined;
 }
 
-export { BUILD_MODE_KEY, BUNDLE_ENTRY_KEY, buildMode, bundleEntry, isBuiltApplication };
+export { BUILD_MODE_KEY, BUNDLE_ENTRY_KEY, STARTUP_ERRORS_KEY, buildMode, bundleEntry, isBuiltApplication };

package/dist/esm/util/interaction.util.js

@@ -1,4 +1,4 @@
-import { ApplicationCommandOptionType, ModalSubmitInteraction, ChannelSelectMenuInteraction, MentionableSelectMenuInteraction, RoleSelectMenuInteraction, UserSelectMenuInteraction, StringSelectMenuInteraction, ButtonInteraction, PrimaryEntryPointCommandInteraction, ContextMenuCommandInteraction, ChatInputCommandInteraction, MessageComponentInteraction } from 'discord.js';
+import { ApplicationCommandOptionType, MessageComponentInteraction, ModalSubmitInteraction, ChannelSelectMenuInteraction, MentionableSelectMenuInteraction, RoleSelectMenuInteraction, UserSelectMenuInteraction, StringSelectMenuInteraction, ButtonInteraction, PrimaryEntryPointCommandInteraction, ContextMenuCommandInteraction, ChatInputCommandInteraction } from 'discord.js';
 import { CommandType } from '../enum/controller.enum.js';
 import { quoteForLog } from './user-text.util.js';
 import { withArticle } from './value.util.js';

package/dist/esm/util/meocord-config-validation.util.js

@@ -46,6 +46,7 @@ const oneOf = (...allowed)=>(value, key)=>allowed.includes(value) ? undefined :
         optionalExternals: optional(stringList('package names')),
         rsbuild: optional(func),
         sourceMappedStacks: optional(boolean),
+        startupErrors: optional(oneOf('first', 'all')),
         shutdownTimeout: optional((value, key)=>{
             const problem = shutdownTimeoutProblem(value);
             return problem && `${key} ${problem}`;

package/dist/esm/util/metadata-keys.js

@@ -24,6 +24,7 @@ import { MetadataKey } from '../enum/metadata-key.enum.js';
     /** How many guard wrappers `@UseGuard` and `@Controller` put around one method. */ guardWrappers: 'meocord:guard-wrappers',
     /** The prototype whose method a class-level `@UseGuard` re-declared on a subclass. */ inheritedFrom: 'meocord:inherited-from',
     /** `false` when `@Controller({ inheritStages: false })` stops class stages at this class. */ inheritStages: 'meocord:inherit-stages',
+    /** `true` when `@Controller({ inheritedRoutes: 'replace' })` drops the routes this class's re-decorated methods inherit. */ replacesInheritedRoutes: 'meocord:replaces-inherited-routes',
     /** A controller's class-level `@Cooldown`s. */ classCooldowns: 'meocord:class-cooldowns',
     /** A method's `@Cooldown`s, in declaration order. */ methodCooldowns: 'meocord:method-cooldowns',
     /** The error types a filter's `@Catch` names; empty to catch everything. */ catchTypes: 'meocord:catch-types',

package/dist/esm/util/refusal.util.js

@@ -2,7 +2,7 @@ import path from 'path';
 import { warnDeprecatedBehaviour } from '../common/deprecation.js';
 import { isExplainedError } from '../common/explained-error.js';
 import { Logger } from '../common/logger.js';
-import { isBuiltApplication } from './bundle-entry.util.js';
+import { isBuiltApplication, STARTUP_ERRORS_KEY } from './bundle-entry.util.js';
 import { comparablePath, framePath } from './source-path.util.js';
 
 const REFUSAL = Symbol.for('meocord.refusal');
@@ -51,10 +51,10 @@ const REFUSAL = Symbol.for('meocord.refusal');
 // A stack frame's function and file: `at fn (file:line:col)` or `at file:line:col`, the file possibly a file:// URL
 const FRAME = /^\s*at (?:(.*?) \()?(.+?):\d+:\d+\)?$/;
 /**
- * A refusal as the application reports it: the message, and the first file of the application's own source the stack
- * passes through, other than its entry, which only loads the rest. The file alone: a line from a development build's
- * source map can be off, and a compiler's decorate helper can be placed in any file, so those frames are skipped.
- */ function describeRefusal(error, root, windows = process.platform === 'win32') {
+ * The first file of the application's own source an error's stack passes through, other than its entry, which only
+ * loads the rest, relative to `root`. The file alone: a line from a development build's source map can be off, and a
+ * compiler's decorate helper can be placed in any file, so those frames are skipped.
+ */ function sourceFileOf(error, root, windows = process.platform === 'win32') {
     const paths = windows ? path.win32 : path.posix;
     const source = comparablePath(paths.join(root, 'src') + paths.sep, windows);
     const entry = comparablePath(paths.join(root, 'src', 'main.ts'), windows);
@@ -65,9 +65,149 @@ const FRAME = /^\s*at (?:(.*?) \()?(.+?):\d+:\d+\)?$/;
         const file = paths.normalize(framePath(name, windows));
         const compared = comparablePath(file, windows);
         if (!compared.startsWith(source) || compared === entry || compared.includes(dependencies)) continue;
-        return `${error.message}\n    in ${paths.relative(root, file).split(paths.sep).join('/')}`;
+        return paths.relative(root, file).split(paths.sep).join('/');
+    }
+    return undefined;
+}
+/**
+ * A refusal as the application reports it: the message, led by the declaration it is about where the message does not
+ * name it, and the file of the application's source it comes from; see {@link sourceFileOf}.
+ */ function describeRefusal(error, root, windows = process.platform === 'win32') {
+    const declaration = declarationOf(error);
+    const message = declaration && !error.message.startsWith(declaration) ? `${declaration}: ${error.message}` : error.message;
+    const file = sourceFileOf(error, root, windows);
+    return file ? `${message}\n    in ${file}` : message;
+}
+// ---------------------------------------------------------------------------
+// Startup errors: those create() and a testing module's compile() find, and those decorators find at import
+// ---------------------------------------------------------------------------
+const STARTUP_ERRORS = Symbol.for('meocord.startupErrors');
+const DECLARED = Symbol.for('meocord.declaredStartupErrors');
+const ALL_DECLARED = Symbol.for('meocord.allDeclaredStartupErrors');
+// The startup errors kept while checks run under collectStartupErrors; undefined outside them
+let kept;
+/**
+ * Reports an error a startup check finds. Outside {@link collectStartupErrors} it is thrown, as a refusal; inside, it
+ * is kept, and the check goes on to find the rest.
+ */ function startupError(error) {
+    refuse(error);
+    if (!kept) throw error;
+    // Two checks of one mistake, such as a class needing a translator, name it once
+    if (!kept.some((other)=>other.message === error.message)) kept.push(error);
+}
+/**
+ * Runs startup checks, and once they are done throws the first error they found, unchanged, with every one found on it
+ * for {@link startupErrorsOf}. An error that ends the checks after one was found is left out, as one the found error
+ * caused; one that ends them before any was found is thrown as it is.
+ */ function collectStartupErrors(checks) {
+    const outer = kept;
+    const found = [];
+    kept = found;
+    let result;
+    try {
+        result = checks();
+    } catch (error) {
+        if (found.length === 0) throw error;
+        if (isRefusal(error) && !found.includes(error)) found.push(error);
+        throw firstOf(found);
+    } finally{
+        kept = outer;
+    }
+    if (found.length > 0) throw firstOf(found);
+    return result;
+}
+/**
+ * Ends the checks under way with the errors found so far, before a step that is no check, such as binding or a warning:
+ * a run with one error stops where it stopped when the first error was thrown, and the errors of one pass of the
+ * checks are still reported together.
+ */ function stopOnStartupErrors() {
+    if (kept && kept.length > 0) throw kept[0];
+}
+function firstOf(errors) {
+    const [first] = errors;
+    Object.defineProperty(first, STARTUP_ERRORS, {
+        value: errors,
+        configurable: true
+    });
+    return first;
+}
+/** Every startup error found together with `error`, the first of them; `error` alone when it was the only one. */ function startupErrorsOf(error) {
+    return error[STARTUP_ERRORS] ?? [
+        error
+    ];
+}
+/**
+ * Logs each startup error found with `error` as the application reports a refusal, and how many there were, when there
+ * was more than one; a lone error is left to whoever reports it now.
+ */ function logStartupErrors(error, log, ending) {
+    const errors = startupErrorsOf(error);
+    if (errors.length < 2) return false;
+    for (const each of errors)log(describeRefusal(each, process.cwd()));
+    log(`MeoCord found ${errors.length} startup errors; ${ending}.`);
+    return true;
+}
+/** Sets how decorators report startup errors from here on, before the application's modules load. */ function setStartupErrorsMode(mode) {
+    globalThis[STARTUP_ERRORS_KEY] = mode;
+}
+/** Whether decorators keep their startup errors for create(), as `startupErrors: 'all'` has them. */ const keepsDeclaredErrors = ()=>globalThis[STARTUP_ERRORS_KEY] === 'all';
+/** The declaration a decorator's startup error is about, `Class.method` or `Class`. */ function declarationOf(error) {
+    return error.declaration;
+}
+/**
+ * A decorator that names, on each startup error it throws, the declaration it was applied to, `Class.method` or
+ * `Class`, as `declaration`, and the source file it is declared in, as `file`: the same error, thrown at the same
+ * moment, with its message unchanged. With `startupErrors: 'all'` the error is kept on the class instead, for create()
+ * to report with the rest, and the decorator applies nothing more.
+ */ function declaring(decorate) {
+    return function(target, propertyKey, ...rest) {
+        try {
+            return decorate.call(this, target, propertyKey, ...rest);
+        } catch (error) {
+            if (!isRefusal(error)) throw error;
+            keepOrThrow(error, target, propertyKey);
+            return undefined;
+        }
+    };
+}
+function keepOrThrow(error, target, propertyKey) {
+    var _globalThis, _ALL_DECLARED;
+    // A decorator applied through another, such as applyDecorators, names the declaration once, where it was first thrown
+    if (declarationOf(error) === undefined) {
+        Object.defineProperty(error, 'declaration', {
+            value: decoratedName(target, propertyKey),
+            configurable: true
+        });
+        Object.defineProperty(error, 'file', {
+            get: ()=>sourceFileOf(error, process.cwd()),
+            configurable: true
+        });
     }
-    return error.message;
+    if (!keepsDeclaredErrors()) throw error;
+    const owner = typeof target === 'function' ? target : target.constructor;
+    if (!Object.prototype.hasOwnProperty.call(owner, DECLARED)) Object.defineProperty(owner, DECLARED, {
+        value: []
+    });
+    const declared = owner[DECLARED];
+    if (!declared.includes(error)) declared.push(error);
+    const all = (_globalThis = globalThis)[_ALL_DECLARED = ALL_DECLARED] ?? (_globalThis[_ALL_DECLARED] = []);
+    if (!all.includes(error)) all.push(error);
+}
+/** The startup errors decorators kept on `classes` and the classes they extend, each once, in the order they were found. */ function declaredErrorsOf(classes) {
+    const found = new Set();
+    for (const cls of classes){
+        for(let current = cls; typeof current === 'function' && current !== Function.prototype; current = Object.getPrototypeOf(current)){
+            if (Object.prototype.hasOwnProperty.call(current, DECLARED)) for (const error of current[DECLARED])found.add(error);
+        }
+    }
+    const order = allDeclaredErrors();
+    return [
+        ...found
+    ].sort((a, b)=>order.indexOf(a) - order.indexOf(b));
+}
+/** Every startup error decorators kept in this process, in the order they were found. */ function allDeclaredErrors() {
+    return [
+        ...globalThis[ALL_DECLARED] ?? []
+    ];
 }
 /**
  * Reports a refusal nothing catches as one line, with its source file, and exits 1; other errors keep the runtime's
@@ -95,4 +235,4 @@ const FRAME = /^\s*at (?:(.*?) \()?(.+?):\d+:\d+\)?$/;
     process.on('unhandledRejection', onRejection);
 }
 
-export { decoratedName, deprecatedOnMethod, describeRefusal, handOffRefusal, isRefusal, refuse, refuseOnClass, refuseOnMethod, reportRefusals };
+export { allDeclaredErrors, collectStartupErrors, declarationOf, declaredErrorsOf, declaring, decoratedName, deprecatedOnMethod, describeRefusal, handOffRefusal, isRefusal, keepsDeclaredErrors, logStartupErrors, refuse, refuseOnClass, refuseOnMethod, reportRefusals, setStartupErrorsMode, sourceFileOf, startupError, startupErrorsOf, stopOnStartupErrors };

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-DEP0NYrU.cjs';
+import { C as CooldownStore, a as CooldownLimit, b as CooldownVerdict, c as CooldownEntry, d as CooldownBatchVerdict } from '../index-nn5p7OoX.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-DEP0NYrU.cjs';
-export { R as Route, a as RouteParams, b as RouteValue, c as RouteValues, r as route } from '../route-C-aMI7Sl.cjs';
-import { T as Translator } from '../translator-B4mc1lzJ.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-B4mc1lzJ.cjs';
-export { T as ThemeCache } from '../theme-resolvers-COHdX5g6.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';
 import '@rsbuild/core';
 import '../controller.enum-DTDn69N9.cjs';
 
@@ -169,7 +169,7 @@ declare class Theme {
  *
  * @group Utilities
  * @see {@link createMetadata}
- * @see {@link https://meocord.dev/docs/4.1/custom-decorators | Custom decorators}
+ * @see {@link https://meocord.dev/docs/4.2/custom-decorators | Custom decorators}
  */
 declare function applyDecorators(...decorators: (ClassDecorator | MethodDecorator)[]): ClassDecorator & MethodDecorator;
 /**
@@ -523,7 +523,7 @@ declare class ShardedCooldownStore extends CooldownStore {
  * @group Utilities
  * @category Localisation
  * @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 translateError(error: unknown, t: Translator<any>, target: Interaction | Message | Locale | `${Locale}`): string;
 

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-D7n0FBMm.js';
+import { C as CooldownStore, a as CooldownLimit, b as CooldownVerdict, c as CooldownEntry, d as CooldownBatchVerdict } from '../index-CdXsFgjE.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-D7n0FBMm.js';
-export { R as Route, a as RouteParams, b as RouteValue, c as RouteValues, r as route } from '../route-C-aMI7Sl.js';
-import { T as Translator } from '../translator-J6tIUfdp.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-J6tIUfdp.js';
-export { T as ThemeCache } from '../theme-resolvers-DedxyscT.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';
 import '@rsbuild/core';
 import '../controller.enum-DTDn69N9.js';
 
@@ -169,7 +169,7 @@ declare class Theme {
  *
  * @group Utilities
  * @see {@link createMetadata}
- * @see {@link https://meocord.dev/docs/4.1/custom-decorators | Custom decorators}
+ * @see {@link https://meocord.dev/docs/4.2/custom-decorators | Custom decorators}
  */
 declare function applyDecorators(...decorators: (ClassDecorator | MethodDecorator)[]): ClassDecorator & MethodDecorator;
 /**
@@ -523,7 +523,7 @@ declare class ShardedCooldownStore extends CooldownStore {
  * @group Utilities
  * @category Localisation
  * @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 translateError(error: unknown, t: Translator<any>, target: Interaction | Message | Locale | `${Locale}`): string;
 

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

@@ -1,5 +1,5 @@
 import { ServiceIdentifier } from 'inversify';
-import { J as MeoCordApplication } from '../index-DEP0NYrU.cjs';
+import { J as MeoCordApplication } from '../index-nn5p7OoX.cjs';
 import { MetadataDecorator } from '../common/index.cjs';
 import { MessageScope, MessageCommandOptions, MessageHelp } from '../interface/index.cjs';
 import { RESTPostAPIApplicationCommandsJSONBody, ClientEvents, Message, Client } from 'discord.js';
@@ -46,9 +46,11 @@ declare class MeoCordFactory {
      *   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
      *   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. In a built application it is logged first, with where in the source it
-     *   comes from, so `isExplainedError()` tells a caller not to log it again; in a shard of process sharding, the
-     *   manager logs it.
+     *   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
+     *   logged in a built application. Either way `isExplainedError()` then tells a caller not to log it again; in a
+     *   shard of process sharding, the manager logs it. With `startupErrors: 'all'` in `meocord.config.ts`, the errors
+     *   decorators kept are among them.
      */
     static create(target: ServiceIdentifier): MeoCordApplication;
     private static createApplication;
@@ -260,7 +262,7 @@ interface HandlerFilter<K extends HandlerKind = HandlerKind> {
  *
  * @group Controllers
  * @see {@link HandlerEntry}
- * @see {@link https://meocord.dev/docs/4.1/handler-discovery | Handler discovery}
+ * @see {@link https://meocord.dev/docs/4.2/handler-discovery | Handler discovery}
  */
 declare class HandlerRegistry {
     private readonly classes;
@@ -416,7 +418,7 @@ type MethodResult<T, M extends keyof T> = T[M] extends (...args: any[]) => infer
  *
  * @group Controllers
  * @see {@link ShardCallResult}
- * @see {@link https://meocord.dev/docs/4.1/sharding | Sharding}
+ * @see {@link https://meocord.dev/docs/4.2/sharding | Sharding}
  */
 declare class ShardContext {
     private readonly client;

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

@@ -1,5 +1,5 @@
 import { ServiceIdentifier } from 'inversify';
-import { J as MeoCordApplication } from '../index-D7n0FBMm.js';
+import { J as MeoCordApplication } from '../index-CdXsFgjE.js';
 import { MetadataDecorator } from '../common/index.js';
 import { MessageScope, MessageCommandOptions, MessageHelp } from '../interface/index.js';
 import { RESTPostAPIApplicationCommandsJSONBody, ClientEvents, Message, Client } from 'discord.js';
@@ -46,9 +46,11 @@ declare class MeoCordFactory {
      *   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
      *   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. In a built application it is logged first, with where in the source it
-     *   comes from, so `isExplainedError()` tells a caller not to log it again; in a shard of process sharding, the
-     *   manager logs it.
+     *   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
+     *   logged in a built application. Either way `isExplainedError()` then tells a caller not to log it again; in a
+     *   shard of process sharding, the manager logs it. With `startupErrors: 'all'` in `meocord.config.ts`, the errors
+     *   decorators kept are among them.
      */
     static create(target: ServiceIdentifier): MeoCordApplication;
     private static createApplication;
@@ -260,7 +262,7 @@ interface HandlerFilter<K extends HandlerKind = HandlerKind> {
  *
  * @group Controllers
  * @see {@link HandlerEntry}
- * @see {@link https://meocord.dev/docs/4.1/handler-discovery | Handler discovery}
+ * @see {@link https://meocord.dev/docs/4.2/handler-discovery | Handler discovery}
  */
 declare class HandlerRegistry {
     private readonly classes;
@@ -416,7 +418,7 @@ type MethodResult<T, M extends keyof T> = T[M] extends (...args: any[]) => infer
  *
  * @group Controllers
  * @see {@link ShardCallResult}
- * @see {@link https://meocord.dev/docs/4.1/sharding | Sharding}
+ * @see {@link https://meocord.dev/docs/4.2/sharding | Sharding}
  */
 declare class ShardContext {
     private readonly client;

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

@@ -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;