meocord 4.2.0 → 4.2.2

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

@@ -1,5 +1,5 @@
 import { Locale, Interaction, Guild } from 'discord.js';
-import { aq as MeoCordMessages } from './index-CdXsFgjE.js';
+import { aq as MeoCordMessages } from './index-DKJclIi-.js';
 
 /**
  * The plural categories `Intl.PluralRules` selects between.
@@ -33,10 +33,13 @@ type IsPlural<T> = T extends object ? [Exclude<keyof T, PluralCategory>] extends
 /**
  * Every message key of a catalog: the dotted path to each message or plural.
  *
+ * A key with a `.` in its own name is left out, as a lookup reads it as a path and never finds it; `createTranslator`
+ * warns about one. Nest it as a group.
+ *
  * @group Types
  */
 type MessageKey<C> = {
-    [K in keyof C & string]: C[K] extends string ? K : IsPlural<C[K]> extends true ? K : `${K}.${MessageKey<C[K]>}`;
+    [K in keyof C & string]: K extends `${string}.${string}` ? never : C[K] extends string ? K : IsPlural<C[K]> extends true ? K : `${K}.${MessageKey<C[K]>}`;
 }[keyof C & string];
 /**
  * The keys whose message is a single string rather than plural forms, with or without `{params}`.
@@ -45,7 +48,7 @@ type MessageKey<C> = {
  * @see {@link LocalizationKey}
  */
 type StringMessageKey<C> = {
-    [K in keyof C & string]: C[K] extends string ? K : IsPlural<C[K]> extends true ? never : `${K}.${StringMessageKey<C[K]>}`;
+    [K in keyof C & string]: K extends `${string}.${string}` ? never : C[K] extends string ? K : IsPlural<C[K]> extends true ? never : `${K}.${StringMessageKey<C[K]>}`;
 }[keyof C & string];
 /**
  * The keys {@link Translator.localizations} takes: a single string with no `{params}`, since Discord shows a command's
@@ -105,12 +108,17 @@ type Translate<C> = <K extends MessageKey<C>>(key: K, ...params: ParamsArgs<Mess
  * Its messages may use only the `{params}` the default's take: `createTranslator` checks that for a catalog that keeps
  * its text, and `expectCompleteCatalog` for any.
  *
- * A message it leaves out falls back to a related locale, then to the default.
+ * A message it leaves out falls back to a related locale, then to the default. Its `meocord` group translates MeoCord's
+ * own texts.
  *
  * @group Types
  */
-type LocaleCatalog<C> = {
-    readonly [K in keyof C]?: C[K] extends string ? string : IsPlural<C[K]> extends true ? PluralMessage : LocaleCatalog<C[K]>;
+type LocaleCatalog<C> = LocaleMessages<C> & {
+    readonly meocord?: LocaleMessages<MeoCordMessages>;
+};
+/** Any part of a catalog, in a locale's own wording. */
+type LocaleMessages<C> = {
+    readonly [K in keyof C]?: C[K] extends string ? string : IsPlural<C[K]> extends true ? PluralMessage : LocaleMessages<C[K]>;
 };
 /**
  * What is wrong with a catalog's `meocord` group, one message per mistake: a key MeoCord has no text for, a group where
@@ -266,8 +274,13 @@ declare abstract class Translator<C = CatalogShape> {
     /**
      * A message in every locale other than the default whose own catalog has it, for a builder's
      * `setNameLocalizations` or `setDescriptionLocalizations`. Locales without it are left out, so
-     * Discord falls back to the default name for them, and so is a translation with a `{param}`, which
-     * `expectCompleteCatalog` reports.
+     * Discord falls back to the default name for them, and so are an empty translation and a translation
+     * with a `{param}`, which `expectCompleteCatalog` reports.
+     *
+     * Discord shows en-US users the en-GB value, en-GB users the en-US one, and es-419 users the es-ES one,
+     * when their own locale has none. So when the default is en-US, en-GB or es-419 and its partner is in
+     * the result, the default's own message is added under the default's key, and its users keep the default
+     * wording.
      *
      * @param key - A plain message key without `{params}`: Discord shows a name or description as written, and has no
      *   plural forms for it.

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.2.0",
+  "version": "4.2.2",
   "type": "module",
   "engines": {
     "node": ">=22.13"
@@ -138,6 +138,7 @@
     "cli-table3": "^0.6.5",
     "commander": "^15.0.0",
     "dayjs": "^1.11.23",
+    "get-tsconfig": "^4.14.3",
     "inversify": "^8.2.3",
     "jiti": "^2.7.0",
     "lodash-es": "^4.18.1",
@@ -171,7 +172,6 @@
     "prettier": "^3.9.9",
     "redis": "^6.3.0",
     "rollup": "^4.63.6",
-    "rollup-plugin-copy": "^3.5.0",
     "rollup-plugin-dts": "^6.5.1",
     "typescript": "^6.0.3",
     "typescript-eslint": "^8.71.0",