@playcraft/adsdk 1.0.18-beta.2 → 1.0.18-beta.4

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) {
@@ -512,6 +532,7 @@ function detectCandidates() {
 var SUPPORTED_LANG_CODES = [
   "en",
   "zh",
+  "zh-TW",
   "ja",
   "ko",
   "de",
@@ -528,9 +549,31 @@ var SUPPORTED_LANG_CODES = [
   "ms",
   "id"
 ];
+var LANG_TAG_TO_I18N_CODE = {
+  // 简体中文 → zh
+  "zh": "zh",
+  "zh-cn": "zh",
+  "zh-sg": "zh",
+  "zh-my": "zh",
+  "zh-hans": "zh",
+  "zh-hans-cn": "zh",
+  "zh-hans-sg": "zh",
+  "zh-hans-my": "zh",
+  // 繁体中文 → zh-TW
+  "zh-tw": "zh-TW",
+  "zh-hk": "zh-TW",
+  "zh-mo": "zh-TW",
+  "zh-hant": "zh-TW",
+  "zh-hant-tw": "zh-TW",
+  "zh-hant-hk": "zh-TW",
+  "zh-hant-mo": "zh-TW"
+};
 function normalizeLangTag(tag) {
   if (!tag || typeof tag !== "string") return void 0;
-  const primary = tag.split(/[-_]/)[0].toLowerCase();
+  const lower = tag.toLowerCase();
+  const mapped = LANG_TAG_TO_I18N_CODE[lower];
+  if (mapped) return mapped;
+  const primary = lower.split(/[-_]/)[0];
   return SUPPORTED_LANG_CODES.indexOf(primary) >= 0 ? primary : void 0;
 }
 function getLanguageCode() {
@@ -541,97 +584,6 @@ function getLanguageCode() {
   }
   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) {
@@ -651,11 +603,34 @@ function extractDefaultsFromSchema(schema) {
   }
   return void 0;
 }
+var LANG_FALLBACK_MAP = {
+  // 繁体中文：优先查专用键，没有则回退通用简体，最后回退 en
+  "zh-TW": ["zh-TW", "zh", "en"]
+};
 function lookupI18nRuntime(runtime, key, langCode) {
-  var _a, _b;
+  var _a;
   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 fallbackChain = (_a = LANG_FALLBACK_MAP[langCode]) != null ? _a : [langCode, "en"];
+  for (const code of fallbackChain) {
+    const val = map[code];
+    if (val && val.length > 0) return val;
+  }
+  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;
@@ -669,6 +644,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)) {
@@ -703,11 +681,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));
@@ -717,7 +696,8 @@ function setConfig(configList, config) {
   if (i18nRecord) {
     const langCode = getLanguageCode();
     console.log("detect target langCode", langCode);
-    resolveI18nRefs(mergedConfig, i18nRecord, 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;
@@ -1534,19 +1514,6 @@ var _sdk = class _sdk {
   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 值。
@@ -1609,7 +1576,7 @@ var _sdk = class _sdk {
   }
 };
 /** Current version of the SDK */
-_sdk.version = "1.0.18-beta.2";
+_sdk.version = "1.0.18-beta.4";
 /** 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 */
@@ -1639,7 +1606,6 @@ export {
   sdk as default,
   disableCustomCursor,
   enableCustomCursor,
-  getLanguage,
   getLanguageCode,
   hideWechatGuide,
   removeWechatGuide,

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) {
@@ -750,6 +770,7 @@
   var SUPPORTED_LANG_CODES = [
     "en",
     "zh",
+    "zh-TW",
     "ja",
     "ko",
     "de",
@@ -766,9 +787,31 @@
     "ms",
     "id"
   ];
+  var LANG_TAG_TO_I18N_CODE = {
+    // 简体中文 → zh
+    "zh": "zh",
+    "zh-cn": "zh",
+    "zh-sg": "zh",
+    "zh-my": "zh",
+    "zh-hans": "zh",
+    "zh-hans-cn": "zh",
+    "zh-hans-sg": "zh",
+    "zh-hans-my": "zh",
+    // 繁体中文 → zh-TW
+    "zh-tw": "zh-TW",
+    "zh-hk": "zh-TW",
+    "zh-mo": "zh-TW",
+    "zh-hant": "zh-TW",
+    "zh-hant-tw": "zh-TW",
+    "zh-hant-hk": "zh-TW",
+    "zh-hant-mo": "zh-TW"
+  };
   function normalizeLangTag(tag) {
     if (!tag || typeof tag !== "string") return void 0;
-    const primary = tag.split(/[-_]/)[0].toLowerCase();
+    const lower = tag.toLowerCase();
+    const mapped = LANG_TAG_TO_I18N_CODE[lower];
+    if (mapped) return mapped;
+    const primary = lower.split(/[-_]/)[0];
     return SUPPORTED_LANG_CODES.indexOf(primary) >= 0 ? primary : void 0;
   }
   function getLanguageCode() {
@@ -779,97 +822,6 @@
     }
     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) {
@@ -889,11 +841,34 @@
     }
     return void 0;
   }
+  var LANG_FALLBACK_MAP = {
+    // 繁体中文：优先查专用键，没有则回退通用简体，最后回退 en
+    "zh-TW": ["zh-TW", "zh", "en"]
+  };
   function lookupI18nRuntime(runtime, key, langCode) {
-    var _a, _b;
+    var _a;
     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 fallbackChain = (_a = LANG_FALLBACK_MAP[langCode]) != null ? _a : [langCode, "en"];
+    for (const code of fallbackChain) {
+      const val = map[code];
+      if (val && val.length > 0) return val;
+    }
+    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;
@@ -907,6 +882,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)) {
@@ -941,11 +919,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));
@@ -955,7 +934,8 @@
     if (i18nRecord) {
       const langCode = getLanguageCode();
       console.log("detect target langCode", langCode);
-      resolveI18nRefs(mergedConfig, i18nRecord, 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;
@@ -1772,19 +1752,6 @@
     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 值。
@@ -1847,7 +1814,7 @@
     }
   };
   /** Current version of the SDK */
-  _sdk.version = "1.0.18-beta.2";
+  _sdk.version = "1.0.18-beta.4";
   /** 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';
@@ -272,17 +276,6 @@ declare class sdk {
      * 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 值。
@@ -374,14 +367,8 @@ declare function removeWechatGuide(): void;
 /**
  * 多源探测当前用户语言，并归一化为 i18n 简码。
  *
- * @returns i18n 简码：en | zh | ja | ko | de | fr | es | pt | it | hi | bn | ur | ar | tr | ru | ms | id，默认 'en'
+ * @returns i18n 简码：en | zh | zh-TW | 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 };
+export { type CursorOptions, type I18nRecord, sdk as default, disableCustomCursor, enableCustomCursor, 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';
@@ -272,17 +276,6 @@ declare class sdk {
      * 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 值。
@@ -374,14 +367,8 @@ declare function removeWechatGuide(): void;
 /**
  * 多源探测当前用户语言，并归一化为 i18n 简码。
  *
- * @returns i18n 简码：en | zh | ja | ko | de | fr | es | pt | it | hi | bn | ur | ar | tr | ru | ms | id，默认 'en'
+ * @returns i18n 简码：en | zh | zh-TW | 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 };
+export { type CursorOptions, type I18nRecord, sdk as default, disableCustomCursor, enableCustomCursor, 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,7 +40,6 @@ __export(index_exports, {
   default: () => sdk,
   disableCustomCursor: () => disableCustomCursor,
   enableCustomCursor: () => enableCustomCursor,
-  getLanguage: () => getLanguage,
   getLanguageCode: () => getLanguageCode,
   hideWechatGuide: () => hideWechatGuide,
   removeWechatGuide: () => removeWechatGuide,
@@ -546,6 +562,7 @@ function detectCandidates() {
 var SUPPORTED_LANG_CODES = [
   "en",
   "zh",
+  "zh-TW",
   "ja",
   "ko",
   "de",
@@ -562,9 +579,31 @@ var SUPPORTED_LANG_CODES = [
   "ms",
   "id"
 ];
+var LANG_TAG_TO_I18N_CODE = {
+  // 简体中文 → zh
+  "zh": "zh",
+  "zh-cn": "zh",
+  "zh-sg": "zh",
+  "zh-my": "zh",
+  "zh-hans": "zh",
+  "zh-hans-cn": "zh",
+  "zh-hans-sg": "zh",
+  "zh-hans-my": "zh",
+  // 繁体中文 → zh-TW
+  "zh-tw": "zh-TW",
+  "zh-hk": "zh-TW",
+  "zh-mo": "zh-TW",
+  "zh-hant": "zh-TW",
+  "zh-hant-tw": "zh-TW",
+  "zh-hant-hk": "zh-TW",
+  "zh-hant-mo": "zh-TW"
+};
 function normalizeLangTag(tag) {
   if (!tag || typeof tag !== "string") return void 0;
-  const primary = tag.split(/[-_]/)[0].toLowerCase();
+  const lower = tag.toLowerCase();
+  const mapped = LANG_TAG_TO_I18N_CODE[lower];
+  if (mapped) return mapped;
+  const primary = lower.split(/[-_]/)[0];
   return SUPPORTED_LANG_CODES.indexOf(primary) >= 0 ? primary : void 0;
 }
 function getLanguageCode() {
@@ -575,97 +614,6 @@ function getLanguageCode() {
   }
   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) {
@@ -685,11 +633,34 @@ function extractDefaultsFromSchema(schema) {
   }
   return void 0;
 }
+var LANG_FALLBACK_MAP = {
+  // 繁体中文：优先查专用键，没有则回退通用简体，最后回退 en
+  "zh-TW": ["zh-TW", "zh", "en"]
+};
 function lookupI18nRuntime(runtime, key, langCode) {
-  var _a, _b;
+  var _a;
   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 fallbackChain = (_a = LANG_FALLBACK_MAP[langCode]) != null ? _a : [langCode, "en"];
+  for (const code of fallbackChain) {
+    const val = map[code];
+    if (val && val.length > 0) return val;
+  }
+  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;
@@ -703,6 +674,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)) {
@@ -737,11 +711,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));
@@ -751,7 +726,8 @@ function setConfig(configList, config) {
   if (i18nRecord) {
     const langCode = getLanguageCode();
     console.log("detect target langCode", langCode);
-    resolveI18nRefs(mergedConfig, i18nRecord, 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;
@@ -1568,19 +1544,6 @@ var _sdk = class _sdk {
   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 值。
@@ -1643,7 +1606,7 @@ var _sdk = class _sdk {
   }
 };
 /** Current version of the SDK */
-_sdk.version = "1.0.18-beta.2";
+_sdk.version = "1.0.18-beta.4";
 /** 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 */
@@ -1673,7 +1636,6 @@ window.PlayableSDK = sdk;
 0 && (module.exports = {
   disableCustomCursor,
   enableCustomCursor,
-  getLanguage,
   getLanguageCode,
   hideWechatGuide,
   removeWechatGuide,

package/package.json

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