update docs

Author: kazupon

docs/installation.md

@@ -83,22 +83,38 @@ In the [dist/ directory of the npm package](https://cdn.jsdelivr.net/npm/vue-i18
 
 ### From CDN or without a Bundler
 
-- **`vue-i18n.global(.prod).js`**:
+- **`vue-i18n(.runtime).global(.prod).js`**:
   - For direct use via `<script src="...">` in the browser. Exposes the `VueI18n` global
-  - Note that global builds are not [UMD](https://github.com/umdjs/umd) builds.  They are built as [IIFEs](https://developer.mozilla.org/en-US/docs/Glossary/IIFE) and are only meant for direct use via `<script src="...">`
+  - In-browser message format compilation:
+    - `vue-i18n.global.js` is the "full" build that includes both the compiler and the runtime so it supports compiling message formats on the fly
+    - `vue-i18n.runtime.global.js` contains only the runtime and requires message formats to be pre-compiled during a build step
+  - Inlines all Vue I18n core internal packages - i.e. it’s a single file with no dependencies on other files. This means you **must** import everything from this file and this file only to ensure you are getting the same instance of code
   - Contains hard-coded prod/dev branches, and the prod build is pre-minified. Use the `*.prod.js` files for production
 
 :::tip NOTE
 Global builds are not [UMD](https://github.com/umdjs/umd) builds. They are built as [IIFEs](https://developer.mozilla.org/en-US/docs/Glossary/IIFE) and are only meant for direct use via `<script src="...">`.
 :::
 
-- **`vue-i18n.esm-browser(.prod).js`**:
+- **`vue-i18n(.runtime).esm-browser(.prod).js`**:
   - For usage via native ES modules imports (in browser via `<script type="module">`)
   - Shares the same runtime compilation, dependency inlining and hard-coded prod/dev behavior with the global build
 
 ### With a Bundler
 
-- **`vue-i18n.esm-bundler.js`**:
+- **`vue-i18n(.runtime).esm-bundler.js`**:
   - For use with bundlers like `webpack`, `rollup` and `parcel`
   - Leaves prod/dev branches with `process.env.NODE_ENV` guards (must be replaced by bundler)
   - Does not ship minified builds (to be done together with the rest of the code after bundling)
+  - Imports dependencies (e.g. `@intlify/core`, `@intlify/message-compiler`)
+    - Imported dependencies are also `esm-bundler` builds and will in turn import their dependencies (e.g. `@intlify/message-compiler` imports `@intlify/shared`)
+    - This means you **can** install/import these deps individually without ending up with different instances of these dependencies, but you must make sure they all resolve to the same version
+  - In-browser locale messages compilation:
+    - **`vue-i18n.runtime.esm-bundler.js` (default)** is runtime only, and requires all locale messages to be pre-compiled. This is the default entry for bundlers (via `module` field in `package.json`) because when using a bundler templates are typically pre-compiled (e.g. in `*.json` files)
+    - **`vue-i18n.esm-bundler.js`**: includes the runtime compiler. Use this if you are using a bundler but still want locale messages compilation (e.g. templates via inline JavaScript strings)
+
+### For Node.js (Server-Side)
+
+- **`vue-i18n.cjs(.prod).js`**:
+  - For use in Node.js via `require()`
+  - If you bundle your app with webpack with `target: 'node'` and properly externalize `vue-i18n`, this is the build that will be loaded
+  - The dev/prod files are pre-built, but the appropriate file is automatically required based on `process.env.NODE_ENV`

packages/core-base/package.json

@@ -23,7 +23,10 @@
   "bugs": {
     "url": "https://github.com/intlify/vue-i18n-next/issues"
   },
-  "files": ["index.js", "dist"],
+  "files": [
+    "index.js",
+    "dist"
+  ],
   "main": "index.js",
   "module": "dist/core-base.esm-bundler.js",
   "unpkg": "dist/core-base.global.js",
@@ -40,7 +43,12 @@
   },
   "buildOptions": {
     "name": "IntlifyCoreBase",
-    "formats": ["esm-bundler", "esm-browser", "cjs", "global"]
+    "formats": [
+      "esm-bundler",
+      "esm-browser",
+      "cjs",
+      "global"
+    ]
   },
   "sideEffects": false
 }

packages/core/package.json

@@ -23,7 +23,10 @@
   "bugs": {
     "url": "https://github.com/intlify/vue-i18n-next/issues"
   },
-  "files": ["index.js", "dist"],
+  "files": [
+    "index.js",
+    "dist"
+  ],
   "main": "index.js",
   "module": "dist/core.runtime.esm-bundler.js",
   "unpkg": "dist/core.global.js",

packages/message-compiler/package.json

@@ -23,7 +23,10 @@
   "bugs": {
     "url": "https://github.com/intlify/vue-i18n-next/issues"
   },
-  "files": ["index.js", "dist"],
+  "files": [
+    "index.js",
+    "dist"
+  ],
   "main": "index.js",
   "module": "dist/message-compiler.esm-bundler.js",
   "unpkg": "dist/message-compiler.global.js",
@@ -39,7 +42,12 @@
   },
   "buildOptions": {
     "name": "IntlifyMessageCompiler",
-    "formats": ["esm-bundler", "esm-browser", "cjs", "global"]
+    "formats": [
+      "esm-bundler",
+      "esm-browser",
+      "cjs",
+      "global"
+    ]
   },
   "sideEffects": false
 }

