@commandkit/i18n 0.1.0

package/LICENSE

@@ -0,0 +1,5 @@
+Copyright 2025 Avraj Sahota
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,22 @@
+# `@commandkit/i18n`
+
+A commandkit plugin for i18next integration.
+
+# Installation
+
+```sh
+$ npm i @commandkit/i18n
+```
+
+# Usage
+
+Add the following to your commandkit config:
+
+```ts
+import { defineConfig } from "commandkit"
+import { i18n } from "@commandkit/i18n"
+
+export default defineConfig({
+  plugins: [i18n()]
+})
+```

package/dist/constants.d.ts

@@ -0,0 +1,3 @@
+import { Locale } from 'discord.js';
+export declare const DISCORD_LOCALES: Set<Locale>;
+export declare const COMMAND_METADATA_KEY = "$command";

package/dist/constants.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COMMAND_METADATA_KEY = exports.DISCORD_LOCALES = void 0;
+const discord_js_1 = require("discord.js");
+exports.DISCORD_LOCALES = new Set(Object.values(discord_js_1.Locale).filter((locale) => !/^\d+/.test(locale)));
+exports.COMMAND_METADATA_KEY = '$command';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uc3RhbnRzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2NvbnN0YW50cy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFBQSwyQ0FBb0M7QUFFdkIsUUFBQSxlQUFlLEdBQUcsSUFBSSxHQUFHLENBQ3BDLE1BQU0sQ0FBQyxNQUFNLENBQUMsbUJBQU0sQ0FBQyxDQUFDLE1BQU0sQ0FBQyxDQUFDLE1BQU0sRUFBRSxFQUFFLENBQUMsQ0FBQyxNQUFNLENBQUMsSUFBSSxDQUFDLE1BQU0sQ0FBQyxDQUFDLENBQy9ELENBQUM7QUFFVyxRQUFBLG9CQUFvQixHQUFHLFVBQVUsQ0FBQyJ9

package/dist/hooks.d.ts

@@ -0,0 +1,7 @@
+import type { Locale } from 'discord.js';
+import type { CommandLocalizationContext } from './i18n';
+/**
+ * Gets the localization context.
+ * @param locale The locale to use. Defaults to the detected locale or the default locale.
+ */
+export declare function locale(locale?: Locale): CommandLocalizationContext;

