@playcraft/adsdk 1.0.17 → 1.0.18-beta.2

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025-present Smoud
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025-present Smoud
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/defines.d.ts

@@ -1,130 +1,130 @@
-declare const mraid: {
-  getVersion: () => string;  // MRAID 规范必需：返回 MRAID 版本（如 "3.0"）
-  isReady: () => boolean;
-  isViewable: () => boolean;
-  getState: () => string;
-  addEventListener: (
-    event: 'viewableChange' | 'sizeChange' | 'ready' | 'audioVolumeChange' | 'stateChange' | 'error' | 'orientationChange' | 'resize',
-    callback: (...args: any[]) => void
-  ) => void;
-  removeEventListener: (
-    event: 'viewableChange' | 'sizeChange' | 'ready' | 'audioVolumeChange' | 'stateChange' | 'error' | 'orientationChange' | 'resize',
-    callback: (...args: any[]) => void
-  ) => void;
-  getMaxSize: () => { width: number; height: number };
-  openStoreUrl: () => void;
-  open: (url: string) => void;
-  close: () => void;  // Unity Ads 必需：关闭广告
-  getAudioVolume: () => number;
-  fireTrackingEvent?: (event: string) => void;  // Unity Ads 可选：跟踪事件
-  preloadStore?: () => void;
-};
-
-declare const dapi: {
-  addEventListener: (
-    event: 'viewableChange' | 'adResized' | 'ready' | 'audioVolumeChange' | 'error',
-    callback: (...args: any[]) => void
-  ) => void;
-  removeEventListener: (
-    event: 'viewableChange' | 'adResized' | 'ready' | 'audioVolumeChange' | 'error',
-    callback: (...args: any[]) => void
-  ) => void;
-  getScreenSize: () => { width: number; height: number };
-  openStoreUrl: () => void;
-  getAudioVolume: () => number;
-  isViewable: () => boolean;
-  isReady: () => boolean;
-};
-
-declare const NUC: {
-  trigger: {
-    convert: (destinationUrl: string) => void;
-    tryAgain: Function;
-  };
-};
-
-declare const ScPlayableAd: { onCTAClick: () => void };
-
-// Adikteev 占位符变量
-declare const AK_CLICK_DESTINATION_URL: string;
-declare const AK_CLICK_PIXEL_URL: string;
-declare const FbPlayableAd: { onCTAClick: () => void };
-declare const smxTracking: { redirect: () => void };
-declare const ExitApi: { exit: () => void };
-
-declare const AD_NETWORK:
-  | 'preview'
-  | 'applovin'
-  | 'unity'
-  | 'google'
-  | 'ironsource'
-  | 'facebook'
-  | 'moloco'
-  | 'mintegral'
-  | 'vungle'
-  | 'adcolony'
-  | 'tapjoy'
-  | 'snapchat'
-  | 'tiktok'
-  | 'appreciate'
-  | 'chartboost'
-  | 'pangle'
-  | 'mytarget'
-  | 'liftoff'
-  | 'smadex'
-  | 'adikteev'
-  | 'bigabid'
-  | 'inmobi'
-  | 'bigoads';
-
-declare const AD_PROTOCOL: 'mraid' | 'dapi' | 'nucleo' | 'none';
-declare const GOOGLE_PLAY_URL: string;
-declare const APP_STORE_URL: string;
-declare const BUILD_HASH: string;
-
-interface Window {
-  PlayableSDK: any;
-  ADS_MRAID_CONFIG: {
-    landUrl: string;
-  };
-
-  // AppLovin Playable Analytics
-  // 文档: https://support.axon.ai/en/growth/promoting-your-apps/creatives/playable-analytics-integration
-  ALPlayableAnalytics?: {
-    trackEvent: (event: string) => void;
-  };
-
-  // BigoAds SDK
-  // 文档: https://www.bigoads.com/help/detail?id=143&moduleId=7&currentLan=CN
-  BGY_MRAID: {
-    open: () => void;           // 打开应用商店/推广地址
-    gameReady: () => void;      // 素材准备完毕时调用
-    gameEnd: () => void;        // 游戏结束时调用
-    isViewable: () => boolean;
-    addEventListener: (event: string, callback: (...args: any[]) => void) => void;
-    removeEventListener: (event: string, callback: (...args: any[]) => void) => void;
-  };
-
-  // Mintegral functions
-  gameReady: Function;
-  gameEnd: Function;
-  gameRetry: Function;
-  install: Function;
-  mintGameStart: Function;
-  mintGameClose: Function;
-
-  // Tapjoy functions
-  TJ_API: {
-    objectiveComplete: Function;
-    playableFinished: Function;
-    gameplayFinished: Function;
-    setPlayableBuild: Function;
-    setPlayableAPI: Function;
-    click: Function;
-  };
-
-  BIGABID_BIDTIMEMACROS?: Record<string, string>
-  INMOBI_DSPMACROS?: Record<string, string>
-
-  openAppStore: Function;
-}
+declare const mraid: {
+  getVersion: () => string;  // MRAID 规范必需：返回 MRAID 版本（如 "3.0"）
+  isReady: () => boolean;
+  isViewable: () => boolean;
+  getState: () => string;
+  addEventListener: (
+    event: 'viewableChange' | 'sizeChange' | 'ready' | 'audioVolumeChange' | 'stateChange' | 'error' | 'orientationChange' | 'resize',
+    callback: (...args: any[]) => void
+  ) => void;
+  removeEventListener: (
+    event: 'viewableChange' | 'sizeChange' | 'ready' | 'audioVolumeChange' | 'stateChange' | 'error' | 'orientationChange' | 'resize',
+    callback: (...args: any[]) => void
+  ) => void;
+  getMaxSize: () => { width: number; height: number };
+  openStoreUrl: () => void;
+  open: (url: string) => void;
+  close: () => void;  // Unity Ads 必需：关闭广告
+  getAudioVolume: () => number;
+  fireTrackingEvent?: (event: string) => void;  // Unity Ads 可选：跟踪事件
+  preloadStore?: () => void;
+};
+
+declare const dapi: {
+  addEventListener: (
+    event: 'viewableChange' | 'adResized' | 'ready' | 'audioVolumeChange' | 'error',
+    callback: (...args: any[]) => void
+  ) => void;
+  removeEventListener: (
+    event: 'viewableChange' | 'adResized' | 'ready' | 'audioVolumeChange' | 'error',
+    callback: (...args: any[]) => void
+  ) => void;
+  getScreenSize: () => { width: number; height: number };
+  openStoreUrl: () => void;
+  getAudioVolume: () => number;
+  isViewable: () => boolean;
+  isReady: () => boolean;
+};
+
+declare const NUC: {
+  trigger: {
+    convert: (destinationUrl: string) => void;
+    tryAgain: Function;
+  };
+};
+
+declare const ScPlayableAd: { onCTAClick: () => void };
+
+// Adikteev 占位符变量
+declare const AK_CLICK_DESTINATION_URL: string;
+declare const AK_CLICK_PIXEL_URL: string;
+declare const FbPlayableAd: { onCTAClick: () => void };
+declare const smxTracking: { redirect: () => void };
+declare const ExitApi: { exit: () => void };
+
+declare const AD_NETWORK:
+  | 'preview'
+  | 'applovin'
+  | 'unity'
+  | 'google'
+  | 'ironsource'
+  | 'facebook'
+  | 'moloco'
+  | 'mintegral'
+  | 'vungle'
+  | 'adcolony'
+  | 'tapjoy'
+  | 'snapchat'
+  | 'tiktok'
+  | 'appreciate'
+  | 'chartboost'
+  | 'pangle'
+  | 'mytarget'
+  | 'liftoff'
+  | 'smadex'
+  | 'adikteev'
+  | 'bigabid'
+  | 'inmobi'
+  | 'bigoads';
+
+declare const AD_PROTOCOL: 'mraid' | 'dapi' | 'nucleo' | 'none';
+declare const GOOGLE_PLAY_URL: string;
+declare const APP_STORE_URL: string;
+declare const BUILD_HASH: string;
+
+interface Window {
+  PlayableSDK: any;
+  ADS_MRAID_CONFIG: {
+    landUrl: string;
+  };
+
+  // AppLovin Playable Analytics
+  // 文档: https://support.axon.ai/en/growth/promoting-your-apps/creatives/playable-analytics-integration
+  ALPlayableAnalytics?: {
+    trackEvent: (event: string) => void;
+  };
+
+  // BigoAds SDK
+  // 文档: https://www.bigoads.com/help/detail?id=143&moduleId=7&currentLan=CN
+  BGY_MRAID: {
+    open: () => void;           // 打开应用商店/推广地址
+    gameReady: () => void;      // 素材准备完毕时调用
+    gameEnd: () => void;        // 游戏结束时调用
+    isViewable: () => boolean;
+    addEventListener: (event: string, callback: (...args: any[]) => void) => void;
+    removeEventListener: (event: string, callback: (...args: any[]) => void) => void;
+  };
+
+  // Mintegral functions
+  gameReady: Function;
+  gameEnd: Function;
+  gameRetry: Function;
+  install: Function;
+  mintGameStart: Function;
+  mintGameClose: Function;
+
+  // Tapjoy functions
+  TJ_API: {
+    objectiveComplete: Function;
+    playableFinished: Function;
+    gameplayFinished: Function;
+    setPlayableBuild: Function;
+    setPlayableAPI: Function;
+    click: Function;
+  };
+
+  BIGABID_BIDTIMEMACROS?: Record<string, string>
+  INMOBI_DSPMACROS?: Record<string, string>
+
+  openAppStore: Function;
+}

