@playcraft/adsdk 1.0.16 → 1.0.18-beta.1

package/dist/iife/index.js

@@ -699,6 +699,38 @@
     }
     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];
+  }
+  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)) {
@@ -726,7 +758,7 @@
     return target;
   }
   function setConfig(configList, config) {
-    const { assetRecordByPath } = config;
+    const { assetRecordByPath, i18nRecord } = config;
     const resolvedConfigs = configList.map((item) => {
       var _a;
       if (!item) return {};
@@ -737,6 +769,10 @@
     for (const data of rest) {
       deepMerge(mergedConfig, data);
     }
+    if (i18nRecord) {
+      const langCode = getLanguageCode();
+      resolveI18nRefs(mergedConfig, i18nRecord, langCode);
+    }
     resolveImagePaths(mergedConfig, assetRecordByPath);
     _cachedConfig = mergedConfig;
   }
@@ -748,6 +784,83 @@
     return _cachedConfig;
   }
 
+  // src/cursor.ts
+  var cleanup = null;
+  function toCursor(src, size) {
+    const hotspot = Math.round(size / 8);
+    return new Promise((resolve, reject) => {
+      const img = new Image();
+      img.onload = () => {
+        const c = document.createElement("canvas");
+        c.width = size;
+        c.height = size;
+        const ctx = c.getContext("2d");
+        if (!ctx) {
+          reject(new Error("[PlayableSDK] Failed to get 2d context for cursor"));
+          return;
+        }
+        ctx.drawImage(img, 0, 0, size, size);
+        resolve(`url(${c.toDataURL("image/png")}) ${hotspot} ${hotspot}, pointer`);
+      };
+      img.onerror = () => reject(new Error("[PlayableSDK] Failed to load cursor image"));
+      img.src = src;
+    });
+  }
+  function enableCustomCursor(opts = {}) {
+    var _a, _b;
+    cleanup == null ? void 0 : cleanup();
+    cleanup = null;
+    if (typeof document === "undefined") return () => {
+    };
+    const target = (_a = opts.target) != null ? _a : document.body;
+    if (!target) {
+      console.warn("[PlayableSDK] enableCustomCursor: target not found");
+      return () => {
+      };
+    }
+    const size = (_b = opts.size) != null ? _b : 64;
+    const prevCursor = target.style.cursor;
+    let disposed = false;
+    let down = null;
+    let up = null;
+    const dispose = () => {
+      if (disposed) return;
+      disposed = true;
+      target.style.cursor = prevCursor;
+      if (down) target.removeEventListener("pointerdown", down);
+      if (up) {
+        target.removeEventListener("pointerup", up);
+        target.removeEventListener("pointercancel", up);
+      }
+      if (cleanup === dispose) cleanup = null;
+    };
+    cleanup = dispose;
+    Promise.all([
+      toCursor(FINGER_HOVERING, size),
+      toCursor(FINGER_PRESSING, size)
+    ]).then(([hover, press]) => {
+      if (disposed) return;
+      target.style.cursor = hover;
+      down = () => {
+        target.style.cursor = press;
+      };
+      up = () => {
+        target.style.cursor = hover;
+      };
+      target.addEventListener("pointerdown", down);
+      target.addEventListener("pointerup", up);
+      target.addEventListener("pointercancel", up);
+    }).catch((err) => {
+      console.warn("[PlayableSDK] enableCustomCursor failed:", err);
+      dispose();
+    });
+    return dispose;
+  }
+  function disableCustomCursor() {
+    cleanup == null ? void 0 : cleanup();
+    cleanup = null;
+  }
+
   // src/core.ts
   var destinationUrl = "";
   var isSDKInitialized = false;
@@ -1083,6 +1196,7 @@
      * This must be called as earlier as possible.
      *
      * @param callback Optional function called when ad container is ready
+     * @param options Optional configuration options
      * @example
      * // Basic initialization
      * sdk.playcraftInit();
@@ -1095,12 +1209,15 @@
      * @fires playcraftInit When SDK initialization starts
      * @fires playcraftReady When game instance is created and ready to load resources
      */
-    static playcraftInit(callback) {
+    static playcraftInit(callback, options) {
       if (isSDKInitialized) return;
       if (callback) initCallback = callback;
       initTrackingProtocols();
       document.readyState === "loading" ? window.addEventListener("DOMContentLoaded", initSDK) : initSDK();
       isSDKInitialized = true;
+      if ((options == null ? void 0 : options.useCustomCursor) !== false) {
+        enableCustomCursor();
+      }
     }
     /**
      * Starts the playable ad experience.
@@ -1493,9 +1610,35 @@
     static getConfig() {
       return getConfig();
     }
+    /**
+     * 启用自定义鼠标指针。默认挂载到 `document.body`，作用于整个页面。
+     * 悬浮显示手指图标，按下时切换为按压态图标。
+     * 多次调用会先清理上一次的状态再重新绑定。
+     *
+     * @param opts 可选配置
+     *   - opts.target: 目标元素，未传则默认 document.body
+     *   - opts.size: 光标尺寸（像素），默认 64，热点固定为 size 的 1/8
+     * @returns 清理函数，调用后会恢复默认光标并解除事件监听
+     *
+     * @example
+     * sdk.enableCustomCursor();
+     * sdk.enableCustomCursor({ size: 96 });
+     */
+    static enableCustomCursor(opts) {
+      return enableCustomCursor(opts);
+    }
+    /**
+     * 关闭自定义鼠标指针，恢复默认光标。
+     *
+     * @example
+     * sdk.disableCustomCursor();
+     */
+    static disableCustomCursor() {
+      disableCustomCursor();
+    }
   };
   /** Current version of the SDK */
-  _sdk.version = "1.0.16";
+  _sdk.version = "1.0.18-beta.1";
   /** 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 */
@@ -1521,81 +1664,4 @@
     "background: #e1e4e8; color: #333; font-size: 14px; padding: 4px 8px; border-top-right-radius: 4px; border-bottom-right-radius: 4px;"
   );
   window.PlayableSDK = sdk;
