monaco-editor-nls-adapter 2.1.1 → 2.2.0

package/README.md

@@ -113,14 +113,34 @@ export default defineConfig({
 });
 ```
 
-### 4. Bundle Optimization (Optional)
+### 4. On-demand Packaging (Recommended)
 
-If you are concerned about bundle size or the "Stat size" reported by bundle analyzers, you can use the **Lite Version**. 
+By default, the adapter's entry point contains dynamic references that may cause bundlers to include all available locales (~13MB total stat size).
 
-The default entry point uses dynamic `require`/`import` with template strings, which may cause build tools (Webpack/Vite) to scan and include all available locales or report a large "original size." The Lite version eliminates this by providing only the core logic.
+You can use the `languages` option to specify **only** the languages you need. This is easier than the Lite version because it retains the full automation of `init()` and `initAsync()` while significantly reducing the bundle size.
 
+#### Vite Configuration (`vite.config.js`)
 ```javascript
-// 1. Import from /lite
+vitePlugin({
+  languages: ['zh-hans', 'en'] // Only include Simplified Chinese and English
+})
+```
+
+#### Webpack Configuration (`webpack.config.js`)
+```javascript
+{
+  loader: loader,
+  options: {
+    languages: ['zh-hans', 'ja'] // Only include Simplified Chinese and Japanese
+  }
+}
+```
+
+> [!TIP]
+> **Extreme Optimization (Lite Version)**: If you want zero code injection, you can bypass the main entry point entirely and use the Lite version. See below:
+
+```javascript
+// 1. Import from /lite (No dynamic loading logic included)
 import { setMessages } from 'monaco-editor-nls-adapter/lite';
 
 // 2. Manually import ONLY the language you need
@@ -128,9 +148,6 @@ import zhHans from 'monaco-editor-nls-adapter/locales/zh-hans.json';
 
 // 3. Initialize BEFORE monaco-editor loads
 setMessages(zhHans, 'zh-hans');
-
-// 4. Import monaco-editor as usual
-import * as monaco from 'monaco-editor';
 ```
 
 ## 📖 Usage

package/README_zh.md

@@ -114,24 +114,41 @@ export default defineConfig({
 });
 ```
 
-### 4. 极致体积优化 (可选)
+### 4. 语言包按需打包 (推荐优化方案)
 
-如果你对打包后的 JS 文件体积非常敏感，或者 bundle analyzer 显示 `monaco-editor-nls-adapter` 的 `Stat size` 过大（这是由于默认入口包含所有语言包的动态引用导致的），可以使用 **Lite 版本**。
+默认情况下，由于 `index.js` 包含动态引用，构建工具可能会扫描并打包 `./locales` 目录下的所有语言文件（Stat size 较大）。
 
-Lite 版本不具备内置的语言包发现逻辑，需要你手动导入所需的语言 JSON。这样构建工具（Webpack/Vite）只会打包你真正使用的那门语言，而不会扫描整个 `./locales` 目录。
+你可以通过 `languages` 配置项来指定**仅打包**需要的语言。这比手动使用 Lite 版本更方便，因为它依然保留了 `init()` 和 `initAsync()` 的全自动加载能力，同时大幅减少产物体积。
 
+#### Vite 配置 (`vite.config.js`)
 ```javascript
-// 1. 从 /lite 入口导入
+vitePlugin({
+  languages: ['zh-hans', 'en'] // 最终产物仅包含中、英语言包
+})
+```
+
+#### Webpack 配置 (`webpack.config.js`)
+```javascript
+{
+  loader: loader,
+  options: {
+    languages: ['zh-hans', 'ja'] // 最终产物仅包含中、日语言包
+  }
+}
+```
+
+> [!TIP]
+> **极致优化 (Lite 版本)**: 如果你连按需打包的代码注入也不想要，可以完全绕过 `index.js`，手动导入 JSON 并调用 `setMessages`。详见下文：
+
+```javascript
+// 1. 从 /lite 入口导入 (不含任何动态加载逻辑)
 import { setMessages } from 'monaco-editor-nls-adapter/lite';
 
-// 2. 手动导入特定的语言 JSON (由你自己决定包含哪门语言)
+// 2. 手动导入特定的语言 JSON
 import zhHans from 'monaco-editor-nls-adapter/locales/zh-hans.json';
 
 // 3. 初始化 (必须要在 monaco 加载前运行)
 setMessages(zhHans, 'zh-hans');
-
-// 4. 正常使用 monaco-editor
-import * as monaco from 'monaco-editor';
 ```
 
 ## 📖 使用指南

package/loader.js

@@ -1,11 +1,16 @@
 const { transform } = require('./transform')