package/dist/hooks.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.locale = locale;
+const commandkit_1 = require("commandkit");
+/**
+ * Gets the localization context.
+ * @param locale The locale to use. Defaults to the detected locale or the default locale.
+ */
+function locale(locale) {
+    const env = (0, commandkit_1.useEnvironment)();
+    const context = env.context;
+    if (!context) {
+        throw new Error('No localization context found');
+    }
+    return context.locale(locale);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaG9va3MuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvaG9va3MudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7QUFRQSx3QkFTQztBQWZELDJDQUE0QztBQUU1Qzs7O0dBR0c7QUFDSCxTQUFnQixNQUFNLENBQUMsTUFBZTtJQUNwQyxNQUFNLEdBQUcsR0FBRyxJQUFBLDJCQUFjLEdBQUUsQ0FBQztJQUM3QixNQUFNLE9BQU8sR0FBRyxHQUFHLENBQUMsT0FBTyxDQUFDO0lBRTVCLElBQUksQ0FBQyxPQUFPLEVBQUUsQ0FBQztRQUNiLE1BQU0sSUFBSSxLQUFLLENBQUMsK0JBQStCLENBQUMsQ0FBQztJQUNuRCxDQUFDO0lBRUQsT0FBTyxPQUFPLENBQUMsTUFBTSxDQUFDLE1BQU0sQ0FBQyxDQUFDO0FBQ2hDLENBQUMifQ==

package/dist/i18n.d.ts

@@ -0,0 +1,59 @@
+import type { NewableModule, Module, Newable, i18n, InitOptions } from 'i18next';
+import { CommandKitPluginRuntime, RuntimePlugin, CommandKitEnvironment, CommandSource, PreparedAppCommandExecution, CommandBuilderLike, PreRegisterCommandsEvent, CommandKitHMREvent } from 'commandkit';
+import { Locale } from 'discord.js';
+export type Awaitable<T> = Promise<T> | T;
+export type LocalizationModule = NewableModule<Module> | Module | Newable<Module>;
+export type DynamicLocalizationModule = () => Awaitable<LocalizationModule>;
+export interface LocalizationPluginOptions {
+    /**
+     * The i18next plugins to use. The plugins are loaded in the order they are
+     * specified.
+     */
+    plugins?: Array<LocalizationModule | DynamicLocalizationModule>;
+    /**
+     * The i18next initialization options.
+     * @see https://www.i18next.com/overview/configuration-options
+     */
+    i18nOptions?: InitOptions;
+}
+export interface CommandLocalizationContext {
+    /**
+     * The i18next instance.
+     */
+    i18n: i18n;
+    /**
+     * The localization function bound to the current command.
+     * @param key The key to translate.
+     * @param options The options to pass to the translation function.
+     */
+    t: (key: string, options?: Record<string, unknown>) => string;
+    /**
+     * The locale to use for the command.
+     */
+    locale: Locale;
+}
+declare module 'commandkit' {
+    interface LocalizationContext extends CommandLocalizationContext {
+    }
+    interface Context {
+        /**
+         * Returns the localization context for the current command.
+         * @param locale The locale to use. Defaults to the detected locale or the default locale.
+         */
+        locale: (locale?: Locale) => LocalizationContext;
+    }
+}
+export declare class I18nPlugin extends RuntimePlugin<LocalizationPluginOptions> {
+    readonly name = "I18nPlugin";
+    private i18n;
+    private metadata;
+    activate(ctx: CommandKitPluginRuntime): Promise<void>;
+    private getLoadPath;
+    private scanLocaleDirectory;
+    performHMR(ctx: CommandKitPluginRuntime, event: CommandKitHMREvent): Promise<void>;
+    private loadMetadata;
+    private getBackendOptions;
+    executeCommand(ctx: CommandKitPluginRuntime, env: CommandKitEnvironment, source: CommandSource, command: PreparedAppCommandExecution): Promise<boolean>;
+    prepareCommand(ctx: CommandKitPluginRuntime, command: CommandBuilderLike): Promise<CommandBuilderLike | null>;
+    onBeforeRegisterCommands(ctx: CommandKitPluginRuntime, event: PreRegisterCommandsEvent): Promise<void>;
+}

package/dist/i18n.js

@@ -0,0 +1,189 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.I18nPlugin = void 0;
+const i18next_1 = __importDefault(require("i18next"));
+const commandkit_1 = require("commandkit");
+const i18next_fs_backend_1 = __importDefault(require("i18next-fs-backend"));
+const path_1 = require("path");
+const fs_1 = require("fs");
+const constants_1 = require("./constants");
+const utils_1 = require("./utils");
+const promises_1 = require("fs/promises");
+commandkit_1.Context.prototype.locale = function (locale) {
+    const env = this.config.environment || (0, commandkit_1.useEnvironment)();
+    const detectedLocale = locale || this.getLocale();
+    const i18n = env.variables.get('i18n:plugin:instance');
+    if (!i18n) {
+        throw new Error('I18n plugin not found in context environment variables');
+    }
+    return {
+        t: i18n.getFixedT(detectedLocale, this.getCommandIdentifier()),
+        locale: detectedLocale,
+        i18n,
+    };
+};
+class I18nPlugin extends commandkit_1.RuntimePlugin {
+    constructor() {
+        super(...arguments);
+        this.name = 'I18nPlugin';
+        this.metadata = new Map();
+    }
+    async activate(ctx) {
+        this.i18n = i18next_1.default;
+        this.i18n.use(i18next_fs_backend_1.default);
+        if (this.options.plugins?.length) {
+            for (const plugin of this.options.plugins) {
+                if (typeof plugin === 'function') {
+                    const module = await plugin();
+                    this.i18n.use(module);
+                }
+                else {
+                    this.i18n.use(plugin);
+                }
+            }
+        }
+        // Setup better debugging
+        const debug = this.options.i18nOptions?.debug || false;
+        const { namespaces, languages } = await this.scanLocaleDirectory();
+        await this.i18n.init({
+            initAsync: false,
+            fallbackLng: 'en-US',
+            debug,
+            ns: namespaces,
+            preload: languages,
+            load: 'all',
+            interpolation: {
+                escapeValue: false,
+                skipOnVariables: false,
+            },
+            ...this.options.i18nOptions,
+            backend: this.getBackendOptions(),
+        });
+        // Check if we have any languages available
+        if (this.i18n.languages.length === 0) {
+            commandkit_1.Logger.warn('I18nPlugin: No languages loaded. Using default language only.');
+        }
+        // Set the default locale for command execution
+        ctx.commandkit.config.defaultLocale = (this.i18n.language ||
+            'en-US');
+        commandkit_1.Logger.info('I18nPlugin has been activated');
+    }
+    getLoadPath() {
+        return (0, path_1.join)((0, commandkit_1.getCurrentDirectory)(), '/app/locales/{{lng}}/{{ns}}.json');
+    }
+    async scanLocaleDirectory() {
+        const endPattern = /{{lng}}(\/|\\){{ns}}.json$/;
+        const localesPath = this.getLoadPath();
+        const scanDirTarget = localesPath.replace(endPattern, '');
+        if (!(0, fs_1.existsSync)(scanDirTarget)) {
+            commandkit_1.Logger.warn(`I18nPlugin: No locales directory found at ${scanDirTarget}. Skipping scan.`);
+            return { namespaces: [], languages: [] };
+        }
+        const namespaces = new Set();
+        const languages = new Set();
+        const files = await (0, promises_1.readdir)(scanDirTarget, { withFileTypes: true });
+        for (const file of files) {
+            const isValidLocale = constants_1.DISCORD_LOCALES.has(file.name);
+            if (file.isDirectory()) {
+                if (!isValidLocale) {
+                    commandkit_1.Logger.warn(`I18nPlugin: Invalid locale directory ${file.name}`);
+                    continue;
+                }
+                languages.add(file.name);
+                const files = await (0, promises_1.readdir)((0, path_1.join)(scanDirTarget, file.name), {
+                    withFileTypes: true,
+                });
+                for (const file of files) {
+                    if (file.isFile()) {
+                        const ext = (0, path_1.extname)(file.name);
+                        if (!/\.json$/.test(ext))
+                            continue;
+                        const name = (0, path_1.basename)(file.name, ext);
+                        namespaces.add(name);
+                        const locale = (0, path_1.basename)(file.parentPath);
+                        await this.loadMetadata((0, path_1.join)(file.parentPath, file.name), locale, name);
+                    }
+                }
+            }
+            else if (file.isFile()) {
+                const ext = (0, path_1.extname)(file.name);
+                if (!/\.json$/.test(ext))
+                    continue;
+                const name = (0, path_1.basename)(file.name, ext);
+                namespaces.add(name);
+                const locale = (0, path_1.basename)(file.parentPath);
+                await this.loadMetadata((0, path_1.join)(file.parentPath, file.name), locale, name);
+            }
+        }
+        return {
+            namespaces: Array.from(namespaces),
+            languages: Array.from(languages),
+        };
+    }
+    async performHMR(ctx, event) {
+        const targetLocation = event.path;
+        const localeDir = (0, path_1.join)(process.cwd(), '/src/app/locales');
+        if (!targetLocation.startsWith(localeDir))
+            return;
+        event.accept();
+        event.preventDefault();
+        const { languages, namespaces } = await this.scanLocaleDirectory();
+        await this.i18n.reloadResources(languages, namespaces);
+        await ctx.commandkit.reloadCommands();
+    }
+    async loadMetadata(filePath, locale, name) {
+        try {
+            const translationResource = JSON.parse(await (0, promises_1.readFile)(filePath, {
+                encoding: 'utf8',
+            }));
+            const translation = translationResource.default || translationResource;
+            if (!translation)
+                return;
+            const metadata = translation[constants_1.COMMAND_METADATA_KEY];
+            if (metadata) {
+                this.metadata.set(`${locale}:${name}`, metadata);
+            }
+        }
+        catch { }
+    }
+    getBackendOptions() {
+        const loadPath = this.getLoadPath();
+        return {
+            loadPath: function (lng, namespace) {
+                const path = loadPath
+                    .replace(/{{lng}}/g, lng)
+                    .replace(/{{ns}}/g, namespace);
+                return path;
+            },
+        };
+    }
+    async executeCommand(ctx, env, source, command) {
+        env.variables.set('i18n:plugin:instance', this.i18n);
+        return false;
+    }
+    async prepareCommand(ctx, command) {
+        const data = 'toJSON' in command ? command.toJSON() : command;
+        for (const locale of constants_1.DISCORD_LOCALES) {
+            try {
+                const translation = this.metadata.get(`${locale}:${data.name}`);
+                if (!translation)
+                    continue;
+                (0, utils_1.applyTranslations)(data, locale, translation);
+            }
+            catch (e) {
+                console.log(e);
+                continue;
+            }
+        }
+        return data;
+    }
+    async onBeforeRegisterCommands(ctx, event) {
+        event.preventDefault();
+        (0, fs_1.writeFileSync)(`./.commandkit/cmd.json`, JSON.stringify(event.commands, null, 2));
+    }
+}
+exports.I18nPlugin = I18nPlugin;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaTE4bi5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9pMThuLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7OztBQUFBLHNEQUE4QjtBQVE5QiwyQ0Fhb0I7QUFDcEIsNEVBQTJDO0FBQzNDLCtCQUErQztBQUcvQywyQkFBK0M7QUFFL0MsMkNBQW9FO0FBQ3BFLG1DQUE0QztBQUM1QywwQ0FBZ0Q7QUFxRGhELG9CQUFhLENBQUMsU0FBUyxDQUFDLE1BQU0sR0FBRyxVQUFVLE1BQWU7SUFDeEQsTUFBTSxHQUFHLEdBQUcsSUFBSSxDQUFDLE1BQU0sQ0FBQyxXQUFXLElBQUksSUFBQSwyQkFBYyxHQUFFLENBQUM7SUFDeEQsTUFBTSxjQUFjLEdBQVcsTUFBTSxJQUFJLElBQUksQ0FBQyxTQUFTLEVBQUUsQ0FBQztJQUMxRCxNQUFNLElBQUksR0FBRyxHQUFHLENBQUMsU0FBUyxDQUFDLEdBQUcsQ0FBQyxzQkFBc0IsQ0FBUyxDQUFDO0lBRS9ELElBQUksQ0FBQyxJQUFJLEVBQUUsQ0FBQztRQUNWLE1BQU0sSUFBSSxLQUFLLENBQUMsd0RBQXdELENBQUMsQ0FBQztJQUM1RSxDQUFDO0lBRUQsT0FBTztRQUNMLENBQUMsRUFBRSxJQUFJLENBQUMsU0FBUyxDQUFDLGNBQWMsRUFBRSxJQUFJLENBQUMsb0JBQW9CLEVBQUUsQ0FBQztRQUM5RCxNQUFNLEVBQUUsY0FBYztRQUN0QixJQUFJO0tBQ2dDLENBQUM7QUFDekMsQ0FBQyxDQUFDO0FBRUYsTUFBYSxVQUFXLFNBQVEsMEJBQXdDO0lBQXhFOztRQUNrQixTQUFJLEdBQUcsWUFBWSxDQUFDO1FBRTVCLGFBQVEsR0FBRyxJQUFJLEdBQUcsRUFBc0MsQ0FBQztJQW1PbkUsQ0FBQztJQWpPUSxLQUFLLENBQUMsUUFBUSxDQUFDLEdBQTRCO1FBQ2hELElBQUksQ0FBQyxJQUFJLEdBQUcsaUJBQU8sQ0FBQztRQUVwQixJQUFJLENBQUMsSUFBSSxDQUFDLEdBQUcsQ0FBQyw0QkFBUyxDQUFD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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+import { I18nPlugin, LocalizationPluginOptions } from './i18n';
+export declare function i18n(options?: LocalizationPluginOptions): I18nPlugin;

package/dist/index.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.i18n = i18n;
+const i18n_1 = require("./i18n");
+function i18n(options) {
+    const opt = {
+        ...options,
+        i18nOptions: {
+            defaultNS: 'default',
+            fallbackLng: 'en-US',
+            load: 'currentOnly',
+            saveMissing: false,
+            partialBundledLanguages: true,
+            ...options?.i18nOptions,
+        },
+    };
+    const localization = new i18n_1.I18nPlugin(opt);
+    return localization;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7QUFFQSxvQkFnQkM7QUFsQkQsaUNBQStEO0FBRS9ELFNBQWdCLElBQUksQ0FBQyxPQUFtQztJQUN0RCxNQUFNLEdBQUcsR0FBRztRQUNWLEdBQUcsT0FBTztRQUNWLFdBQVcsRUFBRTtZQUNYLFNBQVMsRUFBRSxTQUFTO1lBQ3BCLFdBQVcsRUFBRSxPQUFPO1lBQ3BCLElBQUksRUFBRSxhQUFhO1lBQ25CLFdBQVcsRUFBRSxLQUFLO1lBQ2xCLHVCQUF1QixFQUFFLElBQUk7WUFDN0IsR0FBRyxPQUFPLEVBQUUsV0FBVztTQUN4QjtLQUMyQixDQUFDO0lBRS9CLE1BQU0sWUFBWSxHQUFHLElBQUksaUJBQVUsQ0FBQyxHQUFHLENBQUMsQ0FBQztJQUV6QyxPQUFPLFlBQVksQ0FBQztBQUN0QixDQUFDIn0=

package/dist/types.d.ts

@@ -0,0 +1,10 @@
+import { COMMAND_METADATA_KEY } from './constants';
+export interface CommandTranslationMetadata {
+    name?: string;
+    description?: string;
+    options?: (Record<'name' | 'description', string> | Record<string, Record<'name' | 'description', string>>)[];
+}
+export interface CommandTranslation {
+    [COMMAND_METADATA_KEY]: CommandTranslationMetadata;
+    translations: Record<string, any>;
+}

package/dist/types.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const constants_1 = require("./constants");
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvdHlwZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7QUFBQSwyQ0FBbUQifQ==

package/dist/utils.d.ts

@@ -0,0 +1,3 @@
+import type { CommandBuilderLike } from 'commandkit';
+import type { CommandTranslationMetadata } from './types';
+export declare function applyTranslations(command: CommandBuilderLike, locale: string, translation: CommandTranslationMetadata): CommandBuilderLike;

package/dist/utils.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyTranslations = applyTranslations;
+function applyTranslations(command, locale, translation) {
+    const json = 'toJSON' in command ? command.toJSON() : command;
+    const { name, description, options } = translation;
+    if (name) {
+        json.name ?? (json.name = name);
+        json.name_localizations ?? (json.name_localizations = {});
+        json.name_localizations[locale] = name;
+    }
+    if (description) {
+        json.description ?? (json.description = description);
+        json.description_localizations ?? (json.description_localizations = {});
+        json.description_localizations[locale] = description;
+    }
+    if (options) {
+        json.options ?? (json.options = []);
+        const applyToOptions = (option, optionTranslation) => {
+            const { name, description } = optionTranslation;
+            if (name) {
+                option.name ?? (option.name = name);
+                option.name_localizations ?? (option.name_localizations = {});
+                option.name_localizations[locale] = name;
+            }
+            if (description) {
+                option.description ?? (option.description = description);
+                option.description_localizations ?? (option.description_localizations = {});
+                option.description_localizations[locale] = description;
+            }
+            if (option.options) {
+                for (let i = 0; i < option.options.length; i++) {
+                    const subOption = option.options[i];
+                    const subOptionTranslation = optionTranslation.options?.[i];
+                    if (subOptionTranslation) {
+                        applyToOptions(subOption, subOptionTranslation);
+                    }
+                }
+            }
+        };
+        for (let i = 0; i < json.options.length; i++) {
+            const cmdOption = json.options[i];
+            const optionTranslation = options[i];
+            if (optionTranslation) {
+                if (Array.isArray(optionTranslation)) {
+                    for (const subOptionTranslation of optionTranslation) {
+                        applyToOptions(cmdOption, subOptionTranslation);
+                    }
+                }
+                else {
+                    applyToOptions(cmdOption, optionTranslation);
+                }
+            }
+        }
+    }
+    return json;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXRpbHMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvdXRpbHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7QUFHQSw4Q0FtRUM7QUFuRUQsU0FBZ0IsaUJBQWlCLENBQy9CLE9BQTJCLEVBQzNCLE1BQWMsRUFDZCxXQUF1QztJQUV2QyxNQUFNLElBQUksR0FBRyxRQUFRLElBQUksT0FBTyxDQUFDLENBQUMsQ0FBQyxPQUFPLENBQUMsTUFBTSxFQUFFLENBQUMsQ0FBQyxDQUFDLE9BQU8sQ0FBQztJQUM5RCxNQUFNLEVBQUUsSUFBSSxFQUFFLFdBQVcsRUFBRSxPQUFPLEVBQUUsR0FBRyxXQUFXLENBQUM7SUFFbkQsSUFBSSxJQUFJLEVBQUUsQ0FBQztRQUNULElBQUksQ0FBQyxJQUFJLEtBQVQsSUFBSSxDQUFDLElBQUksR0FBSyxJQUFJLEVBQUM7UUFDbkIsSUFBSSxDQUFDLGtCQUFrQixLQUF2QixJQUFJLENBQUMsa0JBQWtCLEdBQUssRUFBRSxFQUFDO1FBQy9CLElBQUksQ0FBQyxrQkFBa0IsQ0FBQyxNQUFNLENBQUMsR0FBRyxJQUFJLENBQUM7SUFDekMsQ0FBQztJQUVELElBQUksV0FBVyxFQUFFLENBQUM7UUFDaEIsSUFBSSxDQUFDLFdBQVcsS0FBaEIsSUFBSSxDQUFDLFdBQVcsR0FBSyxXQUFXLEVBQUM7UUFDakMsSUFBSSxDQUFDLHlCQUF5QixLQUE5QixJQUFJLENBQUMseUJBQXlCLEdBQUssRUFBRSxFQUFDO1FBQ3RDLElBQUksQ0FBQyx5QkFBeUIsQ0FBQyxNQUFNLENBQUMsR0FBRyxXQUFXLENBQUM7SUFDdkQsQ0FBQztJQUVELElBQUksT0FBTyxFQUFFLENBQUM7UUFDWixJQUFJLENBQUMsT0FBTyxLQUFaLElBQUksQ0FBQyxPQUFPLEdBQUssRUFBRSxFQUFDO1FBQ3BCLE1BQU0sY0FBYyxHQUFHLENBQ3JCLE1BQTJCLEVBQzNCLGlCQUFzQyxFQUN0QyxFQUFFO1lBQ0YsTUFBTSxFQUFFLElBQUksRUFBRSxXQUFXLEVBQUUsR0FBRyxpQkFBaUIsQ0FBQztZQUNoRCxJQUFJLElBQUksRUFBRSxDQUFDO2dCQUNULE1BQU0sQ0FBQyxJQUFJLEtBQVgsTUFBTSxDQUFDLElBQUksR0FBSyxJQUFJLEVBQUM7Z0JBQ3JCLE1BQU0sQ0FBQyxrQkFBa0IsS0FBekIsTUFBTSxDQUFDLGtCQUFrQixHQUFLLEVBQUUsRUFBQztnQkFDakMsTUFBTSxDQUFDLGtCQUFrQixDQUFDLE1BQU0sQ0FBQyxHQUFHLElBQUksQ0FBQztZQUMzQyxDQUFDO1lBRUQsSUFBSSxXQUFXLEVBQUUsQ0FBQztnQkFDaEIsTUFBTSxDQUFDLFdBQVcsS0FBbEIsTUFBTSxDQUFDLFdBQVcsR0FBSyxXQUFXLEVBQUM7Z0JBQ25DLE1BQU0sQ0FBQyx5QkFBeUIsS0FBaEMsTUFBTSxDQUFDLHlCQUF5QixHQUFLLEVBQUUsRUFBQztnQkFDeEMsTUFBTSxDQUFDLHlCQUF5QixDQUFDLE1BQU0sQ0FBQyxHQUFHLFdBQVcsQ0FBQztZQUN6RCxDQUFDO1lBRUQsSUFBSSxNQUFNLENBQUMsT0FBTyxFQUFFLENBQUM7Z0JBQ25CLEtBQUssSUFBSSxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUMsR0FBRyxNQUFNLENBQUMsT0FBTyxDQUFDLE1BQU0sRUFBRSxDQUFDLEVBQUUsRUFBRSxDQUFDO29CQUMvQyxNQUFNLFNBQVMsR0FBRyxNQUFNLENBQUMsT0FBTyxDQUFDLENBQUMsQ0FBQyxDQUFDO29CQUNwQyxNQUFNLG9CQUFvQixHQUFHLGlCQUFpQixDQUFDLE9BQU8sRUFBRSxDQUFDLENBQUMsQ0FBQyxDQUFDO29CQUM1RCxJQUFJLG9CQUFvQixFQUFFLENBQUM7d0JBQ3pCLGNBQWMsQ0FBQyxTQUFTLEVBQUUsb0JBQW9CLENBQUMsQ0FBQztvQkFDbEQsQ0FBQztnQkFDSCxDQUFDO1lBQ0gsQ0FBQztRQUNILENBQUMsQ0FBQztRQUVGLEtBQUssSUFBSSxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUMsR0FBRyxJQUFJLENBQUMsT0FBTyxDQUFDLE1BQU0sRUFBRSxDQUFDLEVBQUUsRUFBRSxDQUFDO1lBQzdDLE1BQU0sU0FBUyxHQUFHLElBQUksQ0FBQyxPQUFPLENBQUMsQ0FBQyxDQUFDLENBQUM7WUFDbEMsTUFBTSxpQkFBaUIsR0FBRyxPQUFPLENBQUMsQ0FBQyxDQUFDLENBQUM7WUFFckMsSUFBSSxpQkFBaUIsRUFBRSxDQUFDO2dCQUN0QixJQUFJLEtBQUssQ0FBQyxPQUFPLENBQUMsaUJBQWlCLENBQUMsRUFBRSxDQUFDO29CQUNyQyxLQUFLLE1BQU0sb0JBQW9CLElBQUksaUJBQWlCLEVBQUUsQ0FBQzt3QkFDckQsY0FBYyxDQUFDLFNBQVMsRUFBRSxvQkFBb0IsQ0FBQyxDQUFDO29CQUNsRCxDQUFDO2dCQUNILENBQUM7cUJBQU0sQ0FBQztvQkFDTixjQUFjLENBQUMsU0FBUyxFQUFFLGlCQUFpQixDQUFDLENBQUM7Z0JBQy9DLENBQUM7WUFDSCxDQUFDO1FBQ0gsQ0FBQztJQUNILENBQUM7SUFFRCxPQUFPLElBQUksQ0FBQztBQUNkLENBQUMifQ==

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@commandkit/i18n",
+  "version": "0.1.0",
+  "description": "CommandKit plugin that adds command localizations backed by i18next",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/underctrl-io/commandkit.git"
+  },
+  "keywords": [
+    "commandkit",
+    "redis",
+    "cache"
+  ],
+  "author": "twilight <hello@twlite.dev>",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/underctrl-io/commandkit/issues"
+  },
+  "homepage": "https://github.com/underctrl-io/commandkit#readme",
+  "dependencies": {
+    "i18next": "^24.2.3",
+    "i18next-fs-backend": "^2.6.0"
+  },
+  "devDependencies": {
+    "discord.js": "14",
+    "typescript": "^5.7.3",
+    "commandkit": "0.1.11",
+    "tsconfig": "0.0.0"
+  },
+  "scripts": {
+    "lint": "tsc --noEmit",
+    "build": "tsc"
+  }
+}