@intlify/unplugin-vue-i18n 11.0.3 → 11.1.0

package/lib/types.d.cts

@@ -1,5 +1,24 @@
 type SFCLangFormat = 'json' | 'json5' | 'yml' | 'yaml';
 type VueI18nModule = 'vue-i18n' | 'petite-vue-i18n';
+interface TreeShakingOptions {
+    /**
+     * Message key patterns to always keep (never tree-shake).
+     * Supports glob-like patterns (e.g., `'errors.*'`, `'validation.**'`).
+     */
+    safelist?: string[];
+    /**
+     * Strategy when dynamic key usage (e.g., `t(variable)`) is detected.
+     * - `'keep-all'`: Disable tree-shaking and keep all keys (safe default).
+     * - `'ignore'`: Continue tree-shaking despite dynamic keys (risky, use with `safelist`).
+     * @default 'keep-all'
+     */
+    dynamicKeyStrategy?: 'keep-all' | 'ignore';
+    /**
+     * Glob patterns for source files to scan for used message keys.
+     * Defaults to `${projectRoot}/src/**\/*.{vue,ts,js,tsx,jsx}` when not specified.
+     */
+    scanPatterns?: string[];
+}
 interface PluginOptions {
     include?: string | string[];
     exclude?: string | string[];
@@ -18,6 +37,12 @@ interface PluginOptions {
     escapeHtml?: boolean;
     optimizeTranslationDirective?: boolean | string | string[];
     transformI18nBlock?: (src: string | Buffer) => string;
+    /**
+     * Enable message key tree-shaking to remove unused locale message keys.
+     * Only effective in production builds.
+     * @default false
+     */
+    treeShaking?: boolean | TreeShakingOptions;
 }
 
-export type { PluginOptions, SFCLangFormat, VueI18nModule };
+export type { PluginOptions, SFCLangFormat, TreeShakingOptions, VueI18nModule };

package/lib/types.d.mts

@@ -1,5 +1,24 @@
 type SFCLangFormat = 'json' | 'json5' | 'yml' | 'yaml';
 type VueI18nModule = 'vue-i18n' | 'petite-vue-i18n';
+interface TreeShakingOptions {
+    /**
+     * Message key patterns to always keep (never tree-shake).
+     * Supports glob-like patterns (e.g., `'errors.*'`, `'validation.**'`).
+     */
+    safelist?: string[];
+    /**
+     * Strategy when dynamic key usage (e.g., `t(variable)`) is detected.
+     * - `'keep-all'`: Disable tree-shaking and keep all keys (safe default).
+     * - `'ignore'`: Continue tree-shaking despite dynamic keys (risky, use with `safelist`).
+     * @default 'keep-all'
+     */
+    dynamicKeyStrategy?: 'keep-all' | 'ignore';
+    /**
+     * Glob patterns for source files to scan for used message keys.
+     * Defaults to `${projectRoot}/src/**\/*.{vue,ts,js,tsx,jsx}` when not specified.
+     */
+    scanPatterns?: string[];
+}
 interface PluginOptions {
     include?: string | string[];
     exclude?: string | string[];
@@ -18,6 +37,12 @@ interface PluginOptions {
     escapeHtml?: boolean;
     optimizeTranslationDirective?: boolean | string | string[];
     transformI18nBlock?: (src: string | Buffer) => string;
+    /**
+     * Enable message key tree-shaking to remove unused locale message keys.
+     * Only effective in production builds.
+     * @default false
+     */
+    treeShaking?: boolean | TreeShakingOptions;
 }
 
-export type { PluginOptions, SFCLangFormat, VueI18nModule };
+export type { PluginOptions, SFCLangFormat, TreeShakingOptions, VueI18nModule };

package/lib/types.d.ts

@@ -1,5 +1,24 @@
 type SFCLangFormat = 'json' | 'json5' | 'yml' | 'yaml';
 type VueI18nModule = 'vue-i18n' | 'petite-vue-i18n';
+interface TreeShakingOptions {
+    /**
+     * Message key patterns to always keep (never tree-shake).
+     * Supports glob-like patterns (e.g., `'errors.*'`, `'validation.**'`).
+     */
+    safelist?: string[];
+    /**
+     * Strategy when dynamic key usage (e.g., `t(variable)`) is detected.
+     * - `'keep-all'`: Disable tree-shaking and keep all keys (safe default).
+     * - `'ignore'`: Continue tree-shaking despite dynamic keys (risky, use with `safelist`).
+     * @default 'keep-all'
+     */
+    dynamicKeyStrategy?: 'keep-all' | 'ignore';
+    /**
+     * Glob patterns for source files to scan for used message keys.
+     * Defaults to `${projectRoot}/src/**\/*.{vue,ts,js,tsx,jsx}` when not specified.
+     */
+    scanPatterns?: string[];
+}
 interface PluginOptions {
     include?: string | string[];
     exclude?: string | string[];
@@ -18,6 +37,12 @@ interface PluginOptions {
     escapeHtml?: boolean;
     optimizeTranslationDirective?: boolean | string | string[];
     transformI18nBlock?: (src: string | Buffer) => string;
+    /**
+     * Enable message key tree-shaking to remove unused locale message keys.
+     * Only effective in production builds.
+     * @default false
+     */
+    treeShaking?: boolean | TreeShakingOptions;
 }
 
-export type { PluginOptions, SFCLangFormat, VueI18nModule };
+export type { PluginOptions, SFCLangFormat, TreeShakingOptions, VueI18nModule };

package/lib/vite.cjs

@@ -15,7 +15,6 @@ require('picocolors');
 require('@eslint-community/eslint-utils');
 require('@intlify/vue-i18n-extensions');
 require('@typescript-eslint/scope-manager');
-require('@typescript-eslint/typescript-estree');
 
 const vite = unplugin.createVitePlugin(index.unpluginFactory);
 

package/lib/vite.mjs

@@ -13,7 +13,6 @@ import 'picocolors';
 import '@eslint-community/eslint-utils';
 import '@intlify/vue-i18n-extensions';
 import '@typescript-eslint/scope-manager';
-import '@typescript-eslint/typescript-estree';
 
 const vite = createVitePlugin(unpluginFactory);
 

package/lib/webpack.cjs

@@ -15,7 +15,6 @@ require('picocolors');
 require('@eslint-community/eslint-utils');
 require('@intlify/vue-i18n-extensions');
 require('@typescript-eslint/scope-manager');
-require('@typescript-eslint/typescript-estree');
 
 const webpack = unplugin.createWebpackPlugin(index.unpluginFactory);
 

package/lib/webpack.mjs

@@ -13,7 +13,6 @@ import 'picocolors';
 import '@eslint-community/eslint-utils';
 import '@intlify/vue-i18n-extensions';
 import '@typescript-eslint/scope-manager';
-import '@typescript-eslint/typescript-estree';
 
 const webpack = createWebpackPlugin(unpluginFactory);
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlify/unplugin-vue-i18n",
-  "version": "11.0.3",
+  "version": "11.1.0",
   "description": "unplugin for Vue I18n",
   "author": {
     "name": "kazuya kawaguchi",
@@ -35,7 +35,7 @@
     "picocolors": "^1.0.0",
     "unplugin": "^2.3.4",
     "vue": "^3.5.21",
-    "@intlify/bundle-utils": "11.0.3"
+    "@intlify/bundle-utils": "11.1.0"
   },
   "devDependencies": {
     "@intlify/core-base": "next",