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

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

@@ -1,12 +1,8 @@
-import { Application } from "egg";
-
-//#region src/app/extend/application.d.ts
-declare const I18N_RESOURCES: unique symbol;
-declare 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;
+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;
 }
-//#endregion
-export { I18N_RESOURCES, I18nApplication as default };

package/dist/app/extend/application.js

@@ -1,48 +1,76 @@
+import { debuglog, format } from 'node:util';
+import { Application } from 'egg';
 import { isObject } from "../../utils.js";
-import { debuglog, format } from "node:util";
-import { Application } from "egg";
-
-//#region src/app/extend/application.ts
-const debug = debuglog("egg/i18n/app/extend/application");
-const I18N_RESOURCES = Symbol("Application i18n resources");
-var I18nApplication = class extends Application {
-	isSupportLocale(locale) {
-		return !!this[I18N_RESOURCES][locale];
-	}
-	gettext(locale, key, value, ...args) {
-		if (!locale || !key) return "";
-		let text = (this[I18N_RESOURCES][locale] || {})[key];
-		if (text === void 0) text = key;
-		debug("%s: %j => %j", locale, key, text);
-		if (!text) return "";
-		if (value === void 0) return text;
-		if (args.length === 0) {
-			if (isObject(value)) return formatWithObject(text, value);
-			if (Array.isArray(value)) return formatWithArray(text, value);
-			return format(text, value);
-		}
-		return format(text, value, ...args);
-	}
-	__(locale, key, value, ...args) {
-		return this.gettext(locale, key, value, ...args);
-	}
-};
+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];
-		return original;
-	});
+    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;
-		return original;
-	});
+    return text.replace(Object_INDEX_RE, (original, matched) => {
+        const value = values[matched];
+        if (value) {
+            return value;
+        }
+        // not match index, return original text
+        return original;
+    });
 }