package/dist/esm/index.js

@@ -443,6 +443,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,6 +651,31 @@ function extractDefaultsFromSchema(schema) {
   }
   return void 0;
 }
+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];
+}
+function resolveI18nRefs(config, i18nRecord, langCode) {
+  var _a;
+  if (!config || typeof config !== "object" || Array.isArray(config)) return;
+  const runtime = (_a = i18nRecord.runtime) != null ? _a : {};
+  for (const key of Object.keys(config)) {
+    const value = config[key];
+    if (typeof value === "string") {
+      if (value.startsWith("i18n.runtime.")) {
+        const i18nKey = value.slice("i18n.runtime.".length);
+        const resolved = lookupI18nRuntime(runtime, i18nKey, langCode);
+        if (resolved !== void 0) {
+          config[key] = resolved;
+        }
+      }
+    } else if (value !== null && typeof value === "object" && !Array.isArray(value)) {
+      resolveI18nRefs(value, i18nRecord, langCode);
+    }
+  }
+}
 function resolveImagePaths(config, assetRecordByPath) {
   if (!assetRecordByPath || !config || typeof config !== "object") return;
   for (const key of Object.keys(config)) {
@@ -488,7 +703,7 @@ function deepMerge(target, source) {
   return target;
 }
 function setConfig(configList, config) {
-  const { assetRecordByPath } = config;
+  const { assetRecordByPath, i18nRecord } = config;
   const resolvedConfigs = configList.map((item) => {
     var _a;
     if (!item) return {};
@@ -499,6 +714,11 @@ function setConfig(configList, config) {
   for (const data of rest) {
     deepMerge(mergedConfig, data);
   }
+  if (i18nRecord) {
+    const langCode = getLanguageCode();
+    console.log("detect target langCode", langCode);
+    resolveI18nRefs(mergedConfig, i18nRecord, langCode);
+  }
   resolveImagePaths(mergedConfig, assetRecordByPath);
   _cachedConfig = mergedConfig;
 }
@@ -1302,6 +1522,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 值。
@@ -1364,7 +1609,7 @@ var _sdk = class _sdk {
   }
 };
 /** Current version of the SDK */
-_sdk.version = "1.0.17";
+_sdk.version = "1.0.18-beta.2";
 /** 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 */
@@ -1394,6 +1639,8 @@ export {
   sdk as default,
   disableCustomCursor,
   enableCustomCursor,
+  getLanguage,
+  getLanguageCode,
   hideWechatGuide,
   removeWechatGuide,
   sdk,