-
-  // src/cursor.ts
-  var cleanup = null;
-  function toCursor(src, size) {
-    const hotspot = Math.round(size / 8);
-    return new Promise((resolve, reject) => {
-      const img = new Image();
-      img.onload = () => {
-        const c = document.createElement("canvas");
-        c.width = size;
-        c.height = size;
-        const ctx = c.getContext("2d");
-        if (!ctx) {
-          reject(new Error("[PlayableSDK] Failed to get 2d context for cursor"));
-          return;
-        }
-        ctx.drawImage(img, 0, 0, size, size);
-        resolve(`url(${c.toDataURL("image/png")}) ${hotspot} ${hotspot}, pointer`);
-      };
-      img.onerror = () => reject(new Error("[PlayableSDK] Failed to load cursor image"));
-      img.src = src;
-    });
-  }
-  function enableCustomCursor(opts = {}) {
-    var _a, _b;
-    cleanup == null ? void 0 : cleanup();
-    cleanup = null;
-    if (typeof document === "undefined") return () => {
-    };
-    const target = (_a = opts.target) != null ? _a : document.body;
-    if (!target) {
-      console.warn("[PlayableSDK] enableCustomCursor: target not found");
-      return () => {
-      };
-    }
-    const size = (_b = opts.size) != null ? _b : 64;
-    const prevCursor = target.style.cursor;
-    let disposed = false;
-    let down = null;
-    let up = null;
-    const dispose = () => {
-      if (disposed) return;
-      disposed = true;
-      target.style.cursor = prevCursor;
-      if (down) target.removeEventListener("pointerdown", down);
-      if (up) {
-        target.removeEventListener("pointerup", up);
-        target.removeEventListener("pointercancel", up);
-      }
-      if (cleanup === dispose) cleanup = null;
-    };
-    cleanup = dispose;
-    Promise.all([
-      toCursor(FINGER_HOVERING, size),
-      toCursor(FINGER_PRESSING, size)
-    ]).then(([hover, press]) => {
-      if (disposed) return;
-      target.style.cursor = hover;
-      down = () => {
-        target.style.cursor = press;
-      };
-      up = () => {
-        target.style.cursor = hover;
-      };
-      target.addEventListener("pointerdown", down);
-      target.addEventListener("pointerup", up);
-      target.addEventListener("pointercancel", up);
-    }).catch((err) => {
-      console.warn("[PlayableSDK] enableCustomCursor failed:", err);
-      dispose();
-    });
-    return dispose;
-  }
-  function disableCustomCursor() {
-    cleanup == null ? void 0 : cleanup();
-    cleanup = null;
-  }
 })();

