monaco-editor-nls-adapter 1.0.0

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "monaco-editor-nls-adapter",
+  "version": "1.0.0",
+  "description": "Multi-language NLS adapter for Monaco Editor 0.50.0+ (Self-hosted)",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "loader.js",
+    "proxy.js",
+    "transform.js",
+    "vite-plugin.js",
+    "locales/*.json",
+    "README.md",
+    "README_zh.md"
+  ],
+  "keywords": [
+    "monaco-editor",
+    "nls",
+    "localization",
+    "internationalization",
+    "i18n",
+    "vite-plugin",
+    "webpack-loader"
+  ],
+  "author": "leepule",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com:leepule/monaco-editor-nls-adapter.git"
+  },
+  "bugs": {
+    "url": "https://github.com/leepule/monaco-editor-nls-adapter/issues"
+  },
+  "homepage": "https://github.com/leepule/monaco-editor-nls-adapter#readme",
+  "peerDependencies": {
+    "monaco-editor": ">= 0.50.0"
+  },
+  "dependencies": {}
+}

package/proxy.js

@@ -0,0 +1,74 @@
+/**
+ * 用于 Monaco Editor 0.50.0+ 的自托管 NLS 代理
+ * 此文件通过注入 path 参数，替代了对原本 'monaco-editor-nls/vscode-nls' 的内部依赖方式。
+ */
+
+let CURRENT_LOCALE_DATA = null
+
+function _format(message, args) {
+  if (args.length === 0) {
+    return message
+  }
+  return String(message).replace(/\{(\d+)\}/g, function (match, rest) {
+    const index = rest[0]
+    return typeof args[index] !== 'undefined' ? args[index] : match
+  })
+}
+
+function localize(path, data, defaultMessage, ...args) {
+  // 针对 Monaco 0.50.0 签名的参数修正：
+  // 1. 当通过 loader 调用时，path 是被注入的。
+  // 2. 当通过 create 调用时，path 也会被显式作为第一个参数传入。
+  const key = (data && typeof data === 'object') ? data.key : data
+  const localeData = CURRENT_LOCALE_DATA || {}
+  
+  let message = (localeData[path] || {})[key]
+  // 强化回退逻辑：如果翻译为空或未找到，则回退到默认消息
+  if (message === undefined || message === null || message === '') {
+    message = defaultMessage
+  }
+  
+  return _format(message, args)
+}
+
+function localize2(path, data, defaultMessage, ...args) {
+  const value = localize(path, data, defaultMessage, ...args)
+  return {
+    value: value,
+    original: value
+  }
+}
+
+function setLocaleData(data) {
+  CURRENT_LOCALE_DATA = data
+}
+
+function getConfiguredDefaultLocale() {
+  return undefined
+}
+
+function loadMessageBundle(file) {
+  return localize
+}
+
+function config(opt) {
+  return loadMessageBundle
+}
+
+function create(key, data) {
+  return {
+    localize: (idx, defaultValue, ...args) => localize(key, idx, defaultValue, ...args),
+    localize2: (idx, defaultValue, ...args) => localize2(key, idx, defaultValue, ...args),
+    getConfiguredDefaultLocale: () => undefined
+  }
+}
+
+module.exports = {
+  localize,
+  localize2,
+  setLocaleData,
+  getConfiguredDefaultLocale,
+  loadMessageBundle,
+  config,
+  create
+}

package/transform.js

@@ -0,0 +1,37 @@
+const MONACO_ESM_ROOT = 'node_modules/monaco-editor/esm/'
+
+/**
+ * 转换 Monaco Editor 源代码以注入本地化路径
+ * @param {string} source 源代码内容
+ * @param {string} id 文件路径 (resourcePath 或 vite id)
+ * @returns {string} 转换后的代码
+ */
+function transform(source, id) {
+  // 统一路径分隔符
+  const resourcePath = id.replace(/\\/g, '/')
+
+  if (resourcePath.includes(MONACO_ESM_ROOT)) {
+    // 1. 计算 Monaco 模块路径 (例如 vs/editor/common/editorContextKeys)
+    const startIndex = resourcePath.indexOf(MONACO_ESM_ROOT) + MONACO_ESM_ROOT.length
+    const modulePath = resourcePath.substring(startIndex).replace('.js', '')
+
+    // 2. 将 NLS 引用重定向到本包的代理 (proxy) 文件
+    const proxyPath = 'monaco-editor-nls-adapter/proxy'
+    
+    // 替换对 nls.js 的引用
+    source = source.replace(/import\s+\*\s+as\s+nls\s+from\s+['"].*?\/nls\.js['"]/g, `import * as nls from '${proxyPath}'`)
+    source = source.replace(/require\(['"].*?\/nls\.js['"]\)/g, `require('${proxyPath}')`)
+
+    // 3. 在 localize 和 localize2 调用中注入路径作为第一个参数
+    // 注意：只替换调用，不改变原始代码逻辑
+    source = source.replace(/nls\.localize\(/g, `nls.localize('${modulePath}', `)
+    source = source.replace(/nls\.localize2\(/g, `nls.localize2('${modulePath}', `)
+  }
+
+  return source
+}
+
+module.exports = {
+  transform,
+  MONACO_ESM_ROOT
+}

package/vite-plugin.js

@@ -0,0 +1,25 @@
+const { transform, MONACO_ESM_ROOT } = require('./transform')
+
+/**
+ * Vite Plugin for Monaco Editor NLS Adapter
+ * Supports both development and production builds.
+ */
+function monacoNlsPlugin() {
+  return {
+    name: 'vite-plugin-monaco-nls-adapter',
+    // 强制此插件在代码压缩和混淆之前执行
+    enforce: 'pre',
+    transform(code, id) {
+      // 检查是否是 Monaco Editor 的 ESM 源码文件
+      if (id.replace(/\\/g, '/').includes(MONACO_ESM_ROOT)) {
+        return {
+          code: transform(code, id),
+          // 返回原始 map 或 null，由于是简单的正则匹配转换，不处理 SourceMap
+          map: null
+        }
+      }
+    }
+  }
+}
+
+module.exports = monacoNlsPlugin