@wolfstar/plugin-i18next 2.1.2 → 2.2.0

package/README.md

@@ -31,6 +31,38 @@ pnpm add @wolfstar/http-framework @wolfstar/plugin-i18next
 
 ## Usage
 
+### Stars module
+
+On framework 6.1 and later, list the module in `modules` in `stars.config` (needs the optional
+`@wolfstar/kit` peer):
+
+```ts
+// stars.config.ts
+export default defineConfig({
+  modules: [["@wolfstar/plugin-i18next/module", { defaultLanguageDirectory: "./languages" }]],
+});
+```
+
+The options are written into the built entry, so they must be JSON-serialisable. `fetchLanguage` and
+the functions in `hmr.options` are not: set `fetchLanguage` through `ClientOptions.i18n`, which is
+merged (shallowly) over the module options. Because the merge is shallow, `hmr: { options }` set
+through `ClientOptions.i18n` replaces the module's whole `hmr` object: when you need functions in it,
+set the entire `hmr` object, including `enabled: true`, through `ClientOptions.i18n`.
+
+Never combine the module (or the `@wolfstar/plugin-i18next/plugin` factory below) with
+`import "@wolfstar/plugin-i18next/register"`: both paths install the same hooks, so combining them
+installs them twice.
+
+Without Stars, pass the `definePlugin` factory to `plugins` instead:
+
+```ts
+import i18nPlugin from "@wolfstar/plugin-i18next/plugin";
+
+const client = new Client({ plugins: [i18nPlugin({ defaultName: "en-US" })] });
+```
+
+### `register` entrypoint (framework v3/v5/v6)
+
 Import the register entrypoint **before** creating the client:
 
 ```typescript
@@ -240,6 +272,21 @@ import { I18nextPlugin } from "@wolfstar/plugin-i18next/register";
 await I18nextPlugin.watcher?.close();
 ```
 
+The `./plugin` factory exposes the same watcher as `watcher` on the plugin it returns (`null` until
+`postListen` has run, and when HMR is not enabled):
+
+```typescript
+import i18nPlugin from "@wolfstar/plugin-i18next/plugin";
+
+const plugin = i18nPlugin({ hmr: { enabled: true } });
+const client = new Client({ plugins: [plugin] });
+
+await plugin.watcher?.close();
+```
+
+A module activated through `stars.config` is built by the CLI, so there is no plugin instance to read
+the watcher from.
+
 ## Options
 
 | Option                     | Type                                     | Description                                                                             |

package/dist/esm/hooks-Bwy47aXr.js

@@ -0,0 +1,50 @@
+import { InternationalizationHandler } from "./index.js";
+import { container } from "@wolfstar/http-framework";
+import { watch } from "chokidar";
+
+//#region src/hooks.ts
+/**
+* The chokidar events that make the languages directory's contents change.
+*/
+const HmrEvents = [
+	"add",
+	"addDir",
+	"change",
+	"unlink",
+	"unlinkDir"
+];
+/**
+* Creates the {@link InternationalizationHandler} and assigns it to `container.i18n`. Shared by the `./register`
+* class plugin and the `./plugin` `definePlugin` factory.
+*
+* @param options The client options, read for `i18n`.
+*/
+function installI18n(options) {
+	container.i18n = new InternationalizationHandler(options.i18n);
+}
+/**
+* Loads the languages, so command builders can be localized when the stores load.
+*/
+async function initI18n() {
+	await container.i18n.init();
+}
+/**
+* Watches the languages directory and reloads the resources when it changes, if `i18n.hmr.enabled` is set.
+*
+* @param options The client options, read for `i18n.hmr`.
+* @returns The chokidar watcher, or `null` when HMR is not enabled.
+*/
+function watchLanguages(options) {
+	if (!options.i18n?.hmr?.enabled) return null;
+	console.info("[plugin-i18next] HMR enabled. Watching for language changes.");
+	const watcher = watch(container.i18n.languagesDirectory, {
+		ignoreInitial: true,
+		...options.i18n.hmr.options
+	});
+	for (const event of HmrEvents) watcher.on(event, () => void container.i18n.reloadResources());
+	return watcher;
+}
+
+//#endregion
+export { installI18n as n, watchLanguages as r, initI18n as t };
+//# sourceMappingURL=hooks-Bwy47aXr.js.map

package/dist/esm/hooks-Bwy47aXr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-Bwy47aXr.js","names":[],"sources":["../../src/hooks.ts"],"sourcesContent":["import { container, type ClientOptions } from \"@wolfstar/http-framework\";\nimport { watch, type FSWatcher } from \"chokidar\";\nimport { InternationalizationHandler } from \"./lib/InternationalizationHandler\";\n\n/**\n * The chokidar events that make the languages directory's contents change.\n */\nconst HmrEvents = [\"add\", \"addDir\", \"change\", \"unlink\", \"unlinkDir\"] as const;\n\n/**\n * Creates the {@link InternationalizationHandler} and assigns it to `container.i18n`. Shared by the `./register`\n * class plugin and the `./plugin` `definePlugin` factory.\n *\n * @param options The client options, read for `i18n`.\n */\nexport function installI18n(options: ClientOptions): void {\n  container.i18n = new InternationalizationHandler(options.i18n);\n}\n\n/**\n * Loads the languages, so command builders can be localized when the stores load.\n */\nexport async function initI18n(): Promise<void> {\n  await container.i18n.init();\n}\n\n/**\n * Watches the languages directory and reloads the resources when it changes, if `i18n.hmr.enabled` is set.\n *\n * @param options The client options, read for `i18n.hmr`.\n * @returns The chokidar watcher, or `null` when HMR is not enabled.\n */\nexport function watchLanguages(options: ClientOptions): FSWatcher | null {\n  if (!options.i18n?.hmr?.enabled) return null;\n\n  console.info(\"[plugin-i18next] HMR enabled. Watching for language changes.\");\n\n  // `ignoreInitial` defaults to `true` here: chokidar otherwise replays an `add` for every file\n  // already on disk, which would trigger a reload per translation file on startup.\n  const watcher = watch(container.i18n.languagesDirectory, {\n    ignoreInitial: true,\n    ...options.i18n.hmr.options,\n  });\n\n  // Adding a locale directory or a namespace file emits `addDir` / `add`, not `change`, so all of\n  // them have to be watched for new languages and namespaces to be picked up.\n  for (const event of HmrEvents) {\n    watcher.on(event, () => void container.i18n.reloadResources());\n  }\n\n  return watcher;\n}\n"],"mappings":";;;;;;;;AAOA,MAAM,YAAY;CAAC;CAAO;CAAU;CAAU;CAAU;AAAW;;;;;;;AAQnE,SAAgB,YAAY,SAA8B;CACxD,UAAU,OAAO,IAAI,4BAA4B,QAAQ,IAAI;AAC/D;;;;AAKA,eAAsB,WAA0B;CAC9C,MAAM,UAAU,KAAK,KAAK;AAC5B;;;;;;;AAQA,SAAgB,eAAe,SAA0C;CACvE,IAAI,CAAC,QAAQ,MAAM,KAAK,SAAS,OAAO;CAExC,QAAQ,KAAK,8DAA8D;CAI3E,MAAM,UAAU,MAAM,UAAU,KAAK,oBAAoB;EACvD,eAAe;EACf,GAAG,QAAQ,KAAK,IAAI;CACtB,CAAC;CAID,KAAK,MAAM,SAAS,WAClB,QAAQ,GAAG,aAAa,KAAK,UAAU,KAAK,gBAAgB,CAAC;CAG/D,OAAO;AACT"}