packages/runtime/package.json

@@ -2,7 +2,12 @@
   "name": "@intlify/runtime",
   "version": "9.0.0-beta.15",
   "description": "@intlify/runtime",
-  "keywords": ["i18n", "internationalization", "intlify", "runtime"],
+  "keywords": [
+    "i18n",
+    "internationalization",
+    "intlify",
+    "runtime"
+  ],
   "license": "MIT",
   "author": {
     "name": "kazuya kawaguchi",
@@ -17,7 +22,10 @@
   "bugs": {
     "url": "https://github.com/intlify/vue-i18n-next/issues"
   },
-  "files": ["index.js", "dist"],
+  "files": [
+    "index.js",
+    "dist"
+  ],
   "main": "index.js",
   "module": "dist/runtime.esm-bundler.js",
   "types": "dist/runtime.d.ts",
@@ -31,7 +39,10 @@
   },
   "buildOptions": {
     "name": "IntlifyRuntime",
-    "formats": ["esm-bundler", "cjs"]
+    "formats": [
+      "esm-bundler",
+      "cjs"
+    ]
   },
   "sideEffects": false
 }

packages/vue-i18n/README.md

@@ -36,7 +36,14 @@ Internationalization plugin for Vue.js
     - **`vue-i18n.runtime.esm-bundler.js` (default)** is runtime only, and requires all locale messages to be pre-compiled. This is the default entry for bundlers (via `module` field in `package.json`) because when using a bundler templates are typically pre-compiled (e.g. in `*.json` files)
     - **`vue-i18n.esm-bundler.js`**: includes the runtime compiler. Use this if you are using a bundler but still want locale messages compilation (e.g. templates via inline JavaScript strings)
 
-#### Bundler Build Feature Flags
+### For Node.js (Server-Side)
+
+- **`vue-i18n.cjs(.prod).js`**:
+  - For use in Node.js via `require()`
+  - If you bundle your app with webpack with `target: 'node'` and properly externalize `vue-i18n`, this is the build that will be loaded
+  - The dev/prod files are pre-built, but the appropriate file is automatically required based on `process.env.NODE_ENV`
+
+## Bundler Build Feature Flags
 
 The `esm-bundler` builds now exposes global feature flags that can be overwritten at compile time:
 
@@ -52,13 +59,6 @@ The build will work without configuring these flags, however it is **strongly re
 
 Note: the replacement value **must be boolean literals** and cannot be strings, otherwise the bundler/minifier will not be able to properly evaluate the conditions.
 
-### For Node.js (Server-Side)
-
-- **`vue-i18n.cjs(.prod).js`**:
-  - For use in Node.js via `require()`
-  - If you bundle your app with webpack with `target: 'node'` and properly externalize `vue-i18n`, this is the build that will be loaded
-  - The dev/prod files are pre-built, but the appropriate file is automatically required based on `process.env.NODE_ENV`
-
 ## :copyright: License
 
 [MIT](http://opensource.org/licenses/MIT)

packages/vue-i18n/package.json

@@ -24,7 +24,10 @@
   "bugs": {
     "url": "https://github.com/intlify/vue-i18n-next/issues"
   },
-  "files": ["index.js", "dist"],
+  "files": [
+    "index.js",
+    "dist"
+  ],
   "main": "index.js",
   "module": "dist/vue-i18n.runtime.esm-bundler.js",
   "unpkg": "dist/vue-i18n.global.js",