breacking: change globalInjection default disable (#204)

kazupon · web-flow · commit 9f379cfb552d · 2020-12-03T12:42:25.000+09:00
diff --git a/docs-old/.vuepress/config.js b/docs-old/.vuepress/config.js
@@ -15,11 +15,9 @@ module.exports = {
       lang: 'ru-RU',
       title: 'Vue I18n',
       description: 'Vue I18n — плагин для интернационализации во Vue.js'
-    },
+    }
   },
-  head: [
-    ['meta', { name: 'theme-color', content: '#3eaf7c' }],
-  ],
+  head: [['meta', { name: 'theme-color', content: '#3eaf7c' }]],
   serviceWorker: false,
   themeConfig: {
     repo: 'kazupon/vue-i18n',
@@ -70,11 +68,13 @@ module.exports = {
                 items: [
                   {
                     text: 'BabelEdit',
-                    link: 'https://www.codeandweb.com/babeledit?utm_campaign=vue-i18n-2019-01'
+                    link:
+                      'https://www.codeandweb.com/babeledit?utm_campaign=vue-i18n-2019-01'
                   },
                   {
                     text: 'i18n Ally',
-                    link: 'https://marketplace.visualstudio.com/items?itemName=antfu.i18n-ally'
+                    link:
+                      'https://marketplace.visualstudio.com/items?itemName=antfu.i18n-ally'
                   }
                 ]
               }
@@ -116,10 +116,7 @@ module.exports = {
           {
             title: 'Legacy',
             collapsable: false,
-            children: [
-              '/legacy/',
-              '/legacy/v5'
-            ]
+            children: ['/legacy/', '/legacy/v5']
           }
         ]
       },
@@ -131,7 +128,7 @@ module.exports = {
         nav: [
           {
             text: '指南',
-            link: '/zh/guide/formatting',
+            link: '/zh/guide/formatting'
           },
           {
             text: 'API',
@@ -166,7 +163,8 @@ module.exports = {
                 items: [
                   {
                     text: 'BabelEdit',
-                    link: 'https://www.codeandweb.com/babeledit?utm_campaign=vue-i18n-2019-01'
+                    link:
+                      'https://www.codeandweb.com/babeledit?utm_campaign=vue-i18n-2019-01'
                   }
                 ]
               }
@@ -208,10 +206,7 @@ module.exports = {
           {
             title: 'Legacy',
             collapsable: false,
-            children: [
-              '/zh/legacy/',
-              '/zh/legacy/v5'
-            ]
+            children: ['/zh/legacy/', '/zh/legacy/v5']
           }
         ]
       },
@@ -223,7 +218,7 @@ module.exports = {
         nav: [
           {
             text: 'Руководство',
-            link: '/ru/guide/formatting',
+            link: '/ru/guide/formatting'
           },
           {
             text: 'Справочник API',
@@ -258,11 +253,13 @@ module.exports = {
                 items: [
                   {
                     text: 'BabelEdit',
-                    link: 'https://www.codeandweb.com/babeledit?utm_campaign=vue-i18n-2019-01'
+                    link:
+                      'https://www.codeandweb.com/babeledit?utm_campaign=vue-i18n-2019-01'
                   },
                   {
                     text: 'i18n Ally',
-                    link: 'https://marketplace.visualstudio.com/items?itemName=antfu.i18n-ally'
+                    link:
+                      'https://marketplace.visualstudio.com/items?itemName=antfu.i18n-ally'
                   }
                 ]
               }
@@ -304,14 +301,10 @@ module.exports = {
           {
             title: 'Устаревшие версии',
             collapsable: false,
-            children: [
-              '/ru/legacy/',
-              '/ru/legacy/v5'
-            ]
+            children: ['/ru/legacy/', '/ru/legacy/v5']
           }
         ]
-      },
+      }
     }
   }
 }
-
diff --git a/docs/advanced/composition.md b/docs/advanced/composition.md
@@ -179,9 +179,9 @@ In the Composition API mode, plural translations have been integrated into `t`.
 
 ## Datetime Formatting
 
