@playcraft/adsdk 1.0.12 → 1.0.13

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

@@ -693,6 +693,73 @@ function removeWechatGuide() {
   }
 }
 
+// src/theme-config.ts
+function extractDefaultsFromSchema(schema) {
+  if (!schema || typeof schema !== "object") return void 0;
+  if (schema.type === "object" && schema.properties) {
+    const result = {};
+    for (const [key, propSchema] of Object.entries(schema.properties)) {
+      const val = extractDefaultsFromSchema(propSchema);
+      if (val !== void 0) {
+        result[key] = val;
+      }
+    }
+    return Object.keys(result).length > 0 ? result : void 0;
+  }
+  if ("default" in schema) {
+    return schema.default;
+  }
+  return void 0;
+}
+function resolveImagePaths(config, assetRecordByPath) {
+  if (!assetRecordByPath || !config || typeof config !== "object") return;
+  for (const key of Object.keys(config)) {
+    const value = config[key];
+    if (typeof value === "string") {
+      if (assetRecordByPath[value]) {
+        config[key] = assetRecordByPath[value];
+      }
+    } else if (value !== null && typeof value === "object" && !Array.isArray(value)) {
+      resolveImagePaths(value, assetRecordByPath);
+    }
+  }
+}
+var _cachedConfig = null;
+function deepMerge(target, source) {
+  for (const key of Object.keys(source)) {
+    const srcVal = source[key];
+    const tgtVal = target[key];
+    if (srcVal !== null && typeof srcVal === "object" && !Array.isArray(srcVal) && tgtVal !== null && typeof tgtVal === "object" && !Array.isArray(tgtVal)) {
+      deepMerge(tgtVal, srcVal);
+    } else if (srcVal !== void 0) {
+      target[key] = srcVal;
+    }
+  }
+  return target;
+}
+function setConfig(configList, config) {
+  const { assetRecordByPath } = config;
+  const resolvedConfigs = configList.map((item) => {
+    var _a;
+    if (!item) return {};
+    return item.$schema ? (_a = extractDefaultsFromSchema(item)) != null ? _a : {} : item;
+  });
+  const [first, ...rest] = resolvedConfigs;
+  const mergedConfig = JSON.parse(JSON.stringify(first));
+  for (const data of rest) {
+    deepMerge(mergedConfig, data);
+  }
+  resolveImagePaths(mergedConfig, assetRecordByPath);
+  _cachedConfig = mergedConfig;
+}
+function getConfig() {
+  if (!_cachedConfig) {
+    console.warn("[PlayableSDK] Theme config not initialized. Call setConfig() first.");
+    return {};
+  }
+  return _cachedConfig;
+}
+
 // src/core.ts
 var destinationUrl = "";
 var isSDKInitialized = false;
@@ -1439,9 +1506,43 @@ var _sdk = class _sdk {
   static isGoogle() {
     return _sdk.getCurChannel() === "google";
   }
+  /**
+   * 设置主题配置，支持传入多份 JSON5 配置。
+   * 每一份配置都可以是 JSON Schema（带 $schema 字段），会自动提取其中的 default 值。
+   * 所有配置按顺序依次深度合并，后面的优先级更高。
+   *
+   * @param configList - 配置数组，每一项可以是：
+   *   - JSON Schema（带 $schema 字段）：自动提取 default 值后参与合并
+   *   - 普通配置对象：直接参与合并
+   * @param config - 额外配置项
+   *   - config.assetRecordByPath: 相对路径到已解析 URL 的映射
+   *
+   * @example
+   * sdk.setConfig(
+   *   [schemaA, schemaB, themeData],
+   *   { assetRecordByPath: imageAssets }
+   * );
+   */
+  static setConfig(configList, config) {
+    setConfig(configList, config);
+  }
+  /**
+   * 获取合并后的主题配置。
+   * 返回 schema 默认值与用户主题数据深度合并后的结果。
+   * 必须先调用 sdk.setConfig() 才能使用此方法。
+   *
+   * @returns 合并后的主题配置对象
+   *
+   * @example
+   * const config = sdk.getConfig();
+   * console.log(config.primaryColor); // '#ff0000'
+   */
+  static getConfig() {
+    return getConfig();
+  }
 };
 /** Current version of the SDK */
