@eggjs/i18n 4.0.0-beta.20 → 4.0.0-beta.21

package/dist/app/extend/application.d.ts

@@ -1,2 +1,8 @@
-import { I18N_RESOURCES, I18nApplication } from "../../application-CY4eNoP8.js";
-export { I18N_RESOURCES, I18nApplication as default };
+import { Application } from 'egg';
+export declare const I18N_RESOURCES: unique symbol;
+export default class I18nApplication extends Application {
+    [I18N_RESOURCES]: Record<string, Record<string, string>>;
+    isSupportLocale(locale: string): boolean;
+    gettext(locale: string, key: string, value?: any, ...args: any[]): string;
+    __(locale: string, key: string, value?: any, ...args: any[]): string;
+}

package/dist/app/extend/application.js

@@ -1,4 +1,76 @@
-import "../../utils-D06av2P8.js";
-import { I18N_RESOURCES, I18nApplication } from "../../application-BzyHiDpF.js";
-
-export { I18N_RESOURCES, I18nApplication as default };
+import { debuglog, format } from 'node:util';
+import { Application } from 'egg';
+import { isObject } from "../../utils.js";
+const debug = debuglog('egg/i18n/app/extend/application');
+export const I18N_RESOURCES = Symbol('Application i18n resources');
+export default class I18nApplication extends Application {
+    isSupportLocale(locale) {
+        return !!this[I18N_RESOURCES][locale];
+    }
+    gettext(locale, key, value, ...args) {
+        if (!locale || !key) {
+            // __()
+            // __('en')
+            return '';
+        }
+        const resource = this[I18N_RESOURCES][locale] || {};
+        let text = resource[key];
+        if (text === undefined) {
+            text = key;
+        }
+        debug('%s: %j => %j', locale, key, text);
+        if (!text) {
+            return '';
+        }
+        if (value === undefined) {
+            // __(locale, key)
+            return text;
+        }
+        if (args.length === 0) {
+            if (isObject(value)) {
+                // __(locale, key, object)
+                // __('zh', '{a} {b} {b} {a}', {a: 'foo', b: 'bar'})
+                // =>
+                // foo bar bar foo
+                return formatWithObject(text, value);
+            }
+            if (Array.isArray(value)) {
+                // __(locale, key, array)
+                // __('zh', '{0} {1} {1} {0}', ['foo', 'bar'])
+                // =>
+                // foo bar bar foo
+                return formatWithArray(text, value);
+            }
+            // __(locale, key, value)
+            return format(text, value);
+        }
+        // __(locale, key, value1, ...)
+        return format(text, value, ...args);
+    }
+    __(locale, key, value, ...args) {
+        return this.gettext(locale, key, value, ...args);
+    }
+}
+const ARRAY_INDEX_RE = /\{(\d+)\}/g;
+function formatWithArray(text, values) {
+    return text.replace(ARRAY_INDEX_RE, (original, matched) => {
+        const index = parseInt(matched);
+        if (index < values.length) {
+            return values[index];
+        }
+        // not match index, return original text
+        return original;
+    });
+}
+const Object_INDEX_RE = /\{(.+?)\}/g;
+function formatWithObject(text, values) {
+    return text.replace(Object_INDEX_RE, (original, matched) => {
+        const value = values[matched];
+        if (value) {
+            return value;
+        }
+        // not match index, return original text
+        return original;
+    });
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXBwbGljYXRpb24uanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvYXBwL2V4dGVuZC9hcHBsaWNhdGlvbi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsUUFBUSxFQUFFLE1BQU0sRUFBRSxNQUFNLFdBQVcsQ0FBQztBQUU3QyxPQUFPLEVBQUUsV0FBVyxFQUFFLE1BQU0sS0FBSyxDQUFDO0FBRWxDLE9BQU8sRUFBRSxRQUFRLEVBQUUsTUFBTSxnQkFBZ0IsQ0FBQztBQUUxQyxNQUFNLEtBQUssR0FBRyxRQUFRLENBQUMsaUNBQWlDLENBQUMsQ0FBQztBQUUxRCxNQUFNLENBQUMsTUFBTSxjQUFjLEdBQUcsTUFBTSxDQUFDLDRCQUE0QixDQUFDLENBQUM7QUFFbkUsTUFBTSxDQUFDLE9BQU8sT0FBTyxlQUFnQixTQUFRLFdBQVc7SUFHdEQsZUFBZSxDQUFDLE1BQWM7UUFDNUIsT0FBTyxDQUFDLENBQUMsSUFBSSxDQUFDLGNBQWMsQ0FBQyxDQUFDLE1BQU0sQ0FBQyxDQUFDO0lBQ3hDLENBQUM7SUFFRCxPQUFPLENBQUMsTUFBYyxFQUFFLEdBQVcsRUFBRSxLQUFXLEVBQUUsR0FBRyxJQUFXO1FBQzlELElBQUksQ0FBQyxNQUFNLElBQUksQ0FBQyxHQUFHLEVBQUUsQ0FBQztZQUNwQixPQUFPO1lBQ1AsV0FBVztZQUNYLE9BQU8sRUFBRSxDQUFDO1FBQ1osQ0FBQztRQUVELE1BQU0sUUFBUSxHQUFHLElBQUksQ0FBQyxjQUFjLENBQUMsQ0FBQyxNQUFNLENBQUMsSUFBSSxFQUFFLENBQUM7UUFFcEQsSUFBSSxJQUFJLEdBQUcsUUFBUSxDQUFDLEdBQUcsQ0FBQyxDQUFDO1FBQ3pCLElBQUksSUFBSSxLQUFLLFNBQVMsRUFBRSxDQUFDO1lBQ3ZCLElBQUksR0FBRyxHQUFHLENBQUM7UUFDYixDQUFDO1FBRUQsS0FBSyxDQUFDLGNBQWMsRUFBRSxNQUFNLEVBQUUsR0FBRyxFQUFFLElBQUksQ0FBQyxDQUFDO1FBQ3pDLElBQUksQ0FBQyxJQUFJLEVBQUUsQ0FBQztZQUNWLE9BQU8sRUFBRSxDQUFDO1FBQ1osQ0FBQztRQUVELElBQUksS0FBSyxLQUFLLFNBQVMsRUFBRSxDQUFDO1lBQ3hCLGtCQUFrQjtZQUNsQixPQUFPLElBQUksQ0FBQztRQUNkLENBQUM7UUFDRCxJQUFJLElBQUksQ0FBQyxNQUFNLEtBQUssQ0FBQyxFQUFFLENBQUM7WUFDdEIsSUFBSSxRQUFRLENBQUMsS0FBSyxDQUFDLEVBQUUsQ0FBQztnQkFDcEIsMEJBQTBCO2dCQUMxQixvREFBb0Q7Z0JBQ3BELEtBQUs7Z0JBQ0wsa0JBQWtCO2dCQUNsQixPQUFPLGdCQUFnQixDQUFDLElBQUksRUFBRSxLQUFLLENBQUMsQ0FBQztZQUN2QyxDQUFDO1lBRUQsSUFBSSxLQUFLLENBQUMsT0FBTyxDQUFDLEtBQUssQ0FBQyxFQUFFLENBQUM7Z0JBQ3pCLHlCQUF5QjtnQkFDekIsOENBQThDO2dCQUM5QyxLQUFLO2dCQUNMLGtCQUFrQjtnQkFDbEIsT0FBTyxlQUFlLENBQUMsSUFBSSxFQUFFLEtBQUssQ0FBQyxDQUFDO1lBQ3RDLENBQUM7WUFFRCx5QkFBeUI7WUFDekIsT0FBTyxNQUFNLENBQUMsSUFBSSxFQUFFLEtBQUssQ0FBQyxDQUFDO1FBQzdCLENBQUM7UUFFRCwrQkFBK0I7UUFDL0IsT0FBTyxNQUFNLENBQUMsSUFBSSxFQUFFLEtBQUssRUFBRSxHQUFHLElBQUksQ0FBQyxDQUFDO0lBQ3RDLENBQUM7SUFFRCxFQUFFLENBQUMsTUFBYyxFQUFFLEdBQVcsRUFBRSxLQUFXLEVBQUUsR0FBRyxJQUFXO1FBQ3pELE9BQU8sSUFBSSxDQUFDLE9BQU8sQ0FBQyxNQUFNLEVBQUUsR0FBRyxFQUFFLEtBQUssRUFBRSxHQUFHLElBQUksQ0FBQyxDQUFDO0lBQ25ELENBQUM7Q0FDRjtBQUVELE1BQU0sY0FBYyxHQUFHLFlBQVksQ0FBQztBQUNwQyxTQUFTLGVBQWUsQ0FBQyxJQUFZLEVBQUUsTUFBYTtJQUNsRCxPQUFPLElBQUksQ0FBQyxPQUFPLENBQUMsY0FBYyxFQUFFLENBQUMsUUFBUSxFQUFFLE9BQU8sRUFBRSxFQUFFO1FBQ3hELE1BQU0sS0FBSyxHQUFHLFFBQVEsQ0FBQyxPQUFPLENBQUMsQ0FBQztRQUNoQyxJQUFJLEtBQUssR0FBRyxNQUFNLENBQUMsTUFBTSxFQUFFLENBQUM7WUFDMUIsT0FBTyxNQUFNLENBQUMsS0FBSyxDQUFDLENBQUM7UUFDdkIsQ0FBQztRQUNELHdDQUF3QztRQUN4QyxPQUFPLFFBQVEsQ0FBQztJQUNsQixDQUFDLENBQUMsQ0FBQztBQUNMLENBQUM7QUFFRCxNQUFNLGVBQWUsR0FBRyxZQUFZLENBQUM7QUFDckMsU0FBUyxnQkFBZ0IsQ0FBQyxJQUFZLEVBQUUsTUFBMkI7SUFDakUsT0FBTyxJQUFJLENBQUMsT0FBTyxDQUFDLGVBQWUsRUFBRSxDQUFDLFFBQVEsRUFBRSxPQUFPLEVBQUUsRUFBRTtRQUN6RCxNQUFNLEtBQUssR0FBRyxNQUFNLENBQUMsT0FBTyxDQUFDLENBQUM7UUFDOUIsSUFBSSxLQUFLLEVBQUUsQ0FBQztZQUNWLE9BQU8sS0FBSyxDQUFDO1FBQ2YsQ0FBQztRQUNELHdDQUF3QztRQUN4QyxPQUFPLFFBQVEsQ0FBQztJQUNsQixDQUFDLENBQUMsQ0FBQztBQUNMLENBQUMifQ==

package/dist/app/extend/context.d.ts

@@ -1,2 +1,72 @@
-import { I18nContext } from "../../context-0NWdtfPn.js";
-export { I18nContext as default };
+import { Context } from 'egg';
+export default class I18nContext extends Context {
+    /**
+     * get current request locale
+     * @member Context#locale
+     * @return {String} lower case locale string, e.g.: 'zh-cn', 'en-us'
+     */
+    get locale(): string;
+    set locale(l: string);
+    /**
+     * `ctx.__` 的别名。
+     * @see {@link Context#__}
+     * @function Context#gettext
+     */
+    gettext(key: string, value?: any, ...args: any[]): string;
+    /**
+     * 如果开启了 I18n 多语言功能，那么会出现此 API，通过它可以获取到当前请求对应的本地化数据。
+     *
+     * 详细使用说明，请查看 {@link I18n}
+     * - `ctx.__ = function (key, value[, value2, ...])`: 类似 `util.format` 接口
+     * - `ctx.__ = function (key, values)`: 支持数组下标占位符方式，如
+     * - `__` 的别名是 `gettext(key, value)`
+     *
+     * > NOTE: __ 是两个下划线哦！
+     * @function Context#__
+     * @example
+     * ```js
+     * ctx.__('{0} {0} {1} {1}'), ['foo', 'bar'])
+     * ctx.gettext('{0} {0} {1} {1}'), ['foo', 'bar'])
+     * =>
+     * foo foo bar bar
+     * ```
+     * ##### Controller 下的使用示例
+     *
+     * ```js
+     * module.exports = function* () {
+     *   this.body = {
+     *     message: this.__('Welcome back, %s!', this.user.name),
+     *     // 或者使用 gettext，如果觉得 __ 不好看的话
+     *     // message: this.gettext('Welcome back, %s!', this.user.name),
+     *     user: this.user,
+     *   };
+     * };
+     * ```
+     *
+     * ##### View 文件下的使用示例
+     *
+     * ```html
+     * <li>{{ __('Email') }}: {{ user.email }}</li>
+     * <li>
+     *   {{ __('Hello %s, how are you today?', user.name) }}
+     * </li>
+     * <li>
+     *   {{ __('{0} {0} {1} {1}'), ['foo', 'bar']) }}
+     * </li>
+     * ```
+     *
+     * ##### locale 参数获取途径
+     *
+     * 优先级从上到下：
+     *
+     * - query: `/?locale=en-US`
+     * - cookie: `locale=zh-TW`
+     * - header: `Accept-Language: zh-CN,zh;q=0.5`
+     */
+    __(key: string, value?: any, ...args: any[]): string;
+    __locale: string;
+    __getLocale(): string;
+    __localeOrigin: string;
+    __getLocaleOrigin(): string;
+    __setLocale(locale: string): void;
+}

package/dist/app/extend/context.js

@@ -1,4 +1,176 @@
-import "../../utils-D06av2P8.js";
-import { I18nContext } from "../../context-BP8fJWAn.js";
-
-export { I18nContext as default };
+import { debuglog } from 'node:util';
+import { Context } from 'egg';
+import { formatLocale } from "../../utils.js";
+const debug = debuglog('egg/i18n/app/extend/context');
+export default class I18nContext extends Context {
+    /**
+     * get current request locale
+     * @member Context#locale
+     * @return {String} lower case locale string, e.g.: 'zh-cn', 'en-us'
+     */
+    get locale() {
+        return this.__getLocale();
+    }
+    set locale(l) {
+        this.__setLocale(l);
+    }
+    /**
+     * `ctx.__` 的别名。
+     * @see {@link Context#__}
+     * @function Context#gettext
+     */
+    gettext(key, value, ...args) {
+        return this.app.gettext(this.locale, key, value, ...args);
+    }
+    /**
+     * 如果开启了 I18n 多语言功能，那么会出现此 API，通过它可以获取到当前请求对应的本地化数据。
+     *
+     * 详细使用说明，请查看 {@link I18n}
+     * - `ctx.__ = function (key, value[, value2, ...])`: 类似 `util.format` 接口
+     * - `ctx.__ = function (key, values)`: 支持数组下标占位符方式，如
+     * - `__` 的别名是 `gettext(key, value)`
+     *
+     * > NOTE: __ 是两个下划线哦！
+     * @function Context#__
+     * @example
+     * ```js
+     * ctx.__('{0} {0} {1} {1}'), ['foo', 'bar'])
+     * ctx.gettext('{0} {0} {1} {1}'), ['foo', 'bar'])
+     * =>
+     * foo foo bar bar
+     * ```
+     * ##### Controller 下的使用示例
+     *
+     * ```js
+     * module.exports = function* () {
+     *   this.body = {
+     *     message: this.__('Welcome back, %s!', this.user.name),
+     *     // 或者使用 gettext，如果觉得 __ 不好看的话
+     *     // message: this.gettext('Welcome back, %s!', this.user.name),
+     *     user: this.user,
+     *   };
+     * };
+     * ```
+     *
+     * ##### View 文件下的使用示例
+     *
+     * ```html
+     * <li>{{ __('Email') }}: {{ user.email }}</li>
+     * <li>
+     *   {{ __('Hello %s, how are you today?', user.name) }}
+     * </li>
+     * <li>
+     *   {{ __('{0} {0} {1} {1}'), ['foo', 'bar']) }}
+     * </li>
+     * ```
+     *
+     * ##### locale 参数获取途径
+     *
+     * 优先级从上到下：
+     *
+     * - query: `/?locale=en-US`
+     * - cookie: `locale=zh-TW`
+     * - header: `Accept-Language: zh-CN,zh;q=0.5`
+     */
+    __(key, value, ...args) {
+        return this.gettext(key, value, ...args);
+    }
+    // 1. query: /?locale=en-US
+    // 2. cookie: locale=zh-TW
+    // 3. header: Accept-Language: zh-CN,zh;q=0.5
+    __getLocale() {
+        if (this.__locale) {
+            return this.__locale;
+        }
+        const { localeAlias, defaultLocale, cookieField, queryField, writeCookie } = this.app.config.i18n;
+        const cookieLocale = this.cookies.get(cookieField, { signed: false });
+        // 1. Query
+        let locale = this.query[queryField];
+        let localeOrigin = 'query';
+        // 2. Cookie
+        if (!locale && cookieLocale) {
+            locale = cookieLocale;
+            localeOrigin = 'cookie';
+        }
+        // 3. Header
+        if (!locale) {
+            // Accept-Language: zh-CN,zh;q=0.5
+            // Accept-Language: zh-CN
+            let languages = this.acceptsLanguages();
+            if (languages) {
+                if (Array.isArray(languages)) {
+                    if (languages[0] === '*') {
+                        languages = languages.slice(1);
+                    }
+                    if (languages.length > 0) {
+                        for (const l of languages) {
+                            const lang = formatLocale(l);
+                            if (this.app.isSupportLocale(lang) || localeAlias[lang]) {
+                                locale = lang;
+                                localeOrigin = 'header';
+                                break;
+                            }
+                        }
+                    }
+                }
+                else {
+                    locale = languages;
+                    localeOrigin = 'header';
+                }
+            }
+            // all missing, set it to defaultLocale
+            if (!locale) {
+                locale = defaultLocale;
+                localeOrigin = 'default';
+            }
+        }
+        // cookie alias
+        if (locale in localeAlias) {
+            const originalLocale = locale;
+            locale = localeAlias[locale];
+            debug('Used alias, received %s but using %s', originalLocale, locale);
+        }
+        locale = formatLocale(locale);
+        // validate locale
+        if (!this.app.isSupportLocale(locale)) {
+            debug('Locale %s is not supported. Using default (%s)', locale, defaultLocale);
+            locale = defaultLocale;
+        }
+        // if header not send, set the locale cookie
+        if (writeCookie && cookieLocale !== locale && !this.headerSent) {
+            updateCookie(this, locale);
+        }
+        debug('Locale: %s from %s', locale, localeOrigin);
+        this.__locale = locale;
+        this.__localeOrigin = localeOrigin;
+        return locale;
+    }
+    __getLocaleOrigin() {
+        if (this.__localeOrigin) {
+            return this.__localeOrigin;
+        }
+        this.__getLocale();
+        return this.__localeOrigin;
+    }
+    __setLocale(locale) {
+        this.__locale = locale;
+        this.__localeOrigin = 'set';
+        if (this.app.config.i18n.writeCookie && !this.headerSent) {
+            updateCookie(this, locale);
+        }
+    }
+}
+function updateCookie(ctx, locale) {
+    const { cookieMaxAge, cookieField, cookieDomain } = ctx.app.config.i18n;
+    const cookieOptions = {
+        // make sure browser javascript can read the cookie
+        httpOnly: false,
+        maxAge: cookieMaxAge,
+        signed: false,
+        domain: cookieDomain,
+        overwrite: true,
+    };
+    ctx.cookies.set(cookieField, locale, cookieOptions);
+    debug('Saved cookie with locale %s, options: %j', locale, cookieOptions);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29udGV4dC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9hcHAvZXh0ZW5kL2NvbnRleHQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLFFBQVEsRUFBRSxNQUFNLFdBQVcsQ0FBQztBQUVyQyxPQUFPLEVBQUUsT0FBTyxFQUFFLE1BQU0sS0FBSyxDQUFDO0FBRTlCLE9BQU8sRUFBRSxZQUFZLEVBQUUsTUFBTSxnQkFBZ0IsQ0FBQztBQUU5QyxNQUFNLEtBQUssR0FBRyxRQUFRLENBQUMsNkJBQTZCLENBQUMsQ0FBQztBQUV0RCxNQUFNLENBQUMsT0FBTyxPQUFPLFdBQVksU0FBUSxPQUFPO0lBQzlDOzs7O09BSUc7SUFDSCxJQUFJLE1BQU07UUFDUixPQUFPLElBQUksQ0FBQyxXQUFXLEVBQUUsQ0FBQztJQUM1QixDQUFDO0lBRUQsSUFBSSxNQUFNLENBQUMsQ0FBUztRQUNsQixJQUFJLENBQUMsV0FBVyxDQUFDLENBQUMsQ0FBQyxDQUFDO0lBQ3RCLENBQUM7SUFFRDs7OztPQUlHO0lBQ0gsT0FBTyxDQUFDLEdBQVcsRUFBRSxLQUFXLEVBQUUsR0FBRyxJQUFXO1FBQzlDLE9BQU8sSUFBSSxDQUFDLEdBQUcsQ0FBQyxPQUFPLENBQUMsSUFBSSxDQUFDLE1BQU0sRUFBRSxHQUFHLEVBQUUsS0FBSyxFQUFFLEdBQUcsSUFBSSxDQUFDLENBQUM7SUFDNUQsQ0FBQztJQUVEOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O09BaURHO0lBQ0gsRUFBRSxDQUFDLEdBQVcsRUFBRSxLQUFXLEVBQUUsR0FBRyxJQUFXO1FBQ3pDLE9BQU8sSUFBSSxDQUFDLE9BQU8sQ0FBQyxHQUFHLEVBQUUsS0FBSyxFQUFFLEdBQUcsSUFBSSxDQUFDLENBQUM7SUFDM0MsQ0FBQztJQUdELDJCQUEyQjtJQUMzQiwwQkFBMEI7SUFDMUIsNkNBQTZDO0lBQzdDLFdBQVc7UUFDVCxJQUFJ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

package/dist/app.d.ts

@@ -1,7 +1,4 @@
-import { Application, ILifecycleBoot } from "egg";
-
-//#region src/app.d.ts
-
+import type { ILifecycleBoot, Application } from 'egg';
 /**
  * I18n 国际化
  *
@@ -49,10 +46,8 @@ import { Application, ILifecycleBoot } from "egg";
  * }
  * ```
  */
-declare class I18n implements ILifecycleBoot {
-  private readonly app;
-  constructor(app: Application);
-  didLoad(): Promise<void>;
+export default class I18n implements ILifecycleBoot {
+    private readonly app;
+    constructor(app: Application);
+    didLoad(): Promise<void>;
 }
-//#endregion
-export { I18n as default };

package/dist/app.js

@@ -1,97 +1,97 @@
-import { formatLocale } from "./utils-D06av2P8.js";
-import "./application-BzyHiDpF.js";
-import { loadLocaleResources } from "./locales-BA2I-wwk.js";
-import path from "node:path";
-import { debuglog } from "node:util";
-import { exists } from "utility";
-import { ms } from "humanize-ms";
-
-//#region src/app.ts
-const debug = debuglog("egg/i18n/app");
+import path from 'node:path';
+import { debuglog } from 'node:util';
+import { exists } from 'utility';
+import { ms } from 'humanize-ms';
+import { loadLocaleResources } from "./locales.js";
+import { formatLocale } from "./utils.js";
+const debug = debuglog('egg/i18n/app');
 /**
-* I18n 国际化
-*
-* 通过设置 Plugin 配置 `i18n: true`，开启多语言支持。
-*
-* #### 语言文件存储路径
-*
-* 统一存放在 `config/locale/*.js` 下（ 兼容`config/locales/*.js` ），如包含英文，简体中文，繁体中文的语言文件：
-*
-* ```
-* - config/locale/
-*   - en-US.js
-*   - zh-CN.js
-*   - zh-TW.js
-* ```
-* @class I18n
-* @param {App} app Application object.
-* @example
-*
-* #### I18n 文件内容
-*
-* ```js
-* // config/locale/zh-CN.js
-* module.exports = {
-*   "Email": "邮箱",
-*   "Welcome back, %s!": "欢迎回来, %s!",
-*   "Hello %s, how are you today?": "你好 %s, 今天过得咋样？",
-* };
-* ```
-*
-* ```js
-* // config/locale/en-US.js
-* module.exports = {
-*   "Email": "Email",
-* };
-* ```
-* 或者也可以用 JSON 格式的文件:
-*
-* ```js
-* // config/locale/zh-CN.json
-* {
-*   "email": "邮箱",
-*   "login": "帐号",
-*   "createdAt": "注册时间"
-* }
-* ```
-*/
-var I18n = class {
-	app;
-	constructor(app) {
-		this.app = app;
-	}
-	async didLoad() {
-		const i18nConfig = this.app.config.i18n;
-		i18nConfig.defaultLocale = formatLocale(i18nConfig.defaultLocale);
-		i18nConfig.cookieMaxAge = ms(i18nConfig.cookieMaxAge);
-		i18nConfig.dirs = Array.isArray(i18nConfig.dirs) ? i18nConfig.dirs : [];
-		for (const unit of this.app.loader.getLoadUnits()) {
-			let localePath = path.join(unit.path, "config/locale");
-			/**
-			* 优先选择 `config/locale` 目录下的多语言文件，不存在时再选择 `config/locales` 目录
-			* 避免 2 个目录同时存在时可能导致的冲突
-			*/
-			if (!await exists(localePath)) localePath = path.join(unit.path, "config/locales");
-			i18nConfig.dirs.push(localePath);
-		}
-		debug("app.config.i18n.dirs:", i18nConfig.dirs);
-		await loadLocaleResources(this.app, i18nConfig);
-		const app = this.app;
-		function gettextInContext(key, ...args) {
-			return app.ctxStorage.getStore().gettext(key, ...args);
-		}
-		Object.defineProperties(app.locals, {
-			__: {
-				value: gettextInContext,
-				enumerable: true
-			},
-			gettext: {
-				value: gettextInContext,
-				enumerable: true
-			}
-		});
-	}
-};
-
-//#endregion
-export { I18n as default };
+ * I18n 国际化
+ *
+ * 通过设置 Plugin 配置 `i18n: true`，开启多语言支持。
+ *
+ * #### 语言文件存储路径
+ *
+ * 统一存放在 `config/locale/*.js` 下（ 兼容`config/locales/*.js` ），如包含英文，简体中文，繁体中文的语言文件：
+ *
+ * ```
+ * - config/locale/
+ *   - en-US.js
+ *   - zh-CN.js
+ *   - zh-TW.js
+ * ```
+ * @class I18n
+ * @param {App} app Application object.
+ * @example
+ *
+ * #### I18n 文件内容
+ *
+ * ```js
+ * // config/locale/zh-CN.js
+ * module.exports = {
+ *   "Email": "邮箱",
+ *   "Welcome back, %s!": "欢迎回来, %s!",
+ *   "Hello %s, how are you today?": "你好 %s, 今天过得咋样？",
+ * };
+ * ```
+ *
+ * ```js
+ * // config/locale/en-US.js
+ * module.exports = {
+ *   "Email": "Email",
+ * };
+ * ```
+ * 或者也可以用 JSON 格式的文件:
+ *
+ * ```js
+ * // config/locale/zh-CN.json
+ * {
+ *   "email": "邮箱",
+ *   "login": "帐号",
+ *   "createdAt": "注册时间"
+ * }
+ * ```
+ */
+export default class I18n {
+    app;
+    constructor(app) {
+        this.app = app;
+    }
+    async didLoad() {
+        const i18nConfig = this.app.config.i18n;
+        i18nConfig.defaultLocale = formatLocale(i18nConfig.defaultLocale);
+        i18nConfig.cookieMaxAge = ms(i18nConfig.cookieMaxAge);
+        i18nConfig.dirs = Array.isArray(i18nConfig.dirs) ? i18nConfig.dirs : [];
+        // 按 egg > 插件 > 框架 > 应用的顺序遍历 config/locale(config/locales) 目录，加载所有配置文件
+        for (const unit of this.app.loader.getLoadUnits()) {
+            let localePath = path.join(unit.path, 'config/locale');
+            /**
+             * 优先选择 `config/locale` 目录下的多语言文件，不存在时再选择 `config/locales` 目录
+             * 避免 2 个目录同时存在时可能导致的冲突
+             */
+            if (!(await exists(localePath))) {
+                localePath = path.join(unit.path, 'config/locales');
+            }
+            i18nConfig.dirs.push(localePath);
+        }
+        debug('app.config.i18n.dirs:', i18nConfig.dirs);
+        await loadLocaleResources(this.app, i18nConfig);
+        const app = this.app;
+        function gettextInContext(key, ...args) {
+            const ctx = app.ctxStorage.getStore();
+            return ctx.gettext(key, ...args);
+        }
+        // 在 view 中使用 `__(key, value, ...args)`
+        Object.defineProperties(app.locals, {
+            __: {
+                value: gettextInContext,
+                enumerable: true,
+            },
+            gettext: {
+                value: gettextInContext,
+                enumerable: true,
+            },
+        });
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXBwLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2FwcC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLElBQUksTUFBTSxXQUFXLENBQUM7QUFDN0IsT0FBTyxFQUFFLFFBQVEsRUFBRSxNQUFNLFdBQVcsQ0FBQztBQUVyQyxPQUFPLEVBQUUsTUFBTSxFQUFFLE1BQU0sU0FBUyxDQUFDO0FBQ2pDLE9BQU8sRUFBRSxFQUFFLEVBQUUsTUFBTSxhQUFhLENBQUM7QUFHakMsT0FBTyxFQUFFLG1CQUFtQixFQUFFLE1BQU0sY0FBYyxDQUFDO0FBQ25ELE9BQU8sRUFBRSxZQUFZLEVBQUUsTUFBTSxZQUFZLENBQUM7QUFFMUMsTUFBTSxLQUFLLEdBQUcsUUFBUSxDQUFDLGNBQWMsQ0FBQyxDQUFDO0FBRXZDOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBOENHO0FBRUgsTUFBTSxDQUFDLE9BQU8sT0FBTyxJQUFJO0lBQ04sR0FBRyxDQUFDO0lBRXJCLFlBQVksR0FBZ0I7UUFDMUIsSUFBSSxDQUFDLEdBQUcsR0FBRyxHQUFHLENBQUM7SUFDakIsQ0FBQztJQUVELEtBQUssQ0FBQyxPQUFPO1FBQ1gsTUFBTSxVQUFVLEdBQUcsSUFBSSxDQUFDLEdBQUcsQ0FBQyxNQUFNLENBQUMsSUFBSSxDQUFDO1FBQ3hDLFVBQVUsQ0FBQyxhQUFhLEdBQUcsWUFBWSxDQUFDLFVBQVUsQ0FBQyxhQUFhLENBQUMsQ0FBQztRQUNsRSxVQUFVLENBQUMsWUFBWSxHQUFHLEVBQUUsQ0FBQyxVQUFVLENBQUMsWUFBWSxDQUFDLENBQUM7UUFFdEQsVUFBVSxDQUFDLElBQUksR0FBRyxLQUFLLENBQUMsT0FBTyxDQUFDLFVBQVUsQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDLENBQUMsVUFBVSxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDO1FBQ3hFLHNFQUFzRTtRQUN0RSxLQUFLLE1BQU0sSUFBSSxJQUFJLElBQUksQ0FBQyxHQUFHLENBQUMsTUFBTSxDQUFDLFlBQVksRUFBRSxFQUFFLENBQUM7WUFDbEQsSUFBSSxVQUFVLEdBQUcsSUFBSSxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsSUFBSSxFQUFFLGVBQWUsQ0FBQyxDQUFDO1lBQ3ZEOzs7ZUFHRztZQUNILElBQUksQ0FBQyxDQUFDLE1BQU0sTUFBTSxDQUFDLFVBQVUsQ0FBQyxDQUFDLEVBQUUsQ0FBQztnQkFDaEMsVUFBVSxHQUFHLElBQUksQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLElBQUksRUFBRSxnQkFBZ0IsQ0FBQyxDQUFDO1lBQ3RELENBQUM7WUFDRCxVQUFVLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxVQUFVLENBQUMsQ0FBQztRQUNuQyxDQUFDO1FBRUQsS0FBSyxDQUFDLHVCQUF1QixFQUFFLFVBQVUsQ0FBQyxJQUFJLENBQUMsQ0FBQztRQUVoRCxNQUFNLG1CQUFtQixDQUFDLElBQUksQ0FBQyxHQUFHLEVBQUUsVUFBVSxDQUFDLENBQUM7UUFFaEQsTUFBTSxHQUFHLEdBQUcsSUFBSSxDQUFDLEdBQUcsQ0FBQztRQUNyQixTQUFTLGdCQUFnQixDQUFDLEdBQVcsRUFBRSxHQUFHLElBQVc7WUFDbkQsTUFBTSxHQUFHLEdBQUcsR0FBRyxDQUFDLFVBQVUsQ0FBQyxRQUFRLEVBQUcsQ0FBQztZQUN2QyxPQUFPLEdBQUcsQ0FBQyxPQUFPLENBQUMsR0FBRyxFQUFFLEdBQUcsSUFBSSxDQUFDLENBQUM7UUFDbkMsQ0FBQztRQUNELHVDQUF1QztRQUN2QyxNQUFNLENBQUMsZ0JBQWdCLENBQUMsR0FBRyxDQUFDLE1BQU0sRUFBRTtZQUNsQyxFQUFFLEVBQUU7Z0JBQ0YsS0FBSyxFQUFFLGdCQUFnQjtnQkFDdkIsVUFBVSxFQUFFLElBQUk7YUFDakI7WUFDRCxPQUFPLEVBQUU7Z0JBQ1AsS0FBSyxFQUFFLGdCQUFnQjtnQkFDdkIsVUFBVSxFQUFFLElBQUk7YUFDakI7U0FDRixDQUFDLENBQUM7SUFDTCxDQUFDO0NBQ0YifQ==

package/dist/config/config.default.d.ts

@@ -1,2 +1,52 @@
-import { I18nConfig, _default } from "../config.default-zrkP0tMD.js";
-export { I18nConfig, _default as default };
+export interface I18nConfig {
+    /**
+     * 默认语言是美式英语，毕竟支持多语言，基本都是以英语为母板
+     * 默认值是 `en_US`
+     */
+    defaultLocale: string;
+    /**
+     * 多语言资源文件存放路径，不建议修改
+     * 默认值是 `[]`
+     */
+    dirs: string[];
+    /**
+     * @deprecated please use `dirs` instead
+     */
+    dir?: string;
+    /**
+     * 设置当前语言的 query 参数字段名，默认通过 `query.locale` 获取
+     * 如果你想修改为 `query.lang`，那么请通过修改此配置实现
+     * 默认值是 `locale`
+     */
+    queryField: string;
+    /**
+     * 如果当前请求用户语言有变化，都会设置到 cookie 中保持着，
+     * 默认是存储在key 为 locale 的 cookie 中
+     * 默认值是 `locale`
+     */
+    cookieField: string;
+    /**
+     * 存储 locale 的 cookie domain 配置，默认不设置，为当前域名才有效
+     * 默认值是 `''`
+     */
+    cookieDomain: string;
+    /**
+     * cookie 默认一年后过期，如果设置为 Number，则单位为 ms
+     * 默认值是 `'1y'`
+     */
+    cookieMaxAge: string | number;
+    /**
+     * locale 别名，比如 zh_CN => cn
+     * 默认值是 `{}`
+     */
+    localeAlias: Record<string, string>;
+    /**
+     * 是否写入 cookie
+     * 默认值是 `true`
+     */
+    writeCookie: boolean;
+}
+declare const _default: {
+    i18n: I18nConfig;
+};
+export default _default;

package/dist/config/config.default.js

@@ -1,3 +1,14 @@
-import { config_default_default } from "../config.default-pQAjrMmI.js";
-
-export { config_default_default as default };
+export default {
+    i18n: {
+        defaultLocale: 'en_US',
+        dirs: [],
+        queryField: 'locale',
+        cookieField: 'locale',
+        cookieDomain: '',
+        cookieMaxAge: '1y',
+        localeAlias: {},
+        writeCookie: true,
+        dir: undefined,
+    },
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uZmlnLmRlZmF1bHQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvY29uZmlnL2NvbmZpZy5kZWZhdWx0LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQWlEQSxlQUFlO0lBQ2IsSUFBSSxFQUFFO1FBQ0osYUFBYSxFQUFFLE9BQU87UUFDdEIsSUFBSSxFQUFFLEVBQUU7UUFDUixVQUFVLEVBQUUsUUFBUTtRQUNwQixXQUFXLEVBQUUsUUFBUTtRQUNyQixZQUFZLEVBQUUsRUFBRTtRQUNoQixZQUFZLEVBQUUsSUFBSTtRQUNsQixXQUFXLEVBQUUsRUFBRTtRQUNmLFdBQVcsRUFBRSxJQUFJO1FBQ2pCLEdBQUcsRUFBRSxTQUFTO0tBQ0Q7Q0FDaEIsQ0FBQyJ9

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import "./application-CY4eNoP8.js";
-import "./context-0NWdtfPn.js";
-import "./config.default-zrkP0tMD.js";
-import "./types-DoabcMjn.js";
+import './config/config.default.ts';
+import './app/extend/context.ts';
+import './app/extend/application.ts';
+import './types.ts';