feat: add transChoice and mixin $tChoice(), as aliases.

Author: xiCO2k

src/index.ts

@@ -63,7 +63,7 @@ export function trans(key: string, replacements: ReplacementsInterface = {}): st
 /**
  * Translates the given message based on a count.
  */
-export function trans_choice(key: string, number: number, replacements: ReplacementsInterface = {}): string {
+export function transChoice(key: string, number: number, replacements: ReplacementsInterface = {}): string {
   const message = trans(key, replacements)
 
   replacements.count = number.toString()
@@ -118,13 +118,20 @@ export const reset = (): void => {
   }
 }
 
+
+/**
+ * Alias to `transChoice` to mimic the same function name from Laravel Framework.
+ */
+export const trans_choice = transChoice;
+
 /**
  * The Vue Plugin. to be used on your Vue app like this: `app.use(i18nVue)`
  */
 export const i18nVue: Plugin = {
   install: (app, currentOptions: OptionsInterface = {}) => {
     options = { ...options, ...currentOptions }
     app.config.globalProperties.$t = (key: string, replacements: ReplacementsInterface) => trans(key, replacements)
+    app.config.globalProperties.$tChoice = (key: string, number: number, replacements: ReplacementsInterface) => transChoice(key, number, replacements)
     loadLanguageAsync(options.lang)
   }
 }

test/fixtures/lang/pt.json

@@ -1,4 +1,5 @@
 {
     "Welcome!": "Bem-vindo!",
-    "Welcome, :name!": "Bem-vindo, :name!"
+    "Welcome, :name!": "Bem-vindo, :name!",
+    "{1} :count minute ago|[2,*] :count minutes ago": "{1} há :count minuto|[2,*] há :count minutos"
 }

test/plurization.test.ts

@@ -1,4 +1,4 @@
-import { trans_choice } from '../src';
+import { trans_choice, transChoice } from '../src';
 
 it.each([
   ['first', 'first', 1],
@@ -41,10 +41,10 @@ it.each([
 
   ['first', '{0}  first | { 1 } second', 0],
   ['first', '[4,*]first | [1,3]second', 100],
-])('translates plurization with "trans_choice" helper', async (expected, message, number) => {
+])('translates plurization with "transChoice" helper', async (expected, message, number) => {
   const wrapper = await global.mountPlugin()
 
-  expect(trans_choice(message, number)).toBe(expected)
+  expect(transChoice(message, number)).toBe(expected)
 })
 
 it.each([
@@ -56,3 +56,18 @@ it.each([
 
   expect(trans_choice(message, number, replacements)).toBe(expected)
 })
+
+it('translates even using the mixin "$tChoice()', async () => {
+  const wrapper = await global.mountPlugin(
+    `<h1>{{ $tChoice('{1} :count minute ago|[2,*] :count minutes ago', 3)}}</h1>`
+  )
+
+  expect(wrapper.html()).toBe('<h1>há 3 minutos</h1>');
+})
+
+it('translates even using an alias "trans_choice"', async () => {
+  await global.mountPlugin()
+
+  expect(trans_choice('{1} :count minute ago|[2,*] :count minutes ago', 3))
+    .toBe('há 3 minutos');
+})