monaco-editor-nls-adapter 2.2.2 → 2.3.0

package/codegen.js

@@ -1,3 +1,6 @@
+const SYNC_LOCALE_LOADER_PATTERN = /function SYNC_LOCALE_LOADER\(locale\) \{\s*return require\(`\.\/locales\/\$\{locale\}\.json`\)\s*\}/
+const ASYNC_LOCALE_LOADER_PATTERN = /function ASYNC_LOCALE_LOADER\(locale\) \{\s*return import\(\/\* webpackChunkName: "nls-\[request\]" \*\/ `\.\/locales\/\$\{locale\}\.json`\)\s*\}/
+
 /**
  * 生成按需加载语言包的代码片段
  * @param {string[]} languages 语言代码数组
@@ -6,32 +9,48 @@
  */
 function generateLocalesCode(languages, isAsync) {
   if (!languages || languages.length === 0) {
-    return null;
+    return null
   }
 
   if (isAsync) {
     // 异步版本 (用于 initAsync)
-    const map = languages.map(lang => `  '${lang}': () => import('./locales/${lang}.json')`).join(',\n');
+    const map = languages.map(lang => `  '${lang}': () => import('./locales/${lang}.json')`).join(',\n')
     return `(async (locale) => {
       const locales = {
 ${map}
       };
       if (locales[locale]) return await locales[locale]();
       throw new Error('[monaco-editor-nls-adapter] Locale not bundled: ' + locale);
-    })(targetLocale)`;
+    })(targetLocale)`
   } else {
     // 同步版本 (用于 init)
-    const map = languages.map(lang => `  '${lang}': () => require('./locales/${lang}.json')`).join(',\n');
+    const map = languages.map(lang => `  '${lang}': () => require('./locales/${lang}.json')`).join(',\n')
     return `((locale) => {
       const locales = {
 ${map}
       };
       if (locales[locale]) return locales[locale]();
       throw new Error('[monaco-editor-nls-adapter] Locale not bundled: ' + locale);
-    })(targetLocale)`;
+    })(targetLocale)`
+  }
+}
+
+function replaceLocaleLoaders(source, languages) {
+  if (!languages || languages.length === 0) {
+    return source
   }
+
+  const syncCode = generateLocalesCode(languages, false)
+  const asyncCode = generateLocalesCode(languages, true)
+
+  return source
+    .replace(SYNC_LOCALE_LOADER_PATTERN, `function SYNC_LOCALE_LOADER(locale) {\n  return ${syncCode}\n}`)
+    .replace(ASYNC_LOCALE_LOADER_PATTERN, `function ASYNC_LOCALE_LOADER(locale) {\n  return ${asyncCode}\n}`)
 }
 
 module.exports = {
-  generateLocalesCode
-};
+  generateLocalesCode,
+  replaceLocaleLoaders,
+  SYNC_LOCALE_LOADER_PATTERN,
+  ASYNC_LOCALE_LOADER_PATTERN
+}

package/index.js

@@ -31,6 +31,35 @@ const LOCALE_MAP = {
 }
 
 let IS_LOADING = false
