From 5b18f5a0e57ea3cf59ab910f8eb17a31d556a75d Mon Sep 17 00:00:00 2001
From: wxzhang <wxzhang@126.com>
Date: Thu, 3 Mar 2022 21:56:14 +0800
Subject: [PATCH] init monorepo

---
 .../formatters}/currency.formatters.js        |  0
 .../formatters}/datetime.formatters.js        |  0
 packages/formatters/package.json              | 11 +++++
 packages/runtime/package.json                 | 11 +++++
 packages/scripts/package.json                 | 11 +++++
 pnpm-workspace.yaml                           |  5 +++
 readme.md                                     | 45 +++++++++++++++++++
 7 files changed, 83 insertions(+)
 rename {src => packages/formatters}/currency.formatters.js (100%)
 rename {src => packages/formatters}/datetime.formatters.js (100%)
 create mode 100644 packages/formatters/package.json
 create mode 100644 packages/runtime/package.json
 create mode 100644 packages/scripts/package.json
 create mode 100644 pnpm-workspace.yaml

diff --git a/src/currency.formatters.js b/packages/formatters/currency.formatters.js
similarity index 100%
rename from src/currency.formatters.js
rename to packages/formatters/currency.formatters.js
diff --git a/src/datetime.formatters.js b/packages/formatters/datetime.formatters.js
similarity index 100%
rename from src/datetime.formatters.js
rename to packages/formatters/datetime.formatters.js
diff --git a/packages/formatters/package.json b/packages/formatters/package.json
new file mode 100644
index 0000000..bd81566
--- /dev/null
+++ b/packages/formatters/package.json
@@ -0,0 +1,11 @@
+{
+  "name": "@voerkai18n/formatters",
+  "version": "1.0.0",
+  "description": "",
+  "main": "currency.formatters.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "author": "",
+  "license": "ISC"
+}
diff --git a/packages/runtime/package.json b/packages/runtime/package.json
new file mode 100644
index 0000000..4f3dfb7
--- /dev/null
+++ b/packages/runtime/package.json
@@ -0,0 +1,11 @@
+{
+  "name": "@voerkai18n/runtime",
+  "version": "1.0.0",
+  "description": "",
+  "main": "index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "author": "",
+  "license": "ISC"
+}
diff --git a/packages/scripts/package.json b/packages/scripts/package.json
new file mode 100644
index 0000000..1272a56
--- /dev/null
+++ b/packages/scripts/package.json
@@ -0,0 +1,11 @@
+{
+  "name": "@voerkai18n/scripts",
+  "version": "1.0.0",
+  "description": "",
+  "main": "index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "author": "",
+  "license": "ISC"
+}
diff --git a/pnpm-workspace.yaml b/pnpm-workspace.yaml
new file mode 100644
index 0000000..b873dab
--- /dev/null
+++ b/pnpm-workspace.yaml
@@ -0,0 +1,5 @@
+packages:
+  # all packages in subdirs of packages/ and components/
+  - 'packages/**'
+  # exclude packages that are inside test directories
+  - '!**/test/**'
\ No newline at end of file
diff --git a/readme.md b/readme.md
index a97eb98..741a3e2 100644
--- a/readme.md
+++ b/readme.md
@@ -197,6 +197,51 @@ t("今天是{date}",{date:new Date()})
 
 ```
 
+
+### 异步格式化器
+
+大部分情况下，`formatter`均应该是一个简单的同步函数。VoerkaI18n也支持采用异步`formatter`，也就是说`formatter`函数可以是一个`async`函数。
+但是由于`t`函数是一个普通的同步函数，并且在应用程序中使用翻译时采用异步的意义并不大，比如我们打印到日志。
+
+```javascript
+    console.log(t("用户{ username | friend }没有权限",username))
+```
+上述语句中的friend格式化器如果是异步不可行的，但是在某此情况下，我们又的的确确需要异步的格式化器。
+比如在使用字典时，以下例子中,假设用户职位采用一个字典描述（`0-普通员工`、`1-主管`、`2-经理`、`3-总经理`）。
+常规情况下，应该由应用程序自行读取该字典
+```javascript
+    const post = await getDict(1)
+    console.log(t("您的身份是{ post }",post.name))
+```
+
+```javascript
+    console.log(t("您的身份是{ post | dict }",post))
+```
+
+
+
+用异步`formatter`需要遵循一定的流程约定。
+
+- 首先定义一个异步`formatter`
+
+```javascript
+{
+    cn:{
+        dict:async ()=>{
+            return {
+
+            }
+        }
+    }
+}
+```
+
+```javascript
+
+t(" {value | dict() }",{value:2})
+
+```
+
 ## 合并第三方库语言