package/dist/esm/index.d.ts

@@ -1,272 +1,9 @@
-import i18next, { AppendKeyPrefix, DefaultNamespace, FlatNamespace, InitOptions, InitOptions as InitOptions$1, InterpolationMap, Namespace, ParseKeys, TFunction, TFunction as TFunction$1, TFunctionReturn, TFunctionReturnOptionalDetails, TOptions, TOptions as TOptions$1, TOptionsBase, TOptionsBase as TOptionsBase$1, TypeOptions } from "i18next";
-import { APIApplicationCommandOptionChoice, APIInteraction, APIPingInteraction, APIUser, ChannelType, LocaleString, LocalizationMap } from "discord-api-types/v10";
+import { C as Target, S as MessageTarget, _ as InternationalizationContext, a as BuilderWithDescription, b as LocaleSeparator, c as ChannelTarget, d as HMROptions, f as I18nextFormatter, g as InternationalizationClientOptions, h as Interaction, i as AnyNamespace, l as DynamicOptions, m as I18nextNamedFormatter, n as $NoInfer, o as BuilderWithName, p as I18nextNamedCachedFormatter, r as $SpecialObject, s as BuilderWithNameAndDescription, t as $Dictionary, u as GuildTarget, v as InternationalizationOptions, x as LocalizedData, y as LocalePrefixKey } from "./types-BhhqHOJk.js";
+import i18next, { AppendKeyPrefix, DefaultNamespace, InitOptions, InterpolationMap, Namespace, ParseKeys, TFunction, TFunction as TFunction$1, TFunctionReturn, TFunctionReturnOptionalDetails, TOptions, TOptions as TOptions$1, TOptionsBase, TOptionsBase as TOptionsBase$1 } from "i18next";
+import { APIApplicationCommandOptionChoice, LocaleString, LocalizationMap } from "discord-api-types/v10";
 import { Awaitable, NonNullObject } from "@sapphire/utilities";
 import { Backend } from "@wolfstar/i18next-backend";
-import { ChokidarOptions } from "chokidar";
 import { PathLike } from "node:fs";