-
-//#endregion
-export { I18N_RESOURCES, I18nApplication as default };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXBwbGljYXRpb24uanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvYXBwL2V4dGVuZC9hcHBsaWNhdGlvbi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsUUFBUSxFQUFFLE1BQU0sRUFBRSxNQUFNLFdBQVcsQ0FBQztBQUU3QyxPQUFPLEVBQUUsV0FBVyxFQUFFLE1BQU0sS0FBSyxDQUFDO0FBRWxDLE9BQU8sRUFBRSxRQUFRLEVBQUUsTUFBTSxnQkFBZ0IsQ0FBQztBQUUxQyxNQUFNLEtBQUssR0FBRyxRQUFRLENBQUMsaUNBQWlDLENBQUMsQ0FBQztBQUUxRCxNQUFNLENBQUMsTUFBTSxjQUFjLEdBQUcsTUFBTSxDQUFDLDRCQUE0QixDQUFDLENBQUM7QUFFbkUsTUFBTSxDQUFDLE9BQU8sT0FBTyxlQUFnQixTQUFRLFdBQVc7SUFHdEQsZUFBZSxDQUFDLE1BQWM7UUFDNUIsT0FBTyxDQUFDLENBQUMsSUFBSSxDQUFDLGNBQWMsQ0FBQyxDQUFDLE1BQU0sQ0FBQyxDQUFDO0lBQ3hDLENBQUM7SUFFRCxPQUFPLENBQUMsTUFBYyxFQUFFLEdBQVcsRUFBRSxLQUFXLEVBQUUsR0FBRyxJQUFXO1FBQzlELElBQUksQ0FBQyxNQUFNLElBQUksQ0FBQyxHQUFHLEVBQUUsQ0FBQztZQUNwQixPQUFPO1lBQ1AsV0FBVztZQUNYLE9BQU8sRUFBRSxDQUFDO1FBQ1osQ0FBQztRQUVELE1BQU0sUUFBUSxHQUFHLElBQUksQ0FBQyxjQUFjLENBQUMsQ0FBQyxNQUFNLENBQUMsSUFBSSxFQUFFLENBQUM7UUFFcEQsSUFBSSxJQUFJLEdBQUcsUUFBUSxDQUFDLEdBQUcsQ0FBQyxDQUFDO1FBQ3pCLElBQUksSUFBSSxLQUFLLFNBQVMsRUFBRSxDQUFDO1lBQ3ZCLElBQUksR0FBRyxHQUFHLENBQUM7UUFDYixDQUFDO1FBRUQsS0FBSyxDQUFDLGNBQWMsRUFBRSxNQUFNLEVBQUUsR0FBRyxFQUFFLElBQUksQ0FBQyxDQUFDO1FBQ3pDLElBQUksQ0FBQyxJQUFJLEVBQUUsQ0FBQztZQUNWLE9BQU8sRUFBRSxDQUFDO1FBQ1osQ0FBQztRQUVELElBQUksS0FBSyxLQUFLLFNBQVMsRUFBRSxDQUFDO1lBQ3hCLGtCQUFrQjtZQUNsQixPQUFPLElBQUksQ0FBQztRQUNkLENBQUM7UUFDRCxJQUFJLElBQUksQ0FBQyxNQUFNLEtBQUssQ0FBQyxFQUFFLENBQUM7WUFDdEIsSUFBSSxRQUFRLENBQUMsS0FBSyxDQUFDLEVBQUUsQ0FBQztnQkFDcEIsMEJBQTBCO2dCQUMxQixvREFBb0Q7Z0JBQ3BELEtBQUs7Z0JBQ0wsa0JBQWtCO2dCQUNsQixPQUFPLGdCQUFnQixDQUFDLElBQUksRUFBRSxLQUFLLENBQUMsQ0FBQztZQUN2QyxDQUFDO1lBRUQsSUFBSSxLQUFLLENBQUMsT0FBTyxDQUFDLEtBQUssQ0FBQyxFQUFFLENBQUM7Z0JBQ3pCLHlCQUF5QjtnQkFDekIsOENBQThDO2dCQUM5QyxLQUFLO2dCQUNMLGtCQUFrQjtnQkFDbEIsT0FBTyxlQUFlLENBQUMsSUFBSSxFQUFFLEtBQUssQ0FBQyxDQUFDO1lBQ3RDLENBQUM7WUFFRCx5QkFBeUI7WUFDekIsT0FBTyxNQUFNLENBQUMsSUFBSSxFQUFFLEtBQUssQ0FBQyxDQUFDO1FBQzdCLENBQUM7UUFFRCwrQkFBK0I7UUFDL0IsT0FBTyxNQUFNLENBQUMsSUFBSSxFQUFFLEtBQUssRUFBRSxHQUFHLElBQUksQ0FBQyxDQUFDO0lBQ3RDLENBQUM7SUFFRCxFQUFFLENBQUMsTUFBYyxFQUFFLEdBQVcsRUFBRSxLQUFXLEVBQUUsR0FBRyxJQUFXO1FBQ3pELE9BQU8sSUFBSSxDQUFDLE9BQU8sQ0FBQyxNQUFNLEVBQUUsR0FBRyxFQUFFLEtBQUssRUFBRSxHQUFHLElBQUksQ0FBQyxDQUFDO0lBQ25ELENBQUM7Q0FDRjtBQUVELE1BQU0sY0FBYyxHQUFHLFlBQVksQ0FBQztBQUNwQyxTQUFTLGVBQWUsQ0FBQyxJQUFZLEVBQUUsTUFBYTtJQUNsRCxPQUFPLElBQUksQ0FBQyxPQUFPLENBQUMsY0FBYyxFQUFFLENBQUMsUUFBUSxFQUFFLE9BQU8sRUFBRSxFQUFFO1FBQ3hELE1BQU0sS0FBSyxHQUFHLFFBQVEsQ0FBQyxPQUFPLENBQUMsQ0FBQztRQUNoQyxJQUFJLEtBQUssR0FBRyxNQUFNLENBQUMsTUFBTSxFQUFFLENBQUM7WUFDMUIsT0FBTyxNQUFNLENBQUMsS0FBSyxDQUFDLENBQUM7UUFDdkIsQ0FBQztRQUNELHdDQUF3QztRQUN4QyxPQUFPLFFBQVEsQ0FBQztJQUNsQixDQUFDLENBQUMsQ0FBQztBQUNMLENBQUM7QUFFRCxNQUFNLGVBQWUsR0FBRyxZQUFZLENBQUM7QUFDckMsU0FBUyxnQkFBZ0IsQ0FBQyxJQUFZLEVBQUUsTUFBMkI7SUFDakUsT0FBTyxJQUFJLENBQUMsT0FBTyxDQUFDLGVBQWUsRUFBRSxDQUFDLFFBQVEsRUFBRSxPQUFPLEVBQUUsRUFBRTtRQUN6RCxNQUFNLEtBQUssR0FBRyxNQUFNLENBQUMsT0FBTyxDQUFDLENBQUM7UUFDOUIsSUFBSSxLQUFLLEVBQUUsQ0FBQztZQUNWLE9BQU8sS0FBSyxDQUFDO1FBQ2YsQ0FBQztRQUNELHdDQUF3QztRQUN4QyxPQUFPLFFBQVEsQ0FBQztJQUNsQixDQUFDLENBQUMsQ0FBQztBQUNMLENBQUMifQ==

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

