@sapphire/plugin-i18next 7.1.3-next.fae3a34.0 → 7.1.3-next.fc8c5ba

package/README.md

@@ -7,7 +7,6 @@
 **Plugin for <a href="https://github.com/sapphiredev/framework">@sapphire/framework</a> to support i18next based internationalization.**
 
 [![GitHub](https://img.shields.io/github/license/sapphiredev/plugins)](https://github.com/sapphiredev/plugins/blob/main/LICENSE.md)
-[![codecov](https://codecov.io/gh/sapphiredev/plugins/branch/main/graph/badge.svg?token=QWL8FB16BR)](https://codecov.io/gh/sapphiredev/plugins)
 [![npm bundle size](https://img.shields.io/bundlephobia/min/@sapphire/plugin-in17n?logo=webpack&style=flat-square)](https://bundlephobia.com/result?p=@sapphire/plugin-in17n)
 [![npm](https://img.shields.io/npm/v/@sapphire/plugin-in17n?color=crimson&logo=npm&style=flat-square)](https://www.npmjs.com/package/@sapphire/plugin-in17n)
 

package/dist/cjs/index.cjs

@@ -10,7 +10,7 @@ function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 var i18next__default = /*#__PURE__*/_interopDefault(i18next);
 
 // src/index.ts
-var version = "7.1.3-next.fae3a34.0";
+var version = "7.1.3-next.fc8c5ba";
 
 Object.defineProperty(exports, "i18next", {
   enumerable: true,
@@ -35,5 +35,5 @@ Object.keys(types_cjs).forEach(function (k) {
     get: function () { return types_cjs[k]; }
   });
 });
-//# sourceMappingURL=out.js.map
+//# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/cjs/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/index.ts"],"names":["default"],"mappings":";AAGA,SAAoB,WAAXA,gBAAyD;AAClE,cAAc;AACd,cAAc;AACd,cAAc;AAmBP,IAAM,UAAkB","sourcesContent":["import type { InternationalizationHandler } from './lib/InternationalizationHandler';\nimport type { InternationalizationClientOptions } from './lib/types';\n\nexport { default as i18next, type TFunction, type TOptions } from 'i18next';\nexport * from './lib/InternationalizationHandler';\nexport * from './lib/functions';\nexport * from './lib/types';\n\ndeclare module '@sapphire/pieces' {\n\tinterface Container {\n\t\ti18n: InternationalizationHandler;\n\t}\n}\n\ndeclare module 'discord.js' {\n\texport interface ClientOptions extends InternationalizationClientOptions {}\n}\n\n/**\n * The [@sapphire/plugin-i18next](https://github.com/sapphiredev/plugins/blob/main/packages/i18next) version that you are currently using.\n * An example use of this is showing it of in a bot information command.\n *\n * Note to Sapphire developers: This needs to explicitly be `string` so it is not typed as the string that gets replaced by esbuild\n */\n// eslint-disable-next-line @typescript-eslint/no-inferrable-types\nexport const version: string = '7.1.3-next.fae3a34.0';\n"]}
+{"version":3,"sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAyBO,IAAM,OAAkB,GAAA","file":"index.cjs","sourcesContent":["import type { InternationalizationHandler } from './lib/InternationalizationHandler';\nimport type { InternationalizationClientOptions } from './lib/types';\n\nexport { default as i18next, type TFunction, type TOptions } from 'i18next';\nexport * from './lib/InternationalizationHandler';\nexport * from './lib/functions';\nexport * from './lib/types';\n\ndeclare module '@sapphire/pieces' {\n\tinterface Container {\n\t\ti18n: InternationalizationHandler;\n\t}\n}\n\ndeclare module 'discord.js' {\n\texport interface ClientOptions extends InternationalizationClientOptions {}\n}\n\n/**\n * The [@sapphire/plugin-i18next](https://github.com/sapphiredev/plugins/blob/main/packages/i18next) version that you are currently using.\n * An example use of this is showing it of in a bot information command.\n *\n * Note to Sapphire developers: This needs to explicitly be `string` so it is not typed as the string that gets replaced by esbuild\n */\n// eslint-disable-next-line @typescript-eslint/no-inferrable-types\nexport const version: string = '7.1.3-next.fc8c5ba';\n"]}

package/dist/cjs/index.d.cts

@@ -282,9 +282,30 @@ declare class InternationalizationHandler {
      * @see {@link https://www.i18next.com/overview/api#t}
      * @returns The localized content.
      */
-    format<const Key extends ParseKeys<Ns, TOpt, undefined>, const TOpt extends TOptions = TOptions, Ns extends Namespace = DefaultNamespace, Ret extends TFunctionReturn<Ns, AppendKeyPrefix<Key, undefined>, TOpt> = TOpt['returnObjects'] extends true ? $SpecialObject : string, const ActualOptions extends TOpt & InterpolationMap<Ret> = TOpt & InterpolationMap<Ret>>(locale: string, ...[key, defaultValueOrOptions, optionsOrUndefined]: [key: Key | Key[], options?: ActualOptions] | [key: string | string[], options: TOpt & $Dictionary & {
+    format<const Key extends ParseKeys<Ns, TOpt, undefined>, const TOpt extends TOptions = TOptions, Ns extends Namespace = DefaultNamespace, Ret extends TFunctionReturn<Ns, AppendKeyPrefix<Key, undefined>, TOpt> = TOpt['returnObjects'] extends true ? $SpecialObject : string, const ActualOptions extends TOpt & InterpolationMap<Ret> = TOpt & InterpolationMap<Ret>>(locale: string, key: Key | Key[], options?: ActualOptions): TFunctionReturnOptionalDetails<Ret, TOpt>;
+    /**
+     * Localizes a content given one or more keys and i18next options.
+     * @since 2.0.0
+     * @param locale The language to be used.
+     * @param key The key or keys to retrieve the content from.
+     * @param options The interpolation options as well as a `defaultValue` for the key and any key/value pairs.
+     * @see {@link https://www.i18next.com/overview/api#t}
+     * @returns The localized content.
+     */
+    format<const Key extends ParseKeys<Ns, TOpt, undefined>, const TOpt extends TOptions = TOptions, Ns extends Namespace = DefaultNamespace, Ret extends TFunctionReturn<Ns, AppendKeyPrefix<Key, undefined>, TOpt> = TOpt['returnObjects'] extends true ? $SpecialObject : string, const ActualOptions extends TOpt & InterpolationMap<Ret> = TOpt & InterpolationMap<Ret>>(locale: string, key: string | string[], options: TOpt & $Dictionary & {
         defaultValue: string;
-    }] | [key: string | string[], defaultValue: string | undefined, options?: TOpt & $Dictionary]): TFunctionReturnOptionalDetails<Ret, TOpt>;
+    }): TFunctionReturnOptionalDetails<Ret, TOpt>;
+    /**
+     * Localizes a content given one or more keys and i18next options.
+     * @since 2.0.0
+     * @param locale The language to be used.
+     * @param key The key or keys to retrieve the content from.
+     * @param defaultValue The default value to use if the key is not found.
+     * @param options The interpolation options.
+     * @see {@link https://www.i18next.com/overview/api#t}
+     * @returns The localized content.
+     */
+    format<const Key extends ParseKeys<Ns, TOpt, undefined>, const TOpt extends TOptions = TOptions, Ns extends Namespace = DefaultNamespace, Ret extends TFunctionReturn<Ns, AppendKeyPrefix<Key, undefined>, TOpt> = TOpt['returnObjects'] extends true ? $SpecialObject : string, const ActualOptions extends TOpt & InterpolationMap<Ret> = TOpt & InterpolationMap<Ret>>(locale: string, key: string | string[], defaultValue: string | undefined, options?: TOpt & $Dictionary): TFunctionReturnOptionalDetails<Ret, TOpt>;
     /**
      * @param directory The directory that should be walked.
      * @since 3.0.0
@@ -331,9 +352,28 @@ declare function fetchT(target: Target): Promise<i18next.TFunction<"translation"
  * @param options The options to be passed to TFunction.
  * @returns The data that `key` held, processed by i18next.
  */
-declare function resolveKey<const Key extends ParseKeys<Ns, TOpt, undefined>, const TOpt extends TOptions = TOptions, Ret extends TFunctionReturn<Ns, AppendKeyPrefix<Key, undefined>, TOpt> = TOpt['returnObjects'] extends true ? $SpecialObject : string, Ns extends Namespace = DefaultNamespace, const ActualOptions extends TOpt & InterpolationMap<Ret> = TOpt & InterpolationMap<Ret>>(target: Target, ...[key, defaultValueOrOptions, optionsOrUndefined]: [key: Key | Key[], options?: ActualOptions] | [key: string | string[], options: TOpt & $Dictionary & {
+declare function resolveKey<const Key extends ParseKeys<Ns, TOpt, undefined>, const TOpt extends TOptions = TOptions, Ret extends TFunctionReturn<Ns, AppendKeyPrefix<Key, undefined>, TOpt> = TOpt['returnObjects'] extends true ? $SpecialObject : string, Ns extends Namespace = DefaultNamespace, const ActualOptions extends TOpt & InterpolationMap<Ret> = TOpt & InterpolationMap<Ret>>(target: Target, key: Key | Key[], options?: ActualOptions): Promise<TFunctionReturnOptionalDetails<Ret, TOpt>>;
+/**
+ * Resolves a key and its parameters.
+ * @since 2.0.0
+ * @param target The target to fetch the language key from.
+ * @param key The i18next key.
+ * @param options The interpolation options as well as a `defaultValue` for the key and any key/value pairs.
+ * @returns The data that `key` held, processed by i18next.
+ */
+declare function resolveKey<const Key extends ParseKeys<Ns, TOpt, undefined>, const TOpt extends TOptions = TOptions, Ret extends TFunctionReturn<Ns, AppendKeyPrefix<Key, undefined>, TOpt> = TOpt['returnObjects'] extends true ? $SpecialObject : string, Ns extends Namespace = DefaultNamespace, const ActualOptions extends TOpt & InterpolationMap<Ret> = TOpt & InterpolationMap<Ret>>(target: Target, key: string | string[], options: TOpt & $Dictionary & {
     defaultValue: string;
-}] | [key: string | string[], defaultValue: string, options?: TOpt & $Dictionary]): Promise<TFunctionReturnOptionalDetails<Ret, TOpt>>;
+}): Promise<TFunctionReturnOptionalDetails<Ret, TOpt>>;
+/**
+ * Resolves a key and its parameters.
+ * @since 2.0.0
+ * @param target The target to fetch the language key from.
+ * @param key The i18next key.
+ * @param defaultValue The default value to use if the key is not found.
+ * @param options The interpolation options.
+ * @returns The data that `key` held, processed by i18next.
+ */
+declare function resolveKey<const Key extends ParseKeys<Ns, TOpt, undefined>, const TOpt extends TOptions = TOptions, Ret extends TFunctionReturn<Ns, AppendKeyPrefix<Key, undefined>, TOpt> = TOpt['returnObjects'] extends true ? $SpecialObject : string, Ns extends Namespace = DefaultNamespace, const ActualOptions extends TOpt & InterpolationMap<Ret> = TOpt & InterpolationMap<Ret>>(target: Target, key: string | string[], defaultValue: string, options?: TOpt & $Dictionary): Promise<TFunctionReturnOptionalDetails<Ret, TOpt>>;
 /**
  * Gets the value and the localizations from a language key.
  * @param key The key to get the localizations from.

package/dist/cjs/lib/Augmentations.d.cjs

@@ -1,4 +1,4 @@
 'use strict';
 
-//# sourceMappingURL=out.js.map
+//# sourceMappingURL=Augmentations.d.cjs.map
 //# sourceMappingURL=Augmentations.d.cjs.map

package/dist/cjs/lib/Augmentations.d.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":""}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"Augmentations.d.cjs"}

package/dist/cjs/lib/InternationalizationHandler.cjs

@@ -16,10 +16,7 @@ var i18next__default = /*#__PURE__*/_interopDefault(i18next);
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
-var __publicField = (obj, key, value) => {
-  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-  return value;
-};
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 var _InternationalizationHandler = class _InternationalizationHandler {
   /**
    * @param options The options that `i18next`, `@skyra/i18next-backend`, and {@link InternationalizationHandler} should use.
@@ -146,10 +143,8 @@ var _InternationalizationHandler = class _InternationalizationHandler {
     const formatter = i18next__default.default.services.formatter;
     const formatters = this.options.formatters ?? [];
     for (const { name, format, cached } of formatters) {
-      if (cached)
-        formatter.addCached(name, format);
-      else
-        formatter.add(name, format);
+      if (cached) formatter.addCached(name, format);
+      else formatter.add(name, format);
     }
   }
   /**
@@ -158,28 +153,27 @@ var _InternationalizationHandler = class _InternationalizationHandler {
    * @since 1.0.0
    */
   getT(locale) {
-    if (!this.languagesLoaded)
-      throw new Error("Cannot call this method until InternationalizationHandler#init has been called");
+    if (!this.languagesLoaded) throw new Error("Cannot call this method until InternationalizationHandler#init has been called");
     const t = this.languages.get(locale);
-    if (t)
-      return t;
+    if (t) return t;
     throw new ReferenceError("Invalid language provided");
   }
   /**
    * Localizes a content given one or more keys and i18next options.
    * @since 2.0.0
    * @param locale The language to be used.
-   * @param key The key or keys to retrieve the content from.
-   * @param options The interpolation options.
+   *
+   * @remark This function also has additional parameters for `key`, `defaultValue`, and `options`, however
+   * TSDoc does not let us document those while matching proper implementation. See the overloads for this method
+   * for the documentation on those parameters.
+   *
    * @see {@link https://www.i18next.com/overview/api#t}
    * @returns The localized content.
    */
   format(locale, ...[key, defaultValueOrOptions, optionsOrUndefined]) {
-    if (!this.languagesLoaded)
-      throw new Error("Cannot call this method until InternationalizationHandler#init has been called");
+    if (!this.languagesLoaded) throw new Error("Cannot call this method until InternationalizationHandler#init has been called");
     const language = this.languages.get(locale);
-    if (!language)
-      throw new ReferenceError("Invalid language provided");
+    if (!language) throw new ReferenceError("Invalid language provided");
     const defaultValue = typeof defaultValueOrOptions === "string" ? defaultValueOrOptions : this.options.defaultMissingKey ? language(this.options.defaultMissingKey, { replace: { key } }) : "";
     return language(key, { defaultValue, ...optionsOrUndefined ?? {} });
   }
@@ -192,8 +186,7 @@ var _InternationalizationHandler = class _InternationalizationHandler {
     const namespaces = /* @__PURE__ */ new Set();
     const dir = await promises.opendir(directory);
     for await (const entry of dir) {
-      if (!entry.isDirectory())
-        continue;
+      if (!entry.isDirectory()) continue;
       languages.add(entry.name);
       for await (const namespace of this.walkLocaleDirectory(path.join(dir.path, entry.name), "")) {
         namespaces.add(namespace);
@@ -236,5 +229,5 @@ __name(_InternationalizationHandler, "InternationalizationHandler");
 var InternationalizationHandler = _InternationalizationHandler;
 
 exports.InternationalizationHandler = InternationalizationHandler;
-//# sourceMappingURL=out.js.map
+//# sourceMappingURL=InternationalizationHandler.cjs.map
 //# sourceMappingURL=InternationalizationHandler.cjs.map

package/dist/cjs/lib/InternationalizationHandler.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/lib/InternationalizationHandler.ts"],"names":[],"mappings":"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","sourcesContent":["import { Result } from '@sapphire/framework';\nimport { container, getRootData } from '@sapphire/pieces';\nimport { isFunction, type Awaitable } from '@sapphire/utilities';\nimport { Backend, type PathResolvable } from '@skyra/i18next-backend';\nimport i18next, {\n\ttype AppendKeyPrefix,\n\ttype DefaultNamespace,\n\ttype InterpolationMap,\n\ttype Namespace,\n\ttype ParseKeys,\n\ttype TFunction,\n\ttype TFunctionReturn,\n\ttype TFunctionReturnOptionalDetails,\n\ttype TOptions\n} from 'i18next';\nimport type { PathLike } from 'node:fs';\nimport { opendir } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { URL, fileURLToPath } from 'node:url';\nimport type { $Dictionary, $SpecialObject, InternationalizationContext, InternationalizationOptions } from './types';\n\n/**\n * A generalized class for handling `i18next` JSON files and their discovery.\n * @since 1.0.0\n */\nexport class InternationalizationHandler {\n\t/**\n\t * Describes whether {@link InternationalizationHandler.init} has been run and languages are loaded in {@link InternationalizationHandler.languages}.\n\t * @since 1.0.0\n\t */\n\tpublic languagesLoaded = false;\n\n\t/**\n\t * A `Set` of initially loaded namespaces.\n\t * @since 1.2.0\n\t */\n\tpublic namespaces = new Set<string>();\n\n\t/**\n\t * A `Map` of `i18next` language functions keyed by their language code.\n\t * @since 1.0.0\n\t */\n\tpublic readonly languages = new Map<string, TFunction>();\n\n\t/**\n\t * The options InternationalizationHandler was initialized with in the client.\n\t * @since 1.0.0\n\t */\n\tpublic readonly options: InternationalizationOptions;\n\n\t/**\n\t * The director passed to `@skyra/i18next-backend`.\n\t * Also used in {@link InternationalizationHandler.walkLanguageDirectory}.\n\t * @since 1.2.0\n\t */\n\tpublic readonly languagesDirectory: string;\n\n\t/**\n\t * The backend options for `@skyra/i18next-backend` used by `i18next`.\n\t * @since 1.0.0\n\t */\n\tprotected readonly backendOptions: Backend.Options;\n\n\t/**\n\t * @param options The options that `i18next`, `@skyra/i18next-backend`, and {@link InternationalizationHandler} should use.\n\t * @since 1.0.0\n\t * @constructor\n\t */\n\tpublic constructor(options?: InternationalizationOptions) {\n\t\tthis.options = options ?? { i18next: { ignoreJSONStructure: false } };\n\n\t\tconst baseUserDirectory =\n\t\t\tcontainer.client?.options?.baseUserDirectory instanceof URL\n\t\t\t\t? fileURLToPath(container.client?.options?.baseUserDirectory)\n\t\t\t\t: container.client?.options?.baseUserDirectory;\n\n\t\tthis.languagesDirectory = this.options.defaultLanguageDirectory ?? join(baseUserDirectory ?? getRootData().root, 'languages');\n\n\t\tconst languagePaths = new Set<PathResolvable>([\n\t\t\tjoin(this.languagesDirectory, '{{lng}}', '{{ns}}.json'), //\n\t\t\t...(options?.backend?.paths ?? [])\n\t\t]);\n\n\t\tthis.backendOptions = {\n\t\t\tpaths: [...languagePaths],\n\t\t\t...this.options.backend\n\t\t};\n\n\t\tif (isFunction(this.options.fetchLanguage)) {\n\t\t\tthis.fetchLanguage = this.options.fetchLanguage;\n\t\t}\n\t}\n\n\t/**\n\t * The method to be overridden by the developer.\n\t *\n\t * @note In the event that fetchLanguage is not defined or returns null / undefined, the defaulting from {@link fetchLanguage} will be used.\n\t * @since 2.0.0\n\t * @return A string for the desired language or null for no match.\n\t * @see {@link fetchLanguage}\n\t * @example\n\t * ```typescript\n\t * // Always use the same language (no per-guild configuration):\n\t * container.i18n.fetchLanguage = () => 'en-US';\n\t * ```\n\t * @example\n\t * ```typescript\n\t * // Retrieving the language from an SQL database:\n\t * container.i18n.fetchLanguage = async (context) => {\n\t *   const guild = await driver.getOne('SELECT language FROM public.guild WHERE id = $1', [context.guild.id]);\n\t *   return guild?.language ?? 'en-US';\n\t * };\n\t * ```\n\t * @example\n\t * ```typescript\n\t * // Retrieving the language from an ORM:\n\t * container.i18n.fetchLanguage = async (context) => {\n\t *   const guild = await driver.getRepository(GuildEntity).findOne({ id: context.guild.id });\n\t *   return guild?.language ?? 'en-US';\n\t * };\n\t * ```\n\t * @example\n\t * ```typescript\n\t * // Retrieving the language on a per channel basis, e.g. per user or guild channel (ORM example but same principles apply):\n\t * container.i18n.fetchLanguage = async (context) => {\n\t *   const channel = await driver.getRepository(ChannelEntity).findOne({ id: context.channel.id });\n\t *   return channel?.language ?? 'en-US';\n\t * };\n\t * ```\n\t */\n\tpublic fetchLanguage: (context: InternationalizationContext) => Awaitable<string | null> = () => null;\n\n\t/**\n\t * Initializes the handler by loading in the namespaces, passing the data to i18next, and filling in the {@link InternationalizationHandler#languages}.\n\t * @since 1.0.0\n\t */\n\tpublic async init() {\n\t\tconst { namespaces, languages } = await this.walkRootDirectory(this.languagesDirectory);\n\t\tconst userOptions = isFunction(this.options.i18next) ? this.options.i18next(namespaces, languages) : this.options.i18next;\n\t\tconst ignoreJSONStructure = userOptions?.ignoreJSONStructure ?? false;\n\t\tconst skipOnVariables = userOptions?.interpolation?.skipOnVariables ?? false;\n\n\t\ti18next.use(Backend);\n\t\tawait i18next.init({\n\t\t\tbackend: this.backendOptions,\n\t\t\tfallbackLng: this.options.defaultName ?? 'en-US',\n\t\t\tinitImmediate: false,\n\t\t\tinterpolation: {\n\t\t\t\tescapeValue: false,\n\t\t\t\t...userOptions?.interpolation,\n\t\t\t\tskipOnVariables\n\t\t\t},\n\t\t\tload: 'all',\n\t\t\tdefaultNS: 'default',\n\t\t\tns: namespaces,\n\t\t\tpreload: languages,\n\t\t\t...userOptions,\n\t\t\tignoreJSONStructure\n\t\t});\n\n\t\tthis.namespaces = new Set(namespaces);\n\t\tfor (const item of languages) {\n\t\t\tthis.languages.set(item, i18next.getFixedT(item));\n\t\t}\n\t\tthis.languagesLoaded = true;\n\n\t\tconst formatter = i18next.services.formatter!;\n\t\tconst formatters = this.options.formatters ?? [];\n\t\tfor (const { name, format, cached } of formatters) {\n\t\t\tif (cached) formatter.addCached(name, format);\n\t\t\telse formatter.add(name, format);\n\t\t}\n\t}\n\n\t/**\n\t * Retrieve a raw TFunction from the passed locale.\n\t * @param locale The language to be used.\n\t * @since 1.0.0\n\t */\n\tpublic getT(locale: string) {\n\t\tif (!this.languagesLoaded) throw new Error('Cannot call this method until InternationalizationHandler#init has been called');\n\n\t\tconst t = this.languages.get(locale);\n\t\tif (t) return t;\n\t\tthrow new ReferenceError('Invalid language provided');\n\t}\n\n\t/**\n\t * Localizes a content given one or more keys and i18next options.\n\t * @since 2.0.0\n\t * @param locale The language to be used.\n\t * @param key The key or keys to retrieve the content from.\n\t * @param options The interpolation options.\n\t * @see {@link https://www.i18next.com/overview/api#t}\n\t * @returns The localized content.\n\t */\n\tpublic format<\n\t\tconst Key extends ParseKeys<Ns, TOpt, undefined>,\n\t\tconst TOpt extends TOptions = TOptions,\n\t\tNs extends Namespace = DefaultNamespace,\n\t\tRet extends TFunctionReturn<Ns, AppendKeyPrefix<Key, undefined>, TOpt> = TOpt['returnObjects'] extends true ? $SpecialObject : string,\n\t\tconst ActualOptions extends TOpt & InterpolationMap<Ret> = TOpt & InterpolationMap<Ret>\n\t>(\n\t\tlocale: string,\n\t\t...[key, defaultValueOrOptions, optionsOrUndefined]:\n\t\t\t| [key: Key | Key[], options?: ActualOptions]\n\t\t\t| [key: string | string[], options: TOpt & $Dictionary & { defaultValue: string }]\n\t\t\t| [key: string | string[], defaultValue: string | undefined, options?: TOpt & $Dictionary]\n\t): TFunctionReturnOptionalDetails<Ret, TOpt> {\n\t\tif (!this.languagesLoaded) throw new Error('Cannot call this method until InternationalizationHandler#init has been called');\n\n\t\tconst language = this.languages.get(locale);\n\t\tif (!language) throw new ReferenceError('Invalid language provided');\n\n\t\tconst defaultValue =\n\t\t\ttypeof defaultValueOrOptions === 'string'\n\t\t\t\t? defaultValueOrOptions\n\t\t\t\t: this.options.defaultMissingKey\n\t\t\t\t\t? language(this.options.defaultMissingKey, { replace: { key } })\n\t\t\t\t\t: '';\n\n\t\treturn language<Key, TOpt, Ret, ActualOptions>(key, { defaultValue, ...((optionsOrUndefined ?? {}) as TOpt) });\n\t}\n\n\t/**\n\t * @param directory The directory that should be walked.\n\t * @since 3.0.0\n\t */\n\tpublic async walkRootDirectory(directory: PathLike) {\n\t\tconst languages = new Set<string>();\n\t\tconst namespaces = new Set<string>();\n\n\t\tconst dir = await opendir(directory);\n\t\tfor await (const entry of dir) {\n\t\t\t// If the entry is not a directory, skip:\n\t\t\tif (!entry.isDirectory()) continue;\n\n\t\t\t// Load the directory:\n\t\t\tlanguages.add(entry.name);\n\n\t\t\tfor await (const namespace of this.walkLocaleDirectory(join(dir.path, entry.name), '')) {\n\t\t\t\tnamespaces.add(namespace);\n\t\t\t}\n\t\t}\n\n\t\treturn { namespaces: [...namespaces], languages: [...languages] };\n\t}\n\n\tpublic async reloadResources() {\n\t\tconst result = await Result.fromAsync(async () => {\n\t\t\tlet languages = this.options.hmr?.languages;\n\t\t\tlet namespaces = this.options.hmr?.namespaces;\n\t\t\tif (!languages || !namespaces) {\n\t\t\t\tconst languageDirectoryResult = await this.walkRootDirectory(this.languagesDirectory);\n\t\t\t\tlanguages ??= languageDirectoryResult.languages;\n\t\t\t\tnamespaces ??= languageDirectoryResult.namespaces;\n\t\t\t}\n\n\t\t\tawait i18next.reloadResources(languages, namespaces);\n\t\t\tcontainer.logger.info('[i18next-Plugin] Reloaded language resources.');\n\t\t});\n\n\t\tresult.inspectErr((error) => container.logger.error('[i18next-Plugin]: Failed to reload language resources.', error));\n\t}\n\n\t/**\n\t * @description Skips any files that don't end with `.json`.\n\t * @param directory The directory that should be walked.\n\t * @param ns The current namespace.\n\t * @since 3.0.0\n\t */\n\tprivate async *walkLocaleDirectory(directory: string, ns: string): AsyncGenerator<string> {\n\t\tconst dir = await opendir(directory);\n\t\tfor await (const entry of dir) {\n\t\t\tif (entry.isDirectory()) {\n\t\t\t\tyield* this.walkLocaleDirectory(join(dir.path, entry.name), `${ns}${entry.name}/`);\n\t\t\t} else if (entry.isFile() && entry.name.endsWith('.json')) {\n\t\t\t\tyield `${ns}${entry.name.slice(0, -5)}`;\n\t\t\t}\n\t\t}\n\t}\n}\n"]}
+{"version":3,"sources":["../../../src/lib/InternationalizationHandler.ts"],"names":["container","URL","fileURLToPath","join","getRootData","isFunction","i18next","Backend","opendir","Result"],"mappings":"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","file":"InternationalizationHandler.cjs","sourcesContent":["import { Result } from '@sapphire/framework';\nimport { container, getRootData } from '@sapphire/pieces';\nimport { isFunction, type Awaitable } from '@sapphire/utilities';\nimport { Backend, type PathResolvable } from '@skyra/i18next-backend';\nimport i18next, {\n\ttype AppendKeyPrefix,\n\ttype DefaultNamespace,\n\ttype InterpolationMap,\n\ttype Namespace,\n\ttype ParseKeys,\n\ttype TFunction,\n\ttype TFunctionReturn,\n\ttype TFunctionReturnOptionalDetails,\n\ttype TOptions\n} from 'i18next';\nimport type { PathLike } from 'node:fs';\nimport { opendir } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { URL, fileURLToPath } from 'node:url';\nimport type { $Dictionary, $SpecialObject, InternationalizationContext, InternationalizationOptions } from './types';\n\n/**\n * A generalized class for handling `i18next` JSON files and their discovery.\n * @since 1.0.0\n */\nexport class InternationalizationHandler {\n\t/**\n\t * Describes whether {@link InternationalizationHandler.init} has been run and languages are loaded in {@link InternationalizationHandler.languages}.\n\t * @since 1.0.0\n\t */\n\tpublic languagesLoaded = false;\n\n\t/**\n\t * A `Set` of initially loaded namespaces.\n\t * @since 1.2.0\n\t */\n\tpublic namespaces = new Set<string>();\n\n\t/**\n\t * A `Map` of `i18next` language functions keyed by their language code.\n\t * @since 1.0.0\n\t */\n\tpublic readonly languages = new Map<string, TFunction>();\n\n\t/**\n\t * The options InternationalizationHandler was initialized with in the client.\n\t * @since 1.0.0\n\t */\n\tpublic readonly options: InternationalizationOptions;\n\n\t/**\n\t * The director passed to `@skyra/i18next-backend`.\n\t * Also used in {@link InternationalizationHandler.walkLanguageDirectory}.\n\t * @since 1.2.0\n\t */\n\tpublic readonly languagesDirectory: string;\n\n\t/**\n\t * The backend options for `@skyra/i18next-backend` used by `i18next`.\n\t * @since 1.0.0\n\t */\n\tprotected readonly backendOptions: Backend.Options;\n\n\t/**\n\t * @param options The options that `i18next`, `@skyra/i18next-backend`, and {@link InternationalizationHandler} should use.\n\t * @since 1.0.0\n\t * @constructor\n\t */\n\tpublic constructor(options?: InternationalizationOptions) {\n\t\tthis.options = options ?? { i18next: { ignoreJSONStructure: false } };\n\n\t\tconst baseUserDirectory =\n\t\t\tcontainer.client?.options?.baseUserDirectory instanceof URL\n\t\t\t\t? fileURLToPath(container.client?.options?.baseUserDirectory)\n\t\t\t\t: container.client?.options?.baseUserDirectory;\n\n\t\tthis.languagesDirectory = this.options.defaultLanguageDirectory ?? join(baseUserDirectory ?? getRootData().root, 'languages');\n\n\t\tconst languagePaths = new Set<PathResolvable>([\n\t\t\tjoin(this.languagesDirectory, '{{lng}}', '{{ns}}.json'), //\n\t\t\t...(options?.backend?.paths ?? [])\n\t\t]);\n\n\t\tthis.backendOptions = {\n\t\t\tpaths: [...languagePaths],\n\t\t\t...this.options.backend\n\t\t};\n\n\t\tif (isFunction(this.options.fetchLanguage)) {\n\t\t\tthis.fetchLanguage = this.options.fetchLanguage;\n\t\t}\n\t}\n\n\t/**\n\t * The method to be overridden by the developer.\n\t *\n\t * @note In the event that fetchLanguage is not defined or returns null / undefined, the defaulting from {@link fetchLanguage} will be used.\n\t * @since 2.0.0\n\t * @return A string for the desired language or null for no match.\n\t * @see {@link fetchLanguage}\n\t * @example\n\t * ```typescript\n\t * // Always use the same language (no per-guild configuration):\n\t * container.i18n.fetchLanguage = () => 'en-US';\n\t * ```\n\t * @example\n\t * ```typescript\n\t * // Retrieving the language from an SQL database:\n\t * container.i18n.fetchLanguage = async (context) => {\n\t *   const guild = await driver.getOne('SELECT language FROM public.guild WHERE id = $1', [context.guild.id]);\n\t *   return guild?.language ?? 'en-US';\n\t * };\n\t * ```\n\t * @example\n\t * ```typescript\n\t * // Retrieving the language from an ORM:\n\t * container.i18n.fetchLanguage = async (context) => {\n\t *   const guild = await driver.getRepository(GuildEntity).findOne({ id: context.guild.id });\n\t *   return guild?.language ?? 'en-US';\n\t * };\n\t * ```\n\t * @example\n\t * ```typescript\n\t * // Retrieving the language on a per channel basis, e.g. per user or guild channel (ORM example but same principles apply):\n\t * container.i18n.fetchLanguage = async (context) => {\n\t *   const channel = await driver.getRepository(ChannelEntity).findOne({ id: context.channel.id });\n\t *   return channel?.language ?? 'en-US';\n\t * };\n\t * ```\n\t */\n\tpublic fetchLanguage: (context: InternationalizationContext) => Awaitable<string | null> = () => null;\n\n\t/**\n\t * Initializes the handler by loading in the namespaces, passing the data to i18next, and filling in the {@link InternationalizationHandler#languages}.\n\t * @since 1.0.0\n\t */\n\tpublic async init() {\n\t\tconst { namespaces, languages } = await this.walkRootDirectory(this.languagesDirectory);\n\t\tconst userOptions = isFunction(this.options.i18next) ? this.options.i18next(namespaces, languages) : this.options.i18next;\n\t\tconst ignoreJSONStructure = userOptions?.ignoreJSONStructure ?? false;\n\t\tconst skipOnVariables = userOptions?.interpolation?.skipOnVariables ?? false;\n\n\t\ti18next.use(Backend);\n\t\tawait i18next.init({\n\t\t\tbackend: this.backendOptions,\n\t\t\tfallbackLng: this.options.defaultName ?? 'en-US',\n\t\t\tinitImmediate: false,\n\t\t\tinterpolation: {\n\t\t\t\tescapeValue: false,\n\t\t\t\t...userOptions?.interpolation,\n\t\t\t\tskipOnVariables\n\t\t\t},\n\t\t\tload: 'all',\n\t\t\tdefaultNS: 'default',\n\t\t\tns: namespaces,\n\t\t\tpreload: languages,\n\t\t\t...userOptions,\n\t\t\tignoreJSONStructure\n\t\t});\n\n\t\tthis.namespaces = new Set(namespaces);\n\t\tfor (const item of languages) {\n\t\t\tthis.languages.set(item, i18next.getFixedT(item));\n\t\t}\n\t\tthis.languagesLoaded = true;\n\n\t\tconst formatter = i18next.services.formatter!;\n\t\tconst formatters = this.options.formatters ?? [];\n\t\tfor (const { name, format, cached } of formatters) {\n\t\t\tif (cached) formatter.addCached(name, format);\n\t\t\telse formatter.add(name, format);\n\t\t}\n\t}\n\n\t/**\n\t * Retrieve a raw TFunction from the passed locale.\n\t * @param locale The language to be used.\n\t * @since 1.0.0\n\t */\n\tpublic getT(locale: string) {\n\t\tif (!this.languagesLoaded) throw new Error('Cannot call this method until InternationalizationHandler#init has been called');\n\n\t\tconst t = this.languages.get(locale);\n\t\tif (t) return t;\n\t\tthrow new ReferenceError('Invalid language provided');\n\t}\n\n\t/**\n\t * Localizes a content given one or more keys and i18next options.\n\t * @since 2.0.0\n\t * @param locale The language to be used.\n\t * @param key The key or keys to retrieve the content from.\n\t * @param options The interpolation options.\n\t * @see {@link https://www.i18next.com/overview/api#t}\n\t * @returns The localized content.\n\t */\n\tpublic format<\n\t\tconst Key extends ParseKeys<Ns, TOpt, undefined>,\n\t\tconst TOpt extends TOptions = TOptions,\n\t\tNs extends Namespace = DefaultNamespace,\n\t\tRet extends TFunctionReturn<Ns, AppendKeyPrefix<Key, undefined>, TOpt> = TOpt['returnObjects'] extends true ? $SpecialObject : string,\n\t\tconst ActualOptions extends TOpt & InterpolationMap<Ret> = TOpt & InterpolationMap<Ret>\n\t>(locale: string, key: Key | Key[], options?: ActualOptions): TFunctionReturnOptionalDetails<Ret, TOpt>;\n\n\t/**\n\t * Localizes a content given one or more keys and i18next options.\n\t * @since 2.0.0\n\t * @param locale The language to be used.\n\t * @param key The key or keys to retrieve the content from.\n\t * @param options The interpolation options as well as a `defaultValue` for the key and any key/value pairs.\n\t * @see {@link https://www.i18next.com/overview/api#t}\n\t * @returns The localized content.\n\t */\n\tpublic format<\n\t\tconst Key extends ParseKeys<Ns, TOpt, undefined>,\n\t\tconst TOpt extends TOptions = TOptions,\n\t\tNs extends Namespace = DefaultNamespace,\n\t\tRet extends TFunctionReturn<Ns, AppendKeyPrefix<Key, undefined>, TOpt> = TOpt['returnObjects'] extends true ? $SpecialObject : string,\n\t\tconst ActualOptions extends TOpt & InterpolationMap<Ret> = TOpt & InterpolationMap<Ret>\n\t>(locale: string, key: string | string[], options: TOpt & $Dictionary & { defaultValue: string }): TFunctionReturnOptionalDetails<Ret, TOpt>;\n\n\t/**\n\t * Localizes a content given one or more keys and i18next options.\n\t * @since 2.0.0\n\t * @param locale The language to be used.\n\t * @param key The key or keys to retrieve the content from.\n\t * @param defaultValue The default value to use if the key is not found.\n\t * @param options The interpolation options.\n\t * @see {@link https://www.i18next.com/overview/api#t}\n\t * @returns The localized content.\n\t */\n\tpublic format<\n\t\tconst Key extends ParseKeys<Ns, TOpt, undefined>,\n\t\tconst TOpt extends TOptions = TOptions,\n\t\tNs extends Namespace = DefaultNamespace,\n\t\tRet extends TFunctionReturn<Ns, AppendKeyPrefix<Key, undefined>, TOpt> = TOpt['returnObjects'] extends true ? $SpecialObject : string,\n\t\tconst ActualOptions extends TOpt & InterpolationMap<Ret> = TOpt & InterpolationMap<Ret>\n\t>(\n\t\tlocale: string,\n\t\tkey: string | string[],\n\t\tdefaultValue: string | undefined,\n\t\toptions?: TOpt & $Dictionary\n\t): TFunctionReturnOptionalDetails<Ret, TOpt>;\n\n\t/**\n\t * Localizes a content given one or more keys and i18next options.\n\t * @since 2.0.0\n\t * @param locale The language to be used.\n\t *\n\t * @remark This function also has additional parameters for `key`, `defaultValue`, and `options`, however\n\t * TSDoc does not let us document those while matching proper implementation. See the overloads for this method\n\t * for the documentation on those parameters.\n\t *\n\t * @see {@link https://www.i18next.com/overview/api#t}\n\t * @returns The localized content.\n\t */\n\tpublic format<\n\t\tconst Key extends ParseKeys<Ns, TOpt, undefined>,\n\t\tconst TOpt extends TOptions = TOptions,\n\t\tNs extends Namespace = DefaultNamespace,\n\t\tRet extends TFunctionReturn<Ns, AppendKeyPrefix<Key, undefined>, TOpt> = TOpt['returnObjects'] extends true ? $SpecialObject : string,\n\t\tconst ActualOptions extends TOpt & InterpolationMap<Ret> = TOpt & InterpolationMap<Ret>\n\t>(\n\t\tlocale: string,\n\t\t...[key, defaultValueOrOptions, optionsOrUndefined]:\n\t\t\t| [key: Key | Key[], options?: ActualOptions]\n\t\t\t| [key: string | string[], options: TOpt & $Dictionary & { defaultValue: string }]\n\t\t\t| [key: string | string[], defaultValue: string | undefined, options?: TOpt & $Dictionary]\n\t): TFunctionReturnOptionalDetails<Ret, TOpt> {\n\t\tif (!this.languagesLoaded) throw new Error('Cannot call this method until InternationalizationHandler#init has been called');\n\n\t\tconst language = this.languages.get(locale);\n\t\tif (!language) throw new ReferenceError('Invalid language provided');\n\n\t\tconst defaultValue =\n\t\t\ttypeof defaultValueOrOptions === 'string'\n\t\t\t\t? defaultValueOrOptions\n\t\t\t\t: this.options.defaultMissingKey\n\t\t\t\t\t? language(this.options.defaultMissingKey, { replace: { key } })\n\t\t\t\t\t: '';\n\n\t\treturn language<Key, TOpt, Ret, ActualOptions>(key, { defaultValue, ...((optionsOrUndefined ?? {}) as TOpt) });\n\t}\n\n\t/**\n\t * @param directory The directory that should be walked.\n\t * @since 3.0.0\n\t */\n\tpublic async walkRootDirectory(directory: PathLike) {\n\t\tconst languages = new Set<string>();\n\t\tconst namespaces = new Set<string>();\n\n\t\tconst dir = await opendir(directory);\n\t\tfor await (const entry of dir) {\n\t\t\t// If the entry is not a directory, skip:\n\t\t\tif (!entry.isDirectory()) continue;\n\n\t\t\t// Load the directory:\n\t\t\tlanguages.add(entry.name);\n\n\t\t\tfor await (const namespace of this.walkLocaleDirectory(join(dir.path, entry.name), '')) {\n\t\t\t\tnamespaces.add(namespace);\n\t\t\t}\n\t\t}\n\n\t\treturn { namespaces: [...namespaces], languages: [...languages] };\n\t}\n\n\tpublic async reloadResources() {\n\t\tconst result = await Result.fromAsync(async () => {\n\t\t\tlet languages = this.options.hmr?.languages;\n\t\t\tlet namespaces = this.options.hmr?.namespaces;\n\t\t\tif (!languages || !namespaces) {\n\t\t\t\tconst languageDirectoryResult = await this.walkRootDirectory(this.languagesDirectory);\n\t\t\t\tlanguages ??= languageDirectoryResult.languages;\n\t\t\t\tnamespaces ??= languageDirectoryResult.namespaces;\n\t\t\t}\n\n\t\t\tawait i18next.reloadResources(languages, namespaces);\n\t\t\tcontainer.logger.info('[i18next-Plugin] Reloaded language resources.');\n\t\t});\n\n\t\tresult.inspectErr((error) => container.logger.error('[i18next-Plugin]: Failed to reload language resources.', error));\n\t}\n\n\t/**\n\t * @description Skips any files that don't end with `.json`.\n\t * @param directory The directory that should be walked.\n\t * @param ns The current namespace.\n\t * @since 3.0.0\n\t */\n\tprivate async *walkLocaleDirectory(directory: string, ns: string): AsyncGenerator<string> {\n\t\tconst dir = await opendir(directory);\n\t\tfor await (const entry of dir) {\n\t\t\tif (entry.isDirectory()) {\n\t\t\t\tyield* this.walkLocaleDirectory(join(dir.path, entry.name), `${ns}${entry.name}/`);\n\t\t\t} else if (entry.isFile() && entry.name.endsWith('.json')) {\n\t\t\t\tyield `${ns}${entry.name.slice(0, -5)}`;\n\t\t\t}\n\t\t}\n\t}\n}\n"]}

package/dist/cjs/lib/functions.cjs

@@ -121,5 +121,5 @@ exports.fetchLanguage = fetchLanguage;
 exports.fetchT = fetchT;
 exports.getLocalizedData = getLocalizedData;
 exports.resolveKey = resolveKey;
-//# sourceMappingURL=out.js.map
+//# sourceMappingURL=functions.cjs.map
 //# sourceMappingURL=functions.cjs.map

package/dist/cjs/lib/functions.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/lib/functions.ts"],"names":[],"mappings":"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","sourcesContent":["import { container } from '@sapphire/pieces';\nimport { lazy } from '@sapphire/utilities';\nimport { BaseInteraction, ChannelType, Guild, Locale, Message, type APIApplicationCommandOptionChoice, type LocaleString } from 'discord.js';\nimport type {\n\tAppendKeyPrefix,\n\tDefaultNamespace,\n\tInterpolationMap,\n\tNamespace,\n\tParseKeys,\n\tTFunctionReturn,\n\tTFunctionReturnOptionalDetails,\n\tTOptions\n} from 'i18next';\nimport type {\n\t$Dictionary,\n\t$SpecialObject,\n\tBuilderWithDescription,\n\tBuilderWithName,\n\tBuilderWithNameAndDescription,\n\tInternationalizationContext,\n\tLocalizedData,\n\tTarget\n} from './types';\n\n/**\n * Retrieves the language name for a specific target, using {@link InternationalizationHandler.fetchLanguage}.\n * If {@link InternationalizationHandler.fetchLanguage} is not defined or this function returns a nullish value,\n * then there will be a series of fallback attempts in the following descending order:\n * 1. Returns {@link Guild.preferredLocale}.\n * 2. Returns {@link InternationalizationOptions.defaultName} if no guild was provided.\n * 3. Returns `'en-US'` if nothing else was found.\n * @since 2.0.0\n * @param target The target to fetch the language from.\n * @see {@link resolveLanguage}\n * @returns The name of the language key.\n */\nexport function fetchLanguage(target: Target): Promise<string> {\n\t// Handle Interactions:\n\tif (target instanceof BaseInteraction) {\n\t\treturn resolveLanguage({\n\t\t\tuser: target.user,\n\t\t\tchannel: target.channel,\n\t\t\tguild: target.guild,\n\t\t\tinteractionGuildLocale: target.guildLocale,\n\t\t\tinteractionLocale: target.locale\n\t\t});\n\t}\n\n\t// Handle Message:\n\tif (target instanceof Message) {\n\t\treturn resolveLanguage({ user: target.author, channel: target.channel, guild: target.guild });\n\t}\n\n\t// Handle Guild:\n\tif (target instanceof Guild) {\n\t\treturn resolveLanguage({ user: null, channel: null, guild: target });\n\t}\n\n\t// Handle DMChannel:\n\tif (target.type === ChannelType.DM) {\n\t\treturn resolveLanguage({ user: null, channel: target, guild: null });\n\t}\n\n\t// Handle any other channel:\n\treturn resolveLanguage({ user: null, channel: target, guild: target.guild });\n}\n\n/**\n * Retrieves the language-assigned function from i18next designated to a target's preferred language code.\n * @since 2.0.0\n * @param target The target to fetch the language from.\n * @returns The language function from i18next.\n */\nexport async function fetchT(target: Target) {\n\treturn container.i18n.getT(await fetchLanguage(target));\n}\n\n/**\n * Resolves a key and its parameters.\n * @since 2.0.0\n * @param target The target to fetch the language key from.\n * @param key The i18next key.\n * @param options The options to be passed to TFunction.\n * @returns The data that `key` held, processed by i18next.\n */\nexport async function resolveKey<\n\tconst Key extends ParseKeys<Ns, TOpt, undefined>,\n\tconst TOpt extends TOptions = TOptions,\n\tRet extends TFunctionReturn<Ns, AppendKeyPrefix<Key, undefined>, TOpt> = TOpt['returnObjects'] extends true ? $SpecialObject : string,\n\tNs extends Namespace = DefaultNamespace,\n\tconst ActualOptions extends TOpt & InterpolationMap<Ret> = TOpt & InterpolationMap<Ret>\n>(\n\ttarget: Target,\n\t...[key, defaultValueOrOptions, optionsOrUndefined]:\n\t\t| [key: Key | Key[], options?: ActualOptions]\n\t\t| [key: string | string[], options: TOpt & $Dictionary & { defaultValue: string }]\n\t\t| [key: string | string[], defaultValue: string, options?: TOpt & $Dictionary]\n): Promise<TFunctionReturnOptionalDetails<Ret, TOpt>> {\n\tconst parsedOptions = typeof defaultValueOrOptions === 'string' ? optionsOrUndefined : defaultValueOrOptions;\n\tconst language = typeof parsedOptions?.lng === 'string' ? parsedOptions.lng : await fetchLanguage(target);\n\n\tif (typeof defaultValueOrOptions === 'string') {\n\t\treturn container.i18n.format<Key, TOpt, Ns, Ret, ActualOptions>(language, key, defaultValueOrOptions, optionsOrUndefined);\n\t}\n\n\treturn container.i18n.format<Key, TOpt, Ns, Ret, ActualOptions>(language, key, undefined, defaultValueOrOptions);\n}\n\n/**\n * @internal\n */\nasync function resolveLanguage(context: InternationalizationContext): Promise<string> {\n\tconst lang = await container.i18n.fetchLanguage(context);\n\treturn lang ?? context.guild?.preferredLocale ?? container.i18n.options.defaultName ?? 'en-US';\n}\n\nconst supportedLanguages = new Set(Object.values(Locale)) as ReadonlySet<LocaleString>;\n\nfunction isSupportedDiscordLocale(language: string): language is LocaleString {\n\treturn supportedLanguages.has(language as LocaleString);\n}\n\nconst getLocales = lazy(() => {\n\tconst locales = new Map(container.i18n.languages);\n\n\tfor (const [locale] of locales) {\n\t\tif (!isSupportedDiscordLocale(locale)) {\n\t\t\tprocess.emitWarning('Unsupported Discord locale', {\n\t\t\t\tcode: 'UNSUPPORTED_LOCALE',\n\t\t\t\tdetail: `'${locale}' needs to be one of: ${[...locales.keys()]}`\n\t\t\t});\n\n\t\t\tlocales.delete(locale);\n\t\t}\n\n\t\tcontinue;\n\t}\n\n\treturn locales;\n});\n\nconst getDefaultT = lazy(() => {\n\tconst defaultLocale = container.i18n.options.defaultName ?? 'en-US';\n\n\tif (!isSupportedDiscordLocale(defaultLocale)) {\n\t\tthrow new TypeError(`Unsupported Discord locale found:\\n'${defaultLocale}' is not within the list of ${[...supportedLanguages]}`);\n\t}\n\n\tconst defaultT = getLocales().get(defaultLocale);\n\n\tif (defaultT) {\n\t\treturn defaultT;\n\t}\n\n\tthrow new TypeError(`Could not find ${defaultLocale}`);\n});\n\n/**\n * Gets the value and the localizations from a language key.\n * @param key The key to get the localizations from.\n * @returns The retrieved data.\n * @remarks This should be called **strictly** after loading the locales.\n */\nexport function getLocalizedData<const TOpt extends TOptions = TOptions, Ns extends Namespace = DefaultNamespace, KPrefix = undefined>(\n\tkey: ParseKeys<Ns, TOpt, KPrefix>\n): LocalizedData {\n\tconst locales = getLocales();\n\tconst defaultT = getDefaultT();\n\n\treturn {\n\t\tvalue: defaultT(key),\n\t\tlocalizations: Object.fromEntries(Array.from(locales, ([locale, t]) => [locale, t(key)]))\n\t};\n}\n\n/**\n * Applies the localized names on the builder, calling `setName` and `setNameLocalizations`.\n * @param builder The builder to apply the localizations to.\n * @param key The key to get the localizations from.\n * @returns The updated builder.\n */\nexport function applyNameLocalizedBuilder<\n\tT extends BuilderWithName,\n\tconst TOpt extends TOptions = TOptions,\n\tNs extends Namespace = DefaultNamespace,\n\tKPrefix = undefined\n>(builder: T, key: ParseKeys<Ns, TOpt, KPrefix>) {\n\tconst result = getLocalizedData(key);\n\treturn builder.setName(result.value).setNameLocalizations(result.localizations);\n}\n\n/**\n * Applies the localized descriptions on the builder, calling `setDescription` and `setDescriptionLocalizations`.\n * @param builder The builder to apply the localizations to.\n * @param key The key to get the localizations from.\n * @returns The updated builder.\n */\nexport function applyDescriptionLocalizedBuilder<\n\tT extends BuilderWithDescription,\n\tconst TOpt extends TOptions = TOptions,\n\tNs extends Namespace = DefaultNamespace,\n\tKPrefix = undefined\n>(builder: T, key: ParseKeys<Ns, TOpt, KPrefix>) {\n\tconst result = getLocalizedData(key);\n\treturn builder.setDescription(result.value).setDescriptionLocalizations(result.localizations);\n}\n\n/**\n * Applies the localized names and descriptions on the builder, calling {@link applyNameLocalizedBuilder} and\n * {@link applyDescriptionLocalizedBuilder}.\n *\n * @param builder The builder to apply the localizations to.\n *\n * @param params The root key or the key for the name and description keys.\n * This needs to be either 1 or 2 parameters.\n * See examples below for more information.\n *\n * @returns The updated builder. You can chain subsequent builder methods on this.\n *\n * @remarks If only 2 parameters were passed, then this function will automatically append `Name` and `Description`\n *  to the root-key (wherein `root-key` is second parameter in the function, after `builder`)\n * passed through the second parameter.\n *\n * For example given `applyLocalizedBuilder(builder, 'userinfo')` the localized options will use the i18next keys\n * `userinfoName` and `userinfoDescription`.\n *\n * In the following example we provide all parameters and add a User Option\n * `applyLocalizedBuilder` needs either\n * @example\n * ```typescript\n * class UserInfoCommand extends Command {\n *   public registerApplicationCommands(registry: ChatInputCommand.Registry) {\n *     registry.registerChatInputCommand(\n *       (builder) =>\n *         applyLocalizedBuilder(builder, 'commands/names:userinfo', 'commands/descriptions:userinfo')\n *           .addUserOption(\n *             (input) => applyLocalizedBuilder(input, 'commands/options:userinfo-name', 'commands/options:userinfo-description').setRequired(true)\n *           )\n *     );\n *   }\n * }\n * ```\n *\n * In the following example we provide single root keys which means `Name` and `Description` get appended as mentioned above.\n * @example\n * ```typescript\n * class UserInfoCommand extends Command {\n *   public registerApplicationCommands(registry: ChatInputCommand.Registry) {\n *     registry.registerChatInputCommand(\n *       (builder) =>\n *         applyLocalizedBuilder(builder, 'commands:userinfo')\n *           .addUserOption(\n *             (input) => applyLocalizedBuilder(input, 'options:userinfo').setRequired(true)\n *           )\n *     );\n *   }\n * }\n * ```\n */\nexport function applyLocalizedBuilder<\n\tT extends BuilderWithNameAndDescription,\n\tconst TOpt extends TOptions = TOptions,\n\tNs extends Namespace = DefaultNamespace,\n\tKPrefix = undefined\n>(builder: T, ...params: [root: string] | [name: ParseKeys<Ns, TOpt, KPrefix>, description: ParseKeys<Ns, TOpt, KPrefix>]): T {\n\ttype LocalKeysType = ParseKeys<Ns, TOpt, KPrefix>;\n\n\tconst [localeName, localeDescription] =\n\t\tparams.length === 1 ? [`${params[0]}Name` as LocalKeysType, `${params[0]}Description` as LocalKeysType] : params;\n\n\tapplyNameLocalizedBuilder(builder, localeName);\n\tapplyDescriptionLocalizedBuilder(builder, localeDescription);\n\n\treturn builder;\n}\n\n/**\n * Constructs an object that can be passed into `setChoices` for String or Number option with localized names.\n *\n * @param key The i18next key for the name of the select option name.\n * @param options The additional Select Menu options. This should _at least_ include the `value` key.\n * @returns An object with anything provided through {@link createLocalizedChoice.options} with `name` and `name_localizations` added.\n *\n * @example\n * ```typescript\n * export class TypeCommand extends Command {\n *   public override registerApplicationCommands(registry: ChatInputCommand.Registry) {\n *     registry.registerChatInputCommand((builder) =>\n *       applyLocalizedBuilder(builder, 'commands/names:type').addStringOption((option) =>\n *         applyLocalizedBuilder(option, 'commands/options:type')\n *           .setRequired(true)\n *           .setChoices(\n *             createLocalizedChoice('selects/pokemon:type-grass', { value: 'grass' }),\n *             createLocalizedChoice('selects/pokemon:type-water', { value: 'water' }),\n *             createLocalizedChoice('selects/pokemon:type-fire', { value: 'fire' }),\n *             createLocalizedChoice('selects/pokemon:type-electric', { value: 'electric' })\n *           )\n *       )\n *     );\n *   }\n * }\n * ```\n */\nexport function createLocalizedChoice<\n\tValueType = string | number,\n\tconst TOpt extends TOptions = TOptions,\n\tNs extends Namespace = DefaultNamespace,\n\tKPrefix = undefined\n>(\n\tkey: ParseKeys<Ns, TOpt, KPrefix>,\n\toptions: Omit<APIApplicationCommandOptionChoice<ValueType>, 'name' | 'name_localizations'>\n): APIApplicationCommandOptionChoice<ValueType> {\n\tconst result = getLocalizedData(key);\n\n\treturn {\n\t\t...options,\n\t\tname: result.value,\n\t\tname_localizations: result.localizations\n\t};\n}\n"]}
+{"version":3,"sources":["../../../src/lib/functions.ts"],"names":["BaseInteraction","Message","Guild","ChannelType","container","Locale","lazy"],"mappings":";;;;;;;;AAoCO,SAAS,cAAc,MAAiC,EAAA;AAE9D,EAAA,IAAI,kBAAkBA,0BAAiB,EAAA;AACtC,IAAA,OAAO,eAAgB,CAAA;AAAA,MACtB,MAAM,MAAO,CAAA,IAAA;AAAA,MACb,SAAS,MAAO,CAAA,OAAA;AAAA,MAChB,OAAO,MAAO,CAAA,KAAA;AAAA,MACd,wBAAwB,MAAO,CAAA,WAAA;AAAA,MAC/B,mBAAmB,MAAO,CAAA,MAAA;AAAA,KAC1B,CAAA,CAAA;AAAA,GACF;AAGA,EAAA,IAAI,kBAAkBC,kBAAS,EAAA;AAC9B,IAAO,OAAA,eAAA,CAAgB,EAAE,IAAA,EAAM,MAAO,CAAA,MAAA,EAAQ,OAAS,EAAA,MAAA,CAAO,OAAS,EAAA,KAAA,EAAO,MAAO,CAAA,KAAA,EAAO,CAAA,CAAA;AAAA,GAC7F;AAGA,EAAA,IAAI,kBAAkBC,gBAAO,EAAA;AAC5B,IAAO,OAAA,eAAA,CAAgB,EAAE,IAAM,EAAA,IAAA,EAAM,SAAS,IAAM,EAAA,KAAA,EAAO,QAAQ,CAAA,CAAA;AAAA,GACpE;AAGA,EAAI,IAAA,MAAA,CAAO,IAAS,KAAAC,sBAAA,CAAY,EAAI,EAAA;AACnC,IAAO,OAAA,eAAA,CAAgB,EAAE,IAAM,EAAA,IAAA,EAAM,SAAS,MAAQ,EAAA,KAAA,EAAO,MAAM,CAAA,CAAA;AAAA,GACpE;AAGA,EAAO,OAAA,eAAA,CAAgB,EAAE,IAAM,EAAA,IAAA,EAAM,SAAS,MAAQ,EAAA,KAAA,EAAO,MAAO,CAAA,KAAA,EAAO,CAAA,CAAA;AAC5E,CAAA;AA7BgB,MAAA,CAAA,aAAA,EAAA,eAAA,CAAA,CAAA;AAqChB,eAAsB,OAAO,MAAgB,EAAA;AAC5C,EAAA,OAAOC,iBAAU,IAAK,CAAA,IAAA,CAAK,MAAM,aAAA,CAAc,MAAM,CAAC,CAAA,CAAA;AACvD,CAAA;AAFsB,MAAA,CAAA,MAAA,EAAA,QAAA,CAAA,CAAA;AAgEtB,eAAsB,WAOrB,MACG,EAAA,GAAA,CAAC,GAAK,EAAA,qBAAA,EAAuB,kBAAkB,CAIG,EAAA;AACrD,EAAA,MAAM,aAAgB,GAAA,OAAO,qBAA0B,KAAA,QAAA,GAAW,kBAAqB,GAAA,qBAAA,CAAA;AACvF,EAAM,MAAA,QAAA,GAAW,OAAO,aAAe,EAAA,GAAA,KAAQ,WAAW,aAAc,CAAA,GAAA,GAAM,MAAM,aAAA,CAAc,MAAM,CAAA,CAAA;AAExG,EAAI,IAAA,OAAO,0BAA0B,QAAU,EAAA;AAC9C,IAAA,OAAOA,iBAAU,IAAK,CAAA,MAAA,CAA0C,QAAU,EAAA,GAAA,EAAK,uBAAuB,kBAAkB,CAAA,CAAA;AAAA,GACzH;AAEA,EAAA,OAAOA,iBAAU,IAAK,CAAA,MAAA,CAA0C,QAAU,EAAA,GAAA,EAAK,QAAW,qBAAqB,CAAA,CAAA;AAChH,CAAA;AArBsB,MAAA,CAAA,UAAA,EAAA,YAAA,CAAA,CAAA;AA0BtB,eAAe,gBAAgB,OAAuD,EAAA;AACrF,EAAA,MAAM,IAAO,GAAA,MAAMA,gBAAU,CAAA,IAAA,CAAK,cAAc,OAAO,CAAA,CAAA;AACvD,EAAA,OAAO,QAAQ,OAAQ,CAAA,KAAA,EAAO,mBAAmBA,gBAAU,CAAA,IAAA,CAAK,QAAQ,WAAe,IAAA,OAAA,CAAA;AACxF,CAAA;AAHe,MAAA,CAAA,eAAA,EAAA,iBAAA,CAAA,CAAA;AAKf,IAAM,qBAAqB,IAAI,GAAA,CAAI,MAAO,CAAA,MAAA,CAAOC,iBAAM,CAAC,CAAA,CAAA;AAExD,SAAS,yBAAyB,QAA4C,EAAA;AAC7E,EAAO,OAAA,kBAAA,CAAmB,IAAI,QAAwB,CAAA,CAAA;AACvD,CAAA;AAFS,MAAA,CAAA,wBAAA,EAAA,0BAAA,CAAA,CAAA;AAIT,IAAM,UAAA,GAAaC,eAAK,MAAM;AAC7B,EAAA,MAAM,OAAU,GAAA,IAAI,GAAI,CAAAF,gBAAA,CAAU,KAAK,SAAS,CAAA,CAAA;AAEhD,EAAW,KAAA,MAAA,CAAC,MAAM,CAAA,IAAK,OAAS,EAAA;AAC/B,IAAI,IAAA,CAAC,wBAAyB,CAAA,MAAM,CAAG,EAAA;AACtC,MAAA,OAAA,CAAQ,YAAY,4BAA8B,EAAA;AAAA,QACjD,IAAM,EAAA,oBAAA;AAAA,QACN,MAAA,EAAQ,IAAI,MAAM,CAAA,sBAAA,EAAyB,CAAC,GAAG,OAAA,CAAQ,IAAK,EAAC,CAAC,CAAA,CAAA;AAAA,OAC9D,CAAA,CAAA;AAED,MAAA,OAAA,CAAQ,OAAO,MAAM,CAAA,CAAA;AAAA,KACtB;AAEA,IAAA,SAAA;AAAA,GACD;AAEA,EAAO,OAAA,OAAA,CAAA;AACR,CAAC,CAAA,CAAA;AAED,IAAM,WAAA,GAAcE,eAAK,MAAM;AAC9B,EAAA,MAAM,aAAgB,GAAAF,gBAAA,CAAU,IAAK,CAAA,OAAA,CAAQ,WAAe,IAAA,OAAA,CAAA;AAE5D,EAAI,IAAA,CAAC,wBAAyB,CAAA,aAAa,CAAG,EAAA;AAC7C,IAAA,MAAM,IAAI,SAAU,CAAA,CAAA;AAAA,CAAA,EAAuC,aAAa,CAA+B,4BAAA,EAAA,CAAC,GAAG,kBAAkB,CAAC,CAAE,CAAA,CAAA,CAAA;AAAA,GACjI;AAEA,EAAA,MAAM,QAAW,GAAA,UAAA,EAAa,CAAA,GAAA,CAAI,aAAa,CAAA,CAAA;AAE/C,EAAA,IAAI,QAAU,EAAA;AACb,IAAO,OAAA,QAAA,CAAA;AAAA,GACR;AAEA,EAAA,MAAM,IAAI,SAAA,CAAU,CAAkB,eAAA,EAAA,aAAa,CAAE,CAAA,CAAA,CAAA;AACtD,CAAC,CAAA,CAAA;AAQM,SAAS,iBACf,GACgB,EAAA;AAChB,EAAA,MAAM,UAAU,UAAW,EAAA,CAAA;AAC3B,EAAA,MAAM,WAAW,WAAY,EAAA,CAAA;AAE7B,EAAO,OAAA;AAAA,IACN,KAAA,EAAO,SAAS,GAAG,CAAA;AAAA,IACnB,eAAe,MAAO,CAAA,WAAA,CAAY,KAAM,CAAA,IAAA,CAAK,SAAS,CAAC,CAAC,MAAQ,EAAA,CAAC,MAAM,CAAC,MAAA,EAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,CAAA;AAAA,GACzF,CAAA;AACD,CAAA;AAVgB,MAAA,CAAA,gBAAA,EAAA,kBAAA,CAAA,CAAA;AAkBT,SAAS,yBAAA,CAKd,SAAY,GAAmC,EAAA;AAChD,EAAM,MAAA,MAAA,GAAS,iBAAiB,GAAG,CAAA,CAAA;AACnC,EAAA,OAAO,QAAQ,OAAQ,CAAA,MAAA,CAAO,KAAK,CAAE,CAAA,oBAAA,CAAqB,OAAO,aAAa,CAAA,CAAA;AAC/E,CAAA;AARgB,MAAA,CAAA,yBAAA,EAAA,2BAAA,CAAA,CAAA;AAgBT,SAAS,gCAAA,CAKd,SAAY,GAAmC,EAAA;AAChD,EAAM,MAAA,MAAA,GAAS,iBAAiB,GAAG,CAAA,CAAA;AACnC,EAAA,OAAO,QAAQ,cAAe,CAAA,MAAA,CAAO,KAAK,CAAE,CAAA,2BAAA,CAA4B,OAAO,aAAa,CAAA,CAAA;AAC7F,CAAA;AARgB,MAAA,CAAA,gCAAA,EAAA,kCAAA,CAAA,CAAA;AA8DT,SAAS,qBAAA,CAKd,YAAe,MAA6G,EAAA;AAG7H,EAAA,MAAM,CAAC,UAAY,EAAA,iBAAiB,IACnC,MAAO,CAAA,MAAA,KAAW,IAAI,CAAC,CAAA,EAAG,MAAO,CAAA,CAAC,CAAC,CAAyB,IAAA,CAAA,EAAA,CAAA,EAAG,OAAO,CAAC,CAAC,aAA8B,CAAI,GAAA,MAAA,CAAA;AAE3G,EAAA,yBAAA,CAA0B,SAAS,UAAU,CAAA,CAAA;AAC7C,EAAA,gCAAA,CAAiC,SAAS,iBAAiB,CAAA,CAAA;AAE3D,EAAO,OAAA,OAAA,CAAA;AACR,CAAA;AAfgB,MAAA,CAAA,qBAAA,EAAA,uBAAA,CAAA,CAAA;AA4CT,SAAS,qBAAA,CAMf,KACA,OAC+C,EAAA;AAC/C,EAAM,MAAA,MAAA,GAAS,iBAAiB,GAAG,CAAA,CAAA;AAEnC,EAAO,OAAA;AAAA,IACN,GAAG,OAAA;AAAA,IACH,MAAM,MAAO,CAAA,KAAA;AAAA,IACb,oBAAoB,MAAO,CAAA,aAAA;AAAA,GAC5B,CAAA;AACD,CAAA;AAhBgB,MAAA,CAAA,qBAAA,EAAA,uBAAA,CAAA","file":"functions.cjs","sourcesContent":["import { container } from '@sapphire/pieces';\nimport { lazy } from '@sapphire/utilities';\nimport { BaseInteraction, ChannelType, Guild, Locale, Message, type APIApplicationCommandOptionChoice, type LocaleString } from 'discord.js';\nimport type {\n\tAppendKeyPrefix,\n\tDefaultNamespace,\n\tInterpolationMap,\n\tNamespace,\n\tParseKeys,\n\tTFunctionReturn,\n\tTFunctionReturnOptionalDetails,\n\tTOptions\n} from 'i18next';\nimport type {\n\t$Dictionary,\n\t$SpecialObject,\n\tBuilderWithDescription,\n\tBuilderWithName,\n\tBuilderWithNameAndDescription,\n\tInternationalizationContext,\n\tLocalizedData,\n\tTarget\n} from './types';\n\n/**\n * Retrieves the language name for a specific target, using {@link InternationalizationHandler.fetchLanguage}.\n * If {@link InternationalizationHandler.fetchLanguage} is not defined or this function returns a nullish value,\n * then there will be a series of fallback attempts in the following descending order:\n * 1. Returns {@link Guild.preferredLocale}.\n * 2. Returns {@link InternationalizationOptions.defaultName} if no guild was provided.\n * 3. Returns `'en-US'` if nothing else was found.\n * @since 2.0.0\n * @param target The target to fetch the language from.\n * @see {@link resolveLanguage}\n * @returns The name of the language key.\n */\nexport function fetchLanguage(target: Target): Promise<string> {\n\t// Handle Interactions:\n\tif (target instanceof BaseInteraction) {\n\t\treturn resolveLanguage({\n\t\t\tuser: target.user,\n\t\t\tchannel: target.channel,\n\t\t\tguild: target.guild,\n\t\t\tinteractionGuildLocale: target.guildLocale,\n\t\t\tinteractionLocale: target.locale\n\t\t});\n\t}\n\n\t// Handle Message:\n\tif (target instanceof Message) {\n\t\treturn resolveLanguage({ user: target.author, channel: target.channel, guild: target.guild });\n\t}\n\n\t// Handle Guild:\n\tif (target instanceof Guild) {\n\t\treturn resolveLanguage({ user: null, channel: null, guild: target });\n\t}\n\n\t// Handle DMChannel:\n\tif (target.type === ChannelType.DM) {\n\t\treturn resolveLanguage({ user: null, channel: target, guild: null });\n\t}\n\n\t// Handle any other channel:\n\treturn resolveLanguage({ user: null, channel: target, guild: target.guild });\n}\n\n/**\n * Retrieves the language-assigned function from i18next designated to a target's preferred language code.\n * @since 2.0.0\n * @param target The target to fetch the language from.\n * @returns The language function from i18next.\n */\nexport async function fetchT(target: Target) {\n\treturn container.i18n.getT(await fetchLanguage(target));\n}\n\n/**\n * Resolves a key and its parameters.\n * @since 2.0.0\n * @param target The target to fetch the language key from.\n * @param key The i18next key.\n * @param options The options to be passed to TFunction.\n * @returns The data that `key` held, processed by i18next.\n */\nexport async function resolveKey<\n\tconst Key extends ParseKeys<Ns, TOpt, undefined>,\n\tconst TOpt extends TOptions = TOptions,\n\tRet extends TFunctionReturn<Ns, AppendKeyPrefix<Key, undefined>, TOpt> = TOpt['returnObjects'] extends true ? $SpecialObject : string,\n\tNs extends Namespace = DefaultNamespace,\n\tconst ActualOptions extends TOpt & InterpolationMap<Ret> = TOpt & InterpolationMap<Ret>\n>(target: Target, key: Key | Key[], options?: ActualOptions): Promise<TFunctionReturnOptionalDetails<Ret, TOpt>>;\n\n/**\n * Resolves a key and its parameters.\n * @since 2.0.0\n * @param target The target to fetch the language key from.\n * @param key The i18next key.\n * @param options The interpolation options as well as a `defaultValue` for the key and any key/value pairs.\n * @returns The data that `key` held, processed by i18next.\n */\nexport async function resolveKey<\n\tconst Key extends ParseKeys<Ns, TOpt, undefined>,\n\tconst TOpt extends TOptions = TOptions,\n\tRet extends TFunctionReturn<Ns, AppendKeyPrefix<Key, undefined>, TOpt> = TOpt['returnObjects'] extends true ? $SpecialObject : string,\n\tNs extends Namespace = DefaultNamespace,\n\tconst ActualOptions extends TOpt & InterpolationMap<Ret> = TOpt & InterpolationMap<Ret>\n>(target: Target, key: string | string[], options: TOpt & $Dictionary & { defaultValue: string }): Promise<TFunctionReturnOptionalDetails<Ret, TOpt>>;\n\n/**\n * Resolves a key and its parameters.\n * @since 2.0.0\n * @param target The target to fetch the language key from.\n * @param key The i18next key.\n * @param defaultValue The default value to use if the key is not found.\n * @param options The interpolation options.\n * @returns The data that `key` held, processed by i18next.\n */\nexport async function resolveKey<\n\tconst Key extends ParseKeys<Ns, TOpt, undefined>,\n\tconst TOpt extends TOptions = TOptions,\n\tRet extends TFunctionReturn<Ns, AppendKeyPrefix<Key, undefined>, TOpt> = TOpt['returnObjects'] extends true ? $SpecialObject : string,\n\tNs extends Namespace = DefaultNamespace,\n\tconst ActualOptions extends TOpt & InterpolationMap<Ret> = TOpt & InterpolationMap<Ret>\n>(target: Target, key: string | string[], defaultValue: string, options?: TOpt & $Dictionary): Promise<TFunctionReturnOptionalDetails<Ret, TOpt>>;\n\n/**\n * Resolves a key and its parameters.\n * @since 2.0.0\n * @param target The target to fetch the language key from.\n *\n * @remark This function also has additional parameters for `key`, `defaultValue`, and `options`, however\n * TSDoc does not let us document those while matching proper implementation. See the overloads for this method\n * for the documentation on those parameters.\n *\n * @returns The data that `key` held, processed by i18next.\n */\nexport async function resolveKey<\n\tconst Key extends ParseKeys<Ns, TOpt, undefined>,\n\tconst TOpt extends TOptions = TOptions,\n\tRet extends TFunctionReturn<Ns, AppendKeyPrefix<Key, undefined>, TOpt> = TOpt['returnObjects'] extends true ? $SpecialObject : string,\n\tNs extends Namespace = DefaultNamespace,\n\tconst ActualOptions extends TOpt & InterpolationMap<Ret> = TOpt & InterpolationMap<Ret>\n>(\n\ttarget: Target,\n\t...[key, defaultValueOrOptions, optionsOrUndefined]:\n\t\t| [key: Key | Key[], options?: ActualOptions]\n\t\t| [key: string | string[], options: TOpt & $Dictionary & { defaultValue: string }]\n\t\t| [key: string | string[], defaultValue: string, options?: TOpt & $Dictionary]\n): Promise<TFunctionReturnOptionalDetails<Ret, TOpt>> {\n\tconst parsedOptions = typeof defaultValueOrOptions === 'string' ? optionsOrUndefined : defaultValueOrOptions;\n\tconst language = typeof parsedOptions?.lng === 'string' ? parsedOptions.lng : await fetchLanguage(target);\n\n\tif (typeof defaultValueOrOptions === 'string') {\n\t\treturn container.i18n.format<Key, TOpt, Ns, Ret, ActualOptions>(language, key, defaultValueOrOptions, optionsOrUndefined);\n\t}\n\n\treturn container.i18n.format<Key, TOpt, Ns, Ret, ActualOptions>(language, key, undefined, defaultValueOrOptions);\n}\n\n/**\n * @internal\n */\nasync function resolveLanguage(context: InternationalizationContext): Promise<string> {\n\tconst lang = await container.i18n.fetchLanguage(context);\n\treturn lang ?? context.guild?.preferredLocale ?? container.i18n.options.defaultName ?? 'en-US';\n}\n\nconst supportedLanguages = new Set(Object.values(Locale)) as ReadonlySet<LocaleString>;\n\nfunction isSupportedDiscordLocale(language: string): language is LocaleString {\n\treturn supportedLanguages.has(language as LocaleString);\n}\n\nconst getLocales = lazy(() => {\n\tconst locales = new Map(container.i18n.languages);\n\n\tfor (const [locale] of locales) {\n\t\tif (!isSupportedDiscordLocale(locale)) {\n\t\t\tprocess.emitWarning('Unsupported Discord locale', {\n\t\t\t\tcode: 'UNSUPPORTED_LOCALE',\n\t\t\t\tdetail: `'${locale}' needs to be one of: ${[...locales.keys()]}`\n\t\t\t});\n\n\t\t\tlocales.delete(locale);\n\t\t}\n\n\t\tcontinue;\n\t}\n\n\treturn locales;\n});\n\nconst getDefaultT = lazy(() => {\n\tconst defaultLocale = container.i18n.options.defaultName ?? 'en-US';\n\n\tif (!isSupportedDiscordLocale(defaultLocale)) {\n\t\tthrow new TypeError(`Unsupported Discord locale found:\\n'${defaultLocale}' is not within the list of ${[...supportedLanguages]}`);\n\t}\n\n\tconst defaultT = getLocales().get(defaultLocale);\n\n\tif (defaultT) {\n\t\treturn defaultT;\n\t}\n\n\tthrow new TypeError(`Could not find ${defaultLocale}`);\n});\n\n/**\n * Gets the value and the localizations from a language key.\n * @param key The key to get the localizations from.\n * @returns The retrieved data.\n * @remarks This should be called **strictly** after loading the locales.\n */\nexport function getLocalizedData<const TOpt extends TOptions = TOptions, Ns extends Namespace = DefaultNamespace, KPrefix = undefined>(\n\tkey: ParseKeys<Ns, TOpt, KPrefix>\n): LocalizedData {\n\tconst locales = getLocales();\n\tconst defaultT = getDefaultT();\n\n\treturn {\n\t\tvalue: defaultT(key),\n\t\tlocalizations: Object.fromEntries(Array.from(locales, ([locale, t]) => [locale, t(key)]))\n\t};\n}\n\n/**\n * Applies the localized names on the builder, calling `setName` and `setNameLocalizations`.\n * @param builder The builder to apply the localizations to.\n * @param key The key to get the localizations from.\n * @returns The updated builder.\n */\nexport function applyNameLocalizedBuilder<\n\tT extends BuilderWithName,\n\tconst TOpt extends TOptions = TOptions,\n\tNs extends Namespace = DefaultNamespace,\n\tKPrefix = undefined\n>(builder: T, key: ParseKeys<Ns, TOpt, KPrefix>) {\n\tconst result = getLocalizedData(key);\n\treturn builder.setName(result.value).setNameLocalizations(result.localizations);\n}\n\n/**\n * Applies the localized descriptions on the builder, calling `setDescription` and `setDescriptionLocalizations`.\n * @param builder The builder to apply the localizations to.\n * @param key The key to get the localizations from.\n * @returns The updated builder.\n */\nexport function applyDescriptionLocalizedBuilder<\n\tT extends BuilderWithDescription,\n\tconst TOpt extends TOptions = TOptions,\n\tNs extends Namespace = DefaultNamespace,\n\tKPrefix = undefined\n>(builder: T, key: ParseKeys<Ns, TOpt, KPrefix>) {\n\tconst result = getLocalizedData(key);\n\treturn builder.setDescription(result.value).setDescriptionLocalizations(result.localizations);\n}\n\n/**\n * Applies the localized names and descriptions on the builder, calling {@link applyNameLocalizedBuilder} and\n * {@link applyDescriptionLocalizedBuilder}.\n *\n * @param builder The builder to apply the localizations to.\n *\n * @param params The root key or the key for the name and description keys.\n * This needs to be either 1 or 2 parameters.\n * See examples below for more information.\n *\n * @returns The updated builder. You can chain subsequent builder methods on this.\n *\n * @remarks If only 2 parameters were passed, then this function will automatically append `Name` and `Description`\n *  to the root-key (wherein `root-key` is second parameter in the function, after `builder`)\n * passed through the second parameter.\n *\n * For example given `applyLocalizedBuilder(builder, 'userinfo')` the localized options will use the i18next keys\n * `userinfoName` and `userinfoDescription`.\n *\n * In the following example we provide all parameters and add a User Option\n * `applyLocalizedBuilder` needs either\n * @example\n * ```typescript\n * class UserInfoCommand extends Command {\n *   public registerApplicationCommands(registry: ChatInputCommand.Registry) {\n *     registry.registerChatInputCommand(\n *       (builder) =>\n *         applyLocalizedBuilder(builder, 'commands/names:userinfo', 'commands/descriptions:userinfo')\n *           .addUserOption(\n *             (input) => applyLocalizedBuilder(input, 'commands/options:userinfo-name', 'commands/options:userinfo-description').setRequired(true)\n *           )\n *     );\n *   }\n * }\n * ```\n *\n * In the following example we provide single root keys which means `Name` and `Description` get appended as mentioned above.\n * @example\n * ```typescript\n * class UserInfoCommand extends Command {\n *   public registerApplicationCommands(registry: ChatInputCommand.Registry) {\n *     registry.registerChatInputCommand(\n *       (builder) =>\n *         applyLocalizedBuilder(builder, 'commands:userinfo')\n *           .addUserOption(\n *             (input) => applyLocalizedBuilder(input, 'options:userinfo').setRequired(true)\n *           )\n *     );\n *   }\n * }\n * ```\n */\nexport function applyLocalizedBuilder<\n\tT extends BuilderWithNameAndDescription,\n\tconst TOpt extends TOptions = TOptions,\n\tNs extends Namespace = DefaultNamespace,\n\tKPrefix = undefined\n>(builder: T, ...params: [root: string] | [name: ParseKeys<Ns, TOpt, KPrefix>, description: ParseKeys<Ns, TOpt, KPrefix>]): T {\n\ttype LocalKeysType = ParseKeys<Ns, TOpt, KPrefix>;\n\n\tconst [localeName, localeDescription] =\n\t\tparams.length === 1 ? [`${params[0]}Name` as LocalKeysType, `${params[0]}Description` as LocalKeysType] : params;\n\n\tapplyNameLocalizedBuilder(builder, localeName);\n\tapplyDescriptionLocalizedBuilder(builder, localeDescription);\n\n\treturn builder;\n}\n\n/**\n * Constructs an object that can be passed into `setChoices` for String or Number option with localized names.\n *\n * @param key The i18next key for the name of the select option name.\n * @param options The additional Select Menu options. This should _at least_ include the `value` key.\n * @returns An object with anything provided through {@link createLocalizedChoice.options} with `name` and `name_localizations` added.\n *\n * @example\n * ```typescript\n * export class TypeCommand extends Command {\n *   public override registerApplicationCommands(registry: ChatInputCommand.Registry) {\n *     registry.registerChatInputCommand((builder) =>\n *       applyLocalizedBuilder(builder, 'commands/names:type').addStringOption((option) =>\n *         applyLocalizedBuilder(option, 'commands/options:type')\n *           .setRequired(true)\n *           .setChoices(\n *             createLocalizedChoice('selects/pokemon:type-grass', { value: 'grass' }),\n *             createLocalizedChoice('selects/pokemon:type-water', { value: 'water' }),\n *             createLocalizedChoice('selects/pokemon:type-fire', { value: 'fire' }),\n *             createLocalizedChoice('selects/pokemon:type-electric', { value: 'electric' })\n *           )\n *       )\n *     );\n *   }\n * }\n * ```\n */\nexport function createLocalizedChoice<\n\tValueType = string | number,\n\tconst TOpt extends TOptions = TOptions,\n\tNs extends Namespace = DefaultNamespace,\n\tKPrefix = undefined\n>(\n\tkey: ParseKeys<Ns, TOpt, KPrefix>,\n\toptions: Omit<APIApplicationCommandOptionChoice<ValueType>, 'name' | 'name_localizations'>\n): APIApplicationCommandOptionChoice<ValueType> {\n\tconst result = getLocalizedData(key);\n\n\treturn {\n\t\t...options,\n\t\tname: result.value,\n\t\tname_localizations: result.localizations\n\t};\n}\n"]}

package/dist/cjs/lib/types.cjs

@@ -1,4 +1,4 @@
 'use strict';
 
-//# sourceMappingURL=out.js.map
+//# sourceMappingURL=types.cjs.map
 //# sourceMappingURL=types.cjs.map

package/dist/cjs/lib/types.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":""}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"types.cjs"}

package/dist/cjs/register.cjs

@@ -17,8 +17,7 @@ var _I18nextPlugin = class _I18nextPlugin extends framework.Plugin {
     if (this.options.i18n?.hmr?.enabled) {
       framework.container.logger.info("[i18next-Plugin]: HMR enabled. Watching for languages changes.");
       const hmr = chokidar.watch(framework.container.i18n.languagesDirectory, this.options.i18n.hmr.options);
-      for (const event of ["change", "unlink"])
-        hmr.on(event, () => framework.container.i18n.reloadResources());
+      for (const event of ["change", "unlink"]) hmr.on(event, () => framework.container.i18n.reloadResources());
     }
   }
 };
@@ -29,5 +28,5 @@ framework.SapphireClient.plugins.registerPreLoginHook(I18nextPlugin[framework.pr
 framework.SapphireClient.plugins.registerPostLoginHook(I18nextPlugin[framework.postLogin], "I18next-PostLogin");
 
 exports.I18nextPlugin = I18nextPlugin;
-//# sourceMappingURL=out.js.map
+//# sourceMappingURL=register.cjs.map
 //# sourceMappingURL=register.cjs.map

package/dist/cjs/register.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/register.ts"],"names":[],"mappings":";;;;AAAA,OAAO;AAEP,SAAS,QAAQ,gBAAgB,WAAW,WAAW,2BAA2B,gBAAgB;AAClG,SAAS,aAAa;AAEtB,SAAS,mCAAmC;AAErC,IAAM,iBAAN,MAAM,uBAAsB,OAAO;AAAA,EACzC,QAAe,yBAAyB,EAAwB,SAA8B;AAC7F,cAAU,OAAO,IAAI,4BAA4B,QAAQ,IAAI;AAAA,EAC9D;AAAA,EAEA,cAAqB,QAAQ,IAAuC;AACnE,UAAM,UAAU,KAAK,KAAK;AAAA,EAC3B;AAAA,EAEA,QAAe,SAAS,IAA8B;AACrD,QAAI,KAAK,QAAQ,MAAM,KAAK,SAAS;AACpC,gBAAU,OAAO,KAAK,gEAAgE;AACtF,YAAM,MAAM,MAAM,UAAU,KAAK,oBAAoB,KAAK,QAAQ,KAAK,IAAI,OAAO;AAElF,iBAAW,SAAS,CAAC,UAAU,QAAQ;AAAG,YAAI,GAAG,OAAO,MAAM,UAAU,KAAK,gBAAgB,CAAC;AAAA,IAC/F;AAAA,EACD;AACD;AAjB0C;AAAnC,IAAM,gBAAN;AAmBP,eAAe,QAAQ,+BAA+B,cAAc,yBAAyB,GAAG,mCAAmC;AACnI,eAAe,QAAQ,qBAAqB,cAAc,QAAQ,GAAG,kBAAkB;AACvF,eAAe,QAAQ,sBAAsB,cAAc,SAAS,GAAG,mBAAmB","sourcesContent":["import './index';\n\nimport { Plugin, SapphireClient, container, postLogin, preGenericsInitialization, preLogin } from '@sapphire/framework';\nimport { watch } from 'chokidar';\nimport type { ClientOptions } from 'discord.js';\nimport { InternationalizationHandler } from './index';\n\nexport class I18nextPlugin extends Plugin {\n\tpublic static [preGenericsInitialization](this: SapphireClient, options: ClientOptions): void {\n\t\tcontainer.i18n = new InternationalizationHandler(options.i18n);\n\t}\n\n\tpublic static async [preLogin](this: SapphireClient): Promise<void> {\n\t\tawait container.i18n.init();\n\t}\n\n\tpublic static [postLogin](this: SapphireClient): void {\n\t\tif (this.options.i18n?.hmr?.enabled) {\n\t\t\tcontainer.logger.info('[i18next-Plugin]: HMR enabled. Watching for languages changes.');\n\t\t\tconst hmr = watch(container.i18n.languagesDirectory, this.options.i18n.hmr.options);\n\n\t\t\tfor (const event of ['change', 'unlink']) hmr.on(event, () => container.i18n.reloadResources());\n\t\t}\n\t}\n}\n\nSapphireClient.plugins.registerPostInitializationHook(I18nextPlugin[preGenericsInitialization], 'I18next-PreGenericsInitialization');\nSapphireClient.plugins.registerPreLoginHook(I18nextPlugin[preLogin], 'I18next-PreLogin');\nSapphireClient.plugins.registerPostLoginHook(I18nextPlugin[postLogin], 'I18next-PostLogin');\n"]}
+{"version":3,"sources":["../../src/register.ts"],"names":["Plugin","preGenericsInitialization","container","InternationalizationHandler","preLogin","postLogin","watch","SapphireClient"],"mappings":";;;;;;;;AAOO,IAAM,cAAA,GAAN,MAAM,cAAA,SAAsBA,gBAAO,CAAA;AAAA,EACzC,QAAeC,mCAAyB,CAAA,CAAwB,OAA8B,EAAA;AAC7F,IAAAC,mBAAA,CAAU,IAAO,GAAA,IAAIC,qCAA4B,CAAA,OAAA,CAAQ,IAAI,CAAA,CAAA;AAAA,GAC9D;AAAA,EAEA,cAAqBC,kBAAQ,CAAuC,GAAA;AACnE,IAAM,MAAAF,mBAAA,CAAU,KAAK,IAAK,EAAA,CAAA;AAAA,GAC3B;AAAA,EAEA,QAAeG,mBAAS,CAA8B,GAAA;AACrD,IAAA,IAAI,IAAK,CAAA,OAAA,CAAQ,IAAM,EAAA,GAAA,EAAK,OAAS,EAAA;AACpC,MAAUH,mBAAA,CAAA,MAAA,CAAO,KAAK,gEAAgE,CAAA,CAAA;AACtF,MAAM,MAAA,GAAA,GAAMI,eAAMJ,mBAAU,CAAA,IAAA,CAAK,oBAAoB,IAAK,CAAA,OAAA,CAAQ,IAAK,CAAA,GAAA,CAAI,OAAO,CAAA,CAAA;AAElF,MAAA,KAAA,MAAW,KAAS,IAAA,CAAC,QAAU,EAAA,QAAQ,CAAG,EAAA,GAAA,CAAI,EAAG,CAAA,KAAA,EAAO,MAAMA,mBAAA,CAAU,IAAK,CAAA,eAAA,EAAiB,CAAA,CAAA;AAAA,KAC/F;AAAA,GACD;AACD,CAAA,CAAA;AAjB0C,MAAA,CAAA,cAAA,EAAA,eAAA,CAAA,CAAA;AAAnC,IAAM,aAAN,GAAA,eAAA;AAmBPK,wBAAA,CAAe,OAAQ,CAAA,8BAAA,CAA+B,aAAc,CAAAN,mCAAyB,GAAG,mCAAmC,CAAA,CAAA;AACnIM,wBAAA,CAAe,OAAQ,CAAA,oBAAA,CAAqB,aAAc,CAAAH,kBAAQ,GAAG,kBAAkB,CAAA,CAAA;AACvFG,wBAAA,CAAe,OAAQ,CAAA,qBAAA,CAAsB,aAAc,CAAAF,mBAAS,GAAG,mBAAmB,CAAA","file":"register.cjs","sourcesContent":["import './index';\n\nimport { Plugin, SapphireClient, container, postLogin, preGenericsInitialization, preLogin } from '@sapphire/framework';\nimport { watch } from 'chokidar';\nimport type { ClientOptions } from 'discord.js';\nimport { InternationalizationHandler } from './index';\n\nexport class I18nextPlugin extends Plugin {\n\tpublic static [preGenericsInitialization](this: SapphireClient, options: ClientOptions): void {\n\t\tcontainer.i18n = new InternationalizationHandler(options.i18n);\n\t}\n\n\tpublic static async [preLogin](this: SapphireClient): Promise<void> {\n\t\tawait container.i18n.init();\n\t}\n\n\tpublic static [postLogin](this: SapphireClient): void {\n\t\tif (this.options.i18n?.hmr?.enabled) {\n\t\t\tcontainer.logger.info('[i18next-Plugin]: HMR enabled. Watching for languages changes.');\n\t\t\tconst hmr = watch(container.i18n.languagesDirectory, this.options.i18n.hmr.options);\n\n\t\t\tfor (const event of ['change', 'unlink']) hmr.on(event, () => container.i18n.reloadResources());\n\t\t}\n\t}\n}\n\nSapphireClient.plugins.registerPostInitializationHook(I18nextPlugin[preGenericsInitialization], 'I18next-PreGenericsInitialization');\nSapphireClient.plugins.registerPreLoginHook(I18nextPlugin[preLogin], 'I18next-PreLogin');\nSapphireClient.plugins.registerPostLoginHook(I18nextPlugin[postLogin], 'I18next-PostLogin');\n"]}

package/dist/esm/{chunk-6QB3UK4Q.mjs → chunk-2JTKI4GS.mjs}

@@ -1,11 +1,8 @@
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
-var __publicField = (obj, key, value) => {
-  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-  return value;
-};
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 
 export { __name, __publicField };
-//# sourceMappingURL=out.js.map
-//# sourceMappingURL=chunk-6QB3UK4Q.mjs.map
+//# sourceMappingURL=chunk-2JTKI4GS.mjs.map
+//# sourceMappingURL=chunk-2JTKI4GS.mjs.map

package/dist/esm/chunk-2JTKI4GS.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"chunk-2JTKI4GS.mjs"}

package/dist/esm/index.d.mts

@@ -282,9 +282,30 @@ declare class InternationalizationHandler {
      * @see {@link https://www.i18next.com/overview/api#t}
      * @returns The localized content.
      */
-    format<const Key extends ParseKeys<Ns, TOpt, undefined>, const TOpt extends TOptions = TOptions, Ns extends Namespace = DefaultNamespace, Ret extends TFunctionReturn<Ns, AppendKeyPrefix<Key, undefined>, TOpt> = TOpt['returnObjects'] extends true ? $SpecialObject : string, const ActualOptions extends TOpt & InterpolationMap<Ret> = TOpt & InterpolationMap<Ret>>(locale: string, ...[key, defaultValueOrOptions, optionsOrUndefined]: [key: Key | Key[], options?: ActualOptions] | [key: string | string[], options: TOpt & $Dictionary & {
+    format<const Key extends ParseKeys<Ns, TOpt, undefined>, const TOpt extends TOptions = TOptions, Ns extends Namespace = DefaultNamespace, Ret extends TFunctionReturn<Ns, AppendKeyPrefix<Key, undefined>, TOpt> = TOpt['returnObjects'] extends true ? $SpecialObject : string, const ActualOptions extends TOpt & InterpolationMap<Ret> = TOpt & InterpolationMap<Ret>>(locale: string, key: Key | Key[], options?: ActualOptions): TFunctionReturnOptionalDetails<Ret, TOpt>;
+    /**
+     * Localizes a content given one or more keys and i18next options.
+     * @since 2.0.0
+     * @param locale The language to be used.
+     * @param key The key or keys to retrieve the content from.
+     * @param options The interpolation options as well as a `defaultValue` for the key and any key/value pairs.
+     * @see {@link https://www.i18next.com/overview/api#t}
+     * @returns The localized content.
+     */
+    format<const Key extends ParseKeys<Ns, TOpt, undefined>, const TOpt extends TOptions = TOptions, Ns extends Namespace = DefaultNamespace, Ret extends TFunctionReturn<Ns, AppendKeyPrefix<Key, undefined>, TOpt> = TOpt['returnObjects'] extends true ? $SpecialObject : string, const ActualOptions extends TOpt & InterpolationMap<Ret> = TOpt & InterpolationMap<Ret>>(locale: string, key: string | string[], options: TOpt & $Dictionary & {
         defaultValue: string;
-    }] | [key: string | string[], defaultValue: string | undefined, options?: TOpt & $Dictionary]): TFunctionReturnOptionalDetails<Ret, TOpt>;
+    }): TFunctionReturnOptionalDetails<Ret, TOpt>;
+    /**
+     * Localizes a content given one or more keys and i18next options.
+     * @since 2.0.0
+     * @param locale The language to be used.
+     * @param key The key or keys to retrieve the content from.
+     * @param defaultValue The default value to use if the key is not found.
+     * @param options The interpolation options.
+     * @see {@link https://www.i18next.com/overview/api#t}
+     * @returns The localized content.
+     */
+    format<const Key extends ParseKeys<Ns, TOpt, undefined>, const TOpt extends TOptions = TOptions, Ns extends Namespace = DefaultNamespace, Ret extends TFunctionReturn<Ns, AppendKeyPrefix<Key, undefined>, TOpt> = TOpt['returnObjects'] extends true ? $SpecialObject : string, const ActualOptions extends TOpt & InterpolationMap<Ret> = TOpt & InterpolationMap<Ret>>(locale: string, key: string | string[], defaultValue: string | undefined, options?: TOpt & $Dictionary): TFunctionReturnOptionalDetails<Ret, TOpt>;
     /**
      * @param directory The directory that should be walked.
      * @since 3.0.0
@@ -331,9 +352,28 @@ declare function fetchT(target: Target): Promise<i18next.TFunction<"translation"
  * @param options The options to be passed to TFunction.
  * @returns The data that `key` held, processed by i18next.
  */
-declare function resolveKey<const Key extends ParseKeys<Ns, TOpt, undefined>, const TOpt extends TOptions = TOptions, Ret extends TFunctionReturn<Ns, AppendKeyPrefix<Key, undefined>, TOpt> = TOpt['returnObjects'] extends true ? $SpecialObject : string, Ns extends Namespace = DefaultNamespace, const ActualOptions extends TOpt & InterpolationMap<Ret> = TOpt & InterpolationMap<Ret>>(target: Target, ...[key, defaultValueOrOptions, optionsOrUndefined]: [key: Key | Key[], options?: ActualOptions] | [key: string | string[], options: TOpt & $Dictionary & {
+declare function resolveKey<const Key extends ParseKeys<Ns, TOpt, undefined>, const TOpt extends TOptions = TOptions, Ret extends TFunctionReturn<Ns, AppendKeyPrefix<Key, undefined>, TOpt> = TOpt['returnObjects'] extends true ? $SpecialObject : string, Ns extends Namespace = DefaultNamespace, const ActualOptions extends TOpt & InterpolationMap<Ret> = TOpt & InterpolationMap<Ret>>(target: Target, key: Key | Key[], options?: ActualOptions): Promise<TFunctionReturnOptionalDetails<Ret, TOpt>>;
+/**
+ * Resolves a key and its parameters.
+ * @since 2.0.0
+ * @param target The target to fetch the language key from.
+ * @param key The i18next key.
+ * @param options The interpolation options as well as a `defaultValue` for the key and any key/value pairs.
+ * @returns The data that `key` held, processed by i18next.
+ */
+declare function resolveKey<const Key extends ParseKeys<Ns, TOpt, undefined>, const TOpt extends TOptions = TOptions, Ret extends TFunctionReturn<Ns, AppendKeyPrefix<Key, undefined>, TOpt> = TOpt['returnObjects'] extends true ? $SpecialObject : string, Ns extends Namespace = DefaultNamespace, const ActualOptions extends TOpt & InterpolationMap<Ret> = TOpt & InterpolationMap<Ret>>(target: Target, key: string | string[], options: TOpt & $Dictionary & {
     defaultValue: string;
-}] | [key: string | string[], defaultValue: string, options?: TOpt & $Dictionary]): Promise<TFunctionReturnOptionalDetails<Ret, TOpt>>;
+}): Promise<TFunctionReturnOptionalDetails<Ret, TOpt>>;
+/**
+ * Resolves a key and its parameters.
+ * @since 2.0.0
+ * @param target The target to fetch the language key from.
+ * @param key The i18next key.
+ * @param defaultValue The default value to use if the key is not found.
+ * @param options The interpolation options.
+ * @returns The data that `key` held, processed by i18next.
+ */
+declare function resolveKey<const Key extends ParseKeys<Ns, TOpt, undefined>, const TOpt extends TOptions = TOptions, Ret extends TFunctionReturn<Ns, AppendKeyPrefix<Key, undefined>, TOpt> = TOpt['returnObjects'] extends true ? $SpecialObject : string, Ns extends Namespace = DefaultNamespace, const ActualOptions extends TOpt & InterpolationMap<Ret> = TOpt & InterpolationMap<Ret>>(target: Target, key: string | string[], defaultValue: string, options?: TOpt & $Dictionary): Promise<TFunctionReturnOptionalDetails<Ret, TOpt>>;
 /**
  * Gets the value and the localizations from a language key.
  * @param key The key to get the localizations from.

package/dist/esm/index.mjs

@@ -1,11 +1,11 @@
-import './chunk-6QB3UK4Q.mjs';
+import './chunk-2JTKI4GS.mjs';
 export { default as i18next } from 'i18next';
 export * from './lib/InternationalizationHandler.mjs';
 export * from './lib/functions.mjs';
 export * from './lib/types.mjs';
 
-var version = "7.1.3-next.fae3a34.0";
+var version = "7.1.3-next.fc8c5ba";
 
 export { version };
-//# sourceMappingURL=out.js.map
+//# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/esm/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/index.ts"],"names":["default"],"mappings":";;;AAGA,SAAoB,WAAXA,gBAAyD;AAClE,cAAc;AACd,cAAc;AACd,cAAc;AAmBP,IAAM,UAAkB","sourcesContent":["import type { InternationalizationHandler } from './lib/InternationalizationHandler';\nimport type { InternationalizationClientOptions } from './lib/types';\n\nexport { default as i18next, type TFunction, type TOptions } from 'i18next';\nexport * from './lib/InternationalizationHandler';\nexport * from './lib/functions';\nexport * from './lib/types';\n\ndeclare module '@sapphire/pieces' {\n\tinterface Container {\n\t\ti18n: InternationalizationHandler;\n\t}\n}\n\ndeclare module 'discord.js' {\n\texport interface ClientOptions extends InternationalizationClientOptions {}\n}\n\n/**\n * The [@sapphire/plugin-i18next](https://github.com/sapphiredev/plugins/blob/main/packages/i18next) version that you are currently using.\n * An example use of this is showing it of in a bot information command.\n *\n * Note to Sapphire developers: This needs to explicitly be `string` so it is not typed as the string that gets replaced by esbuild\n */\n// eslint-disable-next-line @typescript-eslint/no-inferrable-types\nexport const version: string = '7.1.3-next.fae3a34.0';\n"]}
+{"version":3,"sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;AAyBO,IAAM,OAAkB,GAAA","file":"index.mjs","sourcesContent":["import type { InternationalizationHandler } from './lib/InternationalizationHandler';\nimport type { InternationalizationClientOptions } from './lib/types';\n\nexport { default as i18next, type TFunction, type TOptions } from 'i18next';\nexport * from './lib/InternationalizationHandler';\nexport * from './lib/functions';\nexport * from './lib/types';\n\ndeclare module '@sapphire/pieces' {\n\tinterface Container {\n\t\ti18n: InternationalizationHandler;\n\t}\n}\n\ndeclare module 'discord.js' {\n\texport interface ClientOptions extends InternationalizationClientOptions {}\n}\n\n/**\n * The [@sapphire/plugin-i18next](https://github.com/sapphiredev/plugins/blob/main/packages/i18next) version that you are currently using.\n * An example use of this is showing it of in a bot information command.\n *\n * Note to Sapphire developers: This needs to explicitly be `string` so it is not typed as the string that gets replaced by esbuild\n */\n// eslint-disable-next-line @typescript-eslint/no-inferrable-types\nexport const version: string = '7.1.3-next.fc8c5ba';\n"]}

package/dist/esm/lib/Augmentations.d.mjs

@@ -1,3 +1,3 @@
 
-//# sourceMappingURL=out.js.map
+//# sourceMappingURL=Augmentations.d.mjs.map
 //# sourceMappingURL=Augmentations.d.mjs.map

package/dist/esm/lib/Augmentations.d.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":""}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"Augmentations.d.mjs"}

package/dist/esm/lib/InternationalizationHandler.mjs

@@ -1,4 +1,4 @@
-import { __name, __publicField } from '../chunk-6QB3UK4Q.mjs';
+import { __name, __publicField } from '../chunk-2JTKI4GS.mjs';
 import { Result } from '@sapphire/framework';
 import { container, getRootData } from '@sapphire/pieces';
 import { isFunction } from '@sapphire/utilities';
@@ -134,10 +134,8 @@ var _InternationalizationHandler = class _InternationalizationHandler {
     const formatter = i18next.services.formatter;
     const formatters = this.options.formatters ?? [];
     for (const { name, format, cached } of formatters) {
-      if (cached)
-        formatter.addCached(name, format);
-      else
-        formatter.add(name, format);
+      if (cached) formatter.addCached(name, format);
+      else formatter.add(name, format);
     }
   }
   /**
@@ -146,28 +144,27 @@ var _InternationalizationHandler = class _InternationalizationHandler {
    * @since 1.0.0
    */
   getT(locale) {
-    if (!this.languagesLoaded)
-      throw new Error("Cannot call this method until InternationalizationHandler#init has been called");
+    if (!this.languagesLoaded) throw new Error("Cannot call this method until InternationalizationHandler#init has been called");
     const t = this.languages.get(locale);
-    if (t)
-      return t;
+    if (t) return t;
     throw new ReferenceError("Invalid language provided");
   }
   /**
    * Localizes a content given one or more keys and i18next options.
    * @since 2.0.0
    * @param locale The language to be used.
-   * @param key The key or keys to retrieve the content from.
-   * @param options The interpolation options.
+   *
+   * @remark This function also has additional parameters for `key`, `defaultValue`, and `options`, however
+   * TSDoc does not let us document those while matching proper implementation. See the overloads for this method
+   * for the documentation on those parameters.
+   *
    * @see {@link https://www.i18next.com/overview/api#t}
    * @returns The localized content.
    */
   format(locale, ...[key, defaultValueOrOptions, optionsOrUndefined]) {
-    if (!this.languagesLoaded)
-      throw new Error("Cannot call this method until InternationalizationHandler#init has been called");
+    if (!this.languagesLoaded) throw new Error("Cannot call this method until InternationalizationHandler#init has been called");
     const language = this.languages.get(locale);
-    if (!language)
-      throw new ReferenceError("Invalid language provided");
+    if (!language) throw new ReferenceError("Invalid language provided");
     const defaultValue = typeof defaultValueOrOptions === "string" ? defaultValueOrOptions : this.options.defaultMissingKey ? language(this.options.defaultMissingKey, { replace: { key } }) : "";
     return language(key, { defaultValue, ...optionsOrUndefined ?? {} });
   }
@@ -180,8 +177,7 @@ var _InternationalizationHandler = class _InternationalizationHandler {
     const namespaces = /* @__PURE__ */ new Set();
     const dir = await opendir(directory);
     for await (const entry of dir) {
-      if (!entry.isDirectory())
-        continue;
+      if (!entry.isDirectory()) continue;
       languages.add(entry.name);
       for await (const namespace of this.walkLocaleDirectory(join(dir.path, entry.name), "")) {
         namespaces.add(namespace);
@@ -224,5 +220,5 @@ __name(_InternationalizationHandler, "InternationalizationHandler");
 var InternationalizationHandler = _InternationalizationHandler;
 
 export { InternationalizationHandler };
-//# sourceMappingURL=out.js.map
+//# sourceMappingURL=InternationalizationHandler.mjs.map
 //# sourceMappingURL=InternationalizationHandler.mjs.map

package/dist/esm/lib/InternationalizationHandler.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/lib/InternationalizationHandler.ts"],"names":[],"mappings":"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","sourcesContent":["import { Result } from '@sapphire/framework';\nimport { container, getRootData } from '@sapphire/pieces';\nimport { isFunction, type Awaitable } from '@sapphire/utilities';\nimport { Backend, type PathResolvable } from '@skyra/i18next-backend';\nimport i18next, {\n\ttype AppendKeyPrefix,\n\ttype DefaultNamespace,\n\ttype InterpolationMap,\n\ttype Namespace,\n\ttype ParseKeys,\n\ttype TFunction,\n\ttype TFunctionReturn,\n\ttype TFunctionReturnOptionalDetails,\n\ttype TOptions\n} from 'i18next';\nimport type { PathLike } from 'node:fs';\nimport { opendir } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { URL, fileURLToPath } from 'node:url';\nimport type { $Dictionary, $SpecialObject, InternationalizationContext, InternationalizationOptions } from './types';\n\n/**\n * A generalized class for handling `i18next` JSON files and their discovery.\n * @since 1.0.0\n */\nexport class InternationalizationHandler {\n\t/**\n\t * Describes whether {@link InternationalizationHandler.init} has been run and languages are loaded in {@link InternationalizationHandler.languages}.\n\t * @since 1.0.0\n\t */\n\tpublic languagesLoaded = false;\n\n\t/**\n\t * A `Set` of initially loaded namespaces.\n\t * @since 1.2.0\n\t */\n\tpublic namespaces = new Set<string>();\n\n\t/**\n\t * A `Map` of `i18next` language functions keyed by their language code.\n\t * @since 1.0.0\n\t */\n\tpublic readonly languages = new Map<string, TFunction>();\n\n\t/**\n\t * The options InternationalizationHandler was initialized with in the client.\n\t * @since 1.0.0\n\t */\n\tpublic readonly options: InternationalizationOptions;\n\n\t/**\n\t * The director passed to `@skyra/i18next-backend`.\n\t * Also used in {@link InternationalizationHandler.walkLanguageDirectory}.\n\t * @since 1.2.0\n\t */\n\tpublic readonly languagesDirectory: string;\n\n\t/**\n\t * The backend options for `@skyra/i18next-backend` used by `i18next`.\n\t * @since 1.0.0\n\t */\n\tprotected readonly backendOptions: Backend.Options;\n\n\t/**\n\t * @param options The options that `i18next`, `@skyra/i18next-backend`, and {@link InternationalizationHandler} should use.\n\t * @since 1.0.0\n\t * @constructor\n\t */\n\tpublic constructor(options?: InternationalizationOptions) {\n\t\tthis.options = options ?? { i18next: { ignoreJSONStructure: false } };\n\n\t\tconst baseUserDirectory =\n\t\t\tcontainer.client?.options?.baseUserDirectory instanceof URL\n\t\t\t\t? fileURLToPath(container.client?.options?.baseUserDirectory)\n\t\t\t\t: container.client?.options?.baseUserDirectory;\n\n\t\tthis.languagesDirectory = this.options.defaultLanguageDirectory ?? join(baseUserDirectory ?? getRootData().root, 'languages');\n\n\t\tconst languagePaths = new Set<PathResolvable>([\n\t\t\tjoin(this.languagesDirectory, '{{lng}}', '{{ns}}.json'), //\n\t\t\t...(options?.backend?.paths ?? [])\n\t\t]);\n\n\t\tthis.backendOptions = {\n\t\t\tpaths: [...languagePaths],\n\t\t\t...this.options.backend\n\t\t};\n\n\t\tif (isFunction(this.options.fetchLanguage)) {\n\t\t\tthis.fetchLanguage = this.options.fetchLanguage;\n\t\t}\n\t}\n\n\t/**\n\t * The method to be overridden by the developer.\n\t *\n\t * @note In the event that fetchLanguage is not defined or returns null / undefined, the defaulting from {@link fetchLanguage} will be used.\n\t * @since 2.0.0\n\t * @return A string for the desired language or null for no match.\n\t * @see {@link fetchLanguage}\n\t * @example\n\t * ```typescript\n\t * // Always use the same language (no per-guild configuration):\n\t * container.i18n.fetchLanguage = () => 'en-US';\n\t * ```\n\t * @example\n\t * ```typescript\n\t * // Retrieving the language from an SQL database:\n\t * container.i18n.fetchLanguage = async (context) => {\n\t *   const guild = await driver.getOne('SELECT language FROM public.guild WHERE id = $1', [context.guild.id]);\n\t *   return guild?.language ?? 'en-US';\n\t * };\n\t * ```\n\t * @example\n\t * ```typescript\n\t * // Retrieving the language from an ORM:\n\t * container.i18n.fetchLanguage = async (context) => {\n\t *   const guild = await driver.getRepository(GuildEntity).findOne({ id: context.guild.id });\n\t *   return guild?.language ?? 'en-US';\n\t * };\n\t * ```\n\t * @example\n\t * ```typescript\n\t * // Retrieving the language on a per channel basis, e.g. per user or guild channel (ORM example but same principles apply):\n\t * container.i18n.fetchLanguage = async (context) => {\n\t *   const channel = await driver.getRepository(ChannelEntity).findOne({ id: context.channel.id });\n\t *   return channel?.language ?? 'en-US';\n\t * };\n\t * ```\n\t */\n\tpublic fetchLanguage: (context: InternationalizationContext) => Awaitable<string | null> = () => null;\n\n\t/**\n\t * Initializes the handler by loading in the namespaces, passing the data to i18next, and filling in the {@link InternationalizationHandler#languages}.\n\t * @since 1.0.0\n\t */\n\tpublic async init() {\n\t\tconst { namespaces, languages } = await this.walkRootDirectory(this.languagesDirectory);\n\t\tconst userOptions = isFunction(this.options.i18next) ? this.options.i18next(namespaces, languages) : this.options.i18next;\n\t\tconst ignoreJSONStructure = userOptions?.ignoreJSONStructure ?? false;\n\t\tconst skipOnVariables = userOptions?.interpolation?.skipOnVariables ?? false;\n\n\t\ti18next.use(Backend);\n\t\tawait i18next.init({\n\t\t\tbackend: this.backendOptions,\n\t\t\tfallbackLng: this.options.defaultName ?? 'en-US',\n\t\t\tinitImmediate: false,\n\t\t\tinterpolation: {\n\t\t\t\tescapeValue: false,\n\t\t\t\t...userOptions?.interpolation,\n\t\t\t\tskipOnVariables\n\t\t\t},\n\t\t\tload: 'all',\n\t\t\tdefaultNS: 'default',\n\t\t\tns: namespaces,\n\t\t\tpreload: languages,\n\t\t\t...userOptions,\n\t\t\tignoreJSONStructure\n\t\t});\n\n\t\tthis.namespaces = new Set(namespaces);\n\t\tfor (const item of languages) {\n\t\t\tthis.languages.set(item, i18next.getFixedT(item));\n\t\t}\n\t\tthis.languagesLoaded = true;\n\n\t\tconst formatter = i18next.services.formatter!;\n\t\tconst formatters = this.options.formatters ?? [];\n\t\tfor (const { name, format, cached } of formatters) {\n\t\t\tif (cached) formatter.addCached(name, format);\n\t\t\telse formatter.add(name, format);\n\t\t}\n\t}\n\n\t/**\n\t * Retrieve a raw TFunction from the passed locale.\n\t * @param locale The language to be used.\n\t * @since 1.0.0\n\t */\n\tpublic getT(locale: string) {\n\t\tif (!this.languagesLoaded) throw new Error('Cannot call this method until InternationalizationHandler#init has been called');\n\n\t\tconst t = this.languages.get(locale);\n\t\tif (t) return t;\n\t\tthrow new ReferenceError('Invalid language provided');\n\t}\n\n\t/**\n\t * Localizes a content given one or more keys and i18next options.\n\t * @since 2.0.0\n\t * @param locale The language to be used.\n\t * @param key The key or keys to retrieve the content from.\n\t * @param options The interpolation options.\n\t * @see {@link https://www.i18next.com/overview/api#t}\n\t * @returns The localized content.\n\t */\n\tpublic format<\n\t\tconst Key extends ParseKeys<Ns, TOpt, undefined>,\n\t\tconst TOpt extends TOptions = TOptions,\n\t\tNs extends Namespace = DefaultNamespace,\n\t\tRet extends TFunctionReturn<Ns, AppendKeyPrefix<Key, undefined>, TOpt> = TOpt['returnObjects'] extends true ? $SpecialObject : string,\n\t\tconst ActualOptions extends TOpt & InterpolationMap<Ret> = TOpt & InterpolationMap<Ret>\n\t>(\n\t\tlocale: string,\n\t\t...[key, defaultValueOrOptions, optionsOrUndefined]:\n\t\t\t| [key: Key | Key[], options?: ActualOptions]\n\t\t\t| [key: string | string[], options: TOpt & $Dictionary & { defaultValue: string }]\n\t\t\t| [key: string | string[], defaultValue: string | undefined, options?: TOpt & $Dictionary]\n\t): TFunctionReturnOptionalDetails<Ret, TOpt> {\n\t\tif (!this.languagesLoaded) throw new Error('Cannot call this method until InternationalizationHandler#init has been called');\n\n\t\tconst language = this.languages.get(locale);\n\t\tif (!language) throw new ReferenceError('Invalid language provided');\n\n\t\tconst defaultValue =\n\t\t\ttypeof defaultValueOrOptions === 'string'\n\t\t\t\t? defaultValueOrOptions\n\t\t\t\t: this.options.defaultMissingKey\n\t\t\t\t\t? language(this.options.defaultMissingKey, { replace: { key } })\n\t\t\t\t\t: '';\n\n\t\treturn language<Key, TOpt, Ret, ActualOptions>(key, { defaultValue, ...((optionsOrUndefined ?? {}) as TOpt) });\n\t}\n\n\t/**\n\t * @param directory The directory that should be walked.\n\t * @since 3.0.0\n\t */\n\tpublic async walkRootDirectory(directory: PathLike) {\n\t\tconst languages = new Set<string>();\n\t\tconst namespaces = new Set<string>();\n\n\t\tconst dir = await opendir(directory);\n\t\tfor await (const entry of dir) {\n\t\t\t// If the entry is not a directory, skip:\n\t\t\tif (!entry.isDirectory()) continue;\n\n\t\t\t// Load the directory:\n\t\t\tlanguages.add(entry.name);\n\n\t\t\tfor await (const namespace of this.walkLocaleDirectory(join(dir.path, entry.name), '')) {\n\t\t\t\tnamespaces.add(namespace);\n\t\t\t}\n\t\t}\n\n\t\treturn { namespaces: [...namespaces], languages: [...languages] };\n\t}\n\n\tpublic async reloadResources() {\n\t\tconst result = await Result.fromAsync(async () => {\n\t\t\tlet languages = this.options.hmr?.languages;\n\t\t\tlet namespaces = this.options.hmr?.namespaces;\n\t\t\tif (!languages || !namespaces) {\n\t\t\t\tconst languageDirectoryResult = await this.walkRootDirectory(this.languagesDirectory);\n\t\t\t\tlanguages ??= languageDirectoryResult.languages;\n\t\t\t\tnamespaces ??= languageDirectoryResult.namespaces;\n\t\t\t}\n\n\t\t\tawait i18next.reloadResources(languages, namespaces);\n\t\t\tcontainer.logger.info('[i18next-Plugin] Reloaded language resources.');\n\t\t});\n\n\t\tresult.inspectErr((error) => container.logger.error('[i18next-Plugin]: Failed to reload language resources.', error));\n\t}\n\n\t/**\n\t * @description Skips any files that don't end with `.json`.\n\t * @param directory The directory that should be walked.\n\t * @param ns The current namespace.\n\t * @since 3.0.0\n\t */\n\tprivate async *walkLocaleDirectory(directory: string, ns: string): AsyncGenerator<string> {\n\t\tconst dir = await opendir(directory);\n\t\tfor await (const entry of dir) {\n\t\t\tif (entry.isDirectory()) {\n\t\t\t\tyield* this.walkLocaleDirectory(join(dir.path, entry.name), `${ns}${entry.name}/`);\n\t\t\t} else if (entry.isFile() && entry.name.endsWith('.json')) {\n\t\t\t\tyield `${ns}${entry.name.slice(0, -5)}`;\n\t\t\t}\n\t\t}\n\t}\n}\n"]}
+{"version":3,"sources":["../../../src/lib/InternationalizationHandler.ts"],"names":[],"mappings":"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","file":"InternationalizationHandler.mjs","sourcesContent":["import { Result } from '@sapphire/framework';\nimport { container, getRootData } from '@sapphire/pieces';\nimport { isFunction, type Awaitable } from '@sapphire/utilities';\nimport { Backend, type PathResolvable } from '@skyra/i18next-backend';\nimport i18next, {\n\ttype AppendKeyPrefix,\n\ttype DefaultNamespace,\n\ttype InterpolationMap,\n\ttype Namespace,\n\ttype ParseKeys,\n\ttype TFunction,\n\ttype TFunctionReturn,\n\ttype TFunctionReturnOptionalDetails,\n\ttype TOptions\n} from 'i18next';\nimport type { PathLike } from 'node:fs';\nimport { opendir } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { URL, fileURLToPath } from 'node:url';\nimport type { $Dictionary, $SpecialObject, InternationalizationContext, InternationalizationOptions } from './types';\n\n/**\n * A generalized class for handling `i18next` JSON files and their discovery.\n * @since 1.0.0\n */\nexport class InternationalizationHandler {\n\t/**\n\t * Describes whether {@link InternationalizationHandler.init} has been run and languages are loaded in {@link InternationalizationHandler.languages}.\n\t * @since 1.0.0\n\t */\n\tpublic languagesLoaded = false;\n\n\t/**\n\t * A `Set` of initially loaded namespaces.\n\t * @since 1.2.0\n\t */\n\tpublic namespaces = new Set<string>();\n\n\t/**\n\t * A `Map` of `i18next` language functions keyed by their language code.\n\t * @since 1.0.0\n\t */\n\tpublic readonly languages = new Map<string, TFunction>();\n\n\t/**\n\t * The options InternationalizationHandler was initialized with in the client.\n\t * @since 1.0.0\n\t */\n\tpublic readonly options: InternationalizationOptions;\n\n\t/**\n\t * The director passed to `@skyra/i18next-backend`.\n\t * Also used in {@link InternationalizationHandler.walkLanguageDirectory}.\n\t * @since 1.2.0\n\t */\n\tpublic readonly languagesDirectory: string;\n\n\t/**\n\t * The backend options for `@skyra/i18next-backend` used by `i18next`.\n\t * @since 1.0.0\n\t */\n\tprotected readonly backendOptions: Backend.Options;\n\n\t/**\n\t * @param options The options that `i18next`, `@skyra/i18next-backend`, and {@link InternationalizationHandler} should use.\n\t * @since 1.0.0\n\t * @constructor\n\t */\n\tpublic constructor(options?: InternationalizationOptions) {\n\t\tthis.options = options ?? { i18next: { ignoreJSONStructure: false } };\n\n\t\tconst baseUserDirectory =\n\t\t\tcontainer.client?.options?.baseUserDirectory instanceof URL\n\t\t\t\t? fileURLToPath(container.client?.options?.baseUserDirectory)\n\t\t\t\t: container.client?.options?.baseUserDirectory;\n\n\t\tthis.languagesDirectory = this.options.defaultLanguageDirectory ?? join(baseUserDirectory ?? getRootData().root, 'languages');\n\n\t\tconst languagePaths = new Set<PathResolvable>([\n\t\t\tjoin(this.languagesDirectory, '{{lng}}', '{{ns}}.json'), //\n\t\t\t...(options?.backend?.paths ?? [])\n\t\t]);\n\n\t\tthis.backendOptions = {\n\t\t\tpaths: [...languagePaths],\n\t\t\t...this.options.backend\n\t\t};\n\n\t\tif (isFunction(this.options.fetchLanguage)) {\n\t\t\tthis.fetchLanguage = this.options.fetchLanguage;\n\t\t}\n\t}\n\n\t/**\n\t * The method to be overridden by the developer.\n\t *\n\t * @note In the event that fetchLanguage is not defined or returns null / undefined, the defaulting from {@link fetchLanguage} will be used.\n\t * @since 2.0.0\n\t * @return A string for the desired language or null for no match.\n\t * @see {@link fetchLanguage}\n\t * @example\n\t * ```typescript\n\t * // Always use the same language (no per-guild configuration):\n\t * container.i18n.fetchLanguage = () => 'en-US';\n\t * ```\n\t * @example\n\t * ```typescript\n\t * // Retrieving the language from an SQL database:\n\t * container.i18n.fetchLanguage = async (context) => {\n\t *   const guild = await driver.getOne('SELECT language FROM public.guild WHERE id = $1', [context.guild.id]);\n\t *   return guild?.language ?? 'en-US';\n\t * };\n\t * ```\n\t * @example\n\t * ```typescript\n\t * // Retrieving the language from an ORM:\n\t * container.i18n.fetchLanguage = async (context) => {\n\t *   const guild = await driver.getRepository(GuildEntity).findOne({ id: context.guild.id });\n\t *   return guild?.language ?? 'en-US';\n\t * };\n\t * ```\n\t * @example\n\t * ```typescript\n\t * // Retrieving the language on a per channel basis, e.g. per user or guild channel (ORM example but same principles apply):\n\t * container.i18n.fetchLanguage = async (context) => {\n\t *   const channel = await driver.getRepository(ChannelEntity).findOne({ id: context.channel.id });\n\t *   return channel?.language ?? 'en-US';\n\t * };\n\t * ```\n\t */\n\tpublic fetchLanguage: (context: InternationalizationContext) => Awaitable<string | null> = () => null;\n\n\t/**\n\t * Initializes the handler by loading in the namespaces, passing the data to i18next, and filling in the {@link InternationalizationHandler#languages}.\n\t * @since 1.0.0\n\t */\n\tpublic async init() {\n\t\tconst { namespaces, languages } = await this.walkRootDirectory(this.languagesDirectory);\n\t\tconst userOptions = isFunction(this.options.i18next) ? this.options.i18next(namespaces, languages) : this.options.i18next;\n\t\tconst ignoreJSONStructure = userOptions?.ignoreJSONStructure ?? false;\n\t\tconst skipOnVariables = userOptions?.interpolation?.skipOnVariables ?? false;\n\n\t\ti18next.use(Backend);\n\t\tawait i18next.init({\n\t\t\tbackend: this.backendOptions,\n\t\t\tfallbackLng: this.options.defaultName ?? 'en-US',\n\t\t\tinitImmediate: false,\n\t\t\tinterpolation: {\n\t\t\t\tescapeValue: false,\n\t\t\t\t...userOptions?.interpolation,\n\t\t\t\tskipOnVariables\n\t\t\t},\n\t\t\tload: 'all',\n\t\t\tdefaultNS: 'default',\n\t\t\tns: namespaces,\n\t\t\tpreload: languages,\n\t\t\t...userOptions,\n\t\t\tignoreJSONStructure\n\t\t});\n\n\t\tthis.namespaces = new Set(namespaces);\n\t\tfor (const item of languages) {\n\t\t\tthis.languages.set(item, i18next.getFixedT(item));\n\t\t}\n\t\tthis.languagesLoaded = true;\n\n\t\tconst formatter = i18next.services.formatter!;\n\t\tconst formatters = this.options.formatters ?? [];\n\t\tfor (const { name, format, cached } of formatters) {\n\t\t\tif (cached) formatter.addCached(name, format);\n\t\t\telse formatter.add(name, format);\n\t\t}\n\t}\n\n\t/**\n\t * Retrieve a raw TFunction from the passed locale.\n\t * @param locale The language to be used.\n\t * @since 1.0.0\n\t */\n\tpublic getT(locale: string) {\n\t\tif (!this.languagesLoaded) throw new Error('Cannot call this method until InternationalizationHandler#init has been called');\n\n\t\tconst t = this.languages.get(locale);\n\t\tif (t) return t;\n\t\tthrow new ReferenceError('Invalid language provided');\n\t}\n\n\t/**\n\t * Localizes a content given one or more keys and i18next options.\n\t * @since 2.0.0\n\t * @param locale The language to be used.\n\t * @param key The key or keys to retrieve the content from.\n\t * @param options The interpolation options.\n\t * @see {@link https://www.i18next.com/overview/api#t}\n\t * @returns The localized content.\n\t */\n\tpublic format<\n\t\tconst Key extends ParseKeys<Ns, TOpt, undefined>,\n\t\tconst TOpt extends TOptions = TOptions,\n\t\tNs extends Namespace = DefaultNamespace,\n\t\tRet extends TFunctionReturn<Ns, AppendKeyPrefix<Key, undefined>, TOpt> = TOpt['returnObjects'] extends true ? $SpecialObject : string,\n\t\tconst ActualOptions extends TOpt & InterpolationMap<Ret> = TOpt & InterpolationMap<Ret>\n\t>(locale: string, key: Key | Key[], options?: ActualOptions): TFunctionReturnOptionalDetails<Ret, TOpt>;\n\n\t/**\n\t * Localizes a content given one or more keys and i18next options.\n\t * @since 2.0.0\n\t * @param locale The language to be used.\n\t * @param key The key or keys to retrieve the content from.\n\t * @param options The interpolation options as well as a `defaultValue` for the key and any key/value pairs.\n\t * @see {@link https://www.i18next.com/overview/api#t}\n\t * @returns The localized content.\n\t */\n\tpublic format<\n\t\tconst Key extends ParseKeys<Ns, TOpt, undefined>,\n\t\tconst TOpt extends TOptions = TOptions,\n\t\tNs extends Namespace = DefaultNamespace,\n\t\tRet extends TFunctionReturn<Ns, AppendKeyPrefix<Key, undefined>, TOpt> = TOpt['returnObjects'] extends true ? $SpecialObject : string,\n\t\tconst ActualOptions extends TOpt & InterpolationMap<Ret> = TOpt & InterpolationMap<Ret>\n\t>(locale: string, key: string | string[], options: TOpt & $Dictionary & { defaultValue: string }): TFunctionReturnOptionalDetails<Ret, TOpt>;\n\n\t/**\n\t * Localizes a content given one or more keys and i18next options.\n\t * @since 2.0.0\n\t * @param locale The language to be used.\n\t * @param key The key or keys to retrieve the content from.\n\t * @param defaultValue The default value to use if the key is not found.\n\t * @param options The interpolation options.\n\t * @see {@link https://www.i18next.com/overview/api#t}\n\t * @returns The localized content.\n\t */\n\tpublic format<\n\t\tconst Key extends ParseKeys<Ns, TOpt, undefined>,\n\t\tconst TOpt extends TOptions = TOptions,\n\t\tNs extends Namespace = DefaultNamespace,\n\t\tRet extends TFunctionReturn<Ns, AppendKeyPrefix<Key, undefined>, TOpt> = TOpt['returnObjects'] extends true ? $SpecialObject : string,\n\t\tconst ActualOptions extends TOpt & InterpolationMap<Ret> = TOpt & InterpolationMap<Ret>\n\t>(\n\t\tlocale: string,\n\t\tkey: string | string[],\n\t\tdefaultValue: string | undefined,\n\t\toptions?: TOpt & $Dictionary\n\t): TFunctionReturnOptionalDetails<Ret, TOpt>;\n\n\t/**\n\t * Localizes a content given one or more keys and i18next options.\n\t * @since 2.0.0\n\t * @param locale The language to be used.\n\t *\n\t * @remark This function also has additional parameters for `key`, `defaultValue`, and `options`, however\n\t * TSDoc does not let us document those while matching proper implementation. See the overloads for this method\n\t * for the documentation on those parameters.\n\t *\n\t * @see {@link https://www.i18next.com/overview/api#t}\n\t * @returns The localized content.\n\t */\n\tpublic format<\n\t\tconst Key extends ParseKeys<Ns, TOpt, undefined>,\n\t\tconst TOpt extends TOptions = TOptions,\n\t\tNs extends Namespace = DefaultNamespace,\n\t\tRet extends TFunctionReturn<Ns, AppendKeyPrefix<Key, undefined>, TOpt> = TOpt['returnObjects'] extends true ? $SpecialObject : string,\n\t\tconst ActualOptions extends TOpt & InterpolationMap<Ret> = TOpt & InterpolationMap<Ret>\n\t>(\n\t\tlocale: string,\n\t\t...[key, defaultValueOrOptions, optionsOrUndefined]:\n\t\t\t| [key: Key | Key[], options?: ActualOptions]\n\t\t\t| [key: string | string[], options: TOpt & $Dictionary & { defaultValue: string }]\n\t\t\t| [key: string | string[], defaultValue: string | undefined, options?: TOpt & $Dictionary]\n\t): TFunctionReturnOptionalDetails<Ret, TOpt> {\n\t\tif (!this.languagesLoaded) throw new Error('Cannot call this method until InternationalizationHandler#init has been called');\n\n\t\tconst language = this.languages.get(locale);\n\t\tif (!language) throw new ReferenceError('Invalid language provided');\n\n\t\tconst defaultValue =\n\t\t\ttypeof defaultValueOrOptions === 'string'\n\t\t\t\t? defaultValueOrOptions\n\t\t\t\t: this.options.defaultMissingKey\n\t\t\t\t\t? language(this.options.defaultMissingKey, { replace: { key } })\n\t\t\t\t\t: '';\n\n\t\treturn language<Key, TOpt, Ret, ActualOptions>(key, { defaultValue, ...((optionsOrUndefined ?? {}) as TOpt) });\n\t}\n\n\t/**\n\t * @param directory The directory that should be walked.\n\t * @since 3.0.0\n\t */\n\tpublic async walkRootDirectory(directory: PathLike) {\n\t\tconst languages = new Set<string>();\n\t\tconst namespaces = new Set<string>();\n\n\t\tconst dir = await opendir(directory);\n\t\tfor await (const entry of dir) {\n\t\t\t// If the entry is not a directory, skip:\n\t\t\tif (!entry.isDirectory()) continue;\n\n\t\t\t// Load the directory:\n\t\t\tlanguages.add(entry.name);\n\n\t\t\tfor await (const namespace of this.walkLocaleDirectory(join(dir.path, entry.name), '')) {\n\t\t\t\tnamespaces.add(namespace);\n\t\t\t}\n\t\t}\n\n\t\treturn { namespaces: [...namespaces], languages: [...languages] };\n\t}\n\n\tpublic async reloadResources() {\n\t\tconst result = await Result.fromAsync(async () => {\n\t\t\tlet languages = this.options.hmr?.languages;\n\t\t\tlet namespaces = this.options.hmr?.namespaces;\n\t\t\tif (!languages || !namespaces) {\n\t\t\t\tconst languageDirectoryResult = await this.walkRootDirectory(this.languagesDirectory);\n\t\t\t\tlanguages ??= languageDirectoryResult.languages;\n\t\t\t\tnamespaces ??= languageDirectoryResult.namespaces;\n\t\t\t}\n\n\t\t\tawait i18next.reloadResources(languages, namespaces);\n\t\t\tcontainer.logger.info('[i18next-Plugin] Reloaded language resources.');\n\t\t});\n\n\t\tresult.inspectErr((error) => container.logger.error('[i18next-Plugin]: Failed to reload language resources.', error));\n\t}\n\n\t/**\n\t * @description Skips any files that don't end with `.json`.\n\t * @param directory The directory that should be walked.\n\t * @param ns The current namespace.\n\t * @since 3.0.0\n\t */\n\tprivate async *walkLocaleDirectory(directory: string, ns: string): AsyncGenerator<string> {\n\t\tconst dir = await opendir(directory);\n\t\tfor await (const entry of dir) {\n\t\t\tif (entry.isDirectory()) {\n\t\t\t\tyield* this.walkLocaleDirectory(join(dir.path, entry.name), `${ns}${entry.name}/`);\n\t\t\t} else if (entry.isFile() && entry.name.endsWith('.json')) {\n\t\t\t\tyield `${ns}${entry.name.slice(0, -5)}`;\n\t\t\t}\n\t\t}\n\t}\n}\n"]}

package/dist/esm/lib/functions.mjs

@@ -1,4 +1,4 @@
-import { __name } from '../chunk-6QB3UK4Q.mjs';
+import { __name } from '../chunk-2JTKI4GS.mjs';
 import { container } from '@sapphire/pieces';
 import { lazy } from '@sapphire/utilities';
 import { Locale, BaseInteraction, Message, Guild, ChannelType } from 'discord.js';
@@ -111,5 +111,5 @@ function createLocalizedChoice(key, options) {
 __name(createLocalizedChoice, "createLocalizedChoice");
 
 export { applyDescriptionLocalizedBuilder, applyLocalizedBuilder, applyNameLocalizedBuilder, createLocalizedChoice, fetchLanguage, fetchT, getLocalizedData, resolveKey };
-//# sourceMappingURL=out.js.map
+//# sourceMappingURL=functions.mjs.map
 //# sourceMappingURL=functions.mjs.map

package/dist/esm/lib/functions.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/lib/functions.ts"],"names":[],"mappings":"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","sourcesContent":["import { container } from '@sapphire/pieces';\nimport { lazy } from '@sapphire/utilities';\nimport { BaseInteraction, ChannelType, Guild, Locale, Message, type APIApplicationCommandOptionChoice, type LocaleString } from 'discord.js';\nimport type {\n\tAppendKeyPrefix,\n\tDefaultNamespace,\n\tInterpolationMap,\n\tNamespace,\n\tParseKeys,\n\tTFunctionReturn,\n\tTFunctionReturnOptionalDetails,\n\tTOptions\n} from 'i18next';\nimport type {\n\t$Dictionary,\n\t$SpecialObject,\n\tBuilderWithDescription,\n\tBuilderWithName,\n\tBuilderWithNameAndDescription,\n\tInternationalizationContext,\n\tLocalizedData,\n\tTarget\n} from './types';\n\n/**\n * Retrieves the language name for a specific target, using {@link InternationalizationHandler.fetchLanguage}.\n * If {@link InternationalizationHandler.fetchLanguage} is not defined or this function returns a nullish value,\n * then there will be a series of fallback attempts in the following descending order:\n * 1. Returns {@link Guild.preferredLocale}.\n * 2. Returns {@link InternationalizationOptions.defaultName} if no guild was provided.\n * 3. Returns `'en-US'` if nothing else was found.\n * @since 2.0.0\n * @param target The target to fetch the language from.\n * @see {@link resolveLanguage}\n * @returns The name of the language key.\n */\nexport function fetchLanguage(target: Target): Promise<string> {\n\t// Handle Interactions:\n\tif (target instanceof BaseInteraction) {\n\t\treturn resolveLanguage({\n\t\t\tuser: target.user,\n\t\t\tchannel: target.channel,\n\t\t\tguild: target.guild,\n\t\t\tinteractionGuildLocale: target.guildLocale,\n\t\t\tinteractionLocale: target.locale\n\t\t});\n\t}\n\n\t// Handle Message:\n\tif (target instanceof Message) {\n\t\treturn resolveLanguage({ user: target.author, channel: target.channel, guild: target.guild });\n\t}\n\n\t// Handle Guild:\n\tif (target instanceof Guild) {\n\t\treturn resolveLanguage({ user: null, channel: null, guild: target });\n\t}\n\n\t// Handle DMChannel:\n\tif (target.type === ChannelType.DM) {\n\t\treturn resolveLanguage({ user: null, channel: target, guild: null });\n\t}\n\n\t// Handle any other channel:\n\treturn resolveLanguage({ user: null, channel: target, guild: target.guild });\n}\n\n/**\n * Retrieves the language-assigned function from i18next designated to a target's preferred language code.\n * @since 2.0.0\n * @param target The target to fetch the language from.\n * @returns The language function from i18next.\n */\nexport async function fetchT(target: Target) {\n\treturn container.i18n.getT(await fetchLanguage(target));\n}\n\n/**\n * Resolves a key and its parameters.\n * @since 2.0.0\n * @param target The target to fetch the language key from.\n * @param key The i18next key.\n * @param options The options to be passed to TFunction.\n * @returns The data that `key` held, processed by i18next.\n */\nexport async function resolveKey<\n\tconst Key extends ParseKeys<Ns, TOpt, undefined>,\n\tconst TOpt extends TOptions = TOptions,\n\tRet extends TFunctionReturn<Ns, AppendKeyPrefix<Key, undefined>, TOpt> = TOpt['returnObjects'] extends true ? $SpecialObject : string,\n\tNs extends Namespace = DefaultNamespace,\n\tconst ActualOptions extends TOpt & InterpolationMap<Ret> = TOpt & InterpolationMap<Ret>\n>(\n\ttarget: Target,\n\t...[key, defaultValueOrOptions, optionsOrUndefined]:\n\t\t| [key: Key | Key[], options?: ActualOptions]\n\t\t| [key: string | string[], options: TOpt & $Dictionary & { defaultValue: string }]\n\t\t| [key: string | string[], defaultValue: string, options?: TOpt & $Dictionary]\n): Promise<TFunctionReturnOptionalDetails<Ret, TOpt>> {\n\tconst parsedOptions = typeof defaultValueOrOptions === 'string' ? optionsOrUndefined : defaultValueOrOptions;\n\tconst language = typeof parsedOptions?.lng === 'string' ? parsedOptions.lng : await fetchLanguage(target);\n\n\tif (typeof defaultValueOrOptions === 'string') {\n\t\treturn container.i18n.format<Key, TOpt, Ns, Ret, ActualOptions>(language, key, defaultValueOrOptions, optionsOrUndefined);\n\t}\n\n\treturn container.i18n.format<Key, TOpt, Ns, Ret, ActualOptions>(language, key, undefined, defaultValueOrOptions);\n}\n\n/**\n * @internal\n */\nasync function resolveLanguage(context: InternationalizationContext): Promise<string> {\n\tconst lang = await container.i18n.fetchLanguage(context);\n\treturn lang ?? context.guild?.preferredLocale ?? container.i18n.options.defaultName ?? 'en-US';\n}\n\nconst supportedLanguages = new Set(Object.values(Locale)) as ReadonlySet<LocaleString>;\n\nfunction isSupportedDiscordLocale(language: string): language is LocaleString {\n\treturn supportedLanguages.has(language as LocaleString);\n}\n\nconst getLocales = lazy(() => {\n\tconst locales = new Map(container.i18n.languages);\n\n\tfor (const [locale] of locales) {\n\t\tif (!isSupportedDiscordLocale(locale)) {\n\t\t\tprocess.emitWarning('Unsupported Discord locale', {\n\t\t\t\tcode: 'UNSUPPORTED_LOCALE',\n\t\t\t\tdetail: `'${locale}' needs to be one of: ${[...locales.keys()]}`\n\t\t\t});\n\n\t\t\tlocales.delete(locale);\n\t\t}\n\n\t\tcontinue;\n\t}\n\n\treturn locales;\n});\n\nconst getDefaultT = lazy(() => {\n\tconst defaultLocale = container.i18n.options.defaultName ?? 'en-US';\n\n\tif (!isSupportedDiscordLocale(defaultLocale)) {\n\t\tthrow new TypeError(`Unsupported Discord locale found:\\n'${defaultLocale}' is not within the list of ${[...supportedLanguages]}`);\n\t}\n\n\tconst defaultT = getLocales().get(defaultLocale);\n\n\tif (defaultT) {\n\t\treturn defaultT;\n\t}\n\n\tthrow new TypeError(`Could not find ${defaultLocale}`);\n});\n\n/**\n * Gets the value and the localizations from a language key.\n * @param key The key to get the localizations from.\n * @returns The retrieved data.\n * @remarks This should be called **strictly** after loading the locales.\n */\nexport function getLocalizedData<const TOpt extends TOptions = TOptions, Ns extends Namespace = DefaultNamespace, KPrefix = undefined>(\n\tkey: ParseKeys<Ns, TOpt, KPrefix>\n): LocalizedData {\n\tconst locales = getLocales();\n\tconst defaultT = getDefaultT();\n\n\treturn {\n\t\tvalue: defaultT(key),\n\t\tlocalizations: Object.fromEntries(Array.from(locales, ([locale, t]) => [locale, t(key)]))\n\t};\n}\n\n/**\n * Applies the localized names on the builder, calling `setName` and `setNameLocalizations`.\n * @param builder The builder to apply the localizations to.\n * @param key The key to get the localizations from.\n * @returns The updated builder.\n */\nexport function applyNameLocalizedBuilder<\n\tT extends BuilderWithName,\n\tconst TOpt extends TOptions = TOptions,\n\tNs extends Namespace = DefaultNamespace,\n\tKPrefix = undefined\n>(builder: T, key: ParseKeys<Ns, TOpt, KPrefix>) {\n\tconst result = getLocalizedData(key);\n\treturn builder.setName(result.value).setNameLocalizations(result.localizations);\n}\n\n/**\n * Applies the localized descriptions on the builder, calling `setDescription` and `setDescriptionLocalizations`.\n * @param builder The builder to apply the localizations to.\n * @param key The key to get the localizations from.\n * @returns The updated builder.\n */\nexport function applyDescriptionLocalizedBuilder<\n\tT extends BuilderWithDescription,\n\tconst TOpt extends TOptions = TOptions,\n\tNs extends Namespace = DefaultNamespace,\n\tKPrefix = undefined\n>(builder: T, key: ParseKeys<Ns, TOpt, KPrefix>) {\n\tconst result = getLocalizedData(key);\n\treturn builder.setDescription(result.value).setDescriptionLocalizations(result.localizations);\n}\n\n/**\n * Applies the localized names and descriptions on the builder, calling {@link applyNameLocalizedBuilder} and\n * {@link applyDescriptionLocalizedBuilder}.\n *\n * @param builder The builder to apply the localizations to.\n *\n * @param params The root key or the key for the name and description keys.\n * This needs to be either 1 or 2 parameters.\n * See examples below for more information.\n *\n * @returns The updated builder. You can chain subsequent builder methods on this.\n *\n * @remarks If only 2 parameters were passed, then this function will automatically append `Name` and `Description`\n *  to the root-key (wherein `root-key` is second parameter in the function, after `builder`)\n * passed through the second parameter.\n *\n * For example given `applyLocalizedBuilder(builder, 'userinfo')` the localized options will use the i18next keys\n * `userinfoName` and `userinfoDescription`.\n *\n * In the following example we provide all parameters and add a User Option\n * `applyLocalizedBuilder` needs either\n * @example\n * ```typescript\n * class UserInfoCommand extends Command {\n *   public registerApplicationCommands(registry: ChatInputCommand.Registry) {\n *     registry.registerChatInputCommand(\n *       (builder) =>\n *         applyLocalizedBuilder(builder, 'commands/names:userinfo', 'commands/descriptions:userinfo')\n *           .addUserOption(\n *             (input) => applyLocalizedBuilder(input, 'commands/options:userinfo-name', 'commands/options:userinfo-description').setRequired(true)\n *           )\n *     );\n *   }\n * }\n * ```\n *\n * In the following example we provide single root keys which means `Name` and `Description` get appended as mentioned above.\n * @example\n * ```typescript\n * class UserInfoCommand extends Command {\n *   public registerApplicationCommands(registry: ChatInputCommand.Registry) {\n *     registry.registerChatInputCommand(\n *       (builder) =>\n *         applyLocalizedBuilder(builder, 'commands:userinfo')\n *           .addUserOption(\n *             (input) => applyLocalizedBuilder(input, 'options:userinfo').setRequired(true)\n *           )\n *     );\n *   }\n * }\n * ```\n */\nexport function applyLocalizedBuilder<\n\tT extends BuilderWithNameAndDescription,\n\tconst TOpt extends TOptions = TOptions,\n\tNs extends Namespace = DefaultNamespace,\n\tKPrefix = undefined\n>(builder: T, ...params: [root: string] | [name: ParseKeys<Ns, TOpt, KPrefix>, description: ParseKeys<Ns, TOpt, KPrefix>]): T {\n\ttype LocalKeysType = ParseKeys<Ns, TOpt, KPrefix>;\n\n\tconst [localeName, localeDescription] =\n\t\tparams.length === 1 ? [`${params[0]}Name` as LocalKeysType, `${params[0]}Description` as LocalKeysType] : params;\n\n\tapplyNameLocalizedBuilder(builder, localeName);\n\tapplyDescriptionLocalizedBuilder(builder, localeDescription);\n\n\treturn builder;\n}\n\n/**\n * Constructs an object that can be passed into `setChoices` for String or Number option with localized names.\n *\n * @param key The i18next key for the name of the select option name.\n * @param options The additional Select Menu options. This should _at least_ include the `value` key.\n * @returns An object with anything provided through {@link createLocalizedChoice.options} with `name` and `name_localizations` added.\n *\n * @example\n * ```typescript\n * export class TypeCommand extends Command {\n *   public override registerApplicationCommands(registry: ChatInputCommand.Registry) {\n *     registry.registerChatInputCommand((builder) =>\n *       applyLocalizedBuilder(builder, 'commands/names:type').addStringOption((option) =>\n *         applyLocalizedBuilder(option, 'commands/options:type')\n *           .setRequired(true)\n *           .setChoices(\n *             createLocalizedChoice('selects/pokemon:type-grass', { value: 'grass' }),\n *             createLocalizedChoice('selects/pokemon:type-water', { value: 'water' }),\n *             createLocalizedChoice('selects/pokemon:type-fire', { value: 'fire' }),\n *             createLocalizedChoice('selects/pokemon:type-electric', { value: 'electric' })\n *           )\n *       )\n *     );\n *   }\n * }\n * ```\n */\nexport function createLocalizedChoice<\n\tValueType = string | number,\n\tconst TOpt extends TOptions = TOptions,\n\tNs extends Namespace = DefaultNamespace,\n\tKPrefix = undefined\n>(\n\tkey: ParseKeys<Ns, TOpt, KPrefix>,\n\toptions: Omit<APIApplicationCommandOptionChoice<ValueType>, 'name' | 'name_localizations'>\n): APIApplicationCommandOptionChoice<ValueType> {\n\tconst result = getLocalizedData(key);\n\n\treturn {\n\t\t...options,\n\t\tname: result.value,\n\t\tname_localizations: result.localizations\n\t};\n}\n"]}
+{"version":3,"sources":["../../../src/lib/functions.ts"],"names":[],"mappings":"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","file":"functions.mjs","sourcesContent":["import { container } from '@sapphire/pieces';\nimport { lazy } from '@sapphire/utilities';\nimport { BaseInteraction, ChannelType, Guild, Locale, Message, type APIApplicationCommandOptionChoice, type LocaleString } from 'discord.js';\nimport type {\n\tAppendKeyPrefix,\n\tDefaultNamespace,\n\tInterpolationMap,\n\tNamespace,\n\tParseKeys,\n\tTFunctionReturn,\n\tTFunctionReturnOptionalDetails,\n\tTOptions\n} from 'i18next';\nimport type {\n\t$Dictionary,\n\t$SpecialObject,\n\tBuilderWithDescription,\n\tBuilderWithName,\n\tBuilderWithNameAndDescription,\n\tInternationalizationContext,\n\tLocalizedData,\n\tTarget\n} from './types';\n\n/**\n * Retrieves the language name for a specific target, using {@link InternationalizationHandler.fetchLanguage}.\n * If {@link InternationalizationHandler.fetchLanguage} is not defined or this function returns a nullish value,\n * then there will be a series of fallback attempts in the following descending order:\n * 1. Returns {@link Guild.preferredLocale}.\n * 2. Returns {@link InternationalizationOptions.defaultName} if no guild was provided.\n * 3. Returns `'en-US'` if nothing else was found.\n * @since 2.0.0\n * @param target The target to fetch the language from.\n * @see {@link resolveLanguage}\n * @returns The name of the language key.\n */\nexport function fetchLanguage(target: Target): Promise<string> {\n\t// Handle Interactions:\n\tif (target instanceof BaseInteraction) {\n\t\treturn resolveLanguage({\n\t\t\tuser: target.user,\n\t\t\tchannel: target.channel,\n\t\t\tguild: target.guild,\n\t\t\tinteractionGuildLocale: target.guildLocale,\n\t\t\tinteractionLocale: target.locale\n\t\t});\n\t}\n\n\t// Handle Message:\n\tif (target instanceof Message) {\n\t\treturn resolveLanguage({ user: target.author, channel: target.channel, guild: target.guild });\n\t}\n\n\t// Handle Guild:\n\tif (target instanceof Guild) {\n\t\treturn resolveLanguage({ user: null, channel: null, guild: target });\n\t}\n\n\t// Handle DMChannel:\n\tif (target.type === ChannelType.DM) {\n\t\treturn resolveLanguage({ user: null, channel: target, guild: null });\n\t}\n\n\t// Handle any other channel:\n\treturn resolveLanguage({ user: null, channel: target, guild: target.guild });\n}\n\n/**\n * Retrieves the language-assigned function from i18next designated to a target's preferred language code.\n * @since 2.0.0\n * @param target The target to fetch the language from.\n * @returns The language function from i18next.\n */\nexport async function fetchT(target: Target) {\n\treturn container.i18n.getT(await fetchLanguage(target));\n}\n\n/**\n * Resolves a key and its parameters.\n * @since 2.0.0\n * @param target The target to fetch the language key from.\n * @param key The i18next key.\n * @param options The options to be passed to TFunction.\n * @returns The data that `key` held, processed by i18next.\n */\nexport async function resolveKey<\n\tconst Key extends ParseKeys<Ns, TOpt, undefined>,\n\tconst TOpt extends TOptions = TOptions,\n\tRet extends TFunctionReturn<Ns, AppendKeyPrefix<Key, undefined>, TOpt> = TOpt['returnObjects'] extends true ? $SpecialObject : string,\n\tNs extends Namespace = DefaultNamespace,\n\tconst ActualOptions extends TOpt & InterpolationMap<Ret> = TOpt & InterpolationMap<Ret>\n>(target: Target, key: Key | Key[], options?: ActualOptions): Promise<TFunctionReturnOptionalDetails<Ret, TOpt>>;\n\n/**\n * Resolves a key and its parameters.\n * @since 2.0.0\n * @param target The target to fetch the language key from.\n * @param key The i18next key.\n * @param options The interpolation options as well as a `defaultValue` for the key and any key/value pairs.\n * @returns The data that `key` held, processed by i18next.\n */\nexport async function resolveKey<\n\tconst Key extends ParseKeys<Ns, TOpt, undefined>,\n\tconst TOpt extends TOptions = TOptions,\n\tRet extends TFunctionReturn<Ns, AppendKeyPrefix<Key, undefined>, TOpt> = TOpt['returnObjects'] extends true ? $SpecialObject : string,\n\tNs extends Namespace = DefaultNamespace,\n\tconst ActualOptions extends TOpt & InterpolationMap<Ret> = TOpt & InterpolationMap<Ret>\n>(target: Target, key: string | string[], options: TOpt & $Dictionary & { defaultValue: string }): Promise<TFunctionReturnOptionalDetails<Ret, TOpt>>;\n\n/**\n * Resolves a key and its parameters.\n * @since 2.0.0\n * @param target The target to fetch the language key from.\n * @param key The i18next key.\n * @param defaultValue The default value to use if the key is not found.\n * @param options The interpolation options.\n * @returns The data that `key` held, processed by i18next.\n */\nexport async function resolveKey<\n\tconst Key extends ParseKeys<Ns, TOpt, undefined>,\n\tconst TOpt extends TOptions = TOptions,\n\tRet extends TFunctionReturn<Ns, AppendKeyPrefix<Key, undefined>, TOpt> = TOpt['returnObjects'] extends true ? $SpecialObject : string,\n\tNs extends Namespace = DefaultNamespace,\n\tconst ActualOptions extends TOpt & InterpolationMap<Ret> = TOpt & InterpolationMap<Ret>\n>(target: Target, key: string | string[], defaultValue: string, options?: TOpt & $Dictionary): Promise<TFunctionReturnOptionalDetails<Ret, TOpt>>;\n\n/**\n * Resolves a key and its parameters.\n * @since 2.0.0\n * @param target The target to fetch the language key from.\n *\n * @remark This function also has additional parameters for `key`, `defaultValue`, and `options`, however\n * TSDoc does not let us document those while matching proper implementation. See the overloads for this method\n * for the documentation on those parameters.\n *\n * @returns The data that `key` held, processed by i18next.\n */\nexport async function resolveKey<\n\tconst Key extends ParseKeys<Ns, TOpt, undefined>,\n\tconst TOpt extends TOptions = TOptions,\n\tRet extends TFunctionReturn<Ns, AppendKeyPrefix<Key, undefined>, TOpt> = TOpt['returnObjects'] extends true ? $SpecialObject : string,\n\tNs extends Namespace = DefaultNamespace,\n\tconst ActualOptions extends TOpt & InterpolationMap<Ret> = TOpt & InterpolationMap<Ret>\n>(\n\ttarget: Target,\n\t...[key, defaultValueOrOptions, optionsOrUndefined]:\n\t\t| [key: Key | Key[], options?: ActualOptions]\n\t\t| [key: string | string[], options: TOpt & $Dictionary & { defaultValue: string }]\n\t\t| [key: string | string[], defaultValue: string, options?: TOpt & $Dictionary]\n): Promise<TFunctionReturnOptionalDetails<Ret, TOpt>> {\n\tconst parsedOptions = typeof defaultValueOrOptions === 'string' ? optionsOrUndefined : defaultValueOrOptions;\n\tconst language = typeof parsedOptions?.lng === 'string' ? parsedOptions.lng : await fetchLanguage(target);\n\n\tif (typeof defaultValueOrOptions === 'string') {\n\t\treturn container.i18n.format<Key, TOpt, Ns, Ret, ActualOptions>(language, key, defaultValueOrOptions, optionsOrUndefined);\n\t}\n\n\treturn container.i18n.format<Key, TOpt, Ns, Ret, ActualOptions>(language, key, undefined, defaultValueOrOptions);\n}\n\n/**\n * @internal\n */\nasync function resolveLanguage(context: InternationalizationContext): Promise<string> {\n\tconst lang = await container.i18n.fetchLanguage(context);\n\treturn lang ?? context.guild?.preferredLocale ?? container.i18n.options.defaultName ?? 'en-US';\n}\n\nconst supportedLanguages = new Set(Object.values(Locale)) as ReadonlySet<LocaleString>;\n\nfunction isSupportedDiscordLocale(language: string): language is LocaleString {\n\treturn supportedLanguages.has(language as LocaleString);\n}\n\nconst getLocales = lazy(() => {\n\tconst locales = new Map(container.i18n.languages);\n\n\tfor (const [locale] of locales) {\n\t\tif (!isSupportedDiscordLocale(locale)) {\n\t\t\tprocess.emitWarning('Unsupported Discord locale', {\n\t\t\t\tcode: 'UNSUPPORTED_LOCALE',\n\t\t\t\tdetail: `'${locale}' needs to be one of: ${[...locales.keys()]}`\n\t\t\t});\n\n\t\t\tlocales.delete(locale);\n\t\t}\n\n\t\tcontinue;\n\t}\n\n\treturn locales;\n});\n\nconst getDefaultT = lazy(() => {\n\tconst defaultLocale = container.i18n.options.defaultName ?? 'en-US';\n\n\tif (!isSupportedDiscordLocale(defaultLocale)) {\n\t\tthrow new TypeError(`Unsupported Discord locale found:\\n'${defaultLocale}' is not within the list of ${[...supportedLanguages]}`);\n\t}\n\n\tconst defaultT = getLocales().get(defaultLocale);\n\n\tif (defaultT) {\n\t\treturn defaultT;\n\t}\n\n\tthrow new TypeError(`Could not find ${defaultLocale}`);\n});\n\n/**\n * Gets the value and the localizations from a language key.\n * @param key The key to get the localizations from.\n * @returns The retrieved data.\n * @remarks This should be called **strictly** after loading the locales.\n */\nexport function getLocalizedData<const TOpt extends TOptions = TOptions, Ns extends Namespace = DefaultNamespace, KPrefix = undefined>(\n\tkey: ParseKeys<Ns, TOpt, KPrefix>\n): LocalizedData {\n\tconst locales = getLocales();\n\tconst defaultT = getDefaultT();\n\n\treturn {\n\t\tvalue: defaultT(key),\n\t\tlocalizations: Object.fromEntries(Array.from(locales, ([locale, t]) => [locale, t(key)]))\n\t};\n}\n\n/**\n * Applies the localized names on the builder, calling `setName` and `setNameLocalizations`.\n * @param builder The builder to apply the localizations to.\n * @param key The key to get the localizations from.\n * @returns The updated builder.\n */\nexport function applyNameLocalizedBuilder<\n\tT extends BuilderWithName,\n\tconst TOpt extends TOptions = TOptions,\n\tNs extends Namespace = DefaultNamespace,\n\tKPrefix = undefined\n>(builder: T, key: ParseKeys<Ns, TOpt, KPrefix>) {\n\tconst result = getLocalizedData(key);\n\treturn builder.setName(result.value).setNameLocalizations(result.localizations);\n}\n\n/**\n * Applies the localized descriptions on the builder, calling `setDescription` and `setDescriptionLocalizations`.\n * @param builder The builder to apply the localizations to.\n * @param key The key to get the localizations from.\n * @returns The updated builder.\n */\nexport function applyDescriptionLocalizedBuilder<\n\tT extends BuilderWithDescription,\n\tconst TOpt extends TOptions = TOptions,\n\tNs extends Namespace = DefaultNamespace,\n\tKPrefix = undefined\n>(builder: T, key: ParseKeys<Ns, TOpt, KPrefix>) {\n\tconst result = getLocalizedData(key);\n\treturn builder.setDescription(result.value).setDescriptionLocalizations(result.localizations);\n}\n\n/**\n * Applies the localized names and descriptions on the builder, calling {@link applyNameLocalizedBuilder} and\n * {@link applyDescriptionLocalizedBuilder}.\n *\n * @param builder The builder to apply the localizations to.\n *\n * @param params The root key or the key for the name and description keys.\n * This needs to be either 1 or 2 parameters.\n * See examples below for more information.\n *\n * @returns The updated builder. You can chain subsequent builder methods on this.\n *\n * @remarks If only 2 parameters were passed, then this function will automatically append `Name` and `Description`\n *  to the root-key (wherein `root-key` is second parameter in the function, after `builder`)\n * passed through the second parameter.\n *\n * For example given `applyLocalizedBuilder(builder, 'userinfo')` the localized options will use the i18next keys\n * `userinfoName` and `userinfoDescription`.\n *\n * In the following example we provide all parameters and add a User Option\n * `applyLocalizedBuilder` needs either\n * @example\n * ```typescript\n * class UserInfoCommand extends Command {\n *   public registerApplicationCommands(registry: ChatInputCommand.Registry) {\n *     registry.registerChatInputCommand(\n *       (builder) =>\n *         applyLocalizedBuilder(builder, 'commands/names:userinfo', 'commands/descriptions:userinfo')\n *           .addUserOption(\n *             (input) => applyLocalizedBuilder(input, 'commands/options:userinfo-name', 'commands/options:userinfo-description').setRequired(true)\n *           )\n *     );\n *   }\n * }\n * ```\n *\n * In the following example we provide single root keys which means `Name` and `Description` get appended as mentioned above.\n * @example\n * ```typescript\n * class UserInfoCommand extends Command {\n *   public registerApplicationCommands(registry: ChatInputCommand.Registry) {\n *     registry.registerChatInputCommand(\n *       (builder) =>\n *         applyLocalizedBuilder(builder, 'commands:userinfo')\n *           .addUserOption(\n *             (input) => applyLocalizedBuilder(input, 'options:userinfo').setRequired(true)\n *           )\n *     );\n *   }\n * }\n * ```\n */\nexport function applyLocalizedBuilder<\n\tT extends BuilderWithNameAndDescription,\n\tconst TOpt extends TOptions = TOptions,\n\tNs extends Namespace = DefaultNamespace,\n\tKPrefix = undefined\n>(builder: T, ...params: [root: string] | [name: ParseKeys<Ns, TOpt, KPrefix>, description: ParseKeys<Ns, TOpt, KPrefix>]): T {\n\ttype LocalKeysType = ParseKeys<Ns, TOpt, KPrefix>;\n\n\tconst [localeName, localeDescription] =\n\t\tparams.length === 1 ? [`${params[0]}Name` as LocalKeysType, `${params[0]}Description` as LocalKeysType] : params;\n\n\tapplyNameLocalizedBuilder(builder, localeName);\n\tapplyDescriptionLocalizedBuilder(builder, localeDescription);\n\n\treturn builder;\n}\n\n/**\n * Constructs an object that can be passed into `setChoices` for String or Number option with localized names.\n *\n * @param key The i18next key for the name of the select option name.\n * @param options The additional Select Menu options. This should _at least_ include the `value` key.\n * @returns An object with anything provided through {@link createLocalizedChoice.options} with `name` and `name_localizations` added.\n *\n * @example\n * ```typescript\n * export class TypeCommand extends Command {\n *   public override registerApplicationCommands(registry: ChatInputCommand.Registry) {\n *     registry.registerChatInputCommand((builder) =>\n *       applyLocalizedBuilder(builder, 'commands/names:type').addStringOption((option) =>\n *         applyLocalizedBuilder(option, 'commands/options:type')\n *           .setRequired(true)\n *           .setChoices(\n *             createLocalizedChoice('selects/pokemon:type-grass', { value: 'grass' }),\n *             createLocalizedChoice('selects/pokemon:type-water', { value: 'water' }),\n *             createLocalizedChoice('selects/pokemon:type-fire', { value: 'fire' }),\n *             createLocalizedChoice('selects/pokemon:type-electric', { value: 'electric' })\n *           )\n *       )\n *     );\n *   }\n * }\n * ```\n */\nexport function createLocalizedChoice<\n\tValueType = string | number,\n\tconst TOpt extends TOptions = TOptions,\n\tNs extends Namespace = DefaultNamespace,\n\tKPrefix = undefined\n>(\n\tkey: ParseKeys<Ns, TOpt, KPrefix>,\n\toptions: Omit<APIApplicationCommandOptionChoice<ValueType>, 'name' | 'name_localizations'>\n): APIApplicationCommandOptionChoice<ValueType> {\n\tconst result = getLocalizedData(key);\n\n\treturn {\n\t\t...options,\n\t\tname: result.value,\n\t\tname_localizations: result.localizations\n\t};\n}\n"]}

package/dist/esm/lib/types.mjs

@@ -1,3 +1,3 @@
 
-//# sourceMappingURL=out.js.map
+//# sourceMappingURL=types.mjs.map
 //# sourceMappingURL=types.mjs.map

package/dist/esm/lib/types.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":""}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"types.mjs"}

package/dist/esm/register.mjs

@@ -1,4 +1,4 @@
-import { __name } from './chunk-6QB3UK4Q.mjs';
+import { __name } from './chunk-2JTKI4GS.mjs';
 import { InternationalizationHandler } from './index.mjs';
 import { SapphireClient, preGenericsInitialization, preLogin, postLogin, Plugin, container } from '@sapphire/framework';
 import { watch } from 'chokidar';
@@ -14,8 +14,7 @@ var _I18nextPlugin = class _I18nextPlugin extends Plugin {
     if (this.options.i18n?.hmr?.enabled) {
       container.logger.info("[i18next-Plugin]: HMR enabled. Watching for languages changes.");
       const hmr = watch(container.i18n.languagesDirectory, this.options.i18n.hmr.options);
-      for (const event of ["change", "unlink"])
-        hmr.on(event, () => container.i18n.reloadResources());
+      for (const event of ["change", "unlink"]) hmr.on(event, () => container.i18n.reloadResources());
     }
   }
 };
@@ -26,5 +25,5 @@ SapphireClient.plugins.registerPreLoginHook(I18nextPlugin[preLogin], "I18next-Pr
 SapphireClient.plugins.registerPostLoginHook(I18nextPlugin[postLogin], "I18next-PostLogin");
 
 export { I18nextPlugin };
-//# sourceMappingURL=out.js.map
+//# sourceMappingURL=register.mjs.map
 //# sourceMappingURL=register.mjs.map

package/dist/esm/register.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/register.ts"],"names":[],"mappings":";;;;;AAAA,OAAO;AAEP,SAAS,QAAQ,gBAAgB,WAAW,WAAW,2BAA2B,gBAAgB;AAClG,SAAS,aAAa;AAEtB,SAAS,mCAAmC;AAErC,IAAM,iBAAN,MAAM,uBAAsB,OAAO;AAAA,EACzC,QAAe,yBAAyB,EAAwB,SAA8B;AAC7F,cAAU,OAAO,IAAI,4BAA4B,QAAQ,IAAI;AAAA,EAC9D;AAAA,EAEA,cAAqB,QAAQ,IAAuC;AACnE,UAAM,UAAU,KAAK,KAAK;AAAA,EAC3B;AAAA,EAEA,QAAe,SAAS,IAA8B;AACrD,QAAI,KAAK,QAAQ,MAAM,KAAK,SAAS;AACpC,gBAAU,OAAO,KAAK,gEAAgE;AACtF,YAAM,MAAM,MAAM,UAAU,KAAK,oBAAoB,KAAK,QAAQ,KAAK,IAAI,OAAO;AAElF,iBAAW,SAAS,CAAC,UAAU,QAAQ;AAAG,YAAI,GAAG,OAAO,MAAM,UAAU,KAAK,gBAAgB,CAAC;AAAA,IAC/F;AAAA,EACD;AACD;AAjB0C;AAAnC,IAAM,gBAAN;AAmBP,eAAe,QAAQ,+BAA+B,cAAc,yBAAyB,GAAG,mCAAmC;AACnI,eAAe,QAAQ,qBAAqB,cAAc,QAAQ,GAAG,kBAAkB;AACvF,eAAe,QAAQ,sBAAsB,cAAc,SAAS,GAAG,mBAAmB","sourcesContent":["import './index';\n\nimport { Plugin, SapphireClient, container, postLogin, preGenericsInitialization, preLogin } from '@sapphire/framework';\nimport { watch } from 'chokidar';\nimport type { ClientOptions } from 'discord.js';\nimport { InternationalizationHandler } from './index';\n\nexport class I18nextPlugin extends Plugin {\n\tpublic static [preGenericsInitialization](this: SapphireClient, options: ClientOptions): void {\n\t\tcontainer.i18n = new InternationalizationHandler(options.i18n);\n\t}\n\n\tpublic static async [preLogin](this: SapphireClient): Promise<void> {\n\t\tawait container.i18n.init();\n\t}\n\n\tpublic static [postLogin](this: SapphireClient): void {\n\t\tif (this.options.i18n?.hmr?.enabled) {\n\t\t\tcontainer.logger.info('[i18next-Plugin]: HMR enabled. Watching for languages changes.');\n\t\t\tconst hmr = watch(container.i18n.languagesDirectory, this.options.i18n.hmr.options);\n\n\t\t\tfor (const event of ['change', 'unlink']) hmr.on(event, () => container.i18n.reloadResources());\n\t\t}\n\t}\n}\n\nSapphireClient.plugins.registerPostInitializationHook(I18nextPlugin[preGenericsInitialization], 'I18next-PreGenericsInitialization');\nSapphireClient.plugins.registerPreLoginHook(I18nextPlugin[preLogin], 'I18next-PreLogin');\nSapphireClient.plugins.registerPostLoginHook(I18nextPlugin[postLogin], 'I18next-PostLogin');\n"]}
+{"version":3,"sources":["../../src/register.ts"],"names":[],"mappings":";;;;;AAOO,IAAM,cAAA,GAAN,MAAM,cAAA,SAAsB,MAAO,CAAA;AAAA,EACzC,QAAe,yBAAyB,CAAA,CAAwB,OAA8B,EAAA;AAC7F,IAAA,SAAA,CAAU,IAAO,GAAA,IAAI,2BAA4B,CAAA,OAAA,CAAQ,IAAI,CAAA,CAAA;AAAA,GAC9D;AAAA,EAEA,cAAqB,QAAQ,CAAuC,GAAA;AACnE,IAAM,MAAA,SAAA,CAAU,KAAK,IAAK,EAAA,CAAA;AAAA,GAC3B;AAAA,EAEA,QAAe,SAAS,CAA8B,GAAA;AACrD,IAAA,IAAI,IAAK,CAAA,OAAA,CAAQ,IAAM,EAAA,GAAA,EAAK,OAAS,EAAA;AACpC,MAAU,SAAA,CAAA,MAAA,CAAO,KAAK,gEAAgE,CAAA,CAAA;AACtF,MAAM,MAAA,GAAA,GAAM,MAAM,SAAU,CAAA,IAAA,CAAK,oBAAoB,IAAK,CAAA,OAAA,CAAQ,IAAK,CAAA,GAAA,CAAI,OAAO,CAAA,CAAA;AAElF,MAAA,KAAA,MAAW,KAAS,IAAA,CAAC,QAAU,EAAA,QAAQ,CAAG,EAAA,GAAA,CAAI,EAAG,CAAA,KAAA,EAAO,MAAM,SAAA,CAAU,IAAK,CAAA,eAAA,EAAiB,CAAA,CAAA;AAAA,KAC/F;AAAA,GACD;AACD,CAAA,CAAA;AAjB0C,MAAA,CAAA,cAAA,EAAA,eAAA,CAAA,CAAA;AAAnC,IAAM,aAAN,GAAA,eAAA;AAmBP,cAAA,CAAe,OAAQ,CAAA,8BAAA,CAA+B,aAAc,CAAA,yBAAyB,GAAG,mCAAmC,CAAA,CAAA;AACnI,cAAA,CAAe,OAAQ,CAAA,oBAAA,CAAqB,aAAc,CAAA,QAAQ,GAAG,kBAAkB,CAAA,CAAA;AACvF,cAAA,CAAe,OAAQ,CAAA,qBAAA,CAAsB,aAAc,CAAA,SAAS,GAAG,mBAAmB,CAAA","file":"register.mjs","sourcesContent":["import './index';\n\nimport { Plugin, SapphireClient, container, postLogin, preGenericsInitialization, preLogin } from '@sapphire/framework';\nimport { watch } from 'chokidar';\nimport type { ClientOptions } from 'discord.js';\nimport { InternationalizationHandler } from './index';\n\nexport class I18nextPlugin extends Plugin {\n\tpublic static [preGenericsInitialization](this: SapphireClient, options: ClientOptions): void {\n\t\tcontainer.i18n = new InternationalizationHandler(options.i18n);\n\t}\n\n\tpublic static async [preLogin](this: SapphireClient): Promise<void> {\n\t\tawait container.i18n.init();\n\t}\n\n\tpublic static [postLogin](this: SapphireClient): void {\n\t\tif (this.options.i18n?.hmr?.enabled) {\n\t\t\tcontainer.logger.info('[i18next-Plugin]: HMR enabled. Watching for languages changes.');\n\t\t\tconst hmr = watch(container.i18n.languagesDirectory, this.options.i18n.hmr.options);\n\n\t\t\tfor (const event of ['change', 'unlink']) hmr.on(event, () => container.i18n.reloadResources());\n\t\t}\n\t}\n}\n\nSapphireClient.plugins.registerPostInitializationHook(I18nextPlugin[preGenericsInitialization], 'I18next-PreGenericsInitialization');\nSapphireClient.plugins.registerPreLoginHook(I18nextPlugin[preLogin], 'I18next-PreLogin');\nSapphireClient.plugins.registerPostLoginHook(I18nextPlugin[postLogin], 'I18next-PostLogin');\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sapphire/plugin-i18next",
-  "version": "7.1.3-next.fae3a34.0",
+  "version": "7.1.3-next.fc8c5ba",
   "description": "Plugin for @sapphire/framework to support i18next.",
   "author": "@sapphire",
   "license": "MIT",
@@ -50,10 +50,10 @@
     "check-update": "cliff-jumper --dry-run"
   },
   "dependencies": {
-    "@sapphire/utilities": "^3.15.3",
+    "@sapphire/utilities": "^3.17.0",
     "@skyra/i18next-backend": "^2.0.5",
     "chokidar": "^3.6.0",
-    "i18next": "^23.11.2"
+    "i18next": "^23.12.2"
   },
   "repository": {
     "type": "git",
@@ -86,13 +86,13 @@
     "access": "public"
   },
   "devDependencies": {
-    "@favware/cliff-jumper": "^3.0.3",
+    "@favware/cliff-jumper": "^4.0.3",
     "@favware/rollup-type-bundler": "^3.3.0",
     "concurrently": "^8.2.2",
-    "tsup": "^8.0.2",
-    "tsx": "^4.7.3",
+    "tsup": "^8.2.4",
+    "tsx": "^4.17.0",
     "typedoc": "^0.25.13",
     "typedoc-json-parser": "^10.0.0",
-    "typescript": "^5.4.5"
+    "typescript": "~5.4.5"
   }
 }

package/dist/esm/chunk-6QB3UK4Q.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"names":[],"mappings":"","sourcesContent":[]}