+let LOADING_PROMISE = null
+let LOADING_LOCALE = ''
+
+function SYNC_LOCALE_LOADER(locale) {
+  return require(`./locales/${locale}.json`)
+}
+
+function ASYNC_LOCALE_LOADER(locale) {
+  return import(/* webpackChunkName: "nls-[request]" */ `./locales/${locale}.json`)
+}
+
+function resolveLocale(locale) {
+  const isBrowser = typeof window !== 'undefined' && typeof navigator !== 'undefined'
+  let nextLocale = locale
+
+  if (!nextLocale && isBrowser) {
+    nextLocale = navigator.language || navigator.userLanguage
+  }
+
+  let targetLocale = (nextLocale || 'zh-hans').toLowerCase()
+  if (LOCALE_MAP[targetLocale]) {
+    targetLocale = LOCALE_MAP[targetLocale]
+  }
+
+  return {
+    isBrowser,
+    targetLocale
+  }
+}
 
 /**
  * 使用指定的语言代码初始化 Monaco Editor 的本地化。
@@ -39,23 +68,15 @@ let IS_LOADING = false
  * @param {boolean} force 是否强制重新初始化
  */
 function init(locale, force = false) {
-  const isBrowser = typeof window !== 'undefined' && typeof navigator !== 'undefined'
-  if (!locale && isBrowser) {
-    locale = navigator.language || navigator.userLanguage
-  }
-
-  let targetLocale = (locale || 'zh-hans').toLowerCase()
-  if (LOCALE_MAP[targetLocale]) {
-    targetLocale = LOCALE_MAP[targetLocale]
-  }
+  const { isBrowser, targetLocale } = resolveLocale(locale)
 
   if (lite.getCurrentLocale() === targetLocale && !force) {
     return true
   }
 
   try {
-    // 这里的动态 require 是导致全量打包的主要原因，若需精简请改用 lite.setMessages()
-    const data = require(`./locales/${targetLocale}.json`)
+    // 这里的占位表达式会在构建期由 loader/plugin 替换为按需语言分发表。
+    const data = SYNC_LOCALE_LOADER(targetLocale)
     lite.setMessages(data, targetLocale)
     return true
   } catch (e) {
@@ -71,36 +92,37 @@ function init(locale, force = false) {
  * @param {string} locale 语言代码
  * @param {boolean} force 是否强制重新初始化
  */
-async function initAsync(locale, force = false) {
-  const isBrowser = typeof window !== 'undefined' && typeof navigator !== 'undefined'
-  if (!locale && isBrowser) {
-    locale = navigator.language || navigator.userLanguage
-  }
+function initAsync(locale, force = false) {
+  const { isBrowser, targetLocale } = resolveLocale(locale)
 
-  let targetLocale = (locale || 'zh-hans').toLowerCase()
-  if (LOCALE_MAP[targetLocale]) {
-    targetLocale = LOCALE_MAP[targetLocale]
+  if (lite.getCurrentLocale() === targetLocale && !force) {
+    return Promise.resolve(true)
   }
 
-  if (lite.getCurrentLocale() === targetLocale && !force) {
-    return true
+  if (IS_LOADING && !force && LOADING_LOCALE === targetLocale && LOADING_PROMISE) {
+    return LOADING_PROMISE
   }
 
-  if (IS_LOADING && !force) return false
   IS_LOADING = true
+  LOADING_LOCALE = targetLocale
+  LOADING_PROMISE = ASYNC_LOCALE_LOADER(targetLocale)
+    .then((module) => {
+      lite.setMessages(module.default || module, targetLocale)
+      return true
+    })
+    .catch((e) => {
+      if (isBrowser) {
+        console.warn(`[monaco-editor-nls-adapter] 无法异步加载语言包: ${targetLocale}`, e)
+      }
+      return false
+    })
+    .finally(() => {
+      IS_LOADING = false
+      LOADING_PROMISE = null
+      LOADING_LOCALE = ''
+    })
 
-  try {
-    const module = await import(/* webpackChunkName: "nls-[request]" */ `./locales/${targetLocale}.json`)
-    lite.setMessages(module.default || module, targetLocale)
-    return true
-  } catch (e) {
-    if (isBrowser) {
-      console.warn(`[monaco-editor-nls-adapter] 无法异步加载语言包: ${targetLocale}`, e)
-    }
-    return false
-  } finally {
-    IS_LOADING = false
-  }
+  return LOADING_PROMISE
 }
 
 module.exports = {

package/lite.d.ts

@@ -0,0 +1,45 @@
+import { NLSProxy } from './proxy';
+import monacoNlsPlugin from './vite-plugin';
+
+/**
+ * 获取当前已生效的语言代码名称 / Get the current active locale name.
+ * @returns 语言代码 (如 'zh-hans')
+ */
+export function getLocaleName(): string;
+
+/**
+ * 获取当前已生效的语言代码名称 (同 getLocaleName) / Get current locale (alias for getLocaleName).
+ */
+export function getCurrentLocale(): string;
+
+/**
+ * 获取当前加载的原始翻译数据字典 / Get the raw translation dictionary data.
+ */
+export function getLocaleData(): Record<string, any> | null;
+
+/**
+ * 手动注入翻译数据字典 / Manually set the translation messages.
+ * @param messages 符合 Monaco NLS 格式的 JSON 字典对象 / Dictionary following Monaco NLS format.
+ * @param locale 语言代码名称标识符 (可选) / Locale code identifier (optional).
+ */
+export function setMessages(messages: Record<string, any>, locale?: string): void;
+
+/**
+ * 设置当前的本地化数据内容 / Directly set the locale data in the proxy.
+ */
+export function setLocaleData(data: Record<string, any>, locale?: string): void;
+
+/**
+ * NLS 代理对象实例 / The underlying NLS proxy instance.
+ */
+export const proxy: NLSProxy;
+
+/**
+ * Vite 插件导出 / Vite plugin for build-time transformation.
+ */
+export const vitePlugin: typeof monacoNlsPlugin;
+
+/**
+ * Webpack Loader 导出 (用于 webpack.config.js) / Webpack loader path and utility.
+ */
+export const loader: string;

package/loader.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Webpack Loader 处理函数。
+ * 直接导出 Loader 的绝对路径。
+ * [Webpack Loader] Absolute path to the Webpack loader.
+ */
+declare function monacoNlsLoader(this: any, source: string): string | void;
+
+declare namespace monacoNlsLoader {
+  /** 插件配置项同 vitePlugin / Shared PluginOptions */
+}
+
+export = monacoNlsLoader;

package/loader.js

@@ -1,5 +1,5 @@
 const { transform } = require('./transform')
-const { generateLocalesCode } = require('./codegen')
+const { replaceLocaleLoaders } = require('./codegen')
 
 /**
  * Webpack Loader for Monaco Editor NLS Adapter
@@ -22,21 +22,7 @@ module.exports = function (source) {
 
   // 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
+    return replaceLocaleLoaders(source, languages)
   }
 
   // 3. 处理 Monaco Editor 源代码 (注入本地化逻辑)