@intlify/unplugin-vue-i18n 5.0.0-beta.3 → 5.0.0-beta.4

package/README.md

@@ -583,6 +583,53 @@ If do you will use this option, you need to enable `jitCompilation` option.
   > [!WARNING]
   About for manually signature, see the details [vue-i18n-extensions API docs](https://github.com/intlify/vue-i18n-extensions/blob/next/docs/%40intlify/vue-i18n-extensions-api.md#translationsignatures) and [usecase from vue-i18n-extensions PR](https://github.com/intlify/vue-i18n-extensions/pull/217/files#diff-3fb9543f91e011d4b0dc9beff44082fe1a99c9eab70c1afab23c3c34352b7c38R121-R200)
 
+### `transformI18nBlock`
+
+- **Type**: `function`
+- **Default:** `undefined`
+
+  This hook allows a user to modify the `<i18n>` block before the plugin generates the translations. The hook is passed the source of the `<ii8n>` block as a `string` after the SFC is read from disk.
+
+  **Plugin**
+  ```javascript
+  function transformI18nBlock(source) {
+    // transformation logic
+  }
+
+  // Plugin
+  vueI18n({
+    transformI18nBlock
+  })
+  ```
+
+  **Before**
+  ```html
+  <i18n>
+  [
+      'slug-one',
+      'slug-two'
+  ]
+  <i18n>
+  ```
+
+  **After**
+  ```html
+  <i18n>
+  {
+      'en': {
+        'slug-one': 'foo',
+        'slug-two': 'bar'
+      },
+      ja: {
+        'slug-one': 'foo',
+        'slug-two': 'bar'
+      }
+  }
+  </i18n>
+  ```
+  > [!IMPORTANT]
+  The function **must** return a string or the build will fail.
+
 ## 📜 Changelog
 
 Details changes for each release are documented in the [CHANGELOG.md](https://github.com/intlify/bundle-tools/blob/main/packages/unplugin-vue-i18n/CHANGELOG.md)

package/lib/index.cjs

@@ -182,6 +182,7 @@ function resolveOptions(options, installedPkgInfo) {
   const escapeHtml = !!options.escapeHtml;
   const optimizeTranslationDirective = shared.isString(options.optimizeTranslationDirective) || shared.isArray(options.optimizeTranslationDirective) ? options.optimizeTranslationDirective : !!options.optimizeTranslationDirective;
   const translationIdentifiers = /* @__PURE__ */ new Map();
+  const transformI18nBlock = typeof options.transformI18nBlock === "function" ? options.transformI18nBlock : null;
   return {
     include,
     exclude,
@@ -198,7 +199,8 @@ function resolveOptions(options, installedPkgInfo) {
     strictMessage,
     escapeHtml,
     optimizeTranslationDirective,
-    translationIdentifiers
+    translationIdentifiers,
+    transformI18nBlock
   };
 }
 
@@ -284,7 +286,8 @@ function resourcePlugin({
   ssrBuild,
   strictMessage,
   allowDynamic,
-  escapeHtml
+  escapeHtml,
+  transformI18nBlock
 }, meta, installedPkgInfo) {
   const filter = pluginutils.createFilter(include, exclude);
   const getVueI18nAliasPath = ({ ssr = false, runtimeOnly: runtimeOnly2 = false }) => {
@@ -566,7 +569,7 @@ function resourcePlugin({
             }
           );
           debug$2("parseOptions", parseOptions);
-          const source = await getCode(
+          let source = await getCode(
             code,
             filename,
             sourceMap,
@@ -574,6 +577,14 @@ function resourcePlugin({
             getSfcParser(),
             meta.framework
           );
+          if (typeof transformI18nBlock === "function") {
+            const modifiedSource = transformI18nBlock(source);
+            if (modifiedSource && typeof modifiedSource === "string") {
+              source = modifiedSource;
+            } else {
+              warn("transformI18nBlock should return a string");
+            }
+          }
           const { code: generatedCode, map } = generate(source, parseOptions);
           debug$2("generated code", generatedCode);
           debug$2("sourcemap", map, sourceMap);
@@ -627,7 +638,8 @@ async function generateBundleResources(resources, isProduction, {
   onlyLocales = [],
   strictMessage = true,
   escapeHtml = false,
-  jit = true
+  jit = true,
+  transformI18nBlock = void 0
 }) {
   const codes = [];
   for (const res of resources) {
@@ -642,7 +654,8 @@ async function generateBundleResources(resources, isProduction, {
         onlyLocales,
         strictMessage,
         escapeHtml,
-        forceStringify
+        forceStringify,
+        transformI18nBlock
       });
       parseOptions.type = "bare";
       const { code } = generate(source, parseOptions);
@@ -714,7 +727,8 @@ function getOptions(filename, isProduction, query, sourceMap, {
   allowDynamic = false,
   strictMessage = true,
   escapeHtml = false,
-  jit = true
+  jit = true,
+  transformI18nBlock = null
 }) {
   const mode = isProduction ? "production" : "development";
   const baseOptions = {
@@ -728,6 +742,7 @@ function getOptions(filename, isProduction, query, sourceMap, {
     jit,
     onlyLocales,
     env: mode,
+    transformI18nBlock,
     onWarn: (msg) => {
       warn(`${filename} ${msg}`);
     },

package/lib/index.mjs

@@ -167,6 +167,7 @@ function resolveOptions(options, installedPkgInfo) {
   const escapeHtml = !!options.escapeHtml;
   const optimizeTranslationDirective = isString(options.optimizeTranslationDirective) || isArray(options.optimizeTranslationDirective) ? options.optimizeTranslationDirective : !!options.optimizeTranslationDirective;
   const translationIdentifiers = /* @__PURE__ */ new Map();
+  const transformI18nBlock = typeof options.transformI18nBlock === "function" ? options.transformI18nBlock : null;
   return {
     include,
     exclude,
@@ -183,7 +184,8 @@ function resolveOptions(options, installedPkgInfo) {
     strictMessage,
     escapeHtml,
     optimizeTranslationDirective,
-    translationIdentifiers
+    translationIdentifiers,
+    transformI18nBlock
   };
 }
 
@@ -269,7 +271,8 @@ function resourcePlugin({
   ssrBuild,
   strictMessage,
   allowDynamic,
-  escapeHtml
+  escapeHtml,
+  transformI18nBlock
 }, meta, installedPkgInfo) {
   const filter = createFilter(include, exclude);
   const getVueI18nAliasPath = ({ ssr = false, runtimeOnly: runtimeOnly2 = false }) => {
@@ -551,7 +554,7 @@ function resourcePlugin({
             }
           );
           debug$2("parseOptions", parseOptions);
-          const source = await getCode(
+          let source = await getCode(
             code,
             filename,
             sourceMap,
@@ -559,6 +562,14 @@ function resourcePlugin({
             getSfcParser(),
             meta.framework
           );
+          if (typeof transformI18nBlock === "function") {
+            const modifiedSource = transformI18nBlock(source);
+            if (modifiedSource && typeof modifiedSource === "string") {
+              source = modifiedSource;
+            } else {
+              warn("transformI18nBlock should return a string");
+            }
+          }
           const { code: generatedCode, map } = generate(source, parseOptions);
           debug$2("generated code", generatedCode);
           debug$2("sourcemap", map, sourceMap);
@@ -612,7 +623,8 @@ async function generateBundleResources(resources, isProduction, {
   onlyLocales = [],
   strictMessage = true,
   escapeHtml = false,
-  jit = true
+  jit = true,
+  transformI18nBlock = void 0
 }) {
   const codes = [];
   for (const res of resources) {
@@ -627,7 +639,8 @@ async function generateBundleResources(resources, isProduction, {
         onlyLocales,
         strictMessage,
         escapeHtml,
-        forceStringify
+        forceStringify,
+        transformI18nBlock
       });
       parseOptions.type = "bare";
       const { code } = generate(source, parseOptions);
@@ -699,7 +712,8 @@ function getOptions(filename, isProduction, query, sourceMap, {
   allowDynamic = false,
   strictMessage = true,
   escapeHtml = false,
-  jit = true
+  jit = true,
+  transformI18nBlock = null
 }) {
   const mode = isProduction ? "production" : "development";
   const baseOptions = {
@@ -713,6 +727,7 @@ function getOptions(filename, isProduction, query, sourceMap, {
     jit,
     onlyLocales,
     env: mode,
+    transformI18nBlock,
     onWarn: (msg) => {
       warn(`${filename} ${msg}`);
     },

package/lib/types.d.cts

@@ -14,6 +14,7 @@ interface PluginOptions {
     strictMessage?: boolean;
     escapeHtml?: boolean;
     optimizeTranslationDirective?: boolean | string | string[];
+    transformI18nBlock?: (src: string | Buffer) => string;
 }
 
 export type { PluginOptions, SFCLangFormat };

package/lib/types.d.mts

@@ -14,6 +14,7 @@ interface PluginOptions {
     strictMessage?: boolean;
     escapeHtml?: boolean;
     optimizeTranslationDirective?: boolean | string | string[];
+    transformI18nBlock?: (src: string | Buffer) => string;
 }
 
 export type { PluginOptions, SFCLangFormat };

package/lib/types.d.ts

@@ -14,6 +14,7 @@ interface PluginOptions {
     strictMessage?: boolean;
     escapeHtml?: boolean;
     optimizeTranslationDirective?: boolean | string | string[];
+    transformI18nBlock?: (src: string | Buffer) => string;
 }
 
 export type { PluginOptions, SFCLangFormat };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlify/unplugin-vue-i18n",
-  "version": "5.0.0-beta.3",
+  "version": "5.0.0-beta.4",
   "description": "unplugin for Vue I18n",
   "author": {
     "name": "kazuya kawaguchi",