-In the Legacy API mode, Datetime value was localized using `$d` or the VueI18n instance of `d`.
+In the Legacy API mode, Datetime value was formatted using `$d` or the VueI18n instance of `d`.
 
-In the Compostion API mode, it uses the `d` of the Composer instance to localize:
+In the Compostion API mode, it uses the `d` of the Composer instance to format:
 
 ```html
 <template>
@@ -227,9 +227,9 @@ For more details of `d`, see the [API Reference](../api/composition#d-value).
 
 ## Number Formatting
 
-In the Legacy API mode, Number value is localized using `$n` or the `n` of the VueI18n instance.
+In the Legacy API mode, Number value is formatted using `$n` or the `n` of the VueI18n instance.
 
-In the Compostion API mode, it is localized using the `n` of the Composer instance:
+In the Compostion API mode, it is formatted using the `n` of the Composer instance:
 
 ```html
 <template>
@@ -303,7 +303,9 @@ Then you can compose using the functions and properties exposed from the Compose
 
 Another way to refer a global scope Composer instance is through properties and functions implicitly injected into the component.
 
-If you use Compostion API mode with the `legacy: false` option for `createI18n`, Vue I18n defaults to the following properties and functions, which injected to the component via `app.config.globalProperties`:
+You need to specify **`globalInjection: true`** together with `legacy: false` as an option for `createI18n`, because disabled by default.
+
+This allows Vue I18n to inject the following properties and functions into the components:
 
 - `$i18n`: An object wrapped with the following global scope Composer instance properties
   - `locale`
@@ -328,8 +330,11 @@ You’ve noticed that the ones listed above are prifixed with `$`. The reason fo
 
 By doing so, the user is made aware that they are special properties and functions.
 
-With the previously explained explicit way, you had to run `useI18n` in `setup` every time. **If your Vue application doesn’t use local scope and does everything i18n in global scope**, it is very convenient because you don’t have to run `useI18n` in the `setup` every time.
+:::warning NOTICE
+If your Vue application doesn’t use local scope and does everything i18n in global scope, this is very useful as it does not need to run `useI18n` in the `setup` for each component. However, this way has the problem with global variables of the same nature. You should be used with caution, especially for large Vue applications.
 
+If you use it once and stop using it, you must change all the properties or functions used in the templates to those of the setup context returned with the `setup` using the `useI18n` with `useScope: 'global'` option.
+:::
 
 ## Local scope
 
@@ -423,16 +428,7 @@ In this example, the definition of resources is separated from i18n custom block
 
 ### Global Scope
 
-Changing the locale in the global scope, i.e., Composer instance  `locale` property  referenced by i18n instance `global` property,  you can change with `$i18n.locale`.
-
-```html
-<select v-model="$i18n.locale">
-  <option value="en">en</option>
-  <option value="ja">ja</option>
-</select>
-```
-
-If you want to change the locale with `setup`, just get a global Composer with `useI18n` and change it using the `locale` property of the instance.
+You want to change the locale with `setup`, just get a global Composer with `useI18n` and change it using the `locale` property of the instance.
 
 ```js
 setup() {
@@ -444,11 +440,29 @@ setup() {
 }
 ```
 
+And you can also use the setup context in the template, which can be changed as follows:
+
+```html
+<select v-model="locale">
+  <option value="en">en</option>
+  <option value="ja">ja</option>
+</select>
+```
+
 When you change the locale of the global scope, components that depend on the global scope, such as `t` translation API can work reactive and switch the display messages to those of the target locale.
 