-_sdk.version = "1.0.12";
+_sdk.version = "1.0.13";
 /** 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/iife/index.js

@@ -695,6 +695,73 @@
     }
   }
 
+  // src/theme-config.ts
+  function extractDefaultsFromSchema(schema) {
+    if (!schema || typeof schema !== "object") return void 0;
+    if (schema.type === "object" && schema.properties) {
+      const result = {};
+      for (const [key, propSchema] of Object.entries(schema.properties)) {
+        const val = extractDefaultsFromSchema(propSchema);
+        if (val !== void 0) {
+          result[key] = val;
+        }
+      }
+      return Object.keys(result).length > 0 ? result : void 0;
+    }
+    if ("default" in schema) {
+      return schema.default;
+    }
+    return void 0;
+  }
+  function resolveImagePaths(config, assetRecordByPath) {
+    if (!assetRecordByPath || !config || typeof config !== "object") return;
+    for (const key of Object.keys(config)) {
+      const value = config[key];
+      if (typeof value === "string") {
+        if (assetRecordByPath[value]) {
+          config[key] = assetRecordByPath[value];
+        }
+      } else if (value !== null && typeof value === "object" && !Array.isArray(value)) {
+        resolveImagePaths(value, assetRecordByPath);
+      }
+    }
+  }
+  var _cachedConfig = null;
+  function deepMerge(target, source) {
+    for (const key of Object.keys(source)) {
+      const srcVal = source[key];
+      const tgtVal = target[key];
+      if (srcVal !== null && typeof srcVal === "object" && !Array.isArray(srcVal) && tgtVal !== null && typeof tgtVal === "object" && !Array.isArray(tgtVal)) {
+        deepMerge(tgtVal, srcVal);
+      } else if (srcVal !== void 0) {
+        target[key] = srcVal;
+      }
+    }
+    return target;
+  }
+  function setConfig(configList, config) {
+    const { assetRecordByPath } = config;
+    const resolvedConfigs = configList.map((item) => {
+      var _a;
+      if (!item) return {};
+      return item.$schema ? (_a = extractDefaultsFromSchema(item)) != null ? _a : {} : item;
+    });
+    const [first, ...rest] = resolvedConfigs;
+    const mergedConfig = JSON.parse(JSON.stringify(first));
+    for (const data of rest) {
+      deepMerge(mergedConfig, data);
+    }
+    resolveImagePaths(mergedConfig, assetRecordByPath);
+    _cachedConfig = mergedConfig;
+  }
+  function getConfig() {
+    if (!_cachedConfig) {
+      console.warn("[PlayableSDK] Theme config not initialized. Call setConfig() first.");
+      return {};
+    }
+    return _cachedConfig;
+  }
+
   // src/core.ts
   var destinationUrl = "";
   var isSDKInitialized = false;
@@ -1441,9 +1508,43 @@
     static isGoogle() {
       return _sdk.getCurChannel() === "google";
     }
+    /**
+     * 设置主题配置，支持传入多份 JSON5 配置。
+     * 每一份配置都可以是 JSON Schema（带 $schema 字段），会自动提取其中的 default 值。
+     * 所有配置按顺序依次深度合并，后面的优先级更高。
+     *
+     * @param configList - 配置数组，每一项可以是：
+     *   - JSON Schema（带 $schema 字段）：自动提取 default 值后参与合并
+     *   - 普通配置对象：直接参与合并
+     * @param config - 额外配置项
+     *   - config.assetRecordByPath: 相对路径到已解析 URL 的映射
+     *
+     * @example
+     * sdk.setConfig(
+     *   [schemaA, schemaB, themeData],
+     *   { assetRecordByPath: imageAssets }
+     * );
+     */
+    static setConfig(configList, config) {
+      setConfig(configList, config);
+    }
+    /**
+     * 获取合并后的主题配置。
+     * 返回 schema 默认值与用户主题数据深度合并后的结果。
+     * 必须先调用 sdk.setConfig() 才能使用此方法。
+     *
+     * @returns 合并后的主题配置对象
+     *
+     * @example
+     * const config = sdk.getConfig();
+     * console.log(config.primaryColor); // '#ff0000'
+     */
+    static getConfig() {
+      return getConfig();
+    }
   };
   /** Current version of the SDK */
-  _sdk.version = "1.0.12";
+  _sdk.version = "1.0.13";
   /** 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

@@ -260,6 +260,36 @@ declare class sdk {
      * 判断是否是 Google
      */
     static isGoogle(): boolean;
