vue-i18n 11.2.8 → 11.3.1

package/dist/vue-i18n.cjs

@@ -1,6 +1,6 @@
 /*!
-  * vue-i18n v11.2.8
-  * (c) 2025 kazuya kawaguchi
+  * vue-i18n v11.3.1
+  * (c) 2026 kazuya kawaguchi
   * Released under the MIT License.
   */
 'use strict';
@@ -30,7 +30,7 @@ var Vue__namespace = /*#__PURE__*/_interopNamespaceDefault(Vue);
  *
  * @VueI18nGeneral
  */
-const VERSION = '11.2.8';
+const VERSION = '11.3.1';
 
 const I18nErrorCodes = {
     // composer module errors
@@ -535,11 +535,25 @@ function createComposer(options = {}) {
                 return false;
             }
             const targetLocale = shared.isString(locale) ? locale : _locale.value;
-            const message = getLocaleMessage(targetLocale);
-            const resolved = _context.messageResolver(message, key);
-            return (coreBase.isMessageAST(resolved) ||
-                coreBase.isMessageFunction(resolved) ||
-                shared.isString(resolved));
+            // When locale is explicitly specified, check only that locale (no fallback chain)
+            // When locale is not specified, check the fallback locale chain
+            const locales = shared.isString(locale)
+                ? [targetLocale]
+                : coreBase.fallbackWithLocaleChain(_context, _fallbackLocale.value, targetLocale);
+            for (let i = 0; i < locales.length; i++) {
+                const message = getLocaleMessage(locales[i]);
+                let resolved = _context.messageResolver(message, key);
+                // if null, resolve with object key path (for flat keys containing dots)
+                if (resolved === null) {
+                    resolved = message[key];
+                }
+                if (coreBase.isMessageAST(resolved) ||
+                    coreBase.isMessageFunction(resolved) ||
+                    shared.isString(resolved)) {
+                    return true;
+                }
+            }
+            return false;
         }, () => [key], 'translate exists', root => {
             return Reflect.apply(root.te, root, [key, locale]);
         }, NOOP_RETURN_FALSE, val => shared.isBoolean(val));