-//#region src/lib/types.d.ts
-/**
- * This is a re-exported type from i18next.
- *
- * We could use the `NoInfer` TypeScript built-in utility, however this package still supports
- * TypeScript < 5.4.
- *
- * @see https://github.com/millsp/ts-toolbelt/blob/master/sources/Function/NoInfer.ts
- */
-type $NoInfer<A> = [A][A extends any ? 0 : never];
-/**
- * This is a re-exported type from i18next. It is essentially an object of key-value pairs, where
- * the key is a string and the value is any.
- */
-interface $Dictionary {
-  [key: string]: any;
-}
-/**
- * This is a re-exported type from i18next. It is the returned type from the translation helpers
- * when `returnObjects` is `true` in the options.
- */
-type $SpecialObject = $Dictionary | Array<string | $Dictionary>;
-/**
- * The namespace separator i18next is configured with, `':'` unless `CustomTypeOptions` overrides it.
- */
-type LocaleSeparator = TypeOptions["nsSeparator"];
-/**
- * A `<namespace><separator><key>` shaped key, used as the root key overload of
- * {@link applyLocalizedBuilder}.
- */
-type LocalePrefixKey = `${string}${LocaleSeparator}${string}`;
-/**
- * Every namespace known through the `CustomTypeOptions.resources` augmentation generated by
- * [`@wolfstar/i18next-type-generator`](https://www.npmjs.com/package/@wolfstar/i18next-type-generator).
- *
- * @remarks
- * Used as the default `Ns` generic of every helper that takes a fully-qualified
- * `<namespace><separator><key>` key, since i18next only parses those out of `ParseKeys` when `Ns`
- * is the array of every namespace the key could belong to — a single namespace (i18next's own
- * `DefaultNamespace`) only parses keys of that one namespace, unprefixed.
- */
-type AnyNamespace = readonly FlatNamespace[];
-/**
- * The subset of an interaction payload the localization helpers need in order to resolve a language.
- *
- * @remarks
- * `@wolfstar/http-framework` receives raw Discord interaction payloads over HTTP, so the helpers
- * operate on `discord-api-types` structures rather than on `discord.js` class instances.
- */
-type Interaction = Pick<Exclude<APIInteraction, APIPingInteraction>, "locale" | "guild_locale" | "guild_id"> & Partial<Pick<Exclude<APIInteraction, APIPingInteraction>, "channel_id" | "user" | "member">>;
-/**
- * The subset of a guild payload the localization helpers need.
- *
- * @remarks
- * `APIGuild` satisfies it, as does any partial guild that carries an id. Only a full guild payload
- * carries `preferred_locale`; without it the guild's id is still handed to
- * {@link InternationalizationHandler.fetchLanguage}, so a custom hook can resolve the language.
- */
-interface GuildTarget {
-  id: string;
-  /**
-   * The guild's preferred locale. Typed as `string` rather than `LocaleString` because
-   * `APIGuild` types it as the `Locale` enum; it is validated at runtime.
-   */
-  preferred_locale?: string;
-}
-/**
- * The subset of a channel payload the localization helpers need. Every `APIChannel` member
- * satisfies it.
- *
- * @remarks
- * A channel payload carries no locale of its own, so the language is resolved from
- * {@link InternationalizationHandler.fetchLanguage} and then from the configured default.
- */
-interface ChannelTarget {
-  id: string;
-  type: ChannelType;
-  guild_id?: string;
-}
-/**
- * The subset of a message payload the localization helpers need. `APIMessage` satisfies it, and
- * gateway message payloads additionally carry `guild_id`.
- *
- * @remarks
- * Like {@link ChannelTarget}, a message carries no locale of its own.
- */
-interface MessageTarget {
-  id: string;
-  channel_id: string;
-  guild_id?: string;
-  author?: Pick<APIUser, "id">;
-}
-/**
- * Any value the localization helpers accept as the source of a language.
- *
- * @remarks
- * The four members are told apart structurally, in this order: an {@link Interaction} has `locale`,
- * a {@link MessageTarget} has `channel_id`, a {@link ChannelTarget} has `type`, and anything else is
- * a {@link GuildTarget}.
- */
-type Target = Interaction | MessageTarget | ChannelTarget | GuildTarget;
-/**
- * Configure whether to use Hot-Module-Replacement (HMR) for your i18next resources using these
- * options. The minimum config to enable HMR is to set `enabled` to true. Any other properties are
- * optional.
- */
-interface HMROptions {
-  /**
-   * HMR status for the i18next plugin.
-   * @default false
-   */
-  enabled: boolean;
-  /**
-   * Languages that will be reloaded when updating the languages directory.
-   *
-   * @remarks
-   * Pinning both this and {@link HMROptions.namespaces} skips the directory walk, so languages and
-   * namespaces added while the process is running are not registered on i18next.
-   * @default All languages that are automatically resolved from your folder setup
-   */
-  languages?: string | string[];
-  /**
-   * Namespaces that will be reloaded when updating the languages directory.
-   *
-   * @remarks
-   * Pinning both this and {@link HMROptions.languages} skips the directory walk, so languages and
-   * namespaces added while the process is running are not registered on i18next.
-   * @default All namespaces that are automatically resolved from your languages folder setup
-   */
-  namespaces?: string | string[];
-  /**
-   * The options passed to `chokidar`'s `watch`.
-   *
-   * @remarks
-   * `ignoreInitial` defaults to `true`, since chokidar would otherwise replay an `add` event for
-   * every translation file already on disk and trigger a reload for each of them on startup.
-   */
-  options?: ChokidarOptions;
-}
-/**
- * Used to dynamically add options based on the languages found in {@link InternationalizationHandler.init}.
- */
-type DynamicOptions<T extends InitOptions$1> = (namespaces: string[], languages: string[]) => T;
-/**
- * The options used in {@link InternationalizationHandler}.
- */
-interface InternationalizationOptions {
-  /**
-   * Used as the default 2nd to last fallback locale if no other is found. It's only followed by
-   * `'en-US'`.
-   */
-  defaultName?: string;
-  /**
-   * The options passed to `backend` in `i18next.init`.
-   */
-  backend?: Backend.Options;
-  /**
-   * The options passed to `i18next.init`.
-   */
-  i18next?: InitOptions$1 | DynamicOptions<InitOptions$1>;
-  /**
-   * The directory in which `@wolfstar/i18next-backend` should search for files.
-   * @default `rootDirectory/languages`
-   */
-  defaultLanguageDirectory?: string;
-  /**
-   * The default value to be used if a specific language key isn't found. Defaults to
-   * `'default:default'`.
-   */
-  defaultMissingKey?: string;
-  /**
-   * The default namespace that is prefixed to all keys that don't specify it. Defaults to
-   * `'default'`.
-   */
-  defaultNS?: string;
-  /**
-   * Array of formatters to add to i18next.
-   * @default []
-   */
-  formatters?: I18nextFormatter[];
-  /**
-   * Reload languages and namespaces when updating the languages directory.
-   */
-  hmr?: HMROptions;
-  /**
-   * A function that is to be used to retrieve the language for the current context.
-   *
-   * If this is not set, then the language will always be resolved from the interaction's locales.
-   *
-   * This will be inserted for {@link InternationalizationHandler.fetchLanguage}.
-   * @default () => null
-   */
-  fetchLanguage?: (context: InternationalizationContext) => Awaitable<string | null>;
-}
-/**
- * Context for {@link InternationalizationHandler.fetchLanguage} functions. This context enables
- * implementation of per-guild, per-channel, and per-user localization.
- */
-interface InternationalizationContext {
-  /** The ID of the guild the interaction was sent from, or `null` when sent from a DM. */
-  guildId: string | null;
-  /** The ID of the channel the interaction was sent from, or `null` when it was not provided. */
-  channelId: string | null;
-  /** The ID of the user that sent the interaction, or `null` when it was not provided. */
-  userId: string | null;
-  /** The locale the guild the interaction was sent from is configured with. */
-  interactionGuildLocale?: LocaleString;
-  /** The locale the user that sent the interaction is configured with. */
-  interactionLocale?: LocaleString;
-  /**
-   * The preferred locale of the guild the target belongs to.
-   *
-   * @remarks
-   * Filled in from `guild_locale` for an {@link Interaction} and from `preferred_locale` for a
-   * {@link GuildTarget}; a {@link ChannelTarget} and a {@link MessageTarget} carry no locale, so it
-   * is left undefined for them.
-   */
-  preferredLocale?: string;
-}
-interface InternationalizationClientOptions {
-  i18n?: InternationalizationOptions;
-}
-/**
- * Represents a formatter that is added to i18next with `i18next.services.formatter.add` or
- * `i18next.services.formatter.addCached`, depending on the `cached` property.
- *
- * @see {@link https://www.i18next.com/translation-function/formatting#adding-custom-format-function}
- */
-type I18nextFormatter = I18nextNamedFormatter | I18nextNamedCachedFormatter;
-/**
- * Represents a formatter that is added to i18next with `i18next.services.formatter.add`.
- *
- * @see {@link https://www.i18next.com/translation-function/formatting#adding-custom-format-function}
- */
-interface I18nextNamedFormatter {
-  cached?: false;
-  name: string;
-  format(value: any, lng: string | undefined, options: any): string;
-}
-/**
- * Represents a cached formatter that is added to i18next with `i18next.services.formatter.addCached`.
- *
- * @see {@link https://www.i18next.com/translation-function/formatting#adding-custom-format-function}
- */
-interface I18nextNamedCachedFormatter {
-  cached: true;
-  name: string;
-  format(lng: string | undefined, options: any): (value: any) => string;
-}
-interface LocalizedData {
-  value: string;
-  localizations: LocalizationMap;
-}
-interface BuilderWithName {
-  setName(name: string): this;
-  setNameLocalizations(localizedNames: LocalizationMap | null): this;
-}
-interface BuilderWithDescription {
-  setDescription(description: string): this;
-  setDescriptionLocalizations(localizedDescriptions: LocalizationMap | null): this;
-}
-type BuilderWithNameAndDescription = BuilderWithName & BuilderWithDescription;
-//#endregion
 //#region src/lib/InternationalizationHandler.d.ts
 /**
  * A generalized class for handling `i18next` JSON files and their discovery.

package/dist/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/lib/types.ts","../../src/lib/InternationalizationHandler.ts","../../src/lib/compat.ts","../../src/lib/functions.ts","../../src/index.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/lib/InternationalizationHandler.ts","../../src/lib/compat.ts","../../src/lib/functions.ts","../../src/index.ts"],"mappings":"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"}

package/dist/esm/module.d.ts

@@ -0,0 +1,22 @@
+import { v as InternationalizationOptions } from "./types-BhhqHOJk.js";
+//#region src/module.d.ts
+/**
+ * The Stars module: listing `@wolfstar/plugin-i18next/module` in `modules` in `stars.config` registers the i18next
+ * plugin with the options written there.
+ *
+ * @remarks
+ * The options are written into the built entry, so they have to be JSON-serialisable. `fetchLanguage` and the
+ * `hmr.options` functions are not: set `fetchLanguage` through `ClientOptions.i18n`.
+ *
+ * @example
+ * ```ts
+ * // stars.config.ts
+ * export default defineConfig({
+ *   modules: [['@wolfstar/plugin-i18next/module', { defaultLanguageDirectory: './languages' }]],
+ * });
+ * ```
+ */
+declare const _default: import("@wolfstar/kit").StarsModule<InternationalizationOptions>;
+//#endregion
+export { _default as default };
+//# sourceMappingURL=module.d.ts.map

package/dist/esm/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","names":[],"sources":["../../src/module.ts"],"mappings":""}

package/dist/esm/module.js