+const { generateLocalesCode } = require('./codegen')
 
 /**
  * Webpack Loader for Monaco Editor NLS Adapter
  */
 module.exports = function (source) {
-  // 极致性能优化：第一层极速过滤
-  if (!this.resourcePath.endsWith('.js') || this.resourcePath.indexOf('monaco-editor') === -1) {
+  const resourcePath = this.resourcePath.replace(/\\/g, '/')
+  const isAdapter = resourcePath.endsWith('monaco-editor-nls-adapter/index.js') || resourcePath.endsWith('monaco-editor-nls-adapter/index.ts')
+  const isMonaco = resourcePath.indexOf('monaco-editor') !== -1
+
+  // 1. 第一层过滤：仅处理 monaco-editor 或 适配器自身入口
+  if (!isAdapter && !isMonaco) {
     return source
   }
 
@@ -13,18 +18,41 @@ module.exports = function (source) {
   
   // 获取 loader options
   const options = (typeof this.getOptions === 'function') ? this.getOptions() : this.query
-  
-  // 使用共享的 transform 逻辑
-  const result = transform(source, this.resourcePath, options || {})
-  
-  // 如果返回包含 SourceMap 的对象，则使用 this.callback 提示 Webpack
-  if (result && typeof result === 'object') {
-    if (this.callback) {
-      this.callback(null, result.code, result.map)
-      return
+  const languages = (options && Array.isArray(options.languages)) ? options.languages : null
+
+  // 2. 处理适配器自身的 index.js (按需打包语言包)
+  if (isAdapter && languages) {
+    let newCode = source
+    
+    // 替换同步 require
+    const syncCode = generateLocalesCode(languages, false)
+    if (syncCode) {
+      newCode = newCode.replace(/require\(`\.\/locales\/\$\{targetLocale\}\.json`\)/g, syncCode)
+    }
+
+    // 替换异步 import
+    const asyncCode = generateLocalesCode(languages, true)
+    if (asyncCode) {
+      newCode = newCode.replace(/import\(.*?\`\.\/locales\/\$\{targetLocale\}\.json\`\)/g, asyncCode)
+    }
+
+    return newCode
+  }
+
+  // 3. 处理 Monaco Editor 源代码 (注入本地化逻辑)
+  if (isMonaco) {
+    const result = transform(source, this.resourcePath, options || {})
+    
+    // 如果返回包含 SourceMap 的对象，则使用 this.callback 提示 Webpack
+    if (result && typeof result === 'object') {
+      if (this.callback) {
+        this.callback(null, result.code, result.map)
+        return
+      }
+      return result.code
     }
-    return result.code
+    return result
   }
 
-  return result
+  return source
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "monaco-editor-nls-adapter",
-  "version": "2.1.1",
+  "version": "2.2.0",
   "description": "Multi-language NLS adapter for Monaco Editor 0.50.0+ (Self-hosted)",
   "main": "index.js",
   "module": "index.js",

package/vite-plugin.js

@@ -1,25 +1,50 @@
 const { transform } = require('./transform')
+const { generateLocalesCode } = require('./codegen')
 
 /**
  * Vite Plugin for Monaco Editor NLS Adapter
  * @param {Object} options 插件配置
  * @param {string} options.monacoPath 匹配 Monaco Editor ESM 路径的特征字符串，默认为 'monaco-editor/esm'
+ * @param {string[]} options.languages 需要包含的语言包列表 (如 ['zh-hans', 'en'])。不传则全量打包。
  */
 function monacoNlsPlugin(options = {}) {
   const monacoRoot = options.monacoPath || 'monaco-editor/esm'
-  
+  const languages = Array.isArray(options.languages) ? options.languages : null
+
   return {
     name: 'vite-plugin-monaco-nls-adapter',
     enforce: 'pre',
     transform(code, id) {
-      // 极致性能优化：第一层极速过滤，避免非目标文件的正则与替换开销
-      if (!id.endsWith('.js') || id.indexOf('monaco-editor') === -1) return
+      if (!id.endsWith('.js')) return
 
       // 统一路径格式
       const normalizedId = id.replace(/\\/g, '/')
-      
-      // 快速过滤非目标文件 (进一步细化)
-      if (normalizedId.includes(monacoRoot)) {
+
+      // 1. 处理适配器自身的 index.js (按需打包语言包)
+      if (languages && (normalizedId.endsWith('monaco-editor-nls-adapter/index.js') || normalizedId.endsWith('monaco-editor-nls-adapter/index.ts'))) {
+        let newCode = code
+        
+        // 替换同步 require
+        const syncCode = generateLocalesCode(languages, false)
+        if (syncCode) {
+          newCode = newCode.replace(/require\(`\.\/locales\/\$\{targetLocale\}\.json`\)/g, syncCode)
+        }
+
+        // 替换异步 import
+        const asyncCode = generateLocalesCode(languages, true)
+        if (asyncCode) {
+          // 注意：index.js 中的 import 是带注释的: import(/* webpackChunkName: "nls-[request]" */ `./locales/${targetLocale}.json`)
+          newCode = newCode.replace(/import\(.*?\`\.\/locales\/\$\{targetLocale\}\.json\`\)/g, asyncCode)
+        }
+
+        return {
+          code: newCode,
+          map: null // 对于这种简单的替换，暂不生成 sourcemap 以保持性能
+        }
+      }
+
+      // 2. 处理 Monaco Editor 源代码 (注入本地化逻辑)
+      if (normalizedId.indexOf('monaco-editor') !== -1 && normalizedId.includes(monacoRoot)) {
         const result = transform(code, id, options)
         
         // 如果 transform 返回的是对象 ({ code, map })，直接返回