react-i18n-prompt README

This is a extension that allows vscode to prompt a languages tips in tsx,jsx,ts and js file.

Requirements

This extension only support your project export language package like following:

export default {
  key: object | string;
}

if your language package is not export by this type. you should provide a plugin script to tell extension how to get all language key and value.

Features

After you install this extension in your vscode. vscode will prompt the content of the i18n key. like:

vscode will prompt the i18n path when you input a i18n key. like:

your can click the i18n key and jump to language package file.

Extension Settings

react-i18n-prompt.language-package-path: the extension will find language content by this path. the default value is src/locale/zh-cn/**/*.{ts,js,tsx,jsx}
- if you set this item ike src/locale/en/**/*.{ts,js,tsx,jsx}. you can take english language tips.like:
- so, you can modify this item to support any language you want.
react-i18n-prompt.language-package-exclude-path: the extension will exclude this path when extension find language content. default value is src/locale/zh-cn/**/index.{ts,js,tsx,jsx}
react-i18n-prompt.language-key-prefix: the extension will add the prefix path of i18n key. example:
- if your language file is like following:
  
  and the content of common.ts is like:
  
  the extension will find i18n key is
  - ${language-key-prefix}.submit => 提交
  - ${language-key-prefix}.cancel => 取消
  - ${language-key-prefix}.reset => 重复
- this item support variable, current support:
  - ${fileName}: current locale file name.
- the default value of this item is: ${fileName}
  - so, the above example will find following key by default:
    - common.submit => { value: 提交, languageFilePath: /your-project-patch/src/locale/zh-cn/common.ts, line: 2 }
    - common.cancel => { value: 取消, languageFilePath: /your-project-patch/src/locale/zh-cn/common.ts, line: 3 }
    - common.reset => { value: 重复, languageFilePath: /your-project-patch/src/locale/zh-cn/common.ts, line: 4 }
react-i18n-prompt.i18n-name: default value is i18n
react-i18n-prompt.translate-function-name: default value is t
- the above tow config is the extension will add language tips after ${react-i18n-prompt.i18n-name}.${react-i18n-prompt.translate-function-name} and ${react-i18n-prompt.translate-function-name} function params. so the extension will add language tips like following by default:
- i18n.t(params {add tips in here})
- t(params {add tips in here})
react-i18n-prompt.plugin-path: the plugin script path.
- if this item is start with '/', the extension will load plugin script by absolute path.
- if this item is start with other, the extension will load plugin script by relative path which base from current workspace.
react-i18n-prompt.language-tips-visible: default is true, if you set this config to false, and then extension will disable prompt when you input i18n key.
- if your typescript version is bigger than 4.2.0, the i18n-next is support prompt key by native.. so if you like the native prompt. you can set this config to false
react-i18n-prompt.show-not-exist-tips: default is false, if you set this config to true, then extension will add a error message after i18n key which extension not find by any way.

Plugin

the plugin must be a javascript file. and now plugin support following method.

module.exports = {
  fileName: (fileName: string) => string;
  getAllI18nKeyAndValue: () => Map<string, { value: string; line?: number; languageFilePath?: string; }>;
};

fileName
- if you have some prefix of i18n key is not equal fileName: For example:
  - the locale language file name is a.ts, and the file content is:
```
export default {
  test: '测试',
};
```
  - but in the i18n register language package is:
```
import a from './zh-cn/a.ts';
export default {
  translation: {
    b: a,
  },
};
```
  - then i18n will generator b.test => 测试 key. but extension will find a.test => 测试 by default. so, you can provide a plugin like following to fix this question:
```
module.exports = {
  fileName(fileName) {
    if (fileName === 'a') {
      return 'b';
    }
    return fileName;
  },
};
```
  - after this change. the extension will find b.test => 测试 too.
getAllI18nKeyAndValue
- if your project export locale language package is not by following type:
```
export default {
  key: object | string;
}
```
the extension will can't find any key or value of i18n. but you can provide this method to tell extension how to find the key.
- tips:
  - this item must be a function.
  - the function which this item provide must return a Map<string, { value: string; line?: number; languageFilePath?: string; }>.the key of Map is the i18n key. the value object:
    - value: the language content of i18n key.
    - languageFilePath?: the path of file which include current i18n key.
    - line?: current i18n key line number at language file.
    - example:
```
module.exports = {
  getAllI18nKeyAndValue() {
    const map = new Map();
    map.set('common.ok', {
      value: '确认',
      languageFilePath: '/workspace/src/locale/zh-cn/common.ts',
      line: 3,
    });
    return map;
  },
};
```
    this function mean that the tips of 'common.ok' is ‘确认’, and when you click common.ok, you will open '/workspace/src/locale/zh-cn/common.ts' and jump to line 3.
    - if your function not return languageFilePath of line, the link feature of this i18n key will disable.
- if you provide this method, extension will show following tips when extension load plugin successfully.

Release Notes

TODO:

[v] vscode can prompt the language detail value of i18n key.
[v] prompt all related i18n key when user input i18n key.
[v] prompt all related i18n key when user input language value if language value exist in locale language package.
[v] vscode will throw a error when user input a i18n key which not exist locale language package.
[v] i18n key can click and jump to locale language file.

0.0.2

[feature]: you can click i18n key and jump to language package file.
[feature]: add config item to switch prompt of input i18n key.
[feature]: extension will show error message when extension not find appear i18n key.
- this feature is disable by default. because extension not find i18n key is not represent this key is not exist in package, maybe extension has some bug. or plugin script has some bug. so if you really want to use this feature. you should modify react-i18n-prompt.show-not-exist-tips to true.

Breaking change

the getAllI18nKeyAndValue method of plugin if must return a Map<string, string> in version 0.0.1. but now this function must return a Map<string, object>, and the object type is { value: string; line?: number; languageFilePath?: string; }. this change is for support add link for i18n key. if you function is not return field line or languageFilePath. the appear i18n key will can't click...

0.0.1

[feature]: vscode can prompt the language detail value of i18n key.

actiontech/react-i18n-vscode-extension