@@ -1414,8 +1428,7 @@ function vTDirective(i18n) {
     };
     const register = (el, binding) => {
         const [textContent, composer] = _process(binding);
-        if (shared.inBrowser && i18n.global === composer) {
-            // global scope only
+        if (shared.inBrowser) {
             el.__i18nWatcher = Vue.watch(composer.locale, () => {
                 binding.instance && binding.instance.$forceUpdate();
             });

package/dist/vue-i18n.d.ts

@@ -3684,7 +3684,7 @@ declare module 'vue' {
      * @returns formatted value
      */
     $d<
-      Value extends number | Date = number,
+      Value extends number | Date | string = number,
       Key extends string = string,
       DefinedDateTimeFormat extends
         RemovedIndexResources<DefineDateTimeFormat> = RemovedIndexResources<DefineDateTimeFormat>,
@@ -3711,7 +3711,7 @@ declare module 'vue' {
      * @returns formatted value
      */
     $d<
-      Value extends number | Date = number,
+      Value extends number | Date | string = number,
       Key extends string = string,
       DefinedDateTimeFormat extends
         RemovedIndexResources<DefineDateTimeFormat> = RemovedIndexResources<DefineDateTimeFormat>,
@@ -3764,7 +3764,7 @@ declare module 'vue' {
      * @returns formatted value
      */
     $d<
-      Value extends number | Date = number,
+      Value extends number | Date | string = number,
       Key extends string = string,
       DefinedDateTimeFormat extends
         RemovedIndexResources<DefineDateTimeFormat> = RemovedIndexResources<DefineDateTimeFormat>,
@@ -3791,7 +3791,7 @@ declare module 'vue' {
      * @returns formatted value
      */
     $d<
-      Value extends number | Date = number,
+      Value extends number | Date | string = number,
       Key extends string = string,
       DefinedDateTimeFormat extends
         RemovedIndexResources<DefineDateTimeFormat> = RemovedIndexResources<DefineDateTimeFormat>,
@@ -3863,7 +3863,7 @@ declare module 'vue' {
     $n<
       Key extends string = string,
       DefinedNumberFormat extends
-        RemovedIndexResources<DefineDateTimeFormat> = RemovedIndexResources<DefineDateTimeFormat>,
+        RemovedIndexResources<DefineNumberFormat> = RemovedIndexResources<DefineNumberFormat>,
       Keys = IsEmptyObject<DefinedNumberFormat> extends false
         ? PickupFormatPathKeys<{
             [K in keyof DefinedNumberFormat]: DefinedNumberFormat[K]
@@ -3889,7 +3889,7 @@ declare module 'vue' {
     $n<
       Key extends string = string,
       DefinedNumberFormat extends
-        RemovedIndexResources<DefineDateTimeFormat> = RemovedIndexResources<DefineDateTimeFormat>,
+        RemovedIndexResources<DefineNumberFormat> = RemovedIndexResources<DefineNumberFormat>,
       Keys = IsEmptyObject<DefinedNumberFormat> extends false
         ? PickupFormatPathKeys<{
             [K in keyof DefinedNumberFormat]: DefinedNumberFormat[K]
@@ -3977,7 +3977,7 @@ declare module 'vue' {
     $n<
       Key extends string = string,
       DefinedNumberFormat extends
-        RemovedIndexResources<DefineDateTimeFormat> = RemovedIndexResources<DefineDateTimeFormat>,
+        RemovedIndexResources<DefineNumberFormat> = RemovedIndexResources<DefineNumberFormat>,
       Keys = IsEmptyObject<DefinedNumberFormat> extends false
         ? PickupFormatPathKeys<{
             [K in keyof DefinedNumberFormat]: DefinedNumberFormat[K]
@@ -4003,7 +4003,7 @@ declare module 'vue' {
     $n<
       Key extends string = string,
       DefinedNumberFormat extends
-        RemovedIndexResources<DefineDateTimeFormat> = RemovedIndexResources<DefineDateTimeFormat>,
+        RemovedIndexResources<DefineNumberFormat> = RemovedIndexResources<DefineNumberFormat>,
       Keys = IsEmptyObject<DefinedNumberFormat> extends false
         ? PickupFormatPathKeys<{
             [K in keyof DefinedNumberFormat]: DefinedNumberFormat[K]
@@ -4029,7 +4029,7 @@ declare module 'vue' {
     $n<
       Key extends string,
       DefinedNumberFormat extends
-        RemovedIndexResources<DefineDateTimeFormat> = RemovedIndexResources<DefineDateTimeFormat>,
+        RemovedIndexResources<DefineNumberFormat> = RemovedIndexResources<DefineNumberFormat>,
       Keys = IsEmptyObject<DefinedNumberFormat> extends false
         ? PickupFormatPathKeys<{
             [K in keyof DefinedNumberFormat]: DefinedNumberFormat[K]

package/dist/vue-i18n.esm-browser.js

@@ -1,6 +1,6 @@
 /*!
-  * vue-i18n v11.2.8
-  * (c) 2025 kazuya kawaguchi
+  * vue-i18n v11.3.1
+  * (c) 2026 kazuya kawaguchi
   * Released under the MIT License.
   */
 import * as Vue from 'vue';
@@ -716,7 +716,24 @@ function createTokenizer(source, options = {}) {
         let buf = '';
         while (true) {
             const ch = scnr.currentChar();
-            if (ch === "{" /* TokenChars.BraceLeft */ ||
+            if (ch === '\\') {
+                const nextCh = scnr.peek();
+                if (nextCh === "{" /* TokenChars.BraceLeft */ ||
+                    nextCh === "}" /* TokenChars.BraceRight */ ||
+                    nextCh === "@" /* TokenChars.LinkedAlias */ ||
+                    nextCh === "|" /* TokenChars.Pipe */ ||
+                    nextCh === '\\') {
+                    buf += ch + nextCh;
+                    scnr.next();
+                    scnr.next();
+                }
+                else {
+                    scnr.resetPeek();
+                    buf += ch;
+                    scnr.next();
+                }
+            }
+            else if (ch === "{" /* TokenChars.BraceLeft */ ||
                 ch === "}" /* TokenChars.BraceRight */ ||
                 ch === "@" /* TokenChars.LinkedAlias */ ||
                 ch === "|" /* TokenChars.Pipe */ ||
@@ -1102,6 +1119,11 @@ function createTokenizer(source, options = {}) {
 const ERROR_DOMAIN$2 = 'parser';
 // Backslash backslash, backslash quote, uHHHH, UHHHHHH.
 const KNOWN_ESCAPES = /(?:\\\\|\\'|\\u([0-9a-fA-F]{4})|\\U([0-9a-fA-F]{6}))/g;
+// Text context escape sequences: \\, \@, \{, \}, \|
+const TEXT_ESCAPES = /\\([\\@{}|])/g;
+function fromTextEscapeSequence(_match, char) {
+    return char;
+}
 function fromEscapeSequence(match, codePoint4, codePoint6) {
     switch (match) {
         case `\\\\`:
@@ -1157,7 +1179,7 @@ function createParser(options = {}) {
     function parseText(tokenizer, value) {
         const context = tokenizer.context();
         const node = startNode(3 /* NodeTypes.Text */, context.offset, context.startLoc);
-        node.value = value;
+        node.value = value.replace(TEXT_ESCAPES, fromTextEscapeSequence);
         endNode(node, tokenizer.currentOffset(), tokenizer.currentPosition());
         return node;
     }
@@ -2462,6 +2484,7 @@ function resolveValue(obj, path) {
     }
     // resolve path value
     const len = hit.length;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- for generic object
     let last = obj;
     let i = 0;
     while (i < len) {
@@ -2474,6 +2497,12 @@ function resolveValue(obj, path) {
         if (AST_NODE_PROPS_KEYS.includes(key) && isMessageAST(last)) {
             return null;
         }
+        if (!isObject(last)) {
+            return null;
+        }
+        if (!hasOwn(last, key)) {
+            return null;
+        }
         const val = last[key];
         if (val === undefined) {
             return null;
@@ -2494,9 +2523,11 @@ const CoreWarnCodes = {
     FALLBACK_TO_NUMBER_FORMAT: 4,
     CANNOT_FORMAT_DATE: 5,
     FALLBACK_TO_DATE_FORMAT: 6,
-    EXPERIMENTAL_CUSTOM_MESSAGE_COMPILER: 7
+    EXPERIMENTAL_CUSTOM_MESSAGE_COMPILER: 7,
+    INVALID_NUMBER_ARGUMENT: 8,
+    INVALID_DATE_ARGUMENT: 9
 };
-const CORE_WARN_CODES_EXTEND_POINT = 8;
+const CORE_WARN_CODES_EXTEND_POINT = 10;
 /** @internal */
 const warnMessages$1 = {
     [CoreWarnCodes.NOT_FOUND_KEY]: `Not found '{key}' key in '{locale}' locale messages.`,
@@ -2505,7 +2536,9 @@ const warnMessages$1 = {
     [CoreWarnCodes.FALLBACK_TO_NUMBER_FORMAT]: `Fall back to number format '{key}' key with '{target}' locale.`,
     [CoreWarnCodes.CANNOT_FORMAT_DATE]: `Cannot format a date value due to not supported Intl.DateTimeFormat.`,
     [CoreWarnCodes.FALLBACK_TO_DATE_FORMAT]: `Fall back to datetime format '{key}' key with '{target}' locale.`,
-    [CoreWarnCodes.EXPERIMENTAL_CUSTOM_MESSAGE_COMPILER]: `This project is using Custom Message Compiler, which is an experimental feature. It may receive breaking changes or be removed in the future.`
+    [CoreWarnCodes.EXPERIMENTAL_CUSTOM_MESSAGE_COMPILER]: `This project is using Custom Message Compiler, which is an experimental feature. It may receive breaking changes or be removed in the future.`,
+    [CoreWarnCodes.INVALID_NUMBER_ARGUMENT]: `Invalid argument for number formatting: expected a number but received '{value}'.`,
+    [CoreWarnCodes.INVALID_DATE_ARGUMENT]: `Invalid argument for datetime formatting: expected a Date, number, or ISO string but received '{value}'.`
 };
 function getWarnMessage$1(code, ...args) {
     return format$1(warnMessages$1[code], ...args);
@@ -2516,7 +2549,7 @@ function getWarnMessage$1(code, ...args) {
  * Intlify core-base version
  * @internal
  */
-const VERSION$1 = '11.2.8';
+const VERSION$1 = '11.3.1';
 const NOT_REOSLVED = -1;
 const DEFAULT_LOCALE = 'en-US';
 const MISSING_RESOLVE_VALUE = '';
@@ -2780,6 +2813,14 @@ function datetime(context, ...args) {
         onWarn(getWarnMessage$1(CoreWarnCodes.CANNOT_FORMAT_DATE));
         return MISSING_RESOLVE_VALUE;
     }
+    if (!isString(args[0]) && !isDate(args[0]) && !isNumber(args[0])) {
+        {
+            onWarn(getWarnMessage$1(CoreWarnCodes.INVALID_DATE_ARGUMENT, {
+                value: String(args[0])
+            }));
+        }
+        return MISSING_RESOLVE_VALUE;
+    }
     const [key, value, options, overrides] = parseDateTimeArgs(...args);
     const missingWarn = isBoolean(options.missingWarn)
         ? options.missingWarn
@@ -2792,7 +2833,7 @@ function datetime(context, ...args) {
     const locales = localeFallbacker(context, // eslint-disable-line @typescript-eslint/no-explicit-any
     fallbackLocale, locale);
     if (!isString(key) || key === '') {
-        return new Intl.DateTimeFormat(locale, overrides).format(value);
+        return new Intl.DateTimeFormat(locale.replace(/!/g, ''), overrides).format(value);
     }
     // resolve format
     let datetimeFormat = {};
@@ -2954,6 +2995,14 @@ function number(context, ...args) {
         onWarn(getWarnMessage$1(CoreWarnCodes.CANNOT_FORMAT_NUMBER));
         return MISSING_RESOLVE_VALUE;
     }
+    if (!isNumber(args[0])) {
+        {
+            onWarn(getWarnMessage$1(CoreWarnCodes.INVALID_NUMBER_ARGUMENT, {
+                value: String(args[0])
+            }));
+        }
+        return MISSING_RESOLVE_VALUE;
+    }
     const [key, value, options, overrides] = parseNumberArgs(...args);
     const missingWarn = isBoolean(options.missingWarn)
         ? options.missingWarn
@@ -2966,7 +3015,7 @@ function number(context, ...args) {
     const locales = localeFallbacker(context, // eslint-disable-line @typescript-eslint/no-explicit-any
     fallbackLocale, locale);
     if (!isString(key) || key === '') {
-        return new Intl.NumberFormat(locale, overrides).format(value);
+        return new Intl.NumberFormat(locale.replace(/!/g, ''), overrides).format(value);
     }
     // resolve format
     let numberFormat = {};
@@ -3095,59 +3144,43 @@ const DEFAULT_NORMALIZE = (values) => values.length === 0 ? '' : join(values);
 const DEFAULT_INTERPOLATE = toDisplayString;
 function pluralDefault(choice, choicesLength) {
     choice = Math.abs(choice);
+    // singular (0) | plural (1)
     if (choicesLength === 2) {
         // prettier-ignore
-        return choice
-            ? choice > 1
-                ? 1
-                : 0
+        return choice === 1
+            ? 0
             : 1;
     }
-    return choice ? Math.min(choice, 2) : 0;
+    // zero (0) | singular (1) | plural (2)
+    return Math.min(choice, 2);
 }
 function getPluralIndex(options) {
     // prettier-ignore
     const index = isNumber(options.pluralIndex)
         ? options.pluralIndex
         : -1;
-    // prettier-ignore
-    return options.named && (isNumber(options.named.count) || isNumber(options.named.n))
-        ? isNumber(options.named.count)
-            ? options.named.count
-            : isNumber(options.named.n)
-                ? options.named.n
-                : index
-        : index;
-}
-function normalizeNamed(pluralIndex, props) {
-    if (!props.count) {
-        props.count = pluralIndex;
-    }
-    if (!props.n) {
-        props.n = pluralIndex;
-    }
+    return isNumber(options.named?.count)
+        ? options.named.count
+        : isNumber(options.named?.n)
+            ? options.named.n
+            : index;
 }
 function createMessageContext(options = {}) {
     const locale = options.locale;
     const pluralIndex = getPluralIndex(options);
-    const pluralRule = isObject(options.pluralRules) &&
-        isString(locale) &&
-        isFunction(options.pluralRules[locale])
+    const pluralRule = isString(locale) && isFunction(options.pluralRules?.[locale])
         ? options.pluralRules[locale]
         : pluralDefault;
-    const orgPluralRule = isObject(options.pluralRules) &&
-        isString(locale) &&
-        isFunction(options.pluralRules[locale])
-        ? pluralDefault
-        : undefined;
-    const plural = (messages) => {
-        return messages[pluralRule(pluralIndex, messages.length, orgPluralRule)];
-    };
+    const orgPluralRule = pluralRule === pluralDefault ? undefined : pluralDefault;
+    const plural = (messages) => messages[pluralRule(pluralIndex, messages.length, orgPluralRule)];
     const _list = options.list || [];
     const list = (index) => _list[index];
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const _named = options.named || create();
-    isNumber(options.pluralIndex) && normalizeNamed(pluralIndex, _named);
+    const _named = options.named || create(); // eslint-disable-line @typescript-eslint/no-explicit-any
+    // normalize named
+    if (isNumber(options.pluralIndex)) {
+        _named.count ||= options.pluralIndex;
+        _named.n ||= options.pluralIndex;
+    }
     const named = (key) => _named[key];
     function message(key, useLinked) {
         // prettier-ignore
@@ -3165,14 +3198,13 @@ function createMessageContext(options = {}) {
     const _modifier = (name) => options.modifiers
         ? options.modifiers[name]
         : DEFAULT_MODIFIER;
-    const normalize = isPlainObject(options.processor) && isFunction(options.processor.normalize)
+    const normalize = isFunction(options.processor?.normalize)
         ? options.processor.normalize
         : DEFAULT_NORMALIZE;
-    const interpolate = isPlainObject(options.processor) &&
-        isFunction(options.processor.interpolate)
+    const interpolate = isFunction(options.processor?.interpolate)
         ? options.processor.interpolate
         : DEFAULT_INTERPOLATE;
-    const type = isPlainObject(options.processor) && isString(options.processor.type)
+    const type = isString(options.processor?.type)
         ? options.processor.type
         : DEFAULT_MESSAGE_DATA_TYPE;
     const linked = (key, ...args) => {
@@ -3197,11 +3229,13 @@ function createMessageContext(options = {}) {
             }
         }
         const ret = message(key, true)(ctx);
+        // If the linked message is not resolved (empty string), fall back to the key itself
+        const resolved = ret === '' || ret === undefined ? key : ret;
         const msg = 
         // The message in vnode resolved with linked are returned as an array by processor.nomalize
-        type === 'vnode' && isArray(ret) && modifier
-            ? ret[0]
-            : ret;
+        type === 'vnode' && isArray(resolved) && modifier
+            ? resolved[0]
+            : resolved;
         return modifier ? _modifier(modifier)(msg, type) : msg;
     };
     const ctx = {
@@ -3558,7 +3592,6 @@ function getCompileContext(context, locale, key, source, warnHtmlMessage, onErro
             onError && onError(err);
             {
                 const _source = getSourceForCodeFrame(source);
-                const message = `Message compilation error: ${err.message}`;
                 const codeFrame = err.location &&
                     _source &&
                     generateCodeFrame(_source, err.location.start.offset, err.location.end.offset);
@@ -3572,7 +3605,8 @@ function getCompileContext(context, locale, key, source, warnHtmlMessage, onErro
                         groupId: `${'translate'}:${key}`
                     });
                 }
-                console.error(codeFrame ? `${message}\n${codeFrame}` : message);
+                const message = `Message compilation error: ${err.message}`;
+                throw new SyntaxError(codeFrame ? `${message}\n${codeFrame}` : message);
             }
         },
         onCacheKey: (source) => generateFormatCacheKey(locale, key, source)
@@ -3594,9 +3628,9 @@ function getMessageContextOptions(context, locale, message, options) {
         let val = resolveValue(message, key);
         // fallback
         if (val == null && (fallbackContext || useLinked)) {
-            const [, , message] = resolveMessageFormat(fallbackContext || context, // NOTE: if has fallbackContext, fallback to root, else if use linked, fallback to local context
+            const [format, , message] = resolveMessageFormat(fallbackContext || context, // NOTE: if has fallbackContext, fallback to root, else if use linked, fallback to local context
             key, locale, fallbackLocale, fallbackWarn, missingWarn);
-            val = resolveValue(message, key);
+            val = format ?? resolveValue(message, key);
         }
         if (isString(val) || isMessageAST(val)) {
             let occurred = false;
@@ -3645,7 +3679,7 @@ function getMessageContextOptions(context, locale, message, options) {
  *
  * @VueI18nGeneral
  */
-const VERSION = '11.2.8';
+const VERSION = '11.3.1';
 /**
  * This is only called development env
  * istanbul-ignore-next
@@ -3709,19 +3743,20 @@ const InejctWithOptionSymbol =
 const DisposeSymbol = /* #__PURE__*/ makeSymbol('__dispose');
 
 const I18nWarnCodes = {
-    FALLBACK_TO_ROOT: CORE_WARN_CODES_EXTEND_POINT, // 8
-    NOT_FOUND_PARENT_SCOPE: 9,
-    IGNORE_OBJ_FLATTEN: 10,
+    FALLBACK_TO_ROOT: CORE_WARN_CODES_EXTEND_POINT, // 10
+    NOT_FOUND_PARENT_SCOPE: (CORE_WARN_CODES_EXTEND_POINT + 1),
+    IGNORE_OBJ_FLATTEN: (CORE_WARN_CODES_EXTEND_POINT + 2),
     /**
      * @deprecated will be removed at vue-i18n v12
      */
-    DEPRECATE_LEGACY_MODE: 11,
+    DEPRECATE_LEGACY_MODE: (CORE_WARN_CODES_EXTEND_POINT + 3),
     /**
      * @deprecated will be removed at vue-i18n v12
      */
-    DEPRECATE_TRANSLATE_CUSTOME_DIRECTIVE: 12,
+    DEPRECATE_TRANSLATE_CUSTOME_DIRECTIVE: (CORE_WARN_CODES_EXTEND_POINT +
+        4),
     // duplicate `useI18n` calling
-    DUPLICATE_USE_I18N_CALLING: 13
+    DUPLICATE_USE_I18N_CALLING: (CORE_WARN_CODES_EXTEND_POINT + 5)
 };
 const warnMessages = {
     [I18nWarnCodes.FALLBACK_TO_ROOT]: `Fall back to {type} '{key}' with root locale.`,
@@ -4246,11 +4281,25 @@ function createComposer(options = {}) {
                 return false;
             }
             const targetLocale = isString(locale) ? locale : _locale.value;
-            const message = getLocaleMessage(targetLocale);
-            const resolved = _context.messageResolver(message, key);
-            return (isMessageAST(resolved) ||
-                isMessageFunction(resolved) ||
-                isString(resolved));
+            // When locale is explicitly specified, check only that locale (no fallback chain)
+            // When locale is not specified, check the fallback locale chain
+            const locales = isString(locale)
+                ? [targetLocale]
+                : fallbackWithLocaleChain(_context, _fallbackLocale.value, targetLocale);
+            for (let i = 0; i < locales.length; i++) {
+                const message = getLocaleMessage(locales[i]);
+                let resolved = _context.messageResolver(message, key);
+                // if null, resolve with object key path (for flat keys containing dots)
+                if (resolved === null) {
+                    resolved = message[key];
+                }
+                if (isMessageAST(resolved) ||
+                    isMessageFunction(resolved) ||
+                    isString(resolved)) {
+                    return true;
+                }
+            }
+            return false;
         }, () => [key], 'translate exists', root => {
             return Reflect.apply(root.te, root, [key, locale]);
         }, NOOP_RETURN_FALSE, val => isBoolean(val));
@@ -5723,8 +5772,7 @@ function vTDirective(i18n) {
     };
     const register = (el, binding) => {
         const [textContent, composer] = _process(binding);
-        if (inBrowser && i18n.global === composer) {
-            // global scope only
+        if (inBrowser) {
             el.__i18nWatcher = watch(composer.locale, () => {
                 binding.instance && binding.instance.$forceUpdate();
             });