@@ -0,0 +1,35 @@
+import { defineModule } from "@wolfstar/kit";
+
+//#region src/module.ts
+/**
+* The Stars module: listing `@wolfstar/plugin-i18next/module` in `modules` in `stars.config` registers the i18next
+* plugin with the options written there.
+*
+* @remarks
+* The options are written into the built entry, so they have to be JSON-serialisable. `fetchLanguage` and the
+* `hmr.options` functions are not: set `fetchLanguage` through `ClientOptions.i18n`.
+*
+* @example
+* ```ts
+* // stars.config.ts
+* export default defineConfig({
+*   modules: [['@wolfstar/plugin-i18next/module', { defaultLanguageDirectory: './languages' }]],
+* });
+* ```
+*/
+var module_default = defineModule({
+	meta: {
+		name: "@wolfstar/plugin-i18next",
+		compatibility: { framework: ">=6.1.0" }
+	},
+	setup(options, ctx) {
+		ctx.addPlugin({
+			from: "@wolfstar/plugin-i18next/plugin",
+			options
+		});
+	}
+});
+
+//#endregion
+export { module_default as default };
+//# sourceMappingURL=module.js.map

package/dist/esm/module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","names":[],"sources":["../../src/module.ts"],"sourcesContent":["import { defineModule } from \"@wolfstar/kit\";\nimport type { InternationalizationOptions } from \"./lib/types\";\n\n/**\n * The Stars module: listing `@wolfstar/plugin-i18next/module` in `modules` in `stars.config` registers the i18next\n * plugin with the options written there.\n *\n * @remarks\n * The options are written into the built entry, so they have to be JSON-serialisable. `fetchLanguage` and the\n * `hmr.options` functions are not: set `fetchLanguage` through `ClientOptions.i18n`.\n *\n * @example\n * ```ts\n * // stars.config.ts\n * export default defineConfig({\n *   modules: [['@wolfstar/plugin-i18next/module', { defaultLanguageDirectory: './languages' }]],\n * });\n * ```\n */\nexport default defineModule<InternationalizationOptions>({\n  meta: {\n    name: \"@wolfstar/plugin-i18next\",\n    compatibility: { framework: \">=6.1.0\" },\n  },\n  setup(options, ctx) {\n    ctx.addPlugin({ from: \"@wolfstar/plugin-i18next/plugin\", options });\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAmBA,qBAAe,aAA0C;CACvD,MAAM;EACJ,MAAM;EACN,eAAe,EAAE,WAAW,UAAU;CACxC;CACA,MAAM,SAAS,KAAK;EAClB,IAAI,UAAU;GAAE,MAAM;GAAmC;EAAQ,CAAC;CACpE;AACF,CAAC"}

package/dist/esm/plugin.d.ts

@@ -0,0 +1,31 @@
+import { v as InternationalizationOptions } from "./types-BhhqHOJk.js";
+import "./index.js";
+import { ClientOptions } from "@wolfstar/http-framework";
+import { FSWatcher } from "chokidar";
+//#region src/plugin.d.ts
+/**
+ * The i18next plugin: installs the `InternationalizationHandler` on `container.i18n`, loads the languages before the
+ * stores, and watches the languages directory when HMR is enabled.
+ *
+ * The plugin exposes the chokidar watcher started by `postListen` as `watcher` (`null` until then, and when HMR is not
+ * enabled), so it can be closed on shutdown, like `I18nextPlugin.watcher` of `./register`.
+ *
+ * @param pluginOptions The handler options. `ClientOptions.i18n` is merged over them.
+ *
+ * @example
+ * ```ts
+ * import i18nPlugin from '@wolfstar/plugin-i18next/plugin';
+ *
+ * const client = new Client({ plugins: [i18nPlugin({ defaultName: 'en-US' })] });
+ * ```
+ */
+declare const _default: (pluginOptions?: InternationalizationOptions | undefined) => {
+  name: string;
+  readonly watcher: FSWatcher | null;
+  preGenericsInitialization(_client: import("@wolfstar/http-framework").Client, options: ClientOptions): void;
+  preLoad: () => Promise<void>;
+  postListen(_client: import("@wolfstar/http-framework").Client, options: ClientOptions): void;
+};
+//#endregion
+export { _default as default };
+//# sourceMappingURL=plugin.d.ts.map

package/dist/esm/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","names":[],"sources":["../../src/plugin.ts"],"mappings":""}

package/dist/esm/plugin.js

@@ -0,0 +1,50 @@
+import "./index.js";
+import { n as installI18n, r as watchLanguages, t as initI18n } from "./hooks-Bwy47aXr.js";
+import { definePlugin } from "@wolfstar/http-framework";
+
+//#region src/plugin.ts
+/**
+* The i18next plugin: installs the `InternationalizationHandler` on `container.i18n`, loads the languages before the
+* stores, and watches the languages directory when HMR is enabled.
+*
+* The plugin exposes the chokidar watcher started by `postListen` as `watcher` (`null` until then, and when HMR is not
+* enabled), so it can be closed on shutdown, like `I18nextPlugin.watcher` of `./register`.
+*
+* @param pluginOptions The handler options. `ClientOptions.i18n` is merged over them.
+*
+* @example
+* ```ts
+* import i18nPlugin from '@wolfstar/plugin-i18next/plugin';
+*
+* const client = new Client({ plugins: [i18nPlugin({ defaultName: 'en-US' })] });
+* ```
+*/
+var plugin_default = definePlugin((pluginOptions) => {
+	const isEmpty = (value) => !value || Object.keys(value).length === 0;
+	const merged = (options) => ({
+		...options,
+		i18n: isEmpty(pluginOptions) && isEmpty(options.i18n) ? void 0 : {
+			...pluginOptions,
+			...options.i18n
+		}
+	});
+	let watcher = null;
+	return {
+		name: "@wolfstar/plugin-i18next",
+		get watcher() {
+			return watcher;
+		},
+		preGenericsInitialization(_client, options) {
+			options.i18n = merged(options).i18n;
+			installI18n(options);
+		},
+		preLoad: () => initI18n(),
+		postListen(_client, options) {
+			watcher = watchLanguages(merged(options)) ?? watcher;
+		}
+	};
+});
+
+//#endregion
+export { plugin_default as default };
+//# sourceMappingURL=plugin.js.map