+    /**
+     * 设置主题配置，支持传入多份 JSON5 配置。
+     * 每一份配置都可以是 JSON Schema（带 $schema 字段），会自动提取其中的 default 值。
+     * 所有配置按顺序依次深度合并，后面的优先级更高。
+     *
+     * @param configList - 配置数组，每一项可以是：
+     *   - JSON Schema（带 $schema 字段）：自动提取 default 值后参与合并
+     *   - 普通配置对象：直接参与合并
+     * @param config - 额外配置项
+     *   - config.assetRecordByPath: 相对路径到已解析 URL 的映射
+     *
+     * @example
+     * sdk.setConfig(
+     *   [schemaA, schemaB, themeData],
+     *   { assetRecordByPath: imageAssets }
+     * );
+     */
+    static setConfig(configList: any[], config: any): void;
+    /**
+     * 获取合并后的主题配置。
+     * 返回 schema 默认值与用户主题数据深度合并后的结果。
+     * 必须先调用 sdk.setConfig() 才能使用此方法。
+     *
+     * @returns 合并后的主题配置对象
+     *
+     * @example
+     * const config = sdk.getConfig();
+     * console.log(config.primaryColor); // '#ff0000'
+     */
+    static getConfig(): Record<string, any>;
 }
 
 /**

package/dist/index.d.ts

@@ -260,6 +260,36 @@ declare class sdk {
      * 判断是否是 Google
      */
     static isGoogle(): boolean;
+    /**
+     * 设置主题配置，支持传入多份 JSON5 配置。
+     * 每一份配置都可以是 JSON Schema（带 $schema 字段），会自动提取其中的 default 值。
+     * 所有配置按顺序依次深度合并，后面的优先级更高。
+     *
+     * @param configList - 配置数组，每一项可以是：
+     *   - JSON Schema（带 $schema 字段）：自动提取 default 值后参与合并
+     *   - 普通配置对象：直接参与合并
+     * @param config - 额外配置项
+     *   - config.assetRecordByPath: 相对路径到已解析 URL 的映射
+     *
+     * @example
+     * sdk.setConfig(
+     *   [schemaA, schemaB, themeData],
+     *   { assetRecordByPath: imageAssets }
+     * );
+     */
+    static setConfig(configList: any[], config: any): void;
+    /**
+     * 获取合并后的主题配置。
+     * 返回 schema 默认值与用户主题数据深度合并后的结果。
+     * 必须先调用 sdk.setConfig() 才能使用此方法。
+     *
+     * @returns 合并后的主题配置对象
+     *
+     * @example
+     * const config = sdk.getConfig();
+     * console.log(config.primaryColor); // '#ff0000'
+     */
+    static getConfig(): Record<string, any>;
 }
 
 /**

package/dist/index.js

@@ -724,6 +724,73 @@ function removeWechatGuide() {
   }
 }
 
+// src/theme-config.ts
+function extractDefaultsFromSchema(schema) {
+  if (!schema || typeof schema !== "object") return void 0;
+  if (schema.type === "object" && schema.properties) {
+    const result = {};
+    for (const [key, propSchema] of Object.entries(schema.properties)) {
+      const val = extractDefaultsFromSchema(propSchema);
+      if (val !== void 0) {
+        result[key] = val;
+      }
+    }
+    return Object.keys(result).length > 0 ? result : void 0;
+  }
+  if ("default" in schema) {
+    return schema.default;
+  }
+  return void 0;
+}
+function resolveImagePaths(config, assetRecordByPath) {
+  if (!assetRecordByPath || !config || typeof config !== "object") return;
+  for (const key of Object.keys(config)) {
+    const value = config[key];
+    if (typeof value === "string") {
+      if (assetRecordByPath[value]) {
+        config[key] = assetRecordByPath[value];
+      }
+    } else if (value !== null && typeof value === "object" && !Array.isArray(value)) {
+      resolveImagePaths(value, assetRecordByPath);
+    }
+  }
+}
+var _cachedConfig = null;
+function deepMerge(target, source) {
+  for (const key of Object.keys(source)) {
+    const srcVal = source[key];
+    const tgtVal = target[key];
+    if (srcVal !== null && typeof srcVal === "object" && !Array.isArray(srcVal) && tgtVal !== null && typeof tgtVal === "object" && !Array.isArray(tgtVal)) {
+      deepMerge(tgtVal, srcVal);
+    } else if (srcVal !== void 0) {
+      target[key] = srcVal;
+    }
+  }
+  return target;
+}
+function setConfig(configList, config) {
+  const { assetRecordByPath } = config;
+  const resolvedConfigs = configList.map((item) => {
+    var _a;
+    if (!item) return {};
+    return item.$schema ? (_a = extractDefaultsFromSchema(item)) != null ? _a : {} : item;
+  });
+  const [first, ...rest] = resolvedConfigs;
+  const mergedConfig = JSON.parse(JSON.stringify(first));
+  for (const data of rest) {
+    deepMerge(mergedConfig, data);
+  }
+  resolveImagePaths(mergedConfig, assetRecordByPath);
+  _cachedConfig = mergedConfig;
+}
+function getConfig() {
+  if (!_cachedConfig) {
+    console.warn("[PlayableSDK] Theme config not initialized. Call setConfig() first.");
+    return {};
+  }
+  return _cachedConfig;
+}
+
 // src/core.ts
 var destinationUrl = "";
 var isSDKInitialized = false;
@@ -1470,9 +1537,43 @@ var _sdk = class _sdk {
   static isGoogle() {
     return _sdk.getCurChannel() === "google";
   }
+  /**
+   * 设置主题配置，支持传入多份 JSON5 配置。
+   * 每一份配置都可以是 JSON Schema（带 $schema 字段），会自动提取其中的 default 值。
+   * 所有配置按顺序依次深度合并，后面的优先级更高。
+   *
+   * @param configList - 配置数组，每一项可以是：
+   *   - JSON Schema（带 $schema 字段）：自动提取 default 值后参与合并
+   *   - 普通配置对象：直接参与合并
+   * @param config - 额外配置项
+   *   - config.assetRecordByPath: 相对路径到已解析 URL 的映射
+   *
+   * @example
+   * sdk.setConfig(
+   *   [schemaA, schemaB, themeData],
+   *   { assetRecordByPath: imageAssets }
+   * );
+   */
+  static setConfig(configList, config) {
+    setConfig(configList, config);
+  }
+  /**
+   * 获取合并后的主题配置。
+   * 返回 schema 默认值与用户主题数据深度合并后的结果。
+   * 必须先调用 sdk.setConfig() 才能使用此方法。
+   *
+   * @returns 合并后的主题配置对象
+   *
+   * @example
+   * const config = sdk.getConfig();
+   * console.log(config.primaryColor); // '#ff0000'
+   */
+  static getConfig() {
+    return getConfig();
+  }
 };
 /** Current version of the SDK */
