@intlify/core-base 9.4.1 → 9.6.0

package/dist/core-base.cjs

@@ -1,5 +1,5 @@
 /*!
-  * core-base v9.4.1
+  * core-base v9.6.0
   * (c) 2023 kazuya kawaguchi
   * Released under the MIT License.
   */
@@ -449,6 +449,22 @@ function getWarnMessage(code, ...args) {
     return shared.format(warnMessages[code], ...args);
 }
 
+/** @internal */
+function getLocale(context, options) {
+    return options.locale != null
+        ? resolveLocale(options.locale)
+        : resolveLocale(context.locale);
+}
+let _resolveLocale;
+/** @internal */
+function resolveLocale(locale) {
+    // prettier-ignore
+    return shared.isString(locale)
+        ? locale
+        : _resolveLocale != null && locale.resolvedOnce
+            ? _resolveLocale
+            : (_resolveLocale = locale());
+}
 /**
  * Fallback with simple implemenation
  *
@@ -570,7 +586,7 @@ function appendItemToChain(chain, target, blocks) {
  * Intlify core-base version
  * @internal
  */
-const VERSION = '9.4.1';
+const VERSION = '9.6.0';
 const NOT_REOSLVED = -1;
 const DEFAULT_LOCALE = 'en-US';
 const MISSING_RESOLVE_VALUE = '';
