@bhsd/common 0.12.0 → 0.13.1

package/dist/index.d.ts

@@ -47,12 +47,23 @@ export declare const setObject: (key: string, value: unknown) => void;
  * @param baseVersion 基础版本号
  */
 export declare const compareVersion: (version: string, baseVersion: string) => boolean;
+/**
+ * 加载 I18N
+ * @param url 下载地址
+ * @param cur 当前版本号
+ * @param languages 语言代码列表
+ * @param key 存储的键名
+ * @param i18n 已存储的I18N对象
+ * @throws `Error` 无法获取语言包
+ */
+export declare const setI18N: (url: string, cur: string, languages: string[] | string, key: string, i18n?: Record<string, string>) => Promise<Record<string, string>>;
 /**
  * 加载 wikiparse
  * @param getConfig 获取解析配置的函数
  * @param langs 语言代码
+ * @param cdn CDN 地址
  */
-export declare const getWikiparse: (getConfig?: ConfigGetter, langs?: string | string[]) => Promise<void>;
+export declare const getWikiparse: (getConfig?: ConfigGetter, langs?: string | string[], cdn?: string) => Promise<void>;
 /**
  * 获取LSP
  * @param obj 关联对象

package/dist/index.js

@@ -32,6 +32,7 @@ __export(index_exports, {
   rawurldecode: () => rawurldecode,
   refreshStdout: () => refreshStdout,
   sanitizeInlineStyle: () => sanitizeInlineStyle,
+  setI18N: () => setI18N,
   setObject: () => setObject,
   splitColors: () => splitColors
 });
@@ -114,11 +115,31 @@ const compareVersion = (version, baseVersion) => {
   const [major, minor] = parseVersion(version), [baseMajor, baseMinor] = parseVersion(baseVersion);
   return major > baseMajor || major === baseMajor && minor >= baseMinor;
 };
+const setI18N = async (url, cur, languages, key, i18n = getObject(key) ?? {}) => {
+  const { version, lang } = i18n, langs = Array.isArray(languages) ? languages : [languages];
+  if (version === cur && langs.includes(lang)) {
+    return i18n;
+  }
+  for (const language of langs) {
+    try {
+      const res = await fetch(`${url}/${language.toLowerCase()}.json`);
+      Object.assign(i18n, await res.json(), { version: cur, lang: language });
+      setObject(key, i18n);
+      return i18n;
+    } catch {
+    }
+  }
+  throw new Error(`Failed to fetch the localization for ${langs[0]}.`);
+};
 let configLoaded = false, i18nLoaded = false;
-const getWikiparse = async (getConfig, langs) => {
+const getWikiparse = async (getConfig, langs, cdn) => {
   const dir = "extensions/dist";
-  await loadScript(`npm/wikiparser-node/${dir}/base.min.js`, "wikiparse");
-  await loadScript(`${wikiparse.CDN}/${dir}/lsp.min.js`, "wikiparse.LanguageService");
+  let src = cdn || `npm/wikiparser-node/${dir}/base.min.js`;
+  if (!src.endsWith(".js")) {
+    src = `${src}${src.endsWith("/") ? "" : "/"}${dir}/base.js`;
+  }
+  await loadScript(src, "wikiparse");
+  await loadScript(`${wikiparse.CDN}/${dir}/lsp.js`, "wikiparse.LanguageService");
   if (!configLoaded && typeof getConfig === "function") {
     configLoaded = true;
     try {
@@ -128,13 +149,11 @@ const getWikiparse = async (getConfig, langs) => {
   }
   if (!i18nLoaded && langs) {
     i18nLoaded = true;
-    for (const lang of Array.isArray(langs) ? langs : [langs]) {
-      try {
-        const i18n = await (await fetch(`${wikiparse.CDN}/i18n/${lang.toLowerCase()}.json`)).json();
-        wikiparse.setI18N(i18n);
-        break;
-      } catch {
-      }
+    const key = "wikiparse-i18n", { version } = wikiparse;
+    try {
+      wikiparse.setI18N(await setI18N(`${wikiparse.CDN}/i18n`, version, langs, key));
+    } catch {
+      setObject(key, { version, lang: "en" });
     }
   }
 };

package/dist/index.mjs

@@ -76,11 +76,31 @@ const compareVersion = (version, baseVersion) => {
   const [major, minor] = parseVersion(version), [baseMajor, baseMinor] = parseVersion(baseVersion);
   return major > baseMajor || major === baseMajor && minor >= baseMinor;
 };
+const setI18N = async (url, cur, languages, key, i18n = getObject(key) ?? {}) => {
+  const { version, lang } = i18n, langs = Array.isArray(languages) ? languages : [languages];
+  if (version === cur && langs.includes(lang)) {
+    return i18n;
+  }
+  for (const language of langs) {
+    try {
+      const res = await fetch(`${url}/${language.toLowerCase()}.json`);
+      Object.assign(i18n, await res.json(), { version: cur, lang: language });
+      setObject(key, i18n);
+      return i18n;
+    } catch {
+    }
+  }
+  throw new Error(`Failed to fetch the localization for ${langs[0]}.`);
+};
 let configLoaded = false, i18nLoaded = false;
-const getWikiparse = async (getConfig, langs) => {
+const getWikiparse = async (getConfig, langs, cdn) => {
   const dir = "extensions/dist";
-  await loadScript(`npm/wikiparser-node/${dir}/base.min.js`, "wikiparse");
-  await loadScript(`${wikiparse.CDN}/${dir}/lsp.min.js`, "wikiparse.LanguageService");
+  let src = cdn || `npm/wikiparser-node/${dir}/base.min.js`;
+  if (!src.endsWith(".js")) {
+    src = `${src}${src.endsWith("/") ? "" : "/"}${dir}/base.js`;
+  }
+  await loadScript(src, "wikiparse");
+  await loadScript(`${wikiparse.CDN}/${dir}/lsp.js`, "wikiparse.LanguageService");
   if (!configLoaded && typeof getConfig === "function") {
     configLoaded = true;
     try {
@@ -90,13 +110,11 @@ const getWikiparse = async (getConfig, langs) => {
   }
   if (!i18nLoaded && langs) {
     i18nLoaded = true;
-    for (const lang of Array.isArray(langs) ? langs : [langs]) {
-      try {
-        const i18n = await (await fetch(`${wikiparse.CDN}/i18n/${lang.toLowerCase()}.json`)).json();
-        wikiparse.setI18N(i18n);
-        break;
-      } catch {
-      }
+    const key = "wikiparse-i18n", { version } = wikiparse;
+    try {
+      wikiparse.setI18N(await setI18N(`${wikiparse.CDN}/i18n`, version, langs, key));
+    } catch {
+      setObject(key, { version, lang: "en" });
     }
   }
 };
@@ -143,6 +161,7 @@ export {
   rawurldecode,
   refreshStdout,
   sanitizeInlineStyle,
+  setI18N,
   setObject,
   splitColors
 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@bhsd/common",
-	"version": "0.12.0",
+	"version": "0.13.1",
 	"license": "MIT",
 	"author": "Bhsd",
 	"files": [
@@ -62,6 +62,6 @@
 		"eslint-plugin-unicorn": "^56.0.1",
 		"stylelint": "^16.20.0",
 		"typescript": "^5.8.2",
-		"wikiparser-node": "^1.21.1"
+		"wikiparser-node": "^1.21.2"
 	}
 }