package/dist/index.d.mts

@@ -1,5 +1,43 @@
+/**
+ * i18n 数据结构（仅 runtime，SDK 只处理游戏内运行时多语言）：
+ *   runtime: { [key]: { [langCode]: "文案" } }
+ *
+ * xplatform（配置平台 UI 标题）由外部配置平台自行解析，不传入 SDK。
+ */
+type I18nRecord = {
+    runtime?: Record<string, Record<string, string>>;
+};
+
 type EventName = 'playcraftInit' | 'playcraftReady' | 'playcraftStart' | 'playcraftInteractive' | 'playcraftInteraction' | 'playcraftChallengeStart' | 'playcraftChallengeProgress' | 'playcraftChallengeSuccess' | 'playcraftChallengeFailed' | 'playcraftResize' | 'playcraftPause' | 'playcraftResume' | 'playcraftVolume' | 'playcraftRetry' | 'playcraftFinish' | 'playcraftInstall';
 
+/**
+ * 自定义鼠标指针模块。
+ *
+ * 默认挂载到 `document.body`，把整页的默认光标替换为内置的手指图标：
+ * - 悬浮时显示 FingerHovering
+ * - 按下时显示 FingerPressing
+ *
+ * 图片以 base64 dataURL 形式内置到产物中，无需额外加载资源。
+ */
+interface CursorOptions {
+    /** 目标元素，未传则默认挂载到 document.body */
+    target?: HTMLElement;
+    /** 光标尺寸（像素），默认 64。热点固定为 size 的 1/8 */
+    size?: number;
+}
+/**
+ * 启用自定义鼠标指针。默认挂载到 `document.body`，作用于整个页面。
+ *
+ * 多次调用时，会先清理上一次的状态再重新绑定。
+ *
+ * @returns 清理函数，调用后会恢复默认光标并解除事件监听。
+ */
+declare function enableCustomCursor(opts?: CursorOptions): () => void;
+/**
+ * 关闭自定义鼠标指针，恢复默认光标。
+ */
+declare function disableCustomCursor(): void;
+
 type InitCallbackType = (maxWidth: number, maxHeight: number) => void;
 /**
  * Main SDK class providing playable ad functionality and state management.
@@ -31,6 +69,7 @@ declare class sdk {
      * This must be called as earlier as possible.
      *
      * @param callback Optional function called when ad container is ready
+     * @param options Optional configuration options
      * @example
      * // Basic initialization
      * sdk.playcraftInit();
@@ -43,7 +82,9 @@ declare class sdk {
      * @fires playcraftInit When SDK initialization starts
      * @fires playcraftReady When game instance is created and ready to load resources
      */
-    static playcraftInit(callback?: InitCallbackType): void;
+    static playcraftInit(callback?: InitCallbackType, options?: {
+        useCustomCursor?: boolean;
+    }): void;
     /**
      * Starts the playable ad experience.
      * Should be called after all resources are loaded and first frame is rendered.
@@ -238,7 +279,10 @@ declare class sdk {
      *   { assetRecordByPath: imageAssets }
      * );
      */
-    static setConfig(configList: any[], config: any): void;
+    static setConfig(configList: any[], config: {
+        assetRecordByPath: Record<string, string>;
+        i18nRecord?: I18nRecord;
+    }): void;
     /**
      * 获取合并后的主题配置。
      * 返回 schema 默认值与用户主题数据深度合并后的结果。
@@ -251,6 +295,28 @@ declare class sdk {
      * console.log(config.primaryColor); // '#ff0000'
      */
     static getConfig(): Record<string, any>;