+If you are using the [implicit way](composition#implicit-with-injected-properties-and-functions), you can also change it in template with `$i18n.locale`, as follows:
+
+```html
+<select v-model="$i18n.locale">
+  <option value="en">en</option>
+  <option value="ja">ja</option>
+</select>
+```
+
 ### Local Scope
 
-The local scope locales, that is, the  Composer instance `locale` property returned by `useI18n`, are inherited from the global scope, as is the Legacy API. Therefore, when you change the locale at global scope, the inherited local scope locale is also changed. If you want to switch the locale for the whole application, you need to do so via `$i18n.locale`.
+The local scope locales, that is, the  Composer instance `locale` property returned by `useI18n`, are inherited from the global scope, as is the Legacy API. Therefore, when you change the locale at global scope, the inherited local scope locale is also changed. If you want to switch the locale for the whole application, you can use the `locale` returned by `useI18n({ useScope: 'global' })` or, if you use [implicit way](composition#implicit-with-injected-properties-and-functions), you can use `$i18n.locale`.
 
 :::tip NOTE
 If you do not want to inherit the locale from the global scope, the `inheritLocale` option of `useI18n` must be `false`.
diff --git a/docs/api/injection.md b/docs/api/injection.md
@@ -776,10 +776,10 @@ $d(value: number | Date): DateTimeFormatResult;
 
 If this is used in a reactive context, it will re-evaluate once the locale changes.
 
-In [Compostion API mode](general#i18nmode), the `$d` is injected by `app.config.globalProperties`. The input / output is the same as for Composer instance, and it work on **global scope**. About that details, see [Composer#d](composition#d-value).
-
 In [Compostion API mode](general#i18nmode), the input / output is the same as for VueI18n instance. About details, see [VueI18n#d](legacy#d-value).
 
+In [Compostion API mode](general#i18nmode), the `$d` is injected by `app.config.globalProperties`. The input / output is the same as for Composer instance, and it work on **global scope**. About that details, see [Composer#d](composition#d-value).
+
 **See Also**
 - [Datetime Formatting](../essentials/datetime)
 - [Scope and Locale Changing](../essentials/scope)
@@ -969,10 +969,10 @@ $n(value: number): NumberFormatResult;
 
 If this is used in a reactive context, it will re-evaluate once the locale changes.
 
-In [Compostion API mode](general#i18nmode), the `$n` is injected by `app.config.globalProperties`. The input / output is the same as for Composer instance, and it work on **global scope**. About that details, see [Composer#n](composition#n-value).
-
 In [Legacy API mode](general#i18nmode), the input / output is the same as for VueI18n instance. About details, see [VueI18n#n](legacy#n-value).
 
+In [Compostion API mode](general#i18nmode), the `$n` is injected by `app.config.globalProperties`. The input / output is the same as for Composer instance, and it work on **global scope**. About that details, see [Composer#n](composition#n-value).
+
 **See Also**
 - [Number Formatting](../essentials/number)
 - [Scope and Locale Changing](../essentials/scope)
diff --git a/examples/composition/formatting/linked.html b/examples/composition/formatting/linked.html
@@ -9,8 +9,8 @@
   <body>
     <div id="app">
       <form>
-        <label>{{ $t('message.language') }}</label>
-        <select v-model="$i18n.locale">
+        <label>{{ t('message.language') }}</label>
+        <select v-model="locale">
           <option value="en">en</option>
           <option value="ja">ja</option>
         </select>
@@ -64,12 +64,12 @@
 
       const app = createApp({
         setup() {
-          const { t } = useI18n()
+          const { t, locale } = useI18n()
 
           // Something to do ...
           //
 
-          return { t }
+          return { t, locale }
         }
       })
       app.use(i18n)
diff --git a/examples/composition/scope/global.html b/examples/composition/scope/global.html
@@ -76,6 +76,7 @@ <h1>Child</h1>
 
       const i18n = createI18n({
         legacy: false,
+        globalInjection: true,
         locale: 'ja',
         messages: {
           en: {
diff --git a/src/i18n.ts b/src/i18n.ts
@@ -84,12 +84,12 @@ export interface I18nAdditionalOptions {
    * Whether Whether to inject global properties & functions into for each component.
    *
    * @remarks
-   * If set to `false`, then properties and methods prefixed with `$` are injected into Vue Component.
+   * If set to `true`, then properties and methods prefixed with `$` are injected into Vue Component.
    *
    * @VueI18nSee [Implicit with injected properties and functions](../advanced/composition#implicit-with-injected-properties-and-functions)
    * @VueI18nSee [ComponentCustomProperties](injection#componentcustomproperties)
    *
-   * @defaultValue `true`
+   * @defaultValue `false`
    */
   globalInjection?: boolean
 }
@@ -315,7 +315,7 @@ export function createI18n<
   const __legacyMode = __FEATURE_LEGACY_API__ && isBoolean(options.legacy)
     ? options.legacy
     : true
-  const __globalInjection = !options.globalInjection
+  const __globalInjection = !!options.globalInjection
   const __instances = new Map<
     ComponentInternalInstance,
     VueI18n<Messages> | Composer<Messages>
diff --git a/src/vue.d.ts b/src/vue.d.ts
@@ -55,11 +55,11 @@ declare module '@vue/runtime-core' {
      * @remarks
      * If this is used in a reactive context, it will re-evaluate once the locale changes.
      *
+     * In {@link I18nMode | Legacy API mode}, the input / output is the same as for VueI18n instance. About that details, see {@link VueI18n#t | `VueI18n#t`}.
+     *
      * In {@link I18nMode | Compostion API mode}, the `$t` is injected by `app.config.globalProperties`.
      * the input / output is the same as for Composer, and it work on **global scope**. About that details, see {@link Composer#t | `Composer#t` }.
      *
-     * In {@link I18nMode | Legacy API mode}, the input / output is the same as for VueI18n instance. About that details, see {@link VueI18n#t | `VueI18n#t`}.
-     *
      * @param key - A target locale message key
      *
      * @returns translation message
@@ -427,11 +427,11 @@ declare module '@vue/runtime-core' {
      * @remarks
      * If this is used in a reactive context, it will re-evaluate once the locale changes.
      *
+     * In {@link I18nMode | Legacy API mode}, the input / output is the same as for VueI18n instance. About that details, see {@link VueI18n#d | `VueI18n#d` }.
+     *
      * In {@link I18nMode | Compostion API mode}, the `$d` is injected by `app.config.globalProperties`.
      * the input / output is the same as for Composer instance, and it work on **global scope**. About that details, see {@link Composer#d | `Composer#d` }.
      *
-     * In {@link I18nMode | Legacy API mode}, the input / output is the same as for VueI18n instance. About that details, see {@link VueI18n#d | `VueI18n#d` }.
-     *
      * @param value - A value, timestamp number or `Date` instance
      *
      * @returns formatted value
@@ -531,11 +531,11 @@ declare module '@vue/runtime-core' {
      * @remarks
      * If this is used in a reactive context, it will re-evaluate once the locale changes.
      *
+     * In {@link I18nMode | Legacy API mode}, the input / output is the same as for VueI18n instance. About that details, see {@link VueI18n#n | `VueI18n.n` }.
+     *
      * In {@link I18nMode | Compostion API mode}, the `$n` is injected by `app.config.globalProperties`.
      * the input / output is the same as for Composer instance,  and it work on **global scope**. About that details, see {@link Composer#n | `Composer.n` }.
      *
-     * In {@link I18nMode | Legacy API mode}, the input / output is the same as for VueI18n instance. About that details, see {@link VueI18n#n | `VueI18n.n` }.
-     *
      * @param value - A number value
      *
      * @returns formatted value
@@ -629,12 +629,12 @@ declare module '@vue/runtime-core' {
     /**
      * Locale messages getter
      *
+     * In {@link I18nMode | Legacy API mode}, the input / output is the same as for VueI18n instance. About that details, see {@link VueI18n#tm | `VueI18n#tm` }.
+     *
      * @remarks
      * In {@link I18nMode | Compostion API mode}, the `$tm` is injected by `app.config.globalProperties`.
      * the input / output is the same as for Composer instance, and it work on **global scope**. About that details, see {@link Composer#tm | `Composer.tm` }.
      *
-     * In {@link I18nMode | Legacy API mode}, the input / output is the same as for VueI18n instance. About that details, see {@link VueI18n#tm | `VueI18n#tm` }.
-     *
      * @param key - A target locale message key
      *
      * @return locale messages

Original file line number	Diff line number	Diff line change
`@@ -15,11 +15,9 @@ module.exports = {`
`15`	`15`	`lang: 'ru-RU',`
`16`	`16`	`title: 'Vue I18n',`
`17`	`17`	`description: 'Vue I18n — плагин для интернационализации во Vue.js'`
`18`		`- },`
	`18`	`+ }`
`19`	`19`	`},`
`20`		`- head: [`
`21`		`- ['meta', { name: 'theme-color', content: '#3eaf7c' }],`
`22`		`- ],`
	`20`	`+ head: [['meta', { name: 'theme-color', content: '#3eaf7c' }]],`
`23`	`21`	`serviceWorker: false,`
`24`	`22`	`themeConfig: {`
`25`	`23`	`repo: 'kazupon/vue-i18n',`
`@@ -70,11 +68,13 @@ module.exports = {`
`70`	`68`	`items: [`
`71`	`69`	`{`
`72`	`70`	`text: 'BabelEdit',`
`73`		`- link: 'https://www.codeandweb.com/babeledit?utm_campaign=vue-i18n-2019-01'`
	`71`	`+ link:`
	`72`	`+ 'https://www.codeandweb.com/babeledit?utm_campaign=vue-i18n-2019-01'`
`74`	`73`	`},`
`75`	`74`	`{`
`76`	`75`	`text: 'i18n Ally',`
`77`		`- link: 'https://marketplace.visualstudio.com/items?itemName=antfu.i18n-ally'`
	`76`	`+ link:`
	`77`	`+ 'https://marketplace.visualstudio.com/items?itemName=antfu.i18n-ally'`
`78`	`78`	`}`
`79`	`79`	`]`
`80`	`80`	`}`
`@@ -116,10 +116,7 @@ module.exports = {`
`116`	`116`	`{`
`117`	`117`	`title: 'Legacy',`
`118`	`118`	`collapsable: false,`
`119`		`- children: [`
`120`		`- '/legacy/',`
`121`		`- '/legacy/v5'`
`122`		`- ]`
	`119`	`+ children: ['/legacy/', '/legacy/v5']`
`123`	`120`	`}`
`124`	`121`	`]`
`125`	`122`	`},`
`@@ -131,7 +128,7 @@ module.exports = {`
`131`	`128`	`nav: [`
`132`	`129`	`{`
`133`	`130`	`text: '指南',`
`134`		`- link: '/zh/guide/formatting',`
	`131`	`+ link: '/zh/guide/formatting'`
`135`	`132`	`},`
`136`	`133`	`{`
`137`	`134`	`text: 'API',`
`@@ -166,7 +163,8 @@ module.exports = {`
`166`	`163`	`items: [`
`167`	`164`	`{`
`168`	`165`	`text: 'BabelEdit',`
`169`		`- link: 'https://www.codeandweb.com/babeledit?utm_campaign=vue-i18n-2019-01'`
	`166`	`+ link:`
	`167`	`+ 'https://www.codeandweb.com/babeledit?utm_campaign=vue-i18n-2019-01'`
`170`	`168`	`}`
`171`	`169`	`]`
`172`	`170`	`}`
`@@ -208,10 +206,7 @@ module.exports = {`
`208`	`206`	`{`
`209`	`207`	`title: 'Legacy',`
`210`	`208`	`collapsable: false,`
`211`		`- children: [`
`212`		`- '/zh/legacy/',`
`213`		`- '/zh/legacy/v5'`
`214`		`- ]`
	`209`	`+ children: ['/zh/legacy/', '/zh/legacy/v5']`
`215`	`210`	`}`
`216`	`211`	`]`
`217`	`212`	`},`
`@@ -223,7 +218,7 @@ module.exports = {`
`223`	`218`	`nav: [`
`224`	`219`	`{`
`225`	`220`	`text: 'Руководство',`
`226`		`- link: '/ru/guide/formatting',`
	`221`	`+ link: '/ru/guide/formatting'`
`227`	`222`	`},`
`228`	`223`	`{`
`229`	`224`	`text: 'Справочник API',`
`@@ -258,11 +253,13 @@ module.exports = {`
`258`	`253`	`items: [`
`259`	`254`	`{`
`260`	`255`	`text: 'BabelEdit',`
`261`		`- link: 'https://www.codeandweb.com/babeledit?utm_campaign=vue-i18n-2019-01'`
	`256`	`+ link:`
	`257`	`+ 'https://www.codeandweb.com/babeledit?utm_campaign=vue-i18n-2019-01'`
`262`	`258`	`},`
`263`	`259`	`{`
`264`	`260`	`text: 'i18n Ally',`
`265`		`- link: 'https://marketplace.visualstudio.com/items?itemName=antfu.i18n-ally'`
	`261`	`+ link:`
	`262`	`+ 'https://marketplace.visualstudio.com/items?itemName=antfu.i18n-ally'`
`266`	`263`	`}`
`267`	`264`	`]`
`268`	`265`	`}`
`@@ -304,14 +301,10 @@ module.exports = {`
`304`	`301`	`{`
`305`	`302`	`title: 'Устаревшие версии',`
`306`	`303`	`collapsable: false,`
`307`		`- children: [`
`308`		`- '/ru/legacy/',`
`309`		`- '/ru/legacy/v5'`
`310`		`- ]`
	`304`	`+ children: ['/ru/legacy/', '/ru/legacy/v5']`
`311`	`305`	`}`
`312`	`306`	`]`
`313`		`- },`
	`307`	`+ }`
`314`	`308`	`}`
`315`	`309`	`}`
`316`	`310`	`}`
`317`		`-`
Original file line number	Diff line number	Diff line change
`@@ -84,12 +84,12 @@ export interface I18nAdditionalOptions {`
`84`	`84`	`* Whether Whether to inject global properties & functions into for each component.`
`85`	`85`	`*`
`86`	`86`	`* @remarks`
`87`		- * If set to `false`, then properties and methods prefixed with `$` are injected into Vue Component.
	`87`	+ * If set to `true`, then properties and methods prefixed with `$` are injected into Vue Component.
`88`	`88`	`*`
`89`	`89`	`* @VueI18nSee [Implicit with injected properties and functions](../advanced/composition#implicit-with-injected-properties-and-functions)`
`90`	`90`	`* @VueI18nSee [ComponentCustomProperties](injection#componentcustomproperties)`
`91`	`91`	`*`
`92`		- * @defaultValue `true`
	`92`	+ * @defaultValue `false`
`93`	`93`	`*/`
`94`	`94`	`globalInjection?: boolean`
`95`	`95`	`}`
`@@ -315,7 +315,7 @@ export function createI18n<`
`315`	`315`	`const __legacyMode = __FEATURE_LEGACY_API__ && isBoolean(options.legacy)`
`316`	`316`	`? options.legacy`
`317`	`317`	`: true`
`318`		`- const __globalInjection = !options.globalInjection`
	`318`	`+ const __globalInjection = !!options.globalInjection`
`319`	`319`	`const __instances = new Map<`
`320`	`320`	`ComponentInternalInstance,`
`321`	`321`	`VueI18n<Messages> \| Composer<Messages>`
Original file line number	Diff line number	Diff line change
`@@ -55,11 +55,11 @@ declare module '@vue/runtime-core' {`
`55`	`55`	`* @remarks`
`56`	`56`	`* If this is used in a reactive context, it will re-evaluate once the locale changes.`
`57`	`57`	`*`
	`58`	+ * In {@link I18nMode \| Legacy API mode}, the input / output is the same as for VueI18n instance. About that details, see {@link VueI18n#t \| `VueI18n#t`}.
	`59`	`+ *`
`58`	`60`	* In {@link I18nMode \| Compostion API mode}, the `$t` is injected by `app.config.globalProperties`.
`59`	`61`	* the input / output is the same as for Composer, and it work on global scope. About that details, see {@link Composer#t \| `Composer#t` }.
`60`	`62`	`*`
`61`		- * In {@link I18nMode \| Legacy API mode}, the input / output is the same as for VueI18n instance. About that details, see {@link VueI18n#t \| `VueI18n#t`}.
`62`		`- *`
`63`	`63`	`* @param key - A target locale message key`
`64`	`64`	`*`
`65`	`65`	`* @returns translation message`
`@@ -427,11 +427,11 @@ declare module '@vue/runtime-core' {`
`427`	`427`	`* @remarks`
`428`	`428`	`* If this is used in a reactive context, it will re-evaluate once the locale changes.`
`429`	`429`	`*`
	`430`	+ * In {@link I18nMode \| Legacy API mode}, the input / output is the same as for VueI18n instance. About that details, see {@link VueI18n#d \| `VueI18n#d` }.
	`431`	`+ *`
`430`	`432`	* In {@link I18nMode \| Compostion API mode}, the `$d` is injected by `app.config.globalProperties`.
`431`	`433`	* the input / output is the same as for Composer instance, and it work on global scope. About that details, see {@link Composer#d \| `Composer#d` }.
`432`	`434`	`*`
`433`		- * In {@link I18nMode \| Legacy API mode}, the input / output is the same as for VueI18n instance. About that details, see {@link VueI18n#d \| `VueI18n#d` }.
`434`		`- *`
`435`	`435`	* @param value - A value, timestamp number or `Date` instance
`436`	`436`	`*`
`437`	`437`	`* @returns formatted value`
`@@ -531,11 +531,11 @@ declare module '@vue/runtime-core' {`
`531`	`531`	`* @remarks`
`532`	`532`	`* If this is used in a reactive context, it will re-evaluate once the locale changes.`
`533`	`533`	`*`
	`534`	+ * In {@link I18nMode \| Legacy API mode}, the input / output is the same as for VueI18n instance. About that details, see {@link VueI18n#n \| `VueI18n.n` }.
	`535`	`+ *`
`534`	`536`	* In {@link I18nMode \| Compostion API mode}, the `$n` is injected by `app.config.globalProperties`.
`535`	`537`	* the input / output is the same as for Composer instance, and it work on global scope. About that details, see {@link Composer#n \| `Composer.n` }.
`536`	`538`	`*`
`537`		- * In {@link I18nMode \| Legacy API mode}, the input / output is the same as for VueI18n instance. About that details, see {@link VueI18n#n \| `VueI18n.n` }.
`538`		`- *`
`539`	`539`	`* @param value - A number value`
`540`	`540`	`*`
`541`	`541`	`* @returns formatted value`
`@@ -629,12 +629,12 @@ declare module '@vue/runtime-core' {`
`629`	`629`	`/**`
`630`	`630`	`* Locale messages getter`
`631`	`631`	`*`
	`632`	+ * In {@link I18nMode \| Legacy API mode}, the input / output is the same as for VueI18n instance. About that details, see {@link VueI18n#tm \| `VueI18n#tm` }.
	`633`	`+ *`
`632`	`634`	`* @remarks`
`633`	`635`	* In {@link I18nMode \| Compostion API mode}, the `$tm` is injected by `app.config.globalProperties`.
`634`	`636`	* the input / output is the same as for Composer instance, and it work on global scope. About that details, see {@link Composer#tm \| `Composer.tm` }.
`635`	`637`	`*`
`636`		- * In {@link I18nMode \| Legacy API mode}, the input / output is the same as for VueI18n instance. About that details, see {@link VueI18n#tm \| `VueI18n#tm` }.
`637`		`- *`
`638`	`638`	`* @param key - A target locale message key`
`639`	`639`	`*`
`640`	`640`	`* @return locale messages`