@@ -1,76 +1,72 @@
-import { Context } from "egg";
-
-//#region src/app/extend/context.d.ts
-declare 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;
+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;
 }
-//#endregion
-export { I18nContext as default };

package/dist/app/extend/context.js

@@ -1,152 +1,176 @@
+import { debuglog } from 'node:util';
+import { Context } from 'egg';
 import { formatLocale } from "../../utils.js";
-import { debuglog } from "node:util";
-import { Context } from "egg";
-
-//#region src/app/extend/context.ts
-const debug = debuglog("egg/i18n/app/extend/context");
-var I18nContext = class 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);
-	}
-	__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 });
-		let locale = this.query[queryField];
-		let localeOrigin = "query";
-		if (!locale && cookieLocale) {
-			locale = cookieLocale;
-			localeOrigin = "cookie";
-		}
-		if (!locale) {
-			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";
-			}
-			if (!locale) {
-				locale = defaultLocale;
-				localeOrigin = "default";
-			}
-		}
-		if (locale in localeAlias) {
-			const originalLocale = locale;
-			locale = localeAlias[locale];
-			debug("Used alias, received %s but using %s", originalLocale, locale);
-		}
-		locale = formatLocale(locale);
-		if (!this.app.isSupportLocale(locale)) {
-			debug("Locale %s is not supported. Using default (%s)", locale, defaultLocale);
-			locale = defaultLocale;
-		}
-		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);
-	}
-};
+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 = {
-		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);
+    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);
 }
-
-//#endregion
-export { I18nContext as default };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29udGV4dC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9hcHAvZXh0ZW5kL2NvbnRleHQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLFFBQVEsRUFBRSxNQUFNLFdBQVcsQ0FBQztBQUVyQyxPQUFPLEVBQUUsT0FBTyxFQUFFLE1BQU0sS0FBSyxDQUFDO0FBRTlCLE9BQU8sRUFBRSxZQUFZLEVBQUUsTUFBTSxnQkFBZ0IsQ0FBQztBQUU5QyxNQUFNLEtBQUssR0FBRyxRQUFRLENBQUMsNkJBQTZCLENBQUMsQ0FBQztBQUV0RCxNQUFNLENBQUMsT0FBTyxPQUFPLFdBQVksU0FBUSxPQUFPO0lBQzlDOzs7O09BSUc7SUFDSCxJQUFJLE1BQU07UUFDUixPQUFPLElBQUksQ0FBQyxXQUFXLEVBQUUsQ0FBQztJQUM1QixDQUFDO0lBRUQsSUFBSSxNQUFNLENBQUMsQ0FBUztRQUNsQixJQUFJLENBQUMsV0FBVyxDQUFDLENBQUMsQ0FBQyxDQUFDO0lBQ3RCLENBQUM7SUFFRDs7OztPQUlHO0lBQ0gsT0FBTyxDQUFDLEdBQVcsRUFBRSxLQUFXLEVBQUUsR0FBRyxJQUFXO1FBQzlDLE9BQU8sSUFBSSxDQUFDLEdBQUcsQ0FBQyxPQUFPLENBQUMsSUFBSSxDQUFDLE1BQU0sRUFBRSxHQUFHLEVBQUUsS0FBSyxFQUFFLEdBQUcsSUFBSSxDQUFDLENBQUM7SUFDNUQsQ0FBQztJQUVEOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O09BaURHO0lBQ0gsRUFBRSxDQUFDLEdBQVcsRUFBRSxLQUFXLEVBQUUsR0FBRyxJQUFXO1FBQ3pDLE9BQU8sSUFBSSxDQUFDLE9BQU8sQ0FBQyxHQUFHLEVBQUUsS0FBSyxFQUFFLEdBQUcsSUFBSSxDQUFDLENBQUM7SUFDM0MsQ0FBQztJQUdELDJCQUEyQjtJQUMzQiwwQkFBMEI7SUFDMUIsNkNBQTZDO0lBQzdDLFdBQVc7UUFDVCxJQUFJ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