+    /**
+     * 启用自定义鼠标指针。默认挂载到 `document.body`，作用于整个页面。
+     * 悬浮显示手指图标，按下时切换为按压态图标。
+     * 多次调用会先清理上一次的状态再重新绑定。
+     *
+     * @param opts 可选配置
+     *   - opts.target: 目标元素，未传则默认 document.body
+     *   - opts.size: 光标尺寸（像素），默认 64，热点固定为 size 的 1/8
+     * @returns 清理函数，调用后会恢复默认光标并解除事件监听
+     *
+     * @example
+     * sdk.enableCustomCursor();
+     * sdk.enableCustomCursor({ size: 96 });
+     */
+    static enableCustomCursor(opts?: CursorOptions): () => void;
+    /**
+     * 关闭自定义鼠标指针，恢复默认光标。
+     *
+     * @example
+     * sdk.disableCustomCursor();
+     */
+    static disableCustomCursor(): void;
 }
 
 /**
@@ -270,32 +336,4 @@ declare function hideWechatGuide(): void;
  */
 declare function removeWechatGuide(): void;
 
-/**
- * 自定义鼠标指针模块。
- *
- * 默认挂载到 `document.body`，把整页的默认光标替换为内置的手指图标：
- * - 悬浮时显示 FingerHovering
- * - 按下时显示 FingerPressing
- *
- * 图片以 base64 dataURL 形式内置到产物中，无需额外加载资源。
- */
-interface CursorOptions {
-    /** 目标元素，未传则默认挂载到 document.body */
-    target?: HTMLElement;
-    /** 光标尺寸（像素），默认 64。热点固定为 size 的 1/8 */
-    size?: number;
-}
-/**
- * 启用自定义鼠标指针。默认挂载到 `document.body`，作用于整个页面。
- *
- * 多次调用时，会先清理上一次的状态再重新绑定。
- *
- * @returns 清理函数，调用后会恢复默认光标并解除事件监听。
- */
-declare function enableCustomCursor(opts?: CursorOptions): () => void;
-/**
- * 关闭自定义鼠标指针，恢复默认光标。
- */
-declare function disableCustomCursor(): void;
-
-export { type CursorOptions, sdk as default, disableCustomCursor, enableCustomCursor, hideWechatGuide, removeWechatGuide, sdk, showWechatGuide };
+export { type CursorOptions, type I18nRecord, sdk as default, disableCustomCursor, enableCustomCursor, hideWechatGuide, removeWechatGuide, sdk, showWechatGuide };

package/dist/index.d.ts

@@ -1,5 +1,43 @@
+/**
+ * i18n 数据结构（仅 runtime，SDK 只处理游戏内运行时多语言）：
+ *   runtime: { [key]: { [langCode]: "文案" } }
+ *
+ * xplatform（配置平台 UI 标题）由外部配置平台自行解析，不传入 SDK。
+ */
+type I18nRecord = {
+    runtime?: Record<string, Record<string, string>>;
+};
+
 type EventName = 'playcraftInit' | 'playcraftReady' | 'playcraftStart' | 'playcraftInteractive' | 'playcraftInteraction' | 'playcraftChallengeStart' | 'playcraftChallengeProgress' | 'playcraftChallengeSuccess' | 'playcraftChallengeFailed' | 'playcraftResize' | 'playcraftPause' | 'playcraftResume' | 'playcraftVolume' | 'playcraftRetry' | 'playcraftFinish' | 'playcraftInstall';
 
+/**
+ * 自定义鼠标指针模块。
+ *
+ * 默认挂载到 `document.body`，把整页的默认光标替换为内置的手指图标：
+ * - 悬浮时显示 FingerHovering
+ * - 按下时显示 FingerPressing
+ *
+ * 图片以 base64 dataURL 形式内置到产物中，无需额外加载资源。
+ */
+interface CursorOptions {
+    /** 目标元素，未传则默认挂载到 document.body */
+    target?: HTMLElement;
+    /** 光标尺寸（像素），默认 64。热点固定为 size 的 1/8 */
+    size?: number;
+}
+/**
+ * 启用自定义鼠标指针。默认挂载到 `document.body`，作用于整个页面。
+ *
+ * 多次调用时，会先清理上一次的状态再重新绑定。
+ *
+ * @returns 清理函数，调用后会恢复默认光标并解除事件监听。
+ */
+declare function enableCustomCursor(opts?: CursorOptions): () => void;
+/**
+ * 关闭自定义鼠标指针，恢复默认光标。
+ */
+declare function disableCustomCursor(): void;
+
 type InitCallbackType = (maxWidth: number, maxHeight: number) => void;
 /**
  * Main SDK class providing playable ad functionality and state management.
@@ -31,6 +69,7 @@ declare class sdk {
      * This must be called as earlier as possible.
      *
      * @param callback Optional function called when ad container is ready
+     * @param options Optional configuration options
      * @example
      * // Basic initialization
      * sdk.playcraftInit();
@@ -43,7 +82,9 @@ declare class sdk {
      * @fires playcraftInit When SDK initialization starts
      * @fires playcraftReady When game instance is created and ready to load resources
      */