package/dist/esm/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","names":[],"sources":["../../src/plugin.ts"],"sourcesContent":["import { definePlugin, type ClientOptions } from \"@wolfstar/http-framework\";\nimport type { FSWatcher } from \"chokidar\";\nimport \"./index\";\nimport { initI18n, installI18n, watchLanguages } from \"./hooks\";\nimport type { InternationalizationOptions } from \"./lib/types\";\n\n/**\n * The i18next plugin: installs the `InternationalizationHandler` on `container.i18n`, loads the languages before the\n * stores, and watches the languages directory when HMR is enabled.\n *\n * The plugin exposes the chokidar watcher started by `postListen` as `watcher` (`null` until then, and when HMR is not\n * enabled), so it can be closed on shutdown, like `I18nextPlugin.watcher` of `./register`.\n *\n * @param pluginOptions The handler options. `ClientOptions.i18n` is merged over them.\n *\n * @example\n * ```ts\n * import i18nPlugin from '@wolfstar/plugin-i18next/plugin';\n *\n * const client = new Client({ plugins: [i18nPlugin({ defaultName: 'en-US' })] });\n * ```\n */\nexport default definePlugin((pluginOptions?: InternationalizationOptions) => {\n  // Without any options the handler falls back to its own defaults, so only build an object when there is one. Kit's\n  // `defineModule` calls `setup` with `{}` rather than `undefined` when no options are given, so an empty object\n  // counts as \"no options\" too.\n  const isEmpty = (value: InternationalizationOptions | undefined) =>\n    !value || Object.keys(value).length === 0;\n  const merged = (options: ClientOptions): ClientOptions => ({\n    ...options,\n    i18n:\n      isEmpty(pluginOptions) && isEmpty(options.i18n)\n        ? undefined\n        : { ...pluginOptions, ...options.i18n },\n  });\n\n  let watcher: FSWatcher | null = null;\n\n  return {\n    name: \"@wolfstar/plugin-i18next\",\n    get watcher() {\n      return watcher;\n    },\n    preGenericsInitialization(_client, options) {\n      options.i18n = merged(options).i18n;\n      installI18n(options);\n    },\n    preLoad: () => initI18n(),\n    postListen(_client, options) {\n      watcher = watchLanguages(merged(options)) ?? watcher;\n    },\n  };\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAsBA,qBAAe,cAAc,kBAAgD;CAI3E,MAAM,WAAW,UACf,CAAC,SAAS,OAAO,KAAK,KAAK,CAAC,CAAC,WAAW;CAC1C,MAAM,UAAU,aAA2C;EACzD,GAAG;EACH,MACE,QAAQ,aAAa,KAAK,QAAQ,QAAQ,IAAI,IAC1C,SACA;GAAE,GAAG;GAAe,GAAG,QAAQ;EAAK;CAC5C;CAEA,IAAI,UAA4B;CAEhC,OAAO;EACL,MAAM;EACN,IAAI,UAAU;GACZ,OAAO;EACT;EACA,0BAA0B,SAAS,SAAS;GAC1C,QAAQ,OAAO,OAAO,OAAO,CAAC,CAAC;GAC/B,YAAY,OAAO;EACrB;EACA,eAAe,SAAS;EACxB,WAAW,SAAS,SAAS;GAC3B,UAAU,eAAe,OAAO,OAAO,CAAC,KAAK;EAC/C;CACF;AACF,CAAC"}

package/dist/esm/register.d.ts

@@ -3,7 +3,7 @@ import { Client, ClientOptions, Plugin, postListen, preGenericsInitialization, p
 import { FSWatcher } from "chokidar";
 //#region src/register.d.ts
 /**
- * Registers the i18next-powered {@link InternationalizationHandler} on `container.i18n`, loading the
+ * Registers the i18next-powered `InternationalizationHandler` on `container.i18n`, loading the
  * languages before the stores are loaded so command builders can be localized at registration time.
  *
  * Activate by importing the side-effecting entrypoint before creating the client:

package/dist/esm/register.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"register.d.ts","names":[],"sources":["../../src/register.ts"],"mappings":";;;;;;;;;;;;;;qBA4Ba,sBAAsB;;;;;SAKnB,SAAS;UAER,2BAA2B,MAAM,QAAQ,SAAS;UAI5C,SAAS,MAAM,SAAS;UAI9B,YAAY,MAAM,QAAQ,SAAS"}
+{"version":3,"file":"register.d.ts","names":[],"sources":["../../src/register.ts"],"mappings":";;;;;;;;;;;;;;qBAsBa,sBAAsB;;;;;SAKnB,SAAS;UAER,2BAA2B,MAAM,QAAQ,SAAS;UAI5C,SAAS,MAAM,SAAS;UAI9B,YAAY,MAAM,QAAQ,SAAS"}

package/dist/esm/register.js

@@ -1,20 +1,10 @@
-import { InternationalizationHandler } from "./index.js";
-import { Client, Plugin, container, postListen, preGenericsInitialization, preLoad } from "@wolfstar/http-framework";
-import { watch } from "chokidar";
+import "./index.js";
+import { n as installI18n, r as watchLanguages, t as initI18n } from "./hooks-Bwy47aXr.js";
+import { Client, Plugin, postListen, preGenericsInitialization, preLoad } from "@wolfstar/http-framework";
 
 //#region src/register.ts
 /**
-* The chokidar events that make the languages directory's contents change.
-*/
-const HmrEvents = [
-	"add",
-	"addDir",
-	"change",
-	"unlink",
-	"unlinkDir"
-];
-/**
-* Registers the i18next-powered {@link InternationalizationHandler} on `container.i18n`, loading the
+* Registers the i18next-powered `InternationalizationHandler` on `container.i18n`, loading the
 * languages before the stores are loaded so command builders can be localized at registration time.
 *
 * Activate by importing the side-effecting entrypoint before creating the client:
@@ -30,20 +20,13 @@ var I18nextPlugin = class I18nextPlugin extends Plugin {
 	*/
 	static watcher = null;
 	static [preGenericsInitialization](options) {
-		container.i18n = new InternationalizationHandler(options.i18n);
+		installI18n(options);
 	}
 	static async [preLoad]() {
-		await container.i18n.init();
+		await initI18n();
 	}
 	static [postListen](options) {
-		if (!options.i18n?.hmr?.enabled) return;
-		console.info("[plugin-i18next] HMR enabled. Watching for language changes.");
-		const watcher = watch(container.i18n.languagesDirectory, {
-			ignoreInitial: true,
-			...options.i18n.hmr.options
-		});
-		for (const event of HmrEvents) watcher.on(event, () => void container.i18n.reloadResources());
-		I18nextPlugin.watcher = watcher;
+		I18nextPlugin.watcher = watchLanguages(options) ?? I18nextPlugin.watcher;
 	}
 };
 Client.plugins.registerPreGenericsInitializationHook(I18nextPlugin[preGenericsInitialization], "WolfStar-I18next-PreGenericsInitialization");

package/dist/esm/register.js.map