-_sdk.version = "1.0.12";
+_sdk.version = "1.0.13";
 /** 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/package.json

@@ -1,52 +1,52 @@
-{
-  "name": "@playcraft/adsdk",
-  "version": "1.0.12",
-  "description": "统一的 Playable SDK，支持 MRAID、Google、Facebook、Vungle、BigoAds 等多广告渠道",
-  "main": "dist/index.js",
-  "module": "dist/esm/index.js",
-  "types": "dist/index.d.ts",
-  "repository": {
-    "type": "git"
-  },
-  "files": [
-    "dist",
-    "LICENSE",
-    "defines.d.ts"
-  ],
-  "scripts": {
-    "build": "npx tsup",
-    "test": "jest",
-    "deploy": "npm run build && node scripts/publish.js"
-  },
-  "author": "Tencent ADS Team",
-  "license": "MIT",
-  "devDependencies": {
-    "@types/jest": "^29.5.14",
-    "jest": "^29.7.0",
-    "jest-environment-jsdom": "^29.7.0",
-    "ts-jest": "^29.2.5",
-    "tsup": "^8.4.0",
-    "typescript": "^5.7.2"
-  },
-  "keywords": [
-    "playable",
-    "sdk",
-    "playable-sdk",
-    "PlayableSDK",
-    "playable-ads",
-    "html5",
-    "tencent",
-    "bigoads",
-    "mraid",
-    "google-ads",
-    "facebook-playable",
-    "unity-ads",
-    "vungle",
-    "ironsource",
-    "javascript-sdk",
-    "typescript-sdk"
-  ],
-  "publishConfig": {
-    "registry": "https://mirrors.tencent.com/npm/"
-  }
-}
+{
+  "name": "@playcraft/adsdk",
+  "version": "1.0.13",
+  "description": "统一的 Playable SDK，支持 MRAID、Google、Facebook、Vungle、BigoAds 等多广告渠道",
+  "main": "dist/index.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/index.d.ts",
+  "repository": {
+    "type": "git"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "defines.d.ts"
+  ],
+  "scripts": {
+    "build": "npx tsup",
+    "test": "jest",
+    "deploy": "npm run build && node scripts/publish.js"
+  },
+  "author": "Tencent ADS Team",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/jest": "^29.5.14",
+    "jest": "^29.7.0",
+    "jest-environment-jsdom": "^29.7.0",
+    "ts-jest": "^29.2.5",
+    "tsup": "^8.4.0",
+    "typescript": "^5.7.2"
+  },
+  "keywords": [
+    "playable",
+    "sdk",
+    "playable-sdk",
+    "PlayableSDK",
+    "playable-ads",
+    "html5",
+    "tencent",
+    "bigoads",
+    "mraid",
+    "google-ads",
+    "facebook-playable",
+    "unity-ads",
+    "vungle",
+    "ironsource",
+    "javascript-sdk",
+    "typescript-sdk"
+  ],
+  "publishConfig": {
+    "registry": "https://mirrors.tencent.com/npm/"
+  }
+}