@@ -646,23 +662,26 @@ function createCoreContext(options = {}) {
     // setup options
     const onWarn = shared.isFunction(options.onWarn) ? options.onWarn : shared.warn;
     const version = shared.isString(options.version) ? options.version : VERSION;
-    const locale = shared.isString(options.locale) ? options.locale : DEFAULT_LOCALE;
+    const locale = shared.isString(options.locale) || shared.isFunction(options.locale)
+        ? options.locale
+        : DEFAULT_LOCALE;
+    const _locale = shared.isFunction(locale) ? DEFAULT_LOCALE : locale;
     const fallbackLocale = shared.isArray(options.fallbackLocale) ||
         shared.isPlainObject(options.fallbackLocale) ||
         shared.isString(options.fallbackLocale) ||
         options.fallbackLocale === false
         ? options.fallbackLocale
-        : locale;
+        : _locale;
     const messages = shared.isPlainObject(options.messages)
         ? options.messages
-        : { [locale]: {} };
+        : { [_locale]: {} };
     const datetimeFormats = shared.isPlainObject(options.datetimeFormats)
             ? options.datetimeFormats
-            : { [locale]: {} }
+            : { [_locale]: {} }
         ;
     const numberFormats = shared.isPlainObject(options.numberFormats)
             ? options.numberFormats
-            : { [locale]: {} }
+            : { [_locale]: {} }
         ;
     const modifiers = shared.assign({}, options.modifiers || {}, getDefaultLinkedModifiers());
     const pluralRules = options.pluralRules || {};
@@ -839,7 +858,7 @@ function formatMessagePart(ctx, node) {
             return ctx.interpolate(ctx.named(named.k || named.key));
         case 5 /* NodeTypes.List */:
             const list = node;
-            return ctx.interpolate(ctx.list(list.i || list.index));
+            return ctx.interpolate(ctx.list(list.i != null ? list.i : list.index));
         case 6 /* NodeTypes.Linked */:
             const linked = node;
             const modifier = linked.m || linked.modifier;
@@ -1002,7 +1021,7 @@ function translate(context, ...args) {
             ? (!messageCompiler ? () => key : key)
             : '';
     const enableDefaultMsg = fallbackFormat || defaultMsgOrKey !== '';
-    const locale = shared.isString(options.locale) ? options.locale : context.locale;
+    const locale = getLocale(context, options);
     // escape params
     escapeParameter && escapeParams(options);
     // resolve message format
@@ -1406,7 +1425,7 @@ function datetime(context, ...args) {
         ? options.fallbackWarn
         : context.fallbackWarn;
     const part = !!options.part;
-    const locale = shared.isString(options.locale) ? options.locale : context.locale;
+    const locale = getLocale(context, options);
     const locales = localeFallbacker(context, // eslint-disable-line @typescript-eslint/no-explicit-any
     fallbackLocale, locale);
     if (!shared.isString(key) || key === '') {
@@ -1580,7 +1599,7 @@ function number(context, ...args) {
         ? options.fallbackWarn
         : context.fallbackWarn;
     const part = !!options.part;
-    const locale = shared.isString(options.locale) ? options.locale : context.locale;
+    const locale = getLocale(context, options);
     const locales = localeFallbacker(context, // eslint-disable-line @typescript-eslint/no-explicit-any
     fallbackLocale, locale);
     if (!shared.isString(key) || key === '') {
@@ -1731,6 +1750,7 @@ exports.fallbackWithSimple = fallbackWithSimple;
 exports.getAdditionalMeta = getAdditionalMeta;
 exports.getDevToolsHook = getDevToolsHook;
 exports.getFallbackContext = getFallbackContext;
+exports.getLocale = getLocale;
 exports.getWarnMessage = getWarnMessage;
 exports.handleMissing = handleMissing;
 exports.initI18nDevTools = initI18nDevTools;
@@ -1746,6 +1766,7 @@ exports.parseTranslateArgs = parseTranslateArgs;
 exports.registerLocaleFallbacker = registerLocaleFallbacker;
 exports.registerMessageCompiler = registerMessageCompiler;
 exports.registerMessageResolver = registerMessageResolver;
+exports.resolveLocale = resolveLocale;
 exports.resolveValue = resolveValue;
 exports.resolveWithKeyValue = resolveWithKeyValue;
 exports.setAdditionalMeta = setAdditionalMeta;

package/dist/core-base.d.ts

@@ -36,7 +36,7 @@ export declare interface CoreCommonContext<Message = string, Locales = 'en-US'>
     cid: number;
     version: string;
     locale: Locales;
-    fallbackLocale: FallbackLocales<Locales>;
+    fallbackLocale: FallbackLocales<Exclude<Locales, LocaleDetector>>;
     missing: CoreMissingHandler<Message> | null;
     missingWarn: boolean | RegExp;
     fallbackWarn: boolean | RegExp;
@@ -46,8 +46,8 @@ export declare interface CoreCommonContext<Message = string, Locales = 'en-US'>
     onWarn(msg: string, err?: Error): void;
 }
 
-export declare type CoreContext<Message = string, Messages = {}, DateTimeFormats = {}, NumberFormats = {}, ResourceLocales = PickupLocales<NonNullable<Messages>> | PickupLocales<NonNullable<DateTimeFormats>> | PickupLocales<NonNullable<NumberFormats>>, Locales = [ResourceLocales] extends [never] ? Locale : ResourceLocales> = CoreCommonContext<Message, Locales> & CoreTranslationContext<NonNullable<Messages>, Message> & CoreDateTimeContext<NonNullable<DateTimeFormats>> & CoreNumberContext<NonNullable<NumberFormats>> & {
-    fallbackContext?: CoreContext<Message, Messages, DateTimeFormats, NumberFormats, ResourceLocales, Locales>;
+export declare type CoreContext<Message = string, Messages = {}, DateTimeFormats = {}, NumberFormats = {}, LocaleType = Locale, ResourceLocales = PickupLocales<NonNullable<Messages>> | PickupLocales<NonNullable<DateTimeFormats>> | PickupLocales<NonNullable<NumberFormats>>, Locales = IsNever<ResourceLocales> extends true ? LocaleType extends LocaleDetector | Locale ? LocaleType : Locale : ResourceLocales> = CoreCommonContext<Message, Locales> & CoreTranslationContext<NonNullable<Messages>, Message> & CoreDateTimeContext<NonNullable<DateTimeFormats>> & CoreNumberContext<NonNullable<NumberFormats>> & {
+    fallbackContext?: CoreContext<Message, Messages, DateTimeFormats, NumberFormats, LocaleType, ResourceLocales, Locales>;
 };
 
 export declare interface CoreDateTimeContext<DateTimeFormats = {}> {
@@ -99,7 +99,7 @@ export declare interface CoreOptions<Message = string, Schema extends {
     datetime?: unknown;
     number?: unknown;
 } = {
-    message: LocaleMessage<Message>;
+    message: DefaultCoreLocaleMessageSchema;
     datetime: DateTimeFormat;
     number: NumberFormat;
 }, Locales extends {
@@ -114,13 +114,13 @@ export declare interface CoreOptions<Message = string, Schema extends {
     numberFormats: infer N;
 } ? N : Locales extends string ? Locales : Locale, MessageSchema = Schema extends {
     message: infer M;
-} ? M : LocaleMessage<Message>, DateTimeSchema = Schema extends {
+} ? M : DefaultCoreLocaleMessageSchema, DateTimeSchema = Schema extends {
     datetime: infer D;
 } ? D : DateTimeFormat, NumberSchema = Schema extends {
     number: infer N;
 } ? N : NumberFormat, _Messages extends LocaleMessages<MessageSchema, MessagesLocales, Message> = LocaleMessages<MessageSchema, MessagesLocales, Message>, _DateTimeFormats extends DateTimeFormats<DateTimeSchema, DateTimeFormatsLocales> = DateTimeFormats<DateTimeSchema, DateTimeFormatsLocales>, _NumberFormats extends NumberFormats<NumberSchema, NumberFormatsLocales> = NumberFormats<NumberSchema, NumberFormatsLocales>> {
     version?: string;
-    locale?: Locale;
+    locale?: Locale | LocaleDetector;
     fallbackLocale?: FallbackLocale;
     messages?: {
         [K in keyof _Messages]: MessageSchema;
@@ -177,9 +177,9 @@ export declare const CoreWarnCodes: {
 export declare type CoreWarnCodes = (typeof CoreWarnCodes)[keyof typeof CoreWarnCodes];
 export { createCompileError }
 
-export declare function createCoreContext<Message = string, Options extends CoreOptions<Message> = CoreOptions<Message>, Messages extends Record<string, any> = Options['messages'] extends Record<string, any> ? Options['messages'] : {}, DateTimeFormats extends Record<string, any> = Options['datetimeFormats'] extends Record<string, any> ? Options['datetimeFormats'] : {}, NumberFormats extends Record<string, any> = Options['numberFormats'] extends Record<string, any> ? Options['numberFormats'] : {}>(options: Options): CoreContext<Message, Messages, DateTimeFormats, NumberFormats>;
+export declare function createCoreContext<Message = string, Options extends CoreOptions<Message> = CoreOptions<Message>, Messages extends Record<string, any> = Options['messages'] extends Record<string, any> ? Options['messages'] : {}, DateTimeFormats extends Record<string, any> = Options['datetimeFormats'] extends Record<string, any> ? Options['datetimeFormats'] : {}, NumberFormats extends Record<string, any> = Options['numberFormats'] extends Record<string, any> ? Options['numberFormats'] : {}, LocaleType = Locale | LocaleDetector>(options: Options): CoreContext<Message, Messages, DateTimeFormats, NumberFormats, LocaleType>;
 
-export declare function createCoreContext<Schema = LocaleMessage, Locales = 'en-US', Message = string, Options extends CoreOptions<Message, SchemaParams<Schema, Message>, LocaleParams<Locales>> = CoreOptions<Message, SchemaParams<Schema, Message>, LocaleParams<Locales>>, Messages extends Record<string, any> = NonNullable<Options['messages']> extends Record<string, any> ? NonNullable<Options['messages']> : {}, DateTimeFormats extends Record<string, any> = NonNullable<Options['datetimeFormats']> extends Record<string, any> ? NonNullable<Options['datetimeFormats']> : {}, NumberFormats extends Record<string, any> = NonNullable<Options['numberFormats']> extends Record<string, any> ? NonNullable<Options['numberFormats']> : {}>(options: Options): CoreContext<Message, Messages, DateTimeFormats, NumberFormats>;
+export declare function createCoreContext<Schema = LocaleMessage, Locales = 'en-US', Message = string, Options extends CoreOptions<Message, SchemaParams<Schema, Message>, LocaleParams<Locales>> = CoreOptions<Message, SchemaParams<Schema, Message>, LocaleParams<Locales>>, Messages extends Record<string, any> = NonNullable<Options['messages']> extends Record<string, any> ? NonNullable<Options['messages']> : {}, DateTimeFormats extends Record<string, any> = NonNullable<Options['datetimeFormats']> extends Record<string, any> ? NonNullable<Options['datetimeFormats']> : {}, NumberFormats extends Record<string, any> = NonNullable<Options['numberFormats']> extends Record<string, any> ? NonNullable<Options['numberFormats']> : {}, LocaleType = Locale | LocaleDetector>(options: Options): CoreContext<Message, Messages, DateTimeFormats, NumberFormats, LocaleType>;
 
 export declare function createCoreError(code: CoreErrorCodes): CoreError;
 
@@ -275,17 +275,12 @@ export declare type DateTimeHumanReadable = 'long' | 'short' | 'narrow';
  *
  * @VueI18nGeneral
  */
-export declare interface DateTimeOptions<Key = string, Locales = Locale> extends Intl.DateTimeFormatOptions {
+export declare interface DateTimeOptions<Key = string, Locales = Locale> extends Intl.DateTimeFormatOptions, LocaleOptions<Locales> {
     /**
      * @remarks
      * The target format key
      */
     key?: Key;
-    /**
-     * @remarks
-     * The locale of localization
-     */
-    locale?: Locales;
     /**
      * @remarks
      * Whether suppress warnings outputted when localization fails
@@ -307,6 +302,36 @@ export declare const DEFAULT_LOCALE = "en-US";
 
 export declare const DEFAULT_MESSAGE_DATA_TYPE = "text";
 
+export declare type DefaultCoreLocaleMessageSchema<Schema = RemoveIndexSignature<{
+    [K in keyof DefineCoreLocaleMessage]: DefineCoreLocaleMessage[K];
+}>> = IsEmptyObject<Schema> extends true ? LocaleMessage<string> : Schema;
+
+/**
+ * The type definition of Locale Message for `@intlify/core-base` package
+ *
+ * @remarks
+ * The typealias is used to strictly define the type of the Locale message.
+ *
+ * @example
+ * ```ts
+ * // type.d.ts (`.d.ts` file at your app)
+ * import { DefineCoreLocaleMessage } from '@intlify/core-base'
+ *
+ * declare module '@intlify/core-base' {
+ *   export interface DefineCoreLocaleMessage {
+ *     title: string
+ *     menu: {
+ *       login: string
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * @VueI18nGeneral
+ */
+export declare interface DefineCoreLocaleMessage extends LocaleMessage<string> {
+}
+
 declare type ExtractToStringFunction<T> = T[ExtractToStringKey<T>];
 
 declare type ExtractToStringKey<T> = Extract<keyof T, 'toString'>;
@@ -373,6 +398,8 @@ export declare function getDevToolsHook(): IntlifyDevToolsEmitter | null;
 
 export declare const getFallbackContext: () => CoreContext | null;
 
+/* Excluded from this release type: getLocale */
+
 export declare function getWarnMessage(code: CoreWarnCodes, ...args: unknown[]): string;
 
 /* Excluded from this release type: handleMissing */
@@ -406,7 +433,7 @@ declare const enum IntlifyDevToolsHooks {
     FunctionTranslate = "function:translate"
 }
 
-export declare type IsEmptyObject<T> = [keyof T] extends [never] ? true : false;
+export declare type IsEmptyObject<T> = IsNever<keyof T> extends true ? true : false;
 
 export declare const isMessageAST: (val: unknown) => val is ResourceNode;
 
@@ -443,6 +470,12 @@ export declare interface LinkedOptions {
 /** @VueI18nGeneral */
 export declare type Locale = string;
 
+/** @VueI18nGeneral */
+export declare interface LocaleDetector<Args extends any[] = any[]> {
+    (...args: Args): Locale;
+    resolvedOnce?: boolean;
+}
+
 /**
  * The locale fallbacker
  *
@@ -471,6 +504,15 @@ export declare type LocaleMessageType<T, Message = string> = T extends string ?
 /** @VueI18nGeneral */
 export declare type LocaleMessageValue<Message = string> = LocaleMessageDictionary<any, Message> | string;
 
+/** @VueI18nGeneral */
+export declare interface LocaleOptions<Locales = Locale> {
+    /**
+     * @remarks
+     * The locale of localization
+     */
+    locale?: Locales | LocaleDetector;
+}
+
 export declare type LocaleParams<T, Default = 'en-US'> = T extends IsUnion<T> ? {
     messages: T;
     datetimeFormats: T;
@@ -793,17 +835,12 @@ export declare type NumberFormatToPartsResult = {
  *
  * @VueI18nGeneral
  */
-export declare interface NumberOptions<Key = string, Locales = Locale> extends Intl.NumberFormatOptions {
+export declare interface NumberOptions<Key = string, Locales = Locale> extends Intl.NumberFormatOptions, LocaleOptions<Locales> {
     /**
      * @remarks
      * The target format key
      */
     key?: Key;
-    /**
-     * @remarks
-     * The locale of localization
-     */
-    locale?: Locales;
     /**
      * @remarks
      * Whether suppress warnings outputted when localization fails
@@ -887,10 +924,16 @@ export declare function registerMessageCompiler<Message>(compiler: MessageCompil
  */
 export declare function registerMessageResolver(resolver: MessageResolver): void;
 
+export declare type RemovedIndexResources<T> = RemoveIndexSignature<{
+    [K in keyof T]: T[K];
+}>;
+
 export declare type RemoveIndexSignature<T> = {
     [K in keyof T as string extends K ? never : number extends K ? never : K]: T[K];
 };
 
+/* Excluded from this release type: resolveLocale */
+
 /**
  * message resolver
  *
@@ -980,34 +1023,69 @@ export declare interface SpecificNumberFormatOptions extends Intl.NumberFormatOp
 
 declare type StringConvertable<T> = ExtractToStringKey<T> extends never ? unknown : ExtractToStringFunction<T> extends (...args: any) => string ? T : unknown;
 
+/**
+ * TODO:
+ *  this type should be used (refactored) at `translate` type definition
+ *  (Unfortunately, using this type will result in key completion failure due to type mismatch...)
+ */
 /**
  * `translate` function overloads
  */
-export declare function translate<Context extends CoreContext<Message>, Key extends string = string, ResourceKeys extends PickupKeys<Context['messages']> = PickupKeys<Context['messages']>, Message = string>(context: Context, key: Key | ResourceKeys | number | MessageFunction<Message>): MessageFunctionReturn<Message> | number;
+export declare function translate<Context extends CoreContext<Message>, Key extends string = string, DefinedLocaleMessage extends RemovedIndexResources<DefineCoreLocaleMessage> = RemovedIndexResources<DefineCoreLocaleMessage>, CoreMessages = IsEmptyObject<DefinedLocaleMessage> extends false ? PickupPaths<{
+    [K in keyof DefinedLocaleMessage]: DefinedLocaleMessage[K];
+}> : never, ContextMessages = IsEmptyObject<Context['messages']> extends false ? PickupKeys<Context['messages']> : never, ResourceKeys extends CoreMessages | ContextMessages = IsNever<CoreMessages> extends false ? IsNever<ContextMessages> extends false ? CoreMessages | ContextMessages : CoreMessages : IsNever<ContextMessages> extends false ? ContextMessages : never, Message = string>(context: Context, key: Key | ResourceKeys | number | MessageFunction<Message>, plural: number): MessageFunctionReturn<Message> | number;
+
+export declare function translate<Context extends CoreContext<Message, {}, {}, {}>, Key extends string = string, DefinedLocaleMessage extends RemovedIndexResources<DefineCoreLocaleMessage> = RemovedIndexResources<DefineCoreLocaleMessage>, CoreMessages = IsEmptyObject<DefinedLocaleMessage> extends false ? PickupPaths<{
+    [K in keyof DefinedLocaleMessage]: DefinedLocaleMessage[K];
+}> : never, ContextMessages = IsEmptyObject<Context['messages']> extends false ? PickupKeys<Context['messages']> : never, ResourceKeys extends CoreMessages | ContextMessages = IsNever<CoreMessages> extends false ? IsNever<ContextMessages> extends false ? CoreMessages | ContextMessages : CoreMessages : IsNever<ContextMessages> extends false ? ContextMessages : never, Message = string>(context: Context, key: Key | ResourceKeys | number | MessageFunction<Message>): MessageFunctionReturn<Message> | number;
 
-export declare function translate<Context extends CoreContext<Message, {}, {}, {}>, Key extends string = string, ResourceKeys extends PickupKeys<Context['messages']> = PickupKeys<Context['messages']>, Message = string>(context: Context, key: Key | ResourceKeys | number | MessageFunction<Message>, plural: number): MessageFunctionReturn<Message> | number;
+export declare function translate<Context extends CoreContext<Message, {}, {}, {}>, Key extends string = string, DefinedLocaleMessage extends RemovedIndexResources<DefineCoreLocaleMessage> = RemovedIndexResources<DefineCoreLocaleMessage>, CoreMessages = IsEmptyObject<DefinedLocaleMessage> extends false ? PickupPaths<{
+    [K in keyof DefinedLocaleMessage]: DefinedLocaleMessage[K];
+}> : never, ContextMessages = IsEmptyObject<Context['messages']> extends false ? PickupKeys<Context['messages']> : never, ResourceKeys extends CoreMessages | ContextMessages = IsNever<CoreMessages> extends false ? IsNever<ContextMessages> extends false ? CoreMessages | ContextMessages : CoreMessages : IsNever<ContextMessages> extends false ? ContextMessages : never, Message = string>(context: Context, key: Key | ResourceKeys | number | MessageFunction<Message>, plural: number): MessageFunctionReturn<Message> | number;
 
-export declare function translate<Context extends CoreContext<Message, {}, {}, {}>, Key extends string = string, ResourceKeys extends PickupKeys<Context['messages']> = PickupKeys<Context['messages']>, Message = string>(context: Context, key: Key | ResourceKeys | number | MessageFunction<Message>, plural: number, options: TranslateOptions<Context['locale']>): MessageFunctionReturn<Message> | number;
+export declare function translate<Context extends CoreContext<Message, {}, {}, {}>, Key extends string = string, DefinedLocaleMessage extends RemovedIndexResources<DefineCoreLocaleMessage> = RemovedIndexResources<DefineCoreLocaleMessage>, CoreMessages = IsEmptyObject<DefinedLocaleMessage> extends false ? PickupPaths<{
+    [K in keyof DefinedLocaleMessage]: DefinedLocaleMessage[K];
+}> : never, ContextMessages = IsEmptyObject<Context['messages']> extends false ? PickupKeys<Context['messages']> : never, ResourceKeys extends CoreMessages | ContextMessages = IsNever<CoreMessages> extends false ? IsNever<ContextMessages> extends false ? CoreMessages | ContextMessages : CoreMessages : IsNever<ContextMessages> extends false ? ContextMessages : never, Message = string>(context: Context, key: Key | ResourceKeys | number | MessageFunction<Message>, plural: number, options: TranslateOptions<Context['locale']>): MessageFunctionReturn<Message> | number;
 
-export declare function translate<Context extends CoreContext<Message, {}, {}, {}>, Key extends string = string, ResourceKeys extends PickupKeys<Context['messages']> = PickupKeys<Context['messages']>, Message = string>(context: Context, key: Key | ResourceKeys | number | MessageFunction<Message>, defaultMsg: string): MessageFunctionReturn<Message> | number;
+export declare function translate<Context extends CoreContext<Message, {}, {}, {}>, Key extends string = string, DefinedLocaleMessage extends RemovedIndexResources<DefineCoreLocaleMessage> = RemovedIndexResources<DefineCoreLocaleMessage>, CoreMessages = IsEmptyObject<DefinedLocaleMessage> extends false ? PickupPaths<{
+    [K in keyof DefinedLocaleMessage]: DefinedLocaleMessage[K];
+}> : never, ContextMessages = IsEmptyObject<Context['messages']> extends false ? PickupKeys<Context['messages']> : never, ResourceKeys extends CoreMessages | ContextMessages = IsNever<CoreMessages> extends false ? IsNever<ContextMessages> extends false ? CoreMessages | ContextMessages : CoreMessages : IsNever<ContextMessages> extends false ? ContextMessages : never, Message = string>(context: Context, key: Key | ResourceKeys | number | MessageFunction<Message>, defaultMsg: string): MessageFunctionReturn<Message> | number;
 
-export declare function translate<Context extends CoreContext<Message, {}, {}, {}>, Key extends string = string, ResourceKeys extends PickupKeys<Context['messages']> = PickupKeys<Context['messages']>, Message = string>(context: Context, key: Key | ResourceKeys | number | MessageFunction<Message>, defaultMsg: string, options: TranslateOptions<Context['locale']>): MessageFunctionReturn<Message> | number;
+export declare function translate<Context extends CoreContext<Message, {}, {}, {}>, Key extends string = string, DefinedLocaleMessage extends RemovedIndexResources<DefineCoreLocaleMessage> = RemovedIndexResources<DefineCoreLocaleMessage>, CoreMessages = IsEmptyObject<DefinedLocaleMessage> extends false ? PickupPaths<{
+    [K in keyof DefinedLocaleMessage]: DefinedLocaleMessage[K];
+}> : never, ContextMessages = IsEmptyObject<Context['messages']> extends false ? PickupKeys<Context['messages']> : never, ResourceKeys extends CoreMessages | ContextMessages = IsNever<CoreMessages> extends false ? IsNever<ContextMessages> extends false ? CoreMessages | ContextMessages : CoreMessages : IsNever<ContextMessages> extends false ? ContextMessages : never, Message = string>(context: Context, key: Key | ResourceKeys | number | MessageFunction<Message>, defaultMsg: string, options: TranslateOptions<Context['locale']>): MessageFunctionReturn<Message> | number;
 
-export declare function translate<Context extends CoreContext<Message, {}, {}, {}>, Key extends string = string, ResourceKeys extends PickupKeys<Context['messages']> = PickupKeys<Context['messages']>, Message = string>(context: Context, key: Key | ResourceKeys | number | MessageFunction<Message>, list: unknown[]): MessageFunctionReturn<Message> | number;
+export declare function translate<Context extends CoreContext<Message, {}, {}, {}>, Key extends string = string, DefinedLocaleMessage extends RemovedIndexResources<DefineCoreLocaleMessage> = RemovedIndexResources<DefineCoreLocaleMessage>, CoreMessages = IsEmptyObject<DefinedLocaleMessage> extends false ? PickupPaths<{
+    [K in keyof DefinedLocaleMessage]: DefinedLocaleMessage[K];
+}> : never, ContextMessages = IsEmptyObject<Context['messages']> extends false ? PickupKeys<Context['messages']> : never, ResourceKeys extends CoreMessages | ContextMessages = IsNever<CoreMessages> extends false ? IsNever<ContextMessages> extends false ? CoreMessages | ContextMessages : CoreMessages : IsNever<ContextMessages> extends false ? ContextMessages : never, Message = string>(context: Context, key: Key | ResourceKeys | number | MessageFunction<Message>, list: unknown[]): MessageFunctionReturn<Message> | number;
 
-export declare function translate<Context extends CoreContext<Message, {}, {}, {}>, Key extends string = string, ResourceKeys extends PickupKeys<Context['messages']> = PickupKeys<Context['messages']>, Message = string>(context: Context, key: Key | ResourceKeys | number | MessageFunction<Message>, list: unknown[], plural: number): MessageFunctionReturn<Message> | number;
+export declare function translate<Context extends CoreContext<Message, {}, {}, {}>, Key extends string = string, DefinedLocaleMessage extends RemovedIndexResources<DefineCoreLocaleMessage> = RemovedIndexResources<DefineCoreLocaleMessage>, CoreMessages = IsEmptyObject<DefinedLocaleMessage> extends false ? PickupPaths<{
+    [K in keyof DefinedLocaleMessage]: DefinedLocaleMessage[K];
+}> : never, ContextMessages = IsEmptyObject<Context['messages']> extends false ? PickupKeys<Context['messages']> : never, ResourceKeys extends CoreMessages | ContextMessages = IsNever<CoreMessages> extends false ? IsNever<ContextMessages> extends false ? CoreMessages | ContextMessages : CoreMessages : IsNever<ContextMessages> extends false ? ContextMessages : never, Message = string>(context: Context, key: Key | ResourceKeys | number | MessageFunction<Message>, list: unknown[], plural: number): MessageFunctionReturn<Message> | number;
 
-export declare function translate<Context extends CoreContext<Message, {}, {}, {}>, Key extends string = string, ResourceKeys extends PickupKeys<Context['messages']> = PickupKeys<Context['messages']>, Message = string>(context: Context, key: Key | ResourceKeys | number | MessageFunction<Message>, list: unknown[], defaultMsg: string): MessageFunctionReturn<Message> | number;
+export declare function translate<Context extends CoreContext<Message, {}, {}, {}>, Key extends string = string, DefinedLocaleMessage extends RemovedIndexResources<DefineCoreLocaleMessage> = RemovedIndexResources<DefineCoreLocaleMessage>, CoreMessages = IsEmptyObject<DefinedLocaleMessage> extends false ? PickupPaths<{
+    [K in keyof DefinedLocaleMessage]: DefinedLocaleMessage[K];
+}> : never, ContextMessages = IsEmptyObject<Context['messages']> extends false ? PickupKeys<Context['messages']> : never, ResourceKeys extends CoreMessages | ContextMessages = IsNever<CoreMessages> extends false ? IsNever<ContextMessages> extends false ? CoreMessages | ContextMessages : CoreMessages : IsNever<ContextMessages> extends false ? ContextMessages : never, Message = string>(context: Context, key: Key | ResourceKeys | number | MessageFunction<Message>, list: unknown[], defaultMsg: string): MessageFunctionReturn<Message> | number;
 
-export declare function translate<Context extends CoreContext<Message, {}, {}, {}>, Key extends string = string, ResourceKeys extends PickupKeys<Context['messages']> = PickupKeys<Context['messages']>, Message = string>(context: Context, key: Key | ResourceKeys | number | MessageFunction<Message>, list: unknown[], options: TranslateOptions<Context['locale']>): MessageFunctionReturn<Message> | number;
+export declare function translate<Context extends CoreContext<Message, {}, {}, {}>, Key extends string = string, DefinedLocaleMessage extends RemovedIndexResources<DefineCoreLocaleMessage> = RemovedIndexResources<DefineCoreLocaleMessage>, CoreMessages = IsEmptyObject<DefinedLocaleMessage> extends false ? PickupPaths<{
+    [K in keyof DefinedLocaleMessage]: DefinedLocaleMessage[K];
+}> : never, ContextMessages = IsEmptyObject<Context['messages']> extends false ? PickupKeys<Context['messages']> : never, ResourceKeys extends CoreMessages | ContextMessages = IsNever<CoreMessages> extends false ? IsNever<ContextMessages> extends false ? CoreMessages | ContextMessages : CoreMessages : IsNever<ContextMessages> extends false ? ContextMessages : never, Message = string>(context: Context, key: Key | ResourceKeys | number | MessageFunction<Message>, list: unknown[], options: TranslateOptions<Context['locale']>): MessageFunctionReturn<Message> | number;
 
-export declare function translate<Context extends CoreContext<Message, {}, {}, {}>, Key extends string = string, ResourceKeys extends PickupKeys<Context['messages']> = PickupKeys<Context['messages']>, Message = string>(context: Context, key: Key | ResourceKeys | number | MessageFunction<Message>, named: NamedValue): MessageFunctionReturn<Message> | number;
+export declare function translate<Context extends CoreContext<Message, {}, {}, {}>, Key extends string = string, DefinedLocaleMessage extends RemovedIndexResources<DefineCoreLocaleMessage> = RemovedIndexResources<DefineCoreLocaleMessage>, CoreMessages = IsEmptyObject<DefinedLocaleMessage> extends false ? PickupPaths<{
+    [K in keyof DefinedLocaleMessage]: DefinedLocaleMessage[K];
+}> : never, ContextMessages = IsEmptyObject<Context['messages']> extends false ? PickupKeys<Context['messages']> : never, ResourceKeys extends CoreMessages | ContextMessages = IsNever<CoreMessages> extends false ? IsNever<ContextMessages> extends false ? CoreMessages | ContextMessages : CoreMessages : IsNever<ContextMessages> extends false ? ContextMessages : never, Message = string>(context: Context, key: Key | ResourceKeys | number | MessageFunction<Message>, named: NamedValue): MessageFunctionReturn<Message> | number;
 
-export declare function translate<Context extends CoreContext<Message, {}, {}, {}>, Key extends string = string, ResourceKeys extends PickupKeys<Context['messages']> = PickupKeys<Context['messages']>, Message = string>(context: Context, key: Key | ResourceKeys | number | MessageFunction<Message>, named: NamedValue, plural: number): MessageFunctionReturn<Message> | number;
+export declare function translate<Context extends CoreContext<Message, {}, {}, {}>, Key extends string = string, DefinedLocaleMessage extends RemovedIndexResources<DefineCoreLocaleMessage> = RemovedIndexResources<DefineCoreLocaleMessage>, CoreMessages = IsEmptyObject<DefinedLocaleMessage> extends false ? PickupPaths<{
+    [K in keyof DefinedLocaleMessage]: DefinedLocaleMessage[K];
+}> : never, ContextMessages = IsEmptyObject<Context['messages']> extends false ? PickupKeys<Context['messages']> : never, ResourceKeys extends CoreMessages | ContextMessages = IsNever<CoreMessages> extends false ? IsNever<ContextMessages> extends false ? CoreMessages | ContextMessages : CoreMessages : IsNever<ContextMessages> extends false ? ContextMessages : never, Message = string>(context: Context, key: Key | ResourceKeys | number | MessageFunction<Message>, named: NamedValue, plural: number): MessageFunctionReturn<Message> | number;
 
-export declare function translate<Context extends CoreContext<Message, {}, {}, {}>, Key extends string = string, ResourceKeys extends PickupKeys<Context['messages']> = PickupKeys<Context['messages']>, Message = string>(context: Context, key: Key | ResourceKeys | number | MessageFunction<Message>, named: NamedValue, defaultMsg: string): MessageFunctionReturn<Message> | number;
+export declare function translate<Context extends CoreContext<Message, {}, {}, {}>, Key extends string = string, DefinedLocaleMessage extends RemovedIndexResources<DefineCoreLocaleMessage> = RemovedIndexResources<DefineCoreLocaleMessage>, CoreMessages = IsEmptyObject<DefinedLocaleMessage> extends false ? PickupPaths<{
+    [K in keyof DefinedLocaleMessage]: DefinedLocaleMessage[K];
+}> : never, ContextMessages = IsEmptyObject<Context['messages']> extends false ? PickupKeys<Context['messages']> : never, ResourceKeys extends CoreMessages | ContextMessages = IsNever<CoreMessages> extends false ? IsNever<ContextMessages> extends false ? CoreMessages | ContextMessages : CoreMessages : IsNever<ContextMessages> extends false ? ContextMessages : never, Message = string>(context: Context, key: Key | ResourceKeys | number | MessageFunction<Message>, named: NamedValue, defaultMsg: string): MessageFunctionReturn<Message> | number;
 
-export declare function translate<Context extends CoreContext<Message, {}, {}, {}>, Key extends string = string, ResourceKeys extends PickupKeys<Context['messages']> = PickupKeys<Context['messages']>, Message = string>(context: Context, key: Key | ResourceKeys | number | MessageFunction<Message>, named: NamedValue, options: TranslateOptions<Context['locale']>): MessageFunctionReturn<Message> | number;
+export declare function translate<Context extends CoreContext<Message, {}, {}, {}>, Key extends string = string, DefinedLocaleMessage extends RemovedIndexResources<DefineCoreLocaleMessage> = RemovedIndexResources<DefineCoreLocaleMessage>, CoreMessages = IsEmptyObject<DefinedLocaleMessage> extends false ? PickupPaths<{
+    [K in keyof DefinedLocaleMessage]: DefinedLocaleMessage[K];
+}> : never, ContextMessages = IsEmptyObject<Context['messages']> extends false ? PickupKeys<Context['messages']> : never, ResourceKeys extends CoreMessages | ContextMessages = IsNever<CoreMessages> extends false ? IsNever<ContextMessages> extends false ? CoreMessages | ContextMessages : CoreMessages : IsNever<ContextMessages> extends false ? ContextMessages : never, Message = string>(context: Context, key: Key | ResourceKeys | number | MessageFunction<Message>, named: NamedValue, options: TranslateOptions<Context['locale']>): MessageFunctionReturn<Message> | number;
 
 export declare const translateDevTools: (payloads: IntlifyDevToolsHookPayloads[IntlifyDevToolsHooks]) => void | null;
 
@@ -1062,7 +1140,7 @@ export declare const translateDevTools: (payloads: IntlifyDevToolsHookPayloads[I
  *
  * @VueI18nGeneral
  */
-export declare interface TranslateOptions<Locales = Locale> {
+export declare interface TranslateOptions<Locales = Locale> extends LocaleOptions<Locales> {
     /**
      * @remarks
      * List interpolation
@@ -1083,11 +1161,6 @@ export declare interface TranslateOptions<Locales = Locale> {
      * Default message when is occurred translation missing
      */
     default?: string | boolean;
-    /**
-     * @remarks
-     * The locale of localization
-     */
-    locale?: Locales;
     /**
      * @remarks
      * Whether suppress warnings outputted when localization fails

package/dist/core-base.esm-browser.js

@@ -1,5 +1,5 @@
 /*!
-  * core-base v9.4.1
+  * core-base v9.6.0
   * (c) 2023 kazuya kawaguchi
   * Released under the MIT License.
   */
@@ -2102,6 +2102,22 @@ function getWarnMessage(code, ...args) {
     return format$1(warnMessages[code], ...args);
 }
 
+/** @internal */
+function getLocale(context, options) {
+    return options.locale != null
+        ? resolveLocale(options.locale)
+        : resolveLocale(context.locale);
+}
+let _resolveLocale;
+/** @internal */
+function resolveLocale(locale) {
+    // prettier-ignore
+    return isString(locale)
+        ? locale
+        : _resolveLocale != null && locale.resolvedOnce
+            ? _resolveLocale
+            : (_resolveLocale = locale());
+}
 /**
  * Fallback with simple implemenation
  *
@@ -2223,7 +2239,7 @@ function appendItemToChain(chain, target, blocks) {
  * Intlify core-base version
  * @internal
  */
-const VERSION = '9.4.1';
+const VERSION = '9.6.0';
 const NOT_REOSLVED = -1;
 const DEFAULT_LOCALE = 'en-US';
 const MISSING_RESOLVE_VALUE = '';
@@ -2299,23 +2315,26 @@ function createCoreContext(options = {}) {
     // setup options
     const onWarn = isFunction(options.onWarn) ? options.onWarn : warn;
     const version = isString(options.version) ? options.version : VERSION;
-    const locale = isString(options.locale) ? options.locale : DEFAULT_LOCALE;
+    const locale = isString(options.locale) || isFunction(options.locale)
+        ? options.locale
+        : DEFAULT_LOCALE;
+    const _locale = isFunction(locale) ? DEFAULT_LOCALE : locale;
     const fallbackLocale = isArray(options.fallbackLocale) ||
         isPlainObject(options.fallbackLocale) ||
         isString(options.fallbackLocale) ||
         options.fallbackLocale === false
         ? options.fallbackLocale
-        : locale;
+        : _locale;
     const messages = isPlainObject(options.messages)
         ? options.messages
-        : { [locale]: {} };
+        : { [_locale]: {} };
     const datetimeFormats = isPlainObject(options.datetimeFormats)
             ? options.datetimeFormats
-            : { [locale]: {} }
+            : { [_locale]: {} }
         ;
     const numberFormats = isPlainObject(options.numberFormats)
             ? options.numberFormats
-            : { [locale]: {} }
+            : { [_locale]: {} }
         ;
     const modifiers = assign({}, options.modifiers || {}, getDefaultLinkedModifiers());
     const pluralRules = options.pluralRules || {};
@@ -2492,7 +2511,7 @@ function formatMessagePart(ctx, node) {
             return ctx.interpolate(ctx.named(named.k || named.key));
         case 5 /* NodeTypes.List */:
             const list = node;
-            return ctx.interpolate(ctx.list(list.i || list.index));
+            return ctx.interpolate(ctx.list(list.i != null ? list.i : list.index));
         case 6 /* NodeTypes.Linked */:
             const linked = node;
             const modifier = linked.m || linked.modifier;
@@ -2655,7 +2674,7 @@ function translate(context, ...args) {
             ? (!messageCompiler ? () => key : key)
             : '';
     const enableDefaultMsg = fallbackFormat || defaultMsgOrKey !== '';
-    const locale = isString(options.locale) ? options.locale : context.locale;
+    const locale = getLocale(context, options);
     // escape params
     escapeParameter && escapeParams(options);
     // resolve message format
@@ -3059,7 +3078,7 @@ function datetime(context, ...args) {
         ? options.fallbackWarn
         : context.fallbackWarn;
     const part = !!options.part;
-    const locale = isString(options.locale) ? options.locale : context.locale;
+    const locale = getLocale(context, options);
     const locales = localeFallbacker(context, // eslint-disable-line @typescript-eslint/no-explicit-any
     fallbackLocale, locale);
     if (!isString(key) || key === '') {
@@ -3233,7 +3252,7 @@ function number(context, ...args) {
         ? options.fallbackWarn
         : context.fallbackWarn;
     const part = !!options.part;
-    const locale = isString(options.locale) ? options.locale : context.locale;
+    const locale = getLocale(context, options);
     const locales = localeFallbacker(context, // eslint-disable-line @typescript-eslint/no-explicit-any
     fallbackLocale, locale);
     if (!isString(key) || key === '') {
@@ -3359,4 +3378,4 @@ function clearNumberFormat(ctx, locale, format) {
     }
 }
 
-export { CompileErrorCodes, CoreErrorCodes, CoreWarnCodes, DATETIME_FORMAT_OPTIONS_KEYS, DEFAULT_LOCALE, DEFAULT_MESSAGE_DATA_TYPE, MISSING_RESOLVE_VALUE, NOT_REOSLVED, NUMBER_FORMAT_OPTIONS_KEYS, VERSION, clearCompileCache, clearDateTimeFormat, clearNumberFormat, compile, compileToFunction, createCompileError, createCoreContext, createCoreError, createMessageContext, datetime, fallbackWithLocaleChain, fallbackWithSimple, getAdditionalMeta, getDevToolsHook, getFallbackContext, getWarnMessage, handleMissing, initI18nDevTools, isMessageAST, isMessageFunction, isTranslateFallbackWarn, isTranslateMissingWarn, number, parse, parseDateTimeArgs, parseNumberArgs, parseTranslateArgs, registerLocaleFallbacker, registerMessageCompiler, registerMessageResolver, resolveValue, resolveWithKeyValue, setAdditionalMeta, setDevToolsHook, setFallbackContext, translate, translateDevTools, updateFallbackLocale };
+export { CompileErrorCodes, CoreErrorCodes, CoreWarnCodes, DATETIME_FORMAT_OPTIONS_KEYS, DEFAULT_LOCALE, DEFAULT_MESSAGE_DATA_TYPE, MISSING_RESOLVE_VALUE, NOT_REOSLVED, NUMBER_FORMAT_OPTIONS_KEYS, VERSION, clearCompileCache, clearDateTimeFormat, clearNumberFormat, compile, compileToFunction, createCompileError, createCoreContext, createCoreError, createMessageContext, datetime, fallbackWithLocaleChain, fallbackWithSimple, getAdditionalMeta, getDevToolsHook, getFallbackContext, getLocale, getWarnMessage, handleMissing, initI18nDevTools, isMessageAST, isMessageFunction, isTranslateFallbackWarn, isTranslateMissingWarn, number, parse, parseDateTimeArgs, parseNumberArgs, parseTranslateArgs, registerLocaleFallbacker, registerMessageCompiler, registerMessageResolver, resolveLocale, resolveValue, resolveWithKeyValue, setAdditionalMeta, setDevToolsHook, setFallbackContext, translate, translateDevTools, updateFallbackLocale };