@@ -1 +1 @@
-{"version":3,"file":"register.js","names":[],"sources":["../../src/register.ts"],"sourcesContent":["import {\n  Client,\n  container,\n  Plugin,\n  postListen,\n  preGenericsInitialization,\n  preLoad,\n  type ClientOptions,\n} from \"@wolfstar/http-framework\";\nimport { watch, type FSWatcher } from \"chokidar\";\nimport \"./index\";\nimport { InternationalizationHandler } from \"./lib/InternationalizationHandler\";\n\n/**\n * The chokidar events that make the languages directory's contents change.\n */\nconst HmrEvents = [\"add\", \"addDir\", \"change\", \"unlink\", \"unlinkDir\"] as const;\n\n/**\n * Registers the i18next-powered {@link InternationalizationHandler} on `container.i18n`, loading the\n * languages before the stores are loaded so command builders can be localized at registration time.\n *\n * Activate by importing the side-effecting entrypoint before creating the client:\n *\n * ```ts\n * import '@wolfstar/plugin-i18next/register';\n * ```\n */\nexport class I18nextPlugin extends Plugin {\n  /**\n   * The chokidar watcher started by the `postListen` hook when HMR is enabled, or `null` when it is\n   * not. Exposed so it can be closed on shutdown.\n   */\n  public static watcher: FSWatcher | null = null;\n\n  public static [preGenericsInitialization](this: Client, options: ClientOptions): void {\n    container.i18n = new InternationalizationHandler(options.i18n);\n  }\n\n  public static async [preLoad](this: Client): Promise<void> {\n    await container.i18n.init();\n  }\n\n  public static [postListen](this: Client, options: ClientOptions): void {\n    if (!options.i18n?.hmr?.enabled) return;\n\n    console.info(\"[plugin-i18next] HMR enabled. Watching for language changes.\");\n\n    // `ignoreInitial` defaults to `true` here: chokidar otherwise replays an `add` for every file\n    // already on disk, which would trigger a reload per translation file on startup.\n    const watcher = watch(container.i18n.languagesDirectory, {\n      ignoreInitial: true,\n      ...options.i18n.hmr.options,\n    });\n\n    // Adding a locale directory or a namespace file emits `addDir` / `add`, not `change`, so all of\n    // them have to be watched for new languages and namespaces to be picked up.\n    for (const event of HmrEvents) {\n      watcher.on(event, () => void container.i18n.reloadResources());\n    }\n\n    I18nextPlugin.watcher = watcher;\n  }\n}\n\nClient.plugins.registerPreGenericsInitializationHook(\n  I18nextPlugin[preGenericsInitialization],\n  \"WolfStar-I18next-PreGenericsInitialization\",\n);\nClient.plugins.registerPreLoadHook(I18nextPlugin[preLoad], \"WolfStar-I18next-PreLoad\");\nClient.plugins.registerPostListenHook(I18nextPlugin[postListen], \"WolfStar-I18next-PostListen\");\n"],"mappings":";;;;;;;;AAgBA,MAAM,YAAY;CAAC;CAAO;CAAU;CAAU;CAAU;AAAW;;;;;;;;;;;AAYnE,IAAa,gBAAb,MAAa,sBAAsB,OAAO;;;;;CAKxC,OAAc,UAA4B;CAE1C,QAAe,2BAAyC,SAA8B;EACpF,UAAU,OAAO,IAAI,4BAA4B,QAAQ,IAAI;CAC/D;CAEA,cAAqB,WAAsC;EACzD,MAAM,UAAU,KAAK,KAAK;CAC5B;CAEA,QAAe,YAA0B,SAA8B;EACrE,IAAI,CAAC,QAAQ,MAAM,KAAK,SAAS;EAEjC,QAAQ,KAAK,8DAA8D;EAI3E,MAAM,UAAU,MAAM,UAAU,KAAK,oBAAoB;GACvD,eAAe;GACf,GAAG,QAAQ,KAAK,IAAI;EACtB,CAAC;EAID,KAAK,MAAM,SAAS,WAClB,QAAQ,GAAG,aAAa,KAAK,UAAU,KAAK,gBAAgB,CAAC;EAG/D,cAAc,UAAU;CAC1B;AACF;AAEA,OAAO,QAAQ,sCACb,cAAc,4BACd,4CACF;AACA,OAAO,QAAQ,oBAAoB,cAAc,UAAU,0BAA0B;AACrF,OAAO,QAAQ,uBAAuB,cAAc,aAAa,6BAA6B"}
+{"version":3,"file":"register.js","names":[],"sources":["../../src/register.ts"],"sourcesContent":["import {\n  Client,\n  Plugin,\n  postListen,\n  preGenericsInitialization,\n  preLoad,\n  type ClientOptions,\n} from \"@wolfstar/http-framework\";\nimport type { FSWatcher } from \"chokidar\";\nimport \"./index\";\nimport { initI18n, installI18n, watchLanguages } from \"./hooks\";\n\n/**\n * Registers the i18next-powered `InternationalizationHandler` on `container.i18n`, loading the\n * languages before the stores are loaded so command builders can be localized at registration time.\n *\n * Activate by importing the side-effecting entrypoint before creating the client:\n *\n * ```ts\n * import '@wolfstar/plugin-i18next/register';\n * ```\n */\nexport class I18nextPlugin extends Plugin {\n  /**\n   * The chokidar watcher started by the `postListen` hook when HMR is enabled, or `null` when it is\n   * not. Exposed so it can be closed on shutdown.\n   */\n  public static watcher: FSWatcher | null = null;\n\n  public static [preGenericsInitialization](this: Client, options: ClientOptions): void {\n    installI18n(options);\n  }\n\n  public static async [preLoad](this: Client): Promise<void> {\n    await initI18n();\n  }\n\n  public static [postListen](this: Client, options: ClientOptions): void {\n    I18nextPlugin.watcher = watchLanguages(options) ?? I18nextPlugin.watcher;\n  }\n}\n\nClient.plugins.registerPreGenericsInitializationHook(\n  I18nextPlugin[preGenericsInitialization],\n  \"WolfStar-I18next-PreGenericsInitialization\",\n);\nClient.plugins.registerPreLoadHook(I18nextPlugin[preLoad], \"WolfStar-I18next-PreLoad\");\nClient.plugins.registerPostListenHook(I18nextPlugin[postListen], \"WolfStar-I18next-PostListen\");\n"],"mappings":";;;;;;;;;;;;;;;AAsBA,IAAa,gBAAb,MAAa,sBAAsB,OAAO;;;;;CAKxC,OAAc,UAA4B;CAE1C,QAAe,2BAAyC,SAA8B;EACpF,YAAY,OAAO;CACrB;CAEA,cAAqB,WAAsC;EACzD,MAAM,SAAS;CACjB;CAEA,QAAe,YAA0B,SAA8B;EACrE,cAAc,UAAU,eAAe,OAAO,KAAK,cAAc;CACnE;AACF;AAEA,OAAO,QAAQ,sCACb,cAAc,4BACd,4CACF;AACA,OAAO,QAAQ,oBAAoB,cAAc,UAAU,0BAA0B;AACrF,OAAO,QAAQ,uBAAuB,cAAc,aAAa,6BAA6B"}

package/dist/esm/types-BhhqHOJk.d.ts

