@playcraft/adsdk 1.0.18-beta.1 → 1.0.18-beta.3

package/dist/esm/index.js

@@ -1,3 +1,23 @@
+var __defProp = Object.defineProperty;
+var __defProps = Object.defineProperties;
+var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
+
 // src/events.ts
 var registeredEvents = {};
 function onEvent(event, fn, context, once) {
@@ -443,6 +463,196 @@ function removeWechatGuide() {
   }
 }
 
+// src/language.ts
+function readQuerystring(key) {
+  try {
+    if (typeof window === "undefined" || !window.location) return void 0;
+    const search = window.location.search || "";
+    if (!search) return void 0;
+    if (typeof URLSearchParams !== "undefined") {
+      const params = new URLSearchParams(search);
+      return params.get(key) || void 0;
+    }
+    const re = new RegExp("[?&]" + key.replace(/[.*+?^${}()|[\]\\]/g, "\\$&") + "=([^&#]*)");
+    const m = re.exec(search);
+    return m ? decodeURIComponent(m[1]) : void 0;
+  } catch (e) {
+    return void 0;
+  }
+}
+function readLocalStorage(key) {
+  try {
+    if (typeof localStorage === "undefined") return void 0;
+    return localStorage.getItem(key) || void 0;
+  } catch (e) {
+    return void 0;
+  }
+}
+function readCookie(name) {
+  try {
+    if (typeof document === "undefined" || !document.cookie) return void 0;
+    const re = new RegExp("(?:^|; )" + name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&") + "=([^;]*)");
+    const m = re.exec(document.cookie);
+    return m ? decodeURIComponent(m[1]) : void 0;
+  } catch (e) {
+    return void 0;
+  }
+}
+function readNavigatorLanguages() {
+  try {
+    if (typeof navigator === "undefined") return [];
+    const list = [];
+    const langs = navigator.languages;
+    if (Array.isArray(langs)) list.push(...langs);
+    if (navigator.language) list.push(navigator.language);
+    const userLang = navigator.userLanguage || navigator.browserLanguage;
+    if (userLang) list.push(userLang);
+    return list.filter(Boolean);
+  } catch (e) {
+    return [];
+  }
+}
+function readHtmlTag() {
+  try {
+    if (typeof document === "undefined" || !document.documentElement) return void 0;
+    return document.documentElement.lang || void 0;
+  } catch (e) {
+    return void 0;
+  }
+}
+function detectCandidates() {
+  return [
+    readQuerystring("lng"),
+    readLocalStorage("i18nextLng"),
+    readCookie("i18next"),
+    ...readNavigatorLanguages(),
+    readHtmlTag()
+  ];
+}
+var SUPPORTED_LANG_CODES = [
+  "en",
+  "zh",
+  "ja",
+  "ko",
+  "de",
+  "fr",
+  "es",
+  "pt",
+  "it",
+  "hi",
+  "bn",
+  "ur",
+  "ar",
+  "tr",
+  "ru",
+  "ms",
+  "id"
+];
+function normalizeLangTag(tag) {
+  if (!tag || typeof tag !== "string") return void 0;
+  const primary = tag.split(/[-_]/)[0].toLowerCase();
+  return SUPPORTED_LANG_CODES.indexOf(primary) >= 0 ? primary : void 0;
+}
+function getLanguageCode() {
+  const candidates = detectCandidates();
+  for (const tag of candidates) {
+    const code = normalizeLangTag(tag);
+    if (code) return code;
+  }
+  return "en";
+}
+var LANGUAGE_MAP = {
+  // 英语
+  "en": "EN",
+  // 中文（简体）
+  "zh": "CN_S",
+  "zh-cn": "CN_S",
+  "zh-sg": "CN_S",
+  "zh-my": "CN_S",
+  "zh-hans": "CN_S",
+  "zh-hans-cn": "CN_S",
+  "zh-hans-sg": "CN_S",
+  "zh-hans-my": "CN_S",
+  // 中文（繁体）
+  "zh-tw": "CN_T",
+  "zh-hk": "CN_T",
+  "zh-mo": "CN_T",
+  "zh-hant": "CN_T",
+  "zh-hant-tw": "CN_T",
+  "zh-hant-hk": "CN_T",
+  "zh-hant-mo": "CN_T",
+  // 德语
+  "de": "DE",
+  // 法语
+  "fr": "FR",
+  // 西班牙语
+  "es": "ES",
+  // 日语
+  "ja": "JA",
+  // 韩语
+  "ko": "KO",
+  // 葡萄牙语
+  "pt": "PT",
+  // 意大利语
+  "it": "IT",
+  // 印地语
+  "hi": "HI",
+  // 孟加拉语
+  "bn": "BN",
+  // 乌尔都语
+  "ur": "UR",
+  // 阿拉伯语
+  "ar": "AR",
+  // 土耳其语
+  "tr": "TR",
+  // 俄语
+  "ru": "RU",
+  // 马来语
+  "ms": "MS",
+  // 印尼语
+  "id": "ID"
+};
+var SUPPORTED_PROJECT_LANGUAGES = /* @__PURE__ */ new Set([
+  "EN",
+  "CN_S",
+  "CN_T",
+  "DE",
+  "FR",
+  "ES",
+  "JA",
+  "KO",
+  "PT",
+  "IT",
+  "HI",
+  "BN",
+  "UR",
+  "AR",
+  "TR",
+  "RU",
+  "MS",
+  "IN",
+  "ID"
+]);
+function resolveLanguageTag(tag) {
+  if (!tag || typeof tag !== "string") return void 0;
+  const normalized = tag.trim();
+  if (!normalized) return void 0;
+  const projectCode = normalized.toUpperCase().replace(/-/g, "_");
+  if (SUPPORTED_PROJECT_LANGUAGES.has(projectCode)) return projectCode;
+  const lower = normalized.toLowerCase();
+  if (LANGUAGE_MAP[lower]) return LANGUAGE_MAP[lower];
+  const primary = lower.split(/[-_]/)[0];
+  return LANGUAGE_MAP[primary];
+}
+function getLanguage() {
+  const candidates = detectCandidates();
+  for (const tag of candidates) {
+    const code = resolveLanguageTag(tag);
+    if (code) return code;
+  }
+  return "EN";
+}
+
 // src/theme-config.ts
 function extractDefaultsFromSchema(schema) {
   if (!schema || typeof schema !== "object") return void 0;
@@ -461,18 +671,28 @@ function extractDefaultsFromSchema(schema) {
   }
   return void 0;
 }
-function getLanguageCode() {
-  try {
-    return (navigator.language || "en").split("-")[0].toLowerCase();
-  } catch (e) {
-    return "en";
-  }
-}
 function lookupI18nRuntime(runtime, key, langCode) {
-  var _a, _b;
   const map = runtime[key];
   if (!map || typeof map !== "object") return void 0;
-  return (_b = (_a = map[langCode]) != null ? _a : map["en"]) != null ? _b : Object.values(map)[0];
+  const val = map[langCode];
+  if (val && val.length > 0) return val;
+  const enVal = map["en"];
+  if (enVal && enVal.length > 0) return enVal;
+  return Object.values(map).find((v) => typeof v === "string" && v.length > 0);
+}
+function mergeI18nRuntimes(runtimes) {
+  const merged = {};
+  for (const runtime of runtimes) {
+    if (!runtime) continue;
+    for (const [key, langMap] of Object.entries(runtime)) {
+      if (!merged[key]) {
+        merged[key] = __spreadValues({}, langMap);
+      } else {
+        merged[key] = __spreadValues(__spreadValues({}, merged[key]), langMap);
+      }
+    }
+  }
+  return merged;
 }
 function resolveI18nRefs(config, i18nRecord, langCode) {
   var _a;
@@ -486,6 +706,9 @@ function resolveI18nRefs(config, i18nRecord, langCode) {
         const resolved = lookupI18nRuntime(runtime, i18nKey, langCode);
         if (resolved !== void 0) {
           config[key] = resolved;
+        } else {
+          console.warn(`[i18n] Missing translation for key "${i18nKey}" (lang: ${langCode}), using key name as fallback`);
+          config[key] = i18nKey;
         }
       }
     } else if (value !== null && typeof value === "object" && !Array.isArray(value)) {
@@ -520,11 +743,12 @@ function deepMerge(target, source) {
   return target;
 }
 function setConfig(configList, config) {
+  var _a;
   const { assetRecordByPath, i18nRecord } = config;
   const resolvedConfigs = configList.map((item) => {
-    var _a;
+    var _a2;
     if (!item) return {};
-    return item.$schema ? (_a = extractDefaultsFromSchema(item)) != null ? _a : {} : item;
+    return item.$schema ? (_a2 = extractDefaultsFromSchema(item)) != null ? _a2 : {} : item;
   });
   const [first, ...rest] = resolvedConfigs;
   const mergedConfig = JSON.parse(JSON.stringify(first));
@@ -533,7 +757,9 @@ function setConfig(configList, config) {
   }
   if (i18nRecord) {
     const langCode = getLanguageCode();
-    resolveI18nRefs(mergedConfig, i18nRecord, langCode);
+    console.log("detect target langCode", langCode);
+    const runtime = Array.isArray(i18nRecord.runtime) ? mergeI18nRuntimes(i18nRecord.runtime) : (_a = i18nRecord.runtime) != null ? _a : {};
+    resolveI18nRefs(mergedConfig, __spreadProps(__spreadValues({}, i18nRecord), { runtime }), langCode);
   }
   resolveImagePaths(mergedConfig, assetRecordByPath);
   _cachedConfig = mergedConfig;
@@ -1338,6 +1564,31 @@ var _sdk = class _sdk {
   static isGoogle() {
     return _sdk.getCurChannel() === "google";
   }
+  /**
+   * 获取当前用户语言的 i18n 简码。
+   * 多源探测（querystring → localStorage → cookie → navigator → html tag）。
+   *
+   * @returns i18n 简码：en | zh | ja | ko | de | fr | es | pt | it | hi | bn | ur | ar | tr | ru | ms | id，默认 'en'
+   *
+   * @example
+   * const langCode = sdk.getLanguageCode(); // 'zh'
+   */
+  static getLanguageCode() {
+    return getLanguageCode();
+  }
+  /**
+   * 获取当前用户语言的业务代号。
+   * 多源探测（querystring → localStorage → cookie → navigator → html tag），
+   * 并映射到业务语言代号（区分简繁中文）。
+   *
+   * @returns 业务代号：EN | CN_S | CN_T | DE | FR | ES | JA | KO | PT | IT | HI | BN | UR | AR | TR | RU | MS | IN | ID，默认 'EN'
+   *
+   * @example
+   * const lang = sdk.getLanguage(); // 'CN_S'
+   */
+  static getLanguage() {
+    return getLanguage();
+  }
   /**
    * 设置主题配置，支持传入多份 JSON5 配置。
    * 每一份配置都可以是 JSON Schema（带 $schema 字段），会自动提取其中的 default 值。
@@ -1400,7 +1651,7 @@ var _sdk = class _sdk {
   }
 };
 /** Current version of the SDK */
-_sdk.version = "1.0.18-beta.1";
+_sdk.version = "1.0.18-beta.3";
 /** Current maximum width of the playable ad container in pixels */
 _sdk.maxWidth = Math.floor(window.innerWidth);
 /** Current maximum height of the playable ad container in pixels */
@@ -1430,6 +1681,8 @@ export {
   sdk as default,
   disableCustomCursor,
   enableCustomCursor,
+  getLanguage,
+  getLanguageCode,
   hideWechatGuide,
   removeWechatGuide,
   sdk,

package/dist/iife/index.js

@@ -1,5 +1,25 @@
 "use strict";
 (() => {
+  var __defProp = Object.defineProperty;
+  var __defProps = Object.defineProperties;
+  var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
+  var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+  var __hasOwnProp = Object.prototype.hasOwnProperty;
+  var __propIsEnum = Object.prototype.propertyIsEnumerable;
+  var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+  var __spreadValues = (a, b) => {
+    for (var prop in b || (b = {}))
+      if (__hasOwnProp.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    if (__getOwnPropSymbols)
+      for (var prop of __getOwnPropSymbols(b)) {
+        if (__propIsEnum.call(b, prop))
+          __defNormalProp(a, prop, b[prop]);
+      }
+    return a;
+  };
+  var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
+
   // src/events.ts
   var registeredEvents = {};
   function onEvent(event, fn, context, once) {
@@ -681,6 +701,196 @@
     }
   }
 
+  // src/language.ts
+  function readQuerystring(key) {
+    try {
+      if (typeof window === "undefined" || !window.location) return void 0;
+      const search = window.location.search || "";
+      if (!search) return void 0;
+      if (typeof URLSearchParams !== "undefined") {
+        const params = new URLSearchParams(search);
+        return params.get(key) || void 0;
+      }
+      const re = new RegExp("[?&]" + key.replace(/[.*+?^${}()|[\]\\]/g, "\\$&") + "=([^&#]*)");
+      const m = re.exec(search);
+      return m ? decodeURIComponent(m[1]) : void 0;
+    } catch (e) {
+      return void 0;
+    }
+  }
+  function readLocalStorage(key) {
+    try {
+      if (typeof localStorage === "undefined") return void 0;
+      return localStorage.getItem(key) || void 0;
+    } catch (e) {
+      return void 0;
+    }
+  }
+  function readCookie(name) {
+    try {
+      if (typeof document === "undefined" || !document.cookie) return void 0;
+      const re = new RegExp("(?:^|; )" + name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&") + "=([^;]*)");
+      const m = re.exec(document.cookie);
+      return m ? decodeURIComponent(m[1]) : void 0;
+    } catch (e) {
+      return void 0;
+    }
+  }
+  function readNavigatorLanguages() {
+    try {
+      if (typeof navigator === "undefined") return [];
+      const list = [];
+      const langs = navigator.languages;
+      if (Array.isArray(langs)) list.push(...langs);
+      if (navigator.language) list.push(navigator.language);
+      const userLang = navigator.userLanguage || navigator.browserLanguage;
+      if (userLang) list.push(userLang);
+      return list.filter(Boolean);
+    } catch (e) {
+      return [];
+    }
+  }
+  function readHtmlTag() {
+    try {
+      if (typeof document === "undefined" || !document.documentElement) return void 0;
+      return document.documentElement.lang || void 0;
+    } catch (e) {
+      return void 0;
+    }
+  }
+  function detectCandidates() {
+    return [
+      readQuerystring("lng"),
+      readLocalStorage("i18nextLng"),
+      readCookie("i18next"),
+      ...readNavigatorLanguages(),
+      readHtmlTag()
+    ];
+  }
+  var SUPPORTED_LANG_CODES = [
+    "en",
+    "zh",
+    "ja",
+    "ko",
+    "de",
+    "fr",
+    "es",
+    "pt",
+    "it",
+    "hi",
+    "bn",
+    "ur",
+    "ar",
+    "tr",
+    "ru",
+    "ms",
+    "id"
+  ];
+  function normalizeLangTag(tag) {
+    if (!tag || typeof tag !== "string") return void 0;
+    const primary = tag.split(/[-_]/)[0].toLowerCase();
+    return SUPPORTED_LANG_CODES.indexOf(primary) >= 0 ? primary : void 0;
+  }
+  function getLanguageCode() {
+    const candidates = detectCandidates();
+    for (const tag of candidates) {
+      const code = normalizeLangTag(tag);
+      if (code) return code;
+    }
+    return "en";
+  }
+  var LANGUAGE_MAP = {
+    // 英语
+    "en": "EN",
+    // 中文（简体）
+    "zh": "CN_S",
+    "zh-cn": "CN_S",
+    "zh-sg": "CN_S",
+    "zh-my": "CN_S",
+    "zh-hans": "CN_S",
+    "zh-hans-cn": "CN_S",
+    "zh-hans-sg": "CN_S",
+    "zh-hans-my": "CN_S",
+    // 中文（繁体）
+    "zh-tw": "CN_T",
+    "zh-hk": "CN_T",
+    "zh-mo": "CN_T",
+    "zh-hant": "CN_T",
+    "zh-hant-tw": "CN_T",
+    "zh-hant-hk": "CN_T",
+    "zh-hant-mo": "CN_T",
+    // 德语
+    "de": "DE",
+    // 法语
+    "fr": "FR",
+    // 西班牙语
+    "es": "ES",
+    // 日语
+    "ja": "JA",
+    // 韩语
+    "ko": "KO",
+    // 葡萄牙语
+    "pt": "PT",
+    // 意大利语
+    "it": "IT",
+    // 印地语
+    "hi": "HI",
+    // 孟加拉语
+    "bn": "BN",
+    // 乌尔都语
+    "ur": "UR",
+    // 阿拉伯语
+    "ar": "AR",
+    // 土耳其语
+    "tr": "TR",
+    // 俄语
+    "ru": "RU",
+    // 马来语
+    "ms": "MS",
+    // 印尼语
+    "id": "ID"
+  };
+  var SUPPORTED_PROJECT_LANGUAGES = /* @__PURE__ */ new Set([
+    "EN",
+    "CN_S",
+    "CN_T",
+    "DE",
+    "FR",
+    "ES",
+    "JA",
+    "KO",
+    "PT",
+    "IT",
+    "HI",
+    "BN",
+    "UR",
+    "AR",
+    "TR",
+    "RU",
+    "MS",
+    "IN",
+    "ID"
+  ]);
+  function resolveLanguageTag(tag) {
+    if (!tag || typeof tag !== "string") return void 0;
+    const normalized = tag.trim();
+    if (!normalized) return void 0;
+    const projectCode = normalized.toUpperCase().replace(/-/g, "_");
+    if (SUPPORTED_PROJECT_LANGUAGES.has(projectCode)) return projectCode;
+    const lower = normalized.toLowerCase();
+    if (LANGUAGE_MAP[lower]) return LANGUAGE_MAP[lower];
+    const primary = lower.split(/[-_]/)[0];
+    return LANGUAGE_MAP[primary];
+  }
+  function getLanguage() {
+    const candidates = detectCandidates();
+    for (const tag of candidates) {
+      const code = resolveLanguageTag(tag);
+      if (code) return code;
+    }
+    return "EN";
+  }
+
   // src/theme-config.ts
   function extractDefaultsFromSchema(schema) {
     if (!schema || typeof schema !== "object") return void 0;
@@ -699,18 +909,28 @@
     }
     return void 0;
   }
-  function getLanguageCode() {
-    try {
-      return (navigator.language || "en").split("-")[0].toLowerCase();
-    } catch (e) {
-      return "en";
-    }
-  }
   function lookupI18nRuntime(runtime, key, langCode) {
-    var _a, _b;
     const map = runtime[key];
     if (!map || typeof map !== "object") return void 0;
-    return (_b = (_a = map[langCode]) != null ? _a : map["en"]) != null ? _b : Object.values(map)[0];
+    const val = map[langCode];
+    if (val && val.length > 0) return val;
+    const enVal = map["en"];
+    if (enVal && enVal.length > 0) return enVal;
+    return Object.values(map).find((v) => typeof v === "string" && v.length > 0);
+  }
+  function mergeI18nRuntimes(runtimes) {
+    const merged = {};
+    for (const runtime of runtimes) {
+      if (!runtime) continue;
+      for (const [key, langMap] of Object.entries(runtime)) {
+        if (!merged[key]) {
+          merged[key] = __spreadValues({}, langMap);
+        } else {
+          merged[key] = __spreadValues(__spreadValues({}, merged[key]), langMap);
+        }
+      }
+    }
+    return merged;
   }
   function resolveI18nRefs(config, i18nRecord, langCode) {
     var _a;
@@ -724,6 +944,9 @@
           const resolved = lookupI18nRuntime(runtime, i18nKey, langCode);
           if (resolved !== void 0) {
             config[key] = resolved;
+          } else {
+            console.warn(`[i18n] Missing translation for key "${i18nKey}" (lang: ${langCode}), using key name as fallback`);
+            config[key] = i18nKey;
           }
         }
       } else if (value !== null && typeof value === "object" && !Array.isArray(value)) {
@@ -758,11 +981,12 @@
     return target;
   }
   function setConfig(configList, config) {
+    var _a;
     const { assetRecordByPath, i18nRecord } = config;
     const resolvedConfigs = configList.map((item) => {
-      var _a;
+      var _a2;
       if (!item) return {};
-      return item.$schema ? (_a = extractDefaultsFromSchema(item)) != null ? _a : {} : item;
+      return item.$schema ? (_a2 = extractDefaultsFromSchema(item)) != null ? _a2 : {} : item;
     });
     const [first, ...rest] = resolvedConfigs;
     const mergedConfig = JSON.parse(JSON.stringify(first));
@@ -771,7 +995,9 @@
     }
     if (i18nRecord) {
       const langCode = getLanguageCode();
-      resolveI18nRefs(mergedConfig, i18nRecord, langCode);
+      console.log("detect target langCode", langCode);
+      const runtime = Array.isArray(i18nRecord.runtime) ? mergeI18nRuntimes(i18nRecord.runtime) : (_a = i18nRecord.runtime) != null ? _a : {};
+      resolveI18nRefs(mergedConfig, __spreadProps(__spreadValues({}, i18nRecord), { runtime }), langCode);
     }
     resolveImagePaths(mergedConfig, assetRecordByPath);
     _cachedConfig = mergedConfig;
@@ -1576,6 +1802,31 @@
     static isGoogle() {
       return _sdk.getCurChannel() === "google";
     }
+    /**
+     * 获取当前用户语言的 i18n 简码。
+     * 多源探测（querystring → localStorage → cookie → navigator → html tag）。
+     *
+     * @returns i18n 简码：en | zh | ja | ko | de | fr | es | pt | it | hi | bn | ur | ar | tr | ru | ms | id，默认 'en'
+     *
+     * @example
+     * const langCode = sdk.getLanguageCode(); // 'zh'
+     */
+    static getLanguageCode() {
+      return getLanguageCode();
+    }
+    /**
+     * 获取当前用户语言的业务代号。
+     * 多源探测（querystring → localStorage → cookie → navigator → html tag），
+     * 并映射到业务语言代号（区分简繁中文）。
+     *
+     * @returns 业务代号：EN | CN_S | CN_T | DE | FR | ES | JA | KO | PT | IT | HI | BN | UR | AR | TR | RU | MS | IN | ID，默认 'EN'
+     *
+     * @example
+     * const lang = sdk.getLanguage(); // 'CN_S'
+     */
+    static getLanguage() {
+      return getLanguage();
+    }
     /**
      * 设置主题配置，支持传入多份 JSON5 配置。
      * 每一份配置都可以是 JSON Schema（带 $schema 字段），会自动提取其中的 default 值。
@@ -1638,7 +1889,7 @@
     }
   };
   /** Current version of the SDK */
-  _sdk.version = "1.0.18-beta.1";
+  _sdk.version = "1.0.18-beta.3";
   /** Current maximum width of the playable ad container in pixels */
   _sdk.maxWidth = Math.floor(window.innerWidth);
   /** Current maximum height of the playable ad container in pixels */

package/dist/index.d.mts

@@ -1,11 +1,15 @@
 /**
- * i18n 数据结构（仅 runtime，SDK 只处理游戏内运行时多语言）：
+ * i18n 数据结构（仅 runtime，SDK 只处理游戏内运行时多语言）
  *   runtime: { [key]: { [langCode]: "文案" } }
  *
+ * 当传入数组时，按顺序深度合并（后面的优先级更高），
+ * 支持全局 i18n + 主题级 i18n 分文件管理：
+ *   runtime: [I18nRuntime, themeI18n]  // 主题级覆盖全局
+ *
  * xplatform（配置平台 UI 标题）由外部配置平台自行解析，不传入 SDK。
  */
 type I18nRecord = {
-    runtime?: Record<string, Record<string, string>>;
+    runtime?: Record<string, Record<string, string>> | Record<string, Record<string, string>>[];
 };
 
 type EventName = 'playcraftInit' | 'playcraftReady' | 'playcraftStart' | 'playcraftInteractive' | 'playcraftInteraction' | 'playcraftChallengeStart' | 'playcraftChallengeProgress' | 'playcraftChallengeSuccess' | 'playcraftChallengeFailed' | 'playcraftResize' | 'playcraftPause' | 'playcraftResume' | 'playcraftVolume' | 'playcraftRetry' | 'playcraftFinish' | 'playcraftInstall';
@@ -262,6 +266,27 @@ declare class sdk {
      * 判断是否是 Google
      */
     static isGoogle(): boolean;
+    /**
+     * 获取当前用户语言的 i18n 简码。
+     * 多源探测（querystring → localStorage → cookie → navigator → html tag）。
+     *
+     * @returns i18n 简码：en | zh | ja | ko | de | fr | es | pt | it | hi | bn | ur | ar | tr | ru | ms | id，默认 'en'
+     *
+     * @example
+     * const langCode = sdk.getLanguageCode(); // 'zh'
+     */
+    static getLanguageCode(): string;
+    /**
+     * 获取当前用户语言的业务代号。
+     * 多源探测（querystring → localStorage → cookie → navigator → html tag），
+     * 并映射到业务语言代号（区分简繁中文）。
+     *
+     * @returns 业务代号：EN | CN_S | CN_T | DE | FR | ES | JA | KO | PT | IT | HI | BN | UR | AR | TR | RU | MS | IN | ID，默认 'EN'
+     *
+     * @example
+     * const lang = sdk.getLanguage(); // 'CN_S'
+     */
+    static getLanguage(): string;
     /**
      * 设置主题配置，支持传入多份 JSON5 配置。
      * 每一份配置都可以是 JSON Schema（带 $schema 字段），会自动提取其中的 default 值。
@@ -336,4 +361,31 @@ declare function hideWechatGuide(): void;
  */
 declare function removeWechatGuide(): void;
 
-export { type CursorOptions, type I18nRecord, sdk as default, disableCustomCursor, enableCustomCursor, hideWechatGuide, removeWechatGuide, sdk, showWechatGuide };
+/**
+ * 语言检测模块（零外部依赖）。
+ *
+ * 提供两个层级的语言获取：
+ *   - getLanguageCode()  → i18n 简码（en / zh / ja / ko …），用于 i18n.runtime 查表
+ *   - getLanguage()      → 业务语言代号（EN / CN_S / CN_T / DE …），用于游戏内资源选择
+ *
+ * 探测优先级（与 i18next-browser-languagedetector 保持一致）：
+ *   1. URL querystring (?lng=xx)
+ *   2. localStorage (i18nextLng)
+ *   3. cookie (i18next)
+ *   4. navigator.languages / navigator.language
+ *   5. <html lang="xx">
+ */
+/**
+ * 多源探测当前用户语言，并归一化为 i18n 简码。
+ *
+ * @returns i18n 简码：en | zh | ja | ko | de | fr | es | pt | it | hi | bn | ur | ar | tr | ru | ms | id，默认 'en'
+ */
+declare function getLanguageCode(): string;
+/**
+ * 多源探测当前用户语言，返回业务语言代号。
+ *
+ * @returns 业务代号：EN | CN_S | CN_T | DE | FR | ES | JA | KO | PT | IT | HI | BN | UR | AR | TR | RU | MS | IN | ID，默认 'EN'
+ */
+declare function getLanguage(): string;
+
+export { type CursorOptions, type I18nRecord, sdk as default, disableCustomCursor, enableCustomCursor, getLanguage, getLanguageCode, hideWechatGuide, removeWechatGuide, sdk, showWechatGuide };

package/dist/index.d.ts

@@ -1,11 +1,15 @@
 /**
- * i18n 数据结构（仅 runtime，SDK 只处理游戏内运行时多语言）：
+ * i18n 数据结构（仅 runtime，SDK 只处理游戏内运行时多语言）
  *   runtime: { [key]: { [langCode]: "文案" } }
  *
+ * 当传入数组时，按顺序深度合并（后面的优先级更高），
+ * 支持全局 i18n + 主题级 i18n 分文件管理：
+ *   runtime: [I18nRuntime, themeI18n]  // 主题级覆盖全局
+ *
  * xplatform（配置平台 UI 标题）由外部配置平台自行解析，不传入 SDK。
  */
 type I18nRecord = {
-    runtime?: Record<string, Record<string, string>>;
+    runtime?: Record<string, Record<string, string>> | Record<string, Record<string, string>>[];
 };
 
 type EventName = 'playcraftInit' | 'playcraftReady' | 'playcraftStart' | 'playcraftInteractive' | 'playcraftInteraction' | 'playcraftChallengeStart' | 'playcraftChallengeProgress' | 'playcraftChallengeSuccess' | 'playcraftChallengeFailed' | 'playcraftResize' | 'playcraftPause' | 'playcraftResume' | 'playcraftVolume' | 'playcraftRetry' | 'playcraftFinish' | 'playcraftInstall';
@@ -262,6 +266,27 @@ declare class sdk {
      * 判断是否是 Google
      */
     static isGoogle(): boolean;
+    /**
+     * 获取当前用户语言的 i18n 简码。
+     * 多源探测（querystring → localStorage → cookie → navigator → html tag）。
+     *
+     * @returns i18n 简码：en | zh | ja | ko | de | fr | es | pt | it | hi | bn | ur | ar | tr | ru | ms | id，默认 'en'
+     *
+     * @example
+     * const langCode = sdk.getLanguageCode(); // 'zh'
+     */
+    static getLanguageCode(): string;
+    /**
+     * 获取当前用户语言的业务代号。
+     * 多源探测（querystring → localStorage → cookie → navigator → html tag），
+     * 并映射到业务语言代号（区分简繁中文）。
+     *
+     * @returns 业务代号：EN | CN_S | CN_T | DE | FR | ES | JA | KO | PT | IT | HI | BN | UR | AR | TR | RU | MS | IN | ID，默认 'EN'
+     *
+     * @example
+     * const lang = sdk.getLanguage(); // 'CN_S'
+     */
+    static getLanguage(): string;
     /**
      * 设置主题配置，支持传入多份 JSON5 配置。
      * 每一份配置都可以是 JSON Schema（带 $schema 字段），会自动提取其中的 default 值。
@@ -336,4 +361,31 @@ declare function hideWechatGuide(): void;
  */
 declare function removeWechatGuide(): void;
 
-export { type CursorOptions, type I18nRecord, sdk as default, disableCustomCursor, enableCustomCursor, hideWechatGuide, removeWechatGuide, sdk, showWechatGuide };
+/**
+ * 语言检测模块（零外部依赖）。
+ *
+ * 提供两个层级的语言获取：
+ *   - getLanguageCode()  → i18n 简码（en / zh / ja / ko …），用于 i18n.runtime 查表
+ *   - getLanguage()      → 业务语言代号（EN / CN_S / CN_T / DE …），用于游戏内资源选择
+ *
+ * 探测优先级（与 i18next-browser-languagedetector 保持一致）：
+ *   1. URL querystring (?lng=xx)
+ *   2. localStorage (i18nextLng)
+ *   3. cookie (i18next)
+ *   4. navigator.languages / navigator.language
+ *   5. <html lang="xx">
+ */
+/**
+ * 多源探测当前用户语言，并归一化为 i18n 简码。
+ *
+ * @returns i18n 简码：en | zh | ja | ko | de | fr | es | pt | it | hi | bn | ur | ar | tr | ru | ms | id，默认 'en'
+ */
+declare function getLanguageCode(): string;
+/**
+ * 多源探测当前用户语言，返回业务语言代号。
+ *
+ * @returns 业务代号：EN | CN_S | CN_T | DE | FR | ES | JA | KO | PT | IT | HI | BN | UR | AR | TR | RU | MS | IN | ID，默认 'EN'
+ */
+declare function getLanguage(): string;
+
+export { type CursorOptions, type I18nRecord, sdk as default, disableCustomCursor, enableCustomCursor, getLanguage, getLanguageCode, hideWechatGuide, removeWechatGuide, sdk, showWechatGuide };

package/dist/index.js

@@ -1,8 +1,25 @@
 "use strict";
 var __defProp = Object.defineProperty;
+var __defProps = Object.defineProperties;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
@@ -23,6 +40,8 @@ __export(index_exports, {
   default: () => sdk,
   disableCustomCursor: () => disableCustomCursor,
   enableCustomCursor: () => enableCustomCursor,
+  getLanguage: () => getLanguage,
+  getLanguageCode: () => getLanguageCode,
   hideWechatGuide: () => hideWechatGuide,
   removeWechatGuide: () => removeWechatGuide,
   sdk: () => sdk,
@@ -475,6 +494,196 @@ function removeWechatGuide() {
   }
 }
 
+// src/language.ts
+function readQuerystring(key) {
+  try {
+    if (typeof window === "undefined" || !window.location) return void 0;
+    const search = window.location.search || "";
+    if (!search) return void 0;
+    if (typeof URLSearchParams !== "undefined") {
+      const params = new URLSearchParams(search);
+      return params.get(key) || void 0;
+    }
+    const re = new RegExp("[?&]" + key.replace(/[.*+?^${}()|[\]\\]/g, "\\$&") + "=([^&#]*)");
+    const m = re.exec(search);
+    return m ? decodeURIComponent(m[1]) : void 0;
+  } catch (e) {
+    return void 0;
+  }
+}
+function readLocalStorage(key) {
+  try {
+    if (typeof localStorage === "undefined") return void 0;
+    return localStorage.getItem(key) || void 0;
+  } catch (e) {
+    return void 0;
+  }
+}
+function readCookie(name) {
+  try {
+    if (typeof document === "undefined" || !document.cookie) return void 0;
+    const re = new RegExp("(?:^|; )" + name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&") + "=([^;]*)");
+    const m = re.exec(document.cookie);
+    return m ? decodeURIComponent(m[1]) : void 0;
+  } catch (e) {
+    return void 0;
+  }
+}
+function readNavigatorLanguages() {
+  try {
+    if (typeof navigator === "undefined") return [];
+    const list = [];
+    const langs = navigator.languages;
+    if (Array.isArray(langs)) list.push(...langs);
+    if (navigator.language) list.push(navigator.language);
+    const userLang = navigator.userLanguage || navigator.browserLanguage;
+    if (userLang) list.push(userLang);
+    return list.filter(Boolean);
+  } catch (e) {
+    return [];
+  }
+}
+function readHtmlTag() {
+  try {
+    if (typeof document === "undefined" || !document.documentElement) return void 0;
+    return document.documentElement.lang || void 0;
+  } catch (e) {
+    return void 0;
+  }
+}
+function detectCandidates() {
+  return [
+    readQuerystring("lng"),
+    readLocalStorage("i18nextLng"),
+    readCookie("i18next"),
+    ...readNavigatorLanguages(),
+    readHtmlTag()
+  ];
+}
+var SUPPORTED_LANG_CODES = [
+  "en",
+  "zh",
+  "ja",
+  "ko",
+  "de",
+  "fr",
+  "es",
+  "pt",
+  "it",
+  "hi",
+  "bn",
+  "ur",
+  "ar",
+  "tr",
+  "ru",
+  "ms",
+  "id"
+];
+function normalizeLangTag(tag) {
+  if (!tag || typeof tag !== "string") return void 0;
+  const primary = tag.split(/[-_]/)[0].toLowerCase();
+  return SUPPORTED_LANG_CODES.indexOf(primary) >= 0 ? primary : void 0;
+}
+function getLanguageCode() {
+  const candidates = detectCandidates();
+  for (const tag of candidates) {
+    const code = normalizeLangTag(tag);
+    if (code) return code;
+  }
+  return "en";
+}
+var LANGUAGE_MAP = {
+  // 英语
+  "en": "EN",
+  // 中文（简体）
+  "zh": "CN_S",
+  "zh-cn": "CN_S",
+  "zh-sg": "CN_S",
+  "zh-my": "CN_S",
+  "zh-hans": "CN_S",
+  "zh-hans-cn": "CN_S",
+  "zh-hans-sg": "CN_S",
+  "zh-hans-my": "CN_S",
+  // 中文（繁体）
+  "zh-tw": "CN_T",
+  "zh-hk": "CN_T",
+  "zh-mo": "CN_T",
+  "zh-hant": "CN_T",
+  "zh-hant-tw": "CN_T",
+  "zh-hant-hk": "CN_T",
+  "zh-hant-mo": "CN_T",
+  // 德语
+  "de": "DE",
+  // 法语
+  "fr": "FR",
+  // 西班牙语
+  "es": "ES",
+  // 日语
+  "ja": "JA",
+  // 韩语
+  "ko": "KO",
+  // 葡萄牙语
+  "pt": "PT",
+  // 意大利语
+  "it": "IT",
+  // 印地语
+  "hi": "HI",
+  // 孟加拉语
+  "bn": "BN",
+  // 乌尔都语
+  "ur": "UR",
+  // 阿拉伯语
+  "ar": "AR",
+  // 土耳其语
+  "tr": "TR",
+  // 俄语
+  "ru": "RU",
+  // 马来语
+  "ms": "MS",
+  // 印尼语
+  "id": "ID"
+};
+var SUPPORTED_PROJECT_LANGUAGES = /* @__PURE__ */ new Set([
+  "EN",
+  "CN_S",
+  "CN_T",
+  "DE",
+  "FR",
+  "ES",
+  "JA",
+  "KO",
+  "PT",
+  "IT",
+  "HI",
+  "BN",
+  "UR",
+  "AR",
+  "TR",
+  "RU",
+  "MS",
+  "IN",
+  "ID"
+]);
+function resolveLanguageTag(tag) {
+  if (!tag || typeof tag !== "string") return void 0;
+  const normalized = tag.trim();
+  if (!normalized) return void 0;
+  const projectCode = normalized.toUpperCase().replace(/-/g, "_");
+  if (SUPPORTED_PROJECT_LANGUAGES.has(projectCode)) return projectCode;
+  const lower = normalized.toLowerCase();
+  if (LANGUAGE_MAP[lower]) return LANGUAGE_MAP[lower];
+  const primary = lower.split(/[-_]/)[0];
+  return LANGUAGE_MAP[primary];
+}
+function getLanguage() {
+  const candidates = detectCandidates();
+  for (const tag of candidates) {
+    const code = resolveLanguageTag(tag);
+    if (code) return code;
+  }
+  return "EN";
+}
+
 // src/theme-config.ts
 function extractDefaultsFromSchema(schema) {
   if (!schema || typeof schema !== "object") return void 0;
@@ -493,18 +702,28 @@ function extractDefaultsFromSchema(schema) {
   }
   return void 0;
 }
-function getLanguageCode() {
-  try {
-    return (navigator.language || "en").split("-")[0].toLowerCase();
-  } catch (e) {
-    return "en";
-  }
-}
 function lookupI18nRuntime(runtime, key, langCode) {
-  var _a, _b;
   const map = runtime[key];
   if (!map || typeof map !== "object") return void 0;
-  return (_b = (_a = map[langCode]) != null ? _a : map["en"]) != null ? _b : Object.values(map)[0];
+  const val = map[langCode];
+  if (val && val.length > 0) return val;
+  const enVal = map["en"];
+  if (enVal && enVal.length > 0) return enVal;
+  return Object.values(map).find((v) => typeof v === "string" && v.length > 0);
+}
+function mergeI18nRuntimes(runtimes) {
+  const merged = {};
+  for (const runtime of runtimes) {
+    if (!runtime) continue;
+    for (const [key, langMap] of Object.entries(runtime)) {
+      if (!merged[key]) {
+        merged[key] = __spreadValues({}, langMap);
+      } else {
+        merged[key] = __spreadValues(__spreadValues({}, merged[key]), langMap);
+      }
+    }
+  }
+  return merged;
 }
 function resolveI18nRefs(config, i18nRecord, langCode) {
   var _a;
@@ -518,6 +737,9 @@ function resolveI18nRefs(config, i18nRecord, langCode) {
         const resolved = lookupI18nRuntime(runtime, i18nKey, langCode);
         if (resolved !== void 0) {
           config[key] = resolved;
+        } else {
+          console.warn(`[i18n] Missing translation for key "${i18nKey}" (lang: ${langCode}), using key name as fallback`);
+          config[key] = i18nKey;
         }
       }
     } else if (value !== null && typeof value === "object" && !Array.isArray(value)) {
@@ -552,11 +774,12 @@ function deepMerge(target, source) {
   return target;
 }
 function setConfig(configList, config) {
+  var _a;
   const { assetRecordByPath, i18nRecord } = config;
   const resolvedConfigs = configList.map((item) => {
-    var _a;
+    var _a2;
     if (!item) return {};
-    return item.$schema ? (_a = extractDefaultsFromSchema(item)) != null ? _a : {} : item;
+    return item.$schema ? (_a2 = extractDefaultsFromSchema(item)) != null ? _a2 : {} : item;
   });
   const [first, ...rest] = resolvedConfigs;
   const mergedConfig = JSON.parse(JSON.stringify(first));
@@ -565,7 +788,9 @@ function setConfig(configList, config) {
   }
   if (i18nRecord) {
     const langCode = getLanguageCode();
-    resolveI18nRefs(mergedConfig, i18nRecord, langCode);
+    console.log("detect target langCode", langCode);
+    const runtime = Array.isArray(i18nRecord.runtime) ? mergeI18nRuntimes(i18nRecord.runtime) : (_a = i18nRecord.runtime) != null ? _a : {};
+    resolveI18nRefs(mergedConfig, __spreadProps(__spreadValues({}, i18nRecord), { runtime }), langCode);
   }
   resolveImagePaths(mergedConfig, assetRecordByPath);
   _cachedConfig = mergedConfig;
@@ -1370,6 +1595,31 @@ var _sdk = class _sdk {
   static isGoogle() {
     return _sdk.getCurChannel() === "google";
   }
+  /**
+   * 获取当前用户语言的 i18n 简码。
+   * 多源探测（querystring → localStorage → cookie → navigator → html tag）。
+   *
+   * @returns i18n 简码：en | zh | ja | ko | de | fr | es | pt | it | hi | bn | ur | ar | tr | ru | ms | id，默认 'en'
+   *
+   * @example
+   * const langCode = sdk.getLanguageCode(); // 'zh'
+   */
+  static getLanguageCode() {
+    return getLanguageCode();
+  }
+  /**
+   * 获取当前用户语言的业务代号。
+   * 多源探测（querystring → localStorage → cookie → navigator → html tag），
+   * 并映射到业务语言代号（区分简繁中文）。
+   *
+   * @returns 业务代号：EN | CN_S | CN_T | DE | FR | ES | JA | KO | PT | IT | HI | BN | UR | AR | TR | RU | MS | IN | ID，默认 'EN'
+   *
+   * @example
+   * const lang = sdk.getLanguage(); // 'CN_S'
+   */
+  static getLanguage() {
+    return getLanguage();
+  }
   /**
    * 设置主题配置，支持传入多份 JSON5 配置。
    * 每一份配置都可以是 JSON Schema（带 $schema 字段），会自动提取其中的 default 值。
@@ -1432,7 +1682,7 @@ var _sdk = class _sdk {
   }
 };
 /** Current version of the SDK */
-_sdk.version = "1.0.18-beta.1";
+_sdk.version = "1.0.18-beta.3";
 /** Current maximum width of the playable ad container in pixels */
 _sdk.maxWidth = Math.floor(window.innerWidth);
 /** Current maximum height of the playable ad container in pixels */
@@ -1462,6 +1712,8 @@ window.PlayableSDK = sdk;
 0 && (module.exports = {
   disableCustomCursor,
   enableCustomCursor,
+  getLanguage,
+  getLanguageCode,
   hideWechatGuide,
   removeWechatGuide,
   sdk,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@playcraft/adsdk",
-  "version": "1.0.18-beta.1",
+  "version": "1.0.18-beta.3",
   "description": "统一的 Playable SDK，支持 MRAID、Google、Facebook、Vungle、BigoAds 等多广告渠道",
   "main": "dist/index.js",
   "module": "dist/esm/index.js",