-    static playcraftInit(callback?: InitCallbackType): void;
+    static playcraftInit(callback?: InitCallbackType, options?: {
+        useCustomCursor?: boolean;
+    }): void;
     /**
      * Starts the playable ad experience.
      * Should be called after all resources are loaded and first frame is rendered.
@@ -238,7 +279,10 @@ declare class sdk {
      *   { assetRecordByPath: imageAssets }
      * );
      */
-    static setConfig(configList: any[], config: any): void;
+    static setConfig(configList: any[], config: {
+        assetRecordByPath: Record<string, string>;
+        i18nRecord?: I18nRecord;
+    }): void;
     /**
      * 获取合并后的主题配置。
      * 返回 schema 默认值与用户主题数据深度合并后的结果。
@@ -251,6 +295,28 @@ declare class sdk {
      * console.log(config.primaryColor); // '#ff0000'
      */
     static getConfig(): Record<string, any>;
+    /**
+     * 启用自定义鼠标指针。默认挂载到 `document.body`，作用于整个页面。
+     * 悬浮显示手指图标，按下时切换为按压态图标。
+     * 多次调用会先清理上一次的状态再重新绑定。
+     *
+     * @param opts 可选配置
+     *   - opts.target: 目标元素，未传则默认 document.body
+     *   - opts.size: 光标尺寸（像素），默认 64，热点固定为 size 的 1/8
+     * @returns 清理函数，调用后会恢复默认光标并解除事件监听
+     *
+     * @example
+     * sdk.enableCustomCursor();
+     * sdk.enableCustomCursor({ size: 96 });
+     */
+    static enableCustomCursor(opts?: CursorOptions): () => void;
+    /**
+     * 关闭自定义鼠标指针，恢复默认光标。
+     *
+     * @example
+     * sdk.disableCustomCursor();
+     */
+    static disableCustomCursor(): void;
 }
 
 /**
@@ -270,32 +336,4 @@ declare function hideWechatGuide(): void;
  */
 declare function removeWechatGuide(): void;
 
-/**
- * 自定义鼠标指针模块。
- *
- * 默认挂载到 `document.body`，把整页的默认光标替换为内置的手指图标：
- * - 悬浮时显示 FingerHovering
- * - 按下时显示 FingerPressing
- *
- * 图片以 base64 dataURL 形式内置到产物中，无需额外加载资源。
- */
-interface CursorOptions {
-    /** 目标元素，未传则默认挂载到 document.body */
-    target?: HTMLElement;
-    /** 光标尺寸（像素），默认 64。热点固定为 size 的 1/8 */
-    size?: number;
-}
-/**
- * 启用自定义鼠标指针。默认挂载到 `document.body`，作用于整个页面。
- *
- * 多次调用时，会先清理上一次的状态再重新绑定。
- *
- * @returns 清理函数，调用后会恢复默认光标并解除事件监听。
- */
-declare function enableCustomCursor(opts?: CursorOptions): () => void;
-/**
- * 关闭自定义鼠标指针，恢复默认光标。
- */
-declare function disableCustomCursor(): void;
-
-export { type CursorOptions, sdk as default, disableCustomCursor, enableCustomCursor, hideWechatGuide, removeWechatGuide, sdk, showWechatGuide };
+export { type CursorOptions, type I18nRecord, sdk as default, disableCustomCursor, enableCustomCursor, hideWechatGuide, removeWechatGuide, sdk, showWechatGuide };