@@ -0,0 +1,270 @@
+import { FlatNamespace, InitOptions, TypeOptions } from "i18next";
+import { APIInteraction, APIPingInteraction, APIUser, ChannelType, LocaleString, LocalizationMap } from "discord-api-types/v10";
+import { Awaitable } from "@sapphire/utilities";
+import { Backend } from "@wolfstar/i18next-backend";
+import { ChokidarOptions } from "chokidar";
+//#region src/lib/types.d.ts
+/**
+ * This is a re-exported type from i18next.
+ *
+ * We could use the `NoInfer` TypeScript built-in utility, however this package still supports
+ * TypeScript < 5.4.
+ *
+ * @see https://github.com/millsp/ts-toolbelt/blob/master/sources/Function/NoInfer.ts
+ */
+type $NoInfer<A> = [A][A extends any ? 0 : never];
+/**
+ * This is a re-exported type from i18next. It is essentially an object of key-value pairs, where
+ * the key is a string and the value is any.
+ */
+interface $Dictionary {
+  [key: string]: any;
+}
+/**
+ * This is a re-exported type from i18next. It is the returned type from the translation helpers
+ * when `returnObjects` is `true` in the options.
+ */
+type $SpecialObject = $Dictionary | Array<string | $Dictionary>;
+/**
+ * The namespace separator i18next is configured with, `':'` unless `CustomTypeOptions` overrides it.
+ */
+type LocaleSeparator = TypeOptions["nsSeparator"];
+/**
+ * A `<namespace><separator><key>` shaped key, used as the root key overload of
+ * {@link applyLocalizedBuilder}.
+ */
+type LocalePrefixKey = `${string}${LocaleSeparator}${string}`;
+/**
+ * Every namespace known through the `CustomTypeOptions.resources` augmentation generated by
+ * [`@wolfstar/i18next-type-generator`](https://www.npmjs.com/package/@wolfstar/i18next-type-generator).
+ *
+ * @remarks
+ * Used as the default `Ns` generic of every helper that takes a fully-qualified
+ * `<namespace><separator><key>` key, since i18next only parses those out of `ParseKeys` when `Ns`
+ * is the array of every namespace the key could belong to — a single namespace (i18next's own
+ * `DefaultNamespace`) only parses keys of that one namespace, unprefixed.
+ */
+type AnyNamespace = readonly FlatNamespace[];
+/**
+ * The subset of an interaction payload the localization helpers need in order to resolve a language.
+ *
+ * @remarks
+ * `@wolfstar/http-framework` receives raw Discord interaction payloads over HTTP, so the helpers
+ * operate on `discord-api-types` structures rather than on `discord.js` class instances.
+ */
+type Interaction = Pick<Exclude<APIInteraction, APIPingInteraction>, "locale" | "guild_locale" | "guild_id"> & Partial<Pick<Exclude<APIInteraction, APIPingInteraction>, "channel_id" | "user" | "member">>;
+/**
+ * The subset of a guild payload the localization helpers need.
+ *
+ * @remarks
+ * `APIGuild` satisfies it, as does any partial guild that carries an id. Only a full guild payload
+ * carries `preferred_locale`; without it the guild's id is still handed to
+ * {@link InternationalizationHandler.fetchLanguage}, so a custom hook can resolve the language.
+ */
+interface GuildTarget {
+  id: string;
+  /**
+   * The guild's preferred locale. Typed as `string` rather than `LocaleString` because
+   * `APIGuild` types it as the `Locale` enum; it is validated at runtime.
+   */
+  preferred_locale?: string;
+}
+/**
+ * The subset of a channel payload the localization helpers need. Every `APIChannel` member
+ * satisfies it.
+ *
+ * @remarks
+ * A channel payload carries no locale of its own, so the language is resolved from
+ * {@link InternationalizationHandler.fetchLanguage} and then from the configured default.
+ */
+interface ChannelTarget {
+  id: string;
+  type: ChannelType;
+  guild_id?: string;
+}
+/**
+ * The subset of a message payload the localization helpers need. `APIMessage` satisfies it, and
+ * gateway message payloads additionally carry `guild_id`.
+ *
+ * @remarks
+ * Like {@link ChannelTarget}, a message carries no locale of its own.
+ */
+interface MessageTarget {
+  id: string;
+  channel_id: string;
+  guild_id?: string;
+  author?: Pick<APIUser, "id">;
+}
+/**
+ * Any value the localization helpers accept as the source of a language.
+ *
+ * @remarks
+ * The four members are told apart structurally, in this order: an {@link Interaction} has `locale`,
+ * a {@link MessageTarget} has `channel_id`, a {@link ChannelTarget} has `type`, and anything else is
+ * a {@link GuildTarget}.
+ */
+type Target = Interaction | MessageTarget | ChannelTarget | GuildTarget;
+/**
+ * Configure whether to use Hot-Module-Replacement (HMR) for your i18next resources using these
+ * options. The minimum config to enable HMR is to set `enabled` to true. Any other properties are
+ * optional.
+ */
+interface HMROptions {
+  /**
+   * HMR status for the i18next plugin.
+   * @default false
+   */
+  enabled: boolean;
+  /**
+   * Languages that will be reloaded when updating the languages directory.
+   *
+   * @remarks
+   * Pinning both this and {@link HMROptions.namespaces} skips the directory walk, so languages and
+   * namespaces added while the process is running are not registered on i18next.
+   * @default All languages that are automatically resolved from your folder setup
+   */
+  languages?: string | string[];
+  /**
+   * Namespaces that will be reloaded when updating the languages directory.
+   *
+   * @remarks
+   * Pinning both this and {@link HMROptions.languages} skips the directory walk, so languages and
+   * namespaces added while the process is running are not registered on i18next.
+   * @default All namespaces that are automatically resolved from your languages folder setup
+   */
+  namespaces?: string | string[];
+  /**
+   * The options passed to `chokidar`'s `watch`.
+   *
+   * @remarks
+   * `ignoreInitial` defaults to `true`, since chokidar would otherwise replay an `add` event for
+   * every translation file already on disk and trigger a reload for each of them on startup.
+   */
+  options?: ChokidarOptions;
+}
+/**
+ * Used to dynamically add options based on the languages found in {@link InternationalizationHandler.init}.
+ */
+type DynamicOptions<T extends InitOptions> = (namespaces: string[], languages: string[]) => T;
+/**
+ * The options used in {@link InternationalizationHandler}.
+ */
+interface InternationalizationOptions {
+  /**
+   * Used as the default 2nd to last fallback locale if no other is found. It's only followed by
+   * `'en-US'`.
+   */
+  defaultName?: string;
+  /**
+   * The options passed to `backend` in `i18next.init`.
+   */
+  backend?: Backend.Options;
+  /**
+   * The options passed to `i18next.init`.
+   */
+  i18next?: InitOptions | DynamicOptions<InitOptions>;
+  /**
+   * The directory in which `@wolfstar/i18next-backend` should search for files.
+   * @default `rootDirectory/languages`
+   */
+  defaultLanguageDirectory?: string;
+  /**
+   * The default value to be used if a specific language key isn't found. Defaults to
+   * `'default:default'`.
+   */
+  defaultMissingKey?: string;
+  /**
+   * The default namespace that is prefixed to all keys that don't specify it. Defaults to
+   * `'default'`.
+   */
+  defaultNS?: string;
+  /**
+   * Array of formatters to add to i18next.
+   * @default []
+   */
+  formatters?: I18nextFormatter[];
+  /**
+   * Reload languages and namespaces when updating the languages directory.
+   */
+  hmr?: HMROptions;
+  /**
+   * A function that is to be used to retrieve the language for the current context.
+   *
+   * If this is not set, then the language will always be resolved from the interaction's locales.
+   *
+   * This will be inserted for {@link InternationalizationHandler.fetchLanguage}.
+   * @default () => null
+   */
+  fetchLanguage?: (context: InternationalizationContext) => Awaitable<string | null>;
+}
+/**
+ * Context for {@link InternationalizationHandler.fetchLanguage} functions. This context enables
+ * implementation of per-guild, per-channel, and per-user localization.
+ */
+interface InternationalizationContext {
+  /** The ID of the guild the interaction was sent from, or `null` when sent from a DM. */
+  guildId: string | null;
+  /** The ID of the channel the interaction was sent from, or `null` when it was not provided. */
+  channelId: string | null;
+  /** The ID of the user that sent the interaction, or `null` when it was not provided. */
+  userId: string | null;
+  /** The locale the guild the interaction was sent from is configured with. */
+  interactionGuildLocale?: LocaleString;
+  /** The locale the user that sent the interaction is configured with. */
+  interactionLocale?: LocaleString;
+  /**
+   * The preferred locale of the guild the target belongs to.
+   *
+   * @remarks
+   * Filled in from `guild_locale` for an {@link Interaction} and from `preferred_locale` for a
+   * {@link GuildTarget}; a {@link ChannelTarget} and a {@link MessageTarget} carry no locale, so it
+   * is left undefined for them.
+   */
+  preferredLocale?: string;
+}
+interface InternationalizationClientOptions {
+  i18n?: InternationalizationOptions;
+}
+/**
+ * Represents a formatter that is added to i18next with `i18next.services.formatter.add` or
+ * `i18next.services.formatter.addCached`, depending on the `cached` property.
+ *
+ * @see {@link https://www.i18next.com/translation-function/formatting#adding-custom-format-function}
+ */
+type I18nextFormatter = I18nextNamedFormatter | I18nextNamedCachedFormatter;
+/**
+ * Represents a formatter that is added to i18next with `i18next.services.formatter.add`.
+ *
+ * @see {@link https://www.i18next.com/translation-function/formatting#adding-custom-format-function}
+ */
+interface I18nextNamedFormatter {
+  cached?: false;
+  name: string;
+  format(value: any, lng: string | undefined, options: any): string;
+}
+/**
+ * Represents a cached formatter that is added to i18next with `i18next.services.formatter.addCached`.
+ *
+ * @see {@link https://www.i18next.com/translation-function/formatting#adding-custom-format-function}
+ */
+interface I18nextNamedCachedFormatter {
+  cached: true;
+  name: string;
+  format(lng: string | undefined, options: any): (value: any) => string;
+}
+interface LocalizedData {
+  value: string;
+  localizations: LocalizationMap;
+}
+interface BuilderWithName {
+  setName(name: string): this;
+  setNameLocalizations(localizedNames: LocalizationMap | null): this;
+}
+interface BuilderWithDescription {
+  setDescription(description: string): this;
+  setDescriptionLocalizations(localizedDescriptions: LocalizationMap | null): this;
+}
+type BuilderWithNameAndDescription = BuilderWithName & BuilderWithDescription;
+//#endregion
+export { Target as C, MessageTarget as S, InternationalizationContext as _, BuilderWithDescription as a, LocaleSeparator as b, ChannelTarget as c, HMROptions as d, I18nextFormatter as f, InternationalizationClientOptions as g, Interaction as h, AnyNamespace as i, DynamicOptions as l, I18nextNamedFormatter as m, $NoInfer as n, BuilderWithName as o, I18nextNamedCachedFormatter as p, $SpecialObject as r, BuilderWithNameAndDescription as s, $Dictionary as t, GuildTarget as u, InternationalizationOptions as v, LocalizedData as x, LocalePrefixKey as y };
+//# sourceMappingURL=types-BhhqHOJk.d.ts.map

package/dist/esm/types-BhhqHOJk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-BhhqHOJk.d.ts","names":[],"sources":["../../src/lib/types.ts"],"mappings":";;;;;;;;;;;;;;KAqBY,SAAS,MAAM,GAAG;;;;;UAMb;GACd;;;;;;KAOS,iBAAiB,cAAc,eAAe;;;;KAK9C,kBAAkB;;;;;KAMlB,8BAA8B;;;;;;;;;;;KAY9B,wBAAwB;;;;;;;;KASxB,cAAc,KACxB,QAAQ,gBAAgB,+DAGxB,QAAQ,KAAK,QAAQ,gBAAgB;;;;;;;;;UAUtB;EACf;;;;;EAKA;;;;;;;;;;UAWe;EACf;EACA,MAAM;EACN;;;;;;;;;UAUe;EACf;EACA;EACA;EACA,SAAS,KAAK;;;;;;;;;;KAWJ,SAAS,cAAc,gBAAgB,gBAAgB;;;;;;UAOlD;;;;;EAKf;;;;;;;;;EAUA;;;;;;;;;EAUA;;;;;;;;EASA,UAAU;;;;;KAMA,eAAe,UAAU,gBACnC,sBACA,wBACG;;;;UAKY;;;;;EAKf;;;;EAKA,UAAU,QAAQ;;;;EAKlB,UAAU,cAAc,eAAe;;;;;EAMvC;;;;;EAMA;;;;;EAMA;;;;;EAMA,aAAa;;;;EAKb,MAAM;;;;;;;;;EAUN,iBAAiB,SAAS,gCAAgC;;;;;;UAO3C;;EAEf;;EAEA;;EAEA;;EAEA,yBAAyB;;EAEzB,oBAAoB;;;;;;;;;EASpB;;UAGe;EACf,OAAO;;;;;;;;KASG,mBAAmB,wBAAwB;;;;;;UAOtC;EACf;EACA;EACA,OAAO,YAAY,yBAAyB;;;;;;;UAQ7B;EACf;EACA;EACA,OAAO,yBAAyB,gBAAgB;;UAGjC;EACf;EACA,eAAe;;UAGA;EACf,QAAQ;EACR,qBAAqB,gBAAgB;;UAGtB;EACf,eAAe;EACf,4BAA4B,uBAAuB;;KAGzC,gCAAgC,kBAAkB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wolfstar/plugin-i18next",
-  "version": "2.1.2",
+  "version": "2.2.0",
   "description": "Plugin for @wolfstar/http-framework adding i18next-powered internationalization for HTTP interactions",
   "keywords": [
     "discord",
@@ -42,6 +42,18 @@
         "types": "./dist/esm/register.d.ts",
         "default": "./dist/esm/register.js"
       }
+    },
+    "./plugin": {
+      "import": {
+        "types": "./dist/esm/plugin.d.ts",
+        "default": "./dist/esm/plugin.js"
+      }
+    },
+    "./module": {
+      "import": {
+        "types": "./dist/esm/module.d.ts",
+        "default": "./dist/esm/module.js"
+      }
     }
   },
   "publishConfig": {
@@ -60,15 +72,20 @@
   },
   "devDependencies": {
     "@wolfstar/http-framework": "^6.1.0",
-    "@wolfstar/i18next-type-generator": "3.1.5"
+    "@wolfstar/i18next-type-generator": "3.1.5",
+    "@wolfstar/kit": "^0.1.0"
   },
   "peerDependencies": {
     "@wolfstar/http-framework": "^3.1.0 || ^5.0.0 || ^6.0.0",
-    "@wolfstar/i18next-type-generator": "^3.0.0"
+    "@wolfstar/i18next-type-generator": "^3.0.0",
+    "@wolfstar/kit": "^0.1.0"
   },
   "peerDependenciesMeta": {
     "@wolfstar/i18next-type-generator": {
       "optional": true
+    },
+    "@wolfstar/kit": {
+      "optional": true
     }
   },
   "engines": {