@playcraft/devkit 1.0.12 → 1.0.13

package/core/index.d.ts

@@ -1,185 +1,185 @@
-import { Configuration as WebpackConfig } from 'webpack';
-import { WebpackPluginInstance } from 'webpack';
-import { UserConfig as ViteUserConfig } from 'vite';
-
-/** Supported file extensions for webpack resolution */
-export declare const allowedExtensions: string[];
-
-/** Base webpack configuration used by both development and build configs */
-export declare const webpackCommonConfig: WebpackConfig;
-
-/** Options for CLI arguments */
-export interface CLIOptionConfig {
-  name: string;
-  alias?: string;
-  hasValue?: boolean;
-  defaultValue?: any;
-  description: string;
-  parser?: (value: string) => any;
-}
-
-/** Parse command line arguments based on configuration */
-export declare function parseArgvOptions(possibleOptions: CLIOptionConfig[]): Record<string, any>;
-
-/** Deep merge configuration options */
-export declare function mergeOptions<T>(target: T, source?: Partial<T>): T;
-
-/** Configuration for webpack defines */
-export interface DefinesOptions {
-  /** Development mode flag for conditional code */
-  __DEV__: string;
-  /** Google Play Store URL constant */
-  GOOGLE_PLAY_URL: string;
-  /** App Store URL constant */
-  APP_STORE_URL: string;
-  /** Current advertising network identifier */
-  AD_NETWORK: string;
-  /** Current advertising protocol */
-  AD_PROTOCOL: string;
-  /** Application name constant */
-  APP: string;
-  /** Build name constant */
-  NAME: string;
-  /** Build version constant */
-  VERSION: string;
-  /** Unique build identifier generated from timestamp */
-  BUILD_HASH: string;
-  /** Current language code */
-  LANGUAGE: string;
-  /** Current orientation identifier */
-  ORIENTATION: 'both' | 'portrait' | 'landscape' | 'square';
-}
-
-/** CLI configuration options */
-export interface CLIOptions {
-  /** Output directory for build files (default: 'dist') */
-  outDir: string;
-  /** Path to build.json configuration file (default: 'build.json') */
-  buildConfig: string;
-  /** Path to tsconfig.json configuration file (default: 'tsconfig.json') */
-  tsConfig: string;
-  /** Path to jsconfig.json configuration file (default: 'jsconfig.json') */
-  jsConfig: string;
-  /** Development server port number (default: 3000) */
-  port: number;
-  /** Whether to open browser automatically (default: false) */
-  open: boolean;
-  /** Ad protocol to use (default: 'none') */
-  protocol: 'none' | 'mraid' | 'dapi';
-  /** Ad network identifier (default: 'preview') */
-  network:
-    | 'preview'
-    | 'applovin'
-    | 'unity'
-    | 'google'
-    | 'ironsource'
-    | 'facebook'
-    | 'moloco'
-    | 'mintegral'
-    | 'vungle'
-    | 'adcolony'
-    | 'tapjoy'
-    | 'snapchat'
-    | 'tiktok'
-    | 'appreciate'
-    | 'chartboost'
-    | 'pangle'
-    | 'mytarget'
-    | 'liftoff'
-    | 'smadex'
-    | 'adikteev'
-    | 'bigabid'
-    | 'inmobi';
-  /** Development mode flag */
-  dev: boolean;
-  /** Skip recommended meta tags injection */
-  skipRecommendedMeta?: boolean;
-  /** URL of debugger script to inject */
-  debugger?: string;
-  /** Code obfuscation level: 0=no minimize/obfuscate, 1=terser only, 2=obfuscator basic, 3=obfuscator+dead code, 4=maximum (default: 2) */
-  obfuscateLevel: 0 | 1 | 2 | 3 | 4;
-  /** Directories to exclude from compression (default: []) */
-  excludeCompressDirs: string[];
-  /** Template for output filename using pattern {app}_{name}_{version}_{date}_{language}_{network} */
-  filename: string;
-  /** Application name used in build filename and APP define */
-  app: string;
-  /** Concept name used in build filename and NAME define */
-  name: string;
-  /** Version name used in build filename and VERSION define */
-  version: string;
-  /** Language code for localization */
-  language: 'auto' | 'en' | 'es' | 'zh' | 'hi' | 'ar' | 'fr' | 'de' | 'ja' | 'pt';
-  /** Orientation identifier */
-  orientation: 'both' | 'portrait' | 'landscape' | 'square';
-  /** Google Play Store URL for the app */
-  googlePlayUrl: string;
-  /** App Store URL for the app */
-  appStoreUrl: string;
-  /** Webpack define plugin configuration */
-  defines: Record<string, string>;
-}
-
-/** Global options object */
-export declare const options: CLIOptions;
-
-/** Create webpack config for development */
-export declare function makeWebpackDevConfig(
-  customOptions?: Partial<CLIOptions>,
-  customDefines?: Record<string, any>,
-  webpackCustomConfig?: Partial<WebpackConfig>
-): WebpackConfig;
-
-/** Create webpack config for production build */
-export declare function makeWebpackBuildConfig(
-  customOptions?: Partial<CLIOptions>,
-  customDefines?: Record<string, any>,
-  webpackCustomConfig?: Partial<WebpackConfig>
-): WebpackConfig;
-
-/** Start webpack development server */
-export declare function runDev(
-  webpackConfig?: WebpackConfig,
-  customOptions?: Partial<CLIOptions>,
-  customDefines?: Record<string, any>,
-  webpackCustomConfig?: Partial<WebpackConfig>
-): void;
-
-/** Run webpack production build */
-export declare function runBuild(
-  webpackConfig?: WebpackConfig,
-  customOptions?: Partial<CLIOptions>,
-  customDefines?: Record<string, any>,
-  webpackCustomConfig?: Partial<WebpackConfig>
-): void;
-
-/** Plugin for injecting DAPI script */
-export declare class DAPIInjectorPlugin implements WebpackPluginInstance {
-  apply(compiler: any): void;
-}
-
-/** Plugin for injecting debugger script */
-export declare class DebuggerInjectionPlugin implements WebpackPluginInstance {
-  constructor(debuggerSrc: string);
-  apply(compiler: any): void;
-}
-
-/** Plugin for injecting Google's ExitAPI and meta tags */
-export declare class ExitAPIInjectorPlugin implements WebpackPluginInstance {
-  apply(compiler: any): void;
-}
-
-/** Create Vite config for development */
-export declare function makeViteDevConfig(
-  customOptions?: Partial<CLIOptions>,
-  customDefines?: Record<string, any>,
-  viteCustomConfig?: Partial<ViteUserConfig>
-): ViteUserConfig;
-
-/** Start Vite development server */
-export declare function runViteDev(
-  viteConfig?: ViteUserConfig,
-  customOptions?: Partial<CLIOptions>,
-  customDefines?: Record<string, any>,
-  viteCustomConfig?: Partial<ViteUserConfig>
-): Promise<void>;
+import { Configuration as WebpackConfig } from 'webpack';
+import { WebpackPluginInstance } from 'webpack';
+import { UserConfig as ViteUserConfig } from 'vite';
+
+/** Supported file extensions for webpack resolution */
+export declare const allowedExtensions: string[];
+
+/** Base webpack configuration used by both development and build configs */
+export declare const webpackCommonConfig: WebpackConfig;
+
+/** Options for CLI arguments */
+export interface CLIOptionConfig {
+  name: string;
+  alias?: string;
+  hasValue?: boolean;
+  defaultValue?: any;
+  description: string;
+  parser?: (value: string) => any;
+}
+
+/** Parse command line arguments based on configuration */
+export declare function parseArgvOptions(possibleOptions: CLIOptionConfig[]): Record<string, any>;
+
+/** Deep merge configuration options */
+export declare function mergeOptions<T>(target: T, source?: Partial<T>): T;
+
+/** Configuration for webpack defines */
+export interface DefinesOptions {
+  /** Development mode flag for conditional code */
+  __DEV__: string;
+  /** Google Play Store URL constant */
+  GOOGLE_PLAY_URL: string;
+  /** App Store URL constant */
+  APP_STORE_URL: string;
+  /** Current advertising network identifier */
+  AD_NETWORK: string;
+  /** Current advertising protocol */
+  AD_PROTOCOL: string;
+  /** Application name constant */
+  APP: string;
+  /** Build name constant */
+  NAME: string;
+  /** Build version constant */
+  VERSION: string;
+  /** Unique build identifier generated from timestamp */
+  BUILD_HASH: string;
+  /** Current language code */
+  LANGUAGE: string;
+  /** Current orientation identifier */
+  ORIENTATION: 'both' | 'portrait' | 'landscape' | 'square';
+}
+
+/** CLI configuration options */
+export interface CLIOptions {
+  /** Output directory for build files (default: 'dist') */
+  outDir: string;
+  /** Path to build.json configuration file (default: 'build.json') */
+  buildConfig: string;
+  /** Path to tsconfig.json configuration file (default: 'tsconfig.json') */
+  tsConfig: string;
+  /** Path to jsconfig.json configuration file (default: 'jsconfig.json') */
+  jsConfig: string;
+  /** Development server port number (default: 3000) */
+  port: number;
+  /** Whether to open browser automatically (default: false) */
+  open: boolean;
+  /** Ad protocol to use (default: 'none') */
+  protocol: 'none' | 'mraid' | 'dapi';
+  /** Ad network identifier (default: 'preview') */
+  network:
+    | 'preview'
+    | 'applovin'
+    | 'unity'
+    | 'google'
+    | 'ironsource'
+    | 'facebook'
+    | 'moloco'
+    | 'mintegral'
+    | 'vungle'
+    | 'adcolony'
+    | 'tapjoy'
+    | 'snapchat'
+    | 'tiktok'
+    | 'appreciate'
+    | 'chartboost'
+    | 'pangle'
+    | 'mytarget'
+    | 'liftoff'
+    | 'smadex'
+    | 'adikteev'
+    | 'bigabid'
+    | 'inmobi';
+  /** Development mode flag */
+  dev: boolean;
+  /** Skip recommended meta tags injection */
+  skipRecommendedMeta?: boolean;
+  /** URL of debugger script to inject */
+  debugger?: string;
+  /** Code obfuscation level: 0=no minimize/obfuscate, 1=terser only, 2=obfuscator basic, 3=obfuscator+dead code, 4=maximum (default: 2) */
+  obfuscateLevel: 0 | 1 | 2 | 3 | 4;
+  /** Directories to exclude from compression (default: []) */
+  excludeCompressDirs: string[];
+  /** Template for output filename using pattern {app}_{name}_{version}_{date}_{language}_{network} */
+  filename: string;
+  /** Application name used in build filename and APP define */
+  app: string;
+  /** Concept name used in build filename and NAME define */
+  name: string;
+  /** Version name used in build filename and VERSION define */
+  version: string;
+  /** Language code for localization */
+  language: 'auto' | 'en' | 'es' | 'zh' | 'hi' | 'ar' | 'fr' | 'de' | 'ja' | 'pt';
+  /** Orientation identifier */
+  orientation: 'both' | 'portrait' | 'landscape' | 'square';
+  /** Google Play Store URL for the app */
+  googlePlayUrl: string;
+  /** App Store URL for the app */
+  appStoreUrl: string;
+  /** Webpack define plugin configuration */
+  defines: Record<string, string>;
+}
+
+/** Global options object */
+export declare const options: CLIOptions;
+
+/** Create webpack config for development */
+export declare function makeWebpackDevConfig(
+  customOptions?: Partial<CLIOptions>,
+  customDefines?: Record<string, any>,
+  webpackCustomConfig?: Partial<WebpackConfig>
+): WebpackConfig;
+
+/** Create webpack config for production build */
+export declare function makeWebpackBuildConfig(
+  customOptions?: Partial<CLIOptions>,
+  customDefines?: Record<string, any>,
+  webpackCustomConfig?: Partial<WebpackConfig>
+): WebpackConfig;
+
+/** Start webpack development server */
+export declare function runDev(
+  webpackConfig?: WebpackConfig,
+  customOptions?: Partial<CLIOptions>,
+  customDefines?: Record<string, any>,
+  webpackCustomConfig?: Partial<WebpackConfig>
+): void;
+
+/** Run webpack production build */
+export declare function runBuild(
+  webpackConfig?: WebpackConfig,
+  customOptions?: Partial<CLIOptions>,
+  customDefines?: Record<string, any>,
+  webpackCustomConfig?: Partial<WebpackConfig>
+): void;
+
+/** Plugin for injecting DAPI script */
+export declare class DAPIInjectorPlugin implements WebpackPluginInstance {
+  apply(compiler: any): void;
+}
+
+/** Plugin for injecting debugger script */
+export declare class DebuggerInjectionPlugin implements WebpackPluginInstance {
+  constructor(debuggerSrc: string);
+  apply(compiler: any): void;
+}
+
+/** Plugin for injecting Google's ExitAPI and meta tags */
+export declare class ExitAPIInjectorPlugin implements WebpackPluginInstance {
+  apply(compiler: any): void;
+}
+
+/** Create Vite config for development */
+export declare function makeViteDevConfig(
+  customOptions?: Partial<CLIOptions>,
+  customDefines?: Record<string, any>,
+  viteCustomConfig?: Partial<ViteUserConfig>
+): ViteUserConfig;
+
+/** Start Vite development server */
+export declare function runViteDev(
+  viteConfig?: ViteUserConfig,
+  customOptions?: Partial<CLIOptions>,
+  customDefines?: Record<string, any>,
+  viteCustomConfig?: Partial<ViteUserConfig>
+): Promise<void>;

package/core/loaders/gltf-loader.js

@@ -1,22 +1,22 @@
-"use strict";const path=require("path");const loaderUtils=require("loader-utils");const fs=require("fs");const isObject=value=>typeof value==="object"&&value!==null;const isDataURI=value=>/^data:/i.test(value);/**
- * A utility function that allows mapping the value for a given key in an object
- * [in place](https://en.wikipedia.org/wiki/In-place_algorithm).
- *
- * @remarks
- * This function recursively iterates through every key in the object.
- * Once a key strictly equal to the given key is found, the callback function
- * is invoked, and its return value (or resolved value) is then set as the new value
- * for that entry.
- *
- * @param {unknown} obj - The object to mutate.
- * @param {string} key - The key to match against.
- * @param {(value: unknown) => Promise<any>} callback
- * The callback that either returns the mapped value, or returns a Promise
- * that resolves to the new value.
- */async function mapDeep(obj,key,callback){if(Array.isArray(obj)){for(const item of obj){await mapDeep(item,key,callback)}}else if(isObject(obj)){for(const[k,v]of Object.entries(obj)){if(k===key){obj[k]=await callback(v)}else{await mapDeep(v,key,callback)}}}}/**
- * @typedef {import(".").GLTFLoaderDefinition} GLTFLoader
- * @this {ThisParameterType<GLTFLoader>}
- * @type {GLTFLoader}
+"use strict";const path=require("path");const loaderUtils=require("loader-utils");const fs=require("fs");const isObject=value=>typeof value==="object"&&value!==null;const isDataURI=value=>/^data:/i.test(value);/**
+ * A utility function that allows mapping the value for a given key in an object
+ * [in place](https://en.wikipedia.org/wiki/In-place_algorithm).
+ *
+ * @remarks
+ * This function recursively iterates through every key in the object.
+ * Once a key strictly equal to the given key is found, the callback function
+ * is invoked, and its return value (or resolved value) is then set as the new value
+ * for that entry.
+ *
+ * @param {unknown} obj - The object to mutate.
+ * @param {string} key - The key to match against.
+ * @param {(value: unknown) => Promise<any>} callback
+ * The callback that either returns the mapped value, or returns a Promise
+ * that resolves to the new value.
+ */async function mapDeep(obj,key,callback){if(Array.isArray(obj)){for(const item of obj){await mapDeep(item,key,callback)}}else if(isObject(obj)){for(const[k,v]of Object.entries(obj)){if(k===key){obj[k]=await callback(v)}else{await mapDeep(v,key,callback)}}}}/**
+ * @typedef {import(".").GLTFLoaderDefinition} GLTFLoader
+ * @this {ThisParameterType<GLTFLoader>}
+ * @type {GLTFLoader}
  */async function gltfLoader(content){// Destructure loader options and set default values:
 const{// inline = true,
 // useRelativePaths = true,

package/core/plugins/AdikteevInjectorPlugin.js

@@ -1,14 +1,14 @@
-"use strict";const HtmlWebpackPlugin=require("html-webpack-plugin");/**
- * AdikteevInjectorPlugin
- * 
- * 在开发环境中注入 Adikteev MRAID mock 和占位符变量
- * 
- * 官方文档: https://help.adikteev.com/hc/en-us/articles/10549028250130
- * 
- * Adikteev 要求:
- * 1. 使用 mraid.open() 打开目标 URL
- * 2. 暴露 AK_CLICK_DESTINATION_URL 和 AK_CLICK_PIXEL_URL 占位符
- * 3. 生产环境由 Adikteev CDN 提供 mraid.js
+"use strict";const HtmlWebpackPlugin=require("html-webpack-plugin");/**
+ * AdikteevInjectorPlugin
+ * 
+ * 在开发环境中注入 Adikteev MRAID mock 和占位符变量
+ * 
+ * 官方文档: https://help.adikteev.com/hc/en-us/articles/10549028250130
+ * 
+ * Adikteev 要求:
+ * 1. 使用 mraid.open() 打开目标 URL
+ * 2. 暴露 AK_CLICK_DESTINATION_URL 和 AK_CLICK_PIXEL_URL 占位符
+ * 3. 生产环境由 Adikteev CDN 提供 mraid.js
  */class AdikteevInjectorPlugin{apply(compiler){compiler.hooks.compilation.tap("AdikteevInjectorPlugin",compilation=>{HtmlWebpackPlugin.getHooks(compilation).alterAssetTagGroups.tapAsync("AdikteevInjectorPlugin",(data,cb)=>{// 注入 MRAID mock (仅开发环境)
 data.headTags.unshift({tagName:"script",innerHTML:`
               // Adikteev MRAID Mock (Development Only)

package/core/plugins/BigoAdsInjectorPlugin.js

@@ -1,7 +1,7 @@
-"use strict";const HtmlWebpackPlugin=require("html-webpack-plugin");/**
- * BigoAds SDK 注入插件
- * 在 HTML 头部注入 BigoAds 专用 SDK 脚本
- * 文档: https://www.bigoads.com/help/detail?id=143&moduleId=7&currentLan=CN
+"use strict";const HtmlWebpackPlugin=require("html-webpack-plugin");/**
+ * BigoAds SDK 注入插件
+ * 在 HTML 头部注入 BigoAds 专用 SDK 脚本
+ * 文档: https://www.bigoads.com/help/detail?id=143&moduleId=7&currentLan=CN
  */class BigoAdsInjectorPlugin{apply(compiler){compiler.hooks.compilation.tap("BigoAdsInjectorPlugin",compilation=>{HtmlWebpackPlugin.getHooks(compilation).beforeEmit.tapAsync("BigoAdsInjectorPlugin",(data,cb)=>{// BigoAds 要求必须引入此 SDK，不允许使用标准 mraid.js
 const bigoAdsScript=`<script src="https://static-web.likeevideo.com/as/common-static/big-data/dsp-public/bgy-mraid-sdk.js"></script>`;// 在 <head> 标签后注入
 data.html=data.html.replace("<head>",`<head>\n    ${bigoAdsScript}`);cb(null,data)})})}}exports.BigoAdsInjectorPlugin=BigoAdsInjectorPlugin;

package/core/plugins/DAPIInjectorPlugin.js

@@ -1,5 +1,5 @@
-"use strict";const HtmlWebpackPlugin=require("html-webpack-plugin");const dapiSrc="function getScript(e,i){var n=document.createElement(\"script\");n.type=\"text/javascript\",n.async=!0,i&&(n.onload=i),n.src=e,document.head.appendChild(n)}function parseMessage(e){var i=e.data,n=i.indexOf(DOLLAR_PREFIX+RECEIVE_MSG_PREFIX);if(-1!==n){var t=i.slice(n+2);return getMessageParams(t)}return{}}function getMessageParams(e){var i,n=[],t=e.split(\"/\"),a=t.length;if(-1===e.indexOf(RECEIVE_MSG_PREFIX)){if(a>=2&&a%2===0)for(i=0;a>i;i+=2)n[t[i]]=t.length<i+1?null:decodeURIComponent(t[i+1])}else{var o=e.split(RECEIVE_MSG_PREFIX);void 0!==o[1]&&(n=JSON&&JSON.parse(o[1]))}return n}function getDapi(e){var i=parseMessage(e);if(!i||i.name===GET_DAPI_URL_MSG_NAME){var n=i.data;getScript(n,onDapiReceived)}}function invokeDapiListeners(){for(var e in dapiEventsPool)dapiEventsPool.hasOwnProperty(e)&&dapi.addEventListener(e,dapiEventsPool[e])}function onDapiReceived(){dapi=window.dapi,window.removeEventListener(\"message\",getDapi),invokeDapiListeners()}function init(){window.dapi.isDemoDapi&&(window.parent.postMessage(DOLLAR_PREFIX+SEND_MSG_PREFIX+JSON.stringify({state:\"getDapiUrl\"}),\"*\"),window.addEventListener(\"message\",getDapi,!1))}var DOLLAR_PREFIX=\"$$\",RECEIVE_MSG_PREFIX=\"DAPI_SERVICE:\",SEND_MSG_PREFIX=\"DAPI_AD:\",GET_DAPI_URL_MSG_NAME=\"connection.getDapiUrl\",dapiEventsPool={},dapi=window.dapi||{isReady:function(){return!1},addEventListener:function(e,i){dapiEventsPool[e]=i},removeEventListener:function(e){delete dapiEventsPool[e]},isDemoDapi:!0};init();";/**
- * Webpack plugin that injects DAPI (Display Advertising Programming Interface) script
- * into the HTML head. This enables communication with ad networks that use DAPI protocol.
- * @implements {import('webpack').WebpackPluginInstance}
+"use strict";const HtmlWebpackPlugin=require("html-webpack-plugin");const dapiSrc="function getScript(e,i){var n=document.createElement(\"script\");n.type=\"text/javascript\",n.async=!0,i&&(n.onload=i),n.src=e,document.head.appendChild(n)}function parseMessage(e){var i=e.data,n=i.indexOf(DOLLAR_PREFIX+RECEIVE_MSG_PREFIX);if(-1!==n){var t=i.slice(n+2);return getMessageParams(t)}return{}}function getMessageParams(e){var i,n=[],t=e.split(\"/\"),a=t.length;if(-1===e.indexOf(RECEIVE_MSG_PREFIX)){if(a>=2&&a%2===0)for(i=0;a>i;i+=2)n[t[i]]=t.length<i+1?null:decodeURIComponent(t[i+1])}else{var o=e.split(RECEIVE_MSG_PREFIX);void 0!==o[1]&&(n=JSON&&JSON.parse(o[1]))}return n}function getDapi(e){var i=parseMessage(e);if(!i||i.name===GET_DAPI_URL_MSG_NAME){var n=i.data;getScript(n,onDapiReceived)}}function invokeDapiListeners(){for(var e in dapiEventsPool)dapiEventsPool.hasOwnProperty(e)&&dapi.addEventListener(e,dapiEventsPool[e])}function onDapiReceived(){dapi=window.dapi,window.removeEventListener(\"message\",getDapi),invokeDapiListeners()}function init(){window.dapi.isDemoDapi&&(window.parent.postMessage(DOLLAR_PREFIX+SEND_MSG_PREFIX+JSON.stringify({state:\"getDapiUrl\"}),\"*\"),window.addEventListener(\"message\",getDapi,!1))}var DOLLAR_PREFIX=\"$$\",RECEIVE_MSG_PREFIX=\"DAPI_SERVICE:\",SEND_MSG_PREFIX=\"DAPI_AD:\",GET_DAPI_URL_MSG_NAME=\"connection.getDapiUrl\",dapiEventsPool={},dapi=window.dapi||{isReady:function(){return!1},addEventListener:function(e,i){dapiEventsPool[e]=i},removeEventListener:function(e){delete dapiEventsPool[e]},isDemoDapi:!0};init();";/**
+ * Webpack plugin that injects DAPI (Display Advertising Programming Interface) script
+ * into the HTML head. This enables communication with ad networks that use DAPI protocol.
+ * @implements {import('webpack').WebpackPluginInstance}
  */class DAPIInjectorPlugin{apply(compiler){compiler.hooks.compilation.tap("DAPIInjectorPlugin",compilation=>{HtmlWebpackPlugin.getHooks(compilation).alterAssetTagGroups.tapAsync("DAPIInjectorPlugin",(data,callback)=>{data.headTags.splice(0,0,{tagName:"script",voidTag:false,meta:{plugin:"html-inline-script-webpack-plugin"},innerHTML:dapiSrc});callback(null,data)})})}}exports.DAPIInjectorPlugin=DAPIInjectorPlugin;

package/core/plugins/DebuggerInjectionPlugin.js

@@ -1,6 +1,6 @@
-"use strict";const HtmlWebpackPlugin=require("html-webpack-plugin");/**
- * Webpack plugin that injects a custom debugger script into the HTML head
- * @implements {import('webpack').WebpackPluginInstance}
- */class DebuggerInjectionPlugin{/**
-   * @param {string} debuggerSrc - URL of the debugger script to inject
+"use strict";const HtmlWebpackPlugin=require("html-webpack-plugin");/**
+ * Webpack plugin that injects a custom debugger script into the HTML head
+ * @implements {import('webpack').WebpackPluginInstance}
+ */class DebuggerInjectionPlugin{/**
+   * @param {string} debuggerSrc - URL of the debugger script to inject
    */constructor(debuggerSrc){this.debuggerSrc=debuggerSrc}apply(compiler){compiler.hooks.compilation.tap("DebuggerInjectionPlugin",compilation=>{HtmlWebpackPlugin.getHooks(compilation).alterAssetTagGroups.tapAsync("DebuggerInjectionPlugin",(data,callback)=>{data.headTags.splice(0,0,{tagName:"script",voidTag:false,meta:{plugin:"html-inline-script-webpack-plugin"},attributes:{src:this.debuggerSrc,type:"text/javascript"}});callback(null,data)})})}}exports.DebuggerInjectionPlugin=DebuggerInjectionPlugin;

package/core/plugins/ExitAPIInjectorPlugin.js

@@ -1,10 +1,10 @@
-"use strict";const HtmlWebpackPlugin=require("html-webpack-plugin");/**
- * Webpack plugin that injects Google's ExitAPI script and required meta tags for Google Ads.
- * Adds:
- * - ExitAPI script for handling ad exits
- * - Meta tag for ad size configuration
- * - Meta tag for ad orientation support
- * @implements {import('webpack').WebpackPluginInstance}
- */class ExitAPIInjectorPlugin{/**
-   * @param {ORIENTATION} orientation - device orientation
+"use strict";const HtmlWebpackPlugin=require("html-webpack-plugin");/**
+ * Webpack plugin that injects Google's ExitAPI script and required meta tags for Google Ads.
+ * Adds:
+ * - ExitAPI script for handling ad exits
+ * - Meta tag for ad size configuration
+ * - Meta tag for ad orientation support
+ * @implements {import('webpack').WebpackPluginInstance}
+ */class ExitAPIInjectorPlugin{/**
+   * @param {ORIENTATION} orientation - device orientation
    */constructor(orientation){this.orientation=orientation}apply(compiler){compiler.hooks.compilation.tap("ExitAPIInjectorPlugin",compilation=>{HtmlWebpackPlugin.getHooks(compilation).alterAssetTagGroups.tapAsync("ExitAPIInjectorPlugin",(data,callback)=>{data.headTags.splice(0,0,{tagName:"script",voidTag:false,meta:{plugin:"html-inline-script-webpack-plugin"},attributes:{src:"https://tpc.googlesyndication.com/pagead/gadgets/html5/api/exitapi.js",type:"text/javascript"}});let width=320;let height=480;if(this.orientation==="square")width=480;else if(this.orientation==="landscape"){width=480;height=320}data.headTags.splice(0,0,{tagName:"meta",voidTag:true,meta:{plugin:"html-webpack-plugin"},attributes:{name:"ad.size",content:`width=${width},height=${height}`}});data.headTags.splice(0,0,{tagName:"meta",voidTag:true,meta:{plugin:"html-webpack-plugin"},attributes:{name:"ad.orientation",content:this.orientation==="both"||this.orientation==="square"?"portrait,landscape":this.orientation}});callback(null,data)})})}}exports.ExitAPIInjectorPlugin=ExitAPIInjectorPlugin;

package/core/plugins/FflateCompressionPlugin.js

@@ -1,34 +1,34 @@
-"use strict";/**
- * Webpack 插件：使用 fflate 压缩 HTML 文件并生成自解压版本
- * 
- * 工作原理：
- * 1. 编译时：读取最终生成的 HTML 文件
- * 2. 使用 fflate.zlibSync 进行最高级别压缩（level: 9，固定）
- * 3. 转换为 Base64 编码字符串
- * 4. 生成新的 HTML，包含：
- *    - fflate 解压库（内联）
- *    - 压缩后的数据（Base64 字符串）
- *    - 自动解压和执行代码
- * 5. 运行时：浏览器自动解压并执行原始 HTML
- * 
- * 收益：
- * - 体积减少约 66-68%（压缩后）
- * - 解压速度极快（3-5ms）
- * - 完美兼容所有浏览器（99%+）
- * - fflate 包体积仅 8KB
- * 
- * 注意：
- * - 仅在打正式包（生产环境）时使用
- * - 压缩等级固定为 9（最高压缩）
- * - 不保留原始文件
- */const fflate=require("fflate");const fs=require("fs");const path=require("path");const{minify}=require("terser");class FflateCompressionPlugin{/**
-   * @param {Object} options - 插件配置选项
-   * @param {boolean} [options.enabled=true] - 是否启用压缩
-   * @param {number} [options.level=9] - 压缩等级（固定为 9）
-   * @param {boolean} [options.keepOriginal=false] - 是否保留原始文件（固定为 false）
-   * @param {boolean} [options.logStats=true] - 是否输出压缩统计
-   * @param {string} [options.googlePlayUrl] - Google Play 商店链接
-   * @param {string} [options.appStoreUrl] - App Store 商店链接
+"use strict";/**
+ * Webpack 插件：使用 fflate 压缩 HTML 文件并生成自解压版本
+ * 
+ * 工作原理：
+ * 1. 编译时：读取最终生成的 HTML 文件
+ * 2. 使用 fflate.zlibSync 进行最高级别压缩（level: 9，固定）
+ * 3. 转换为 Base64 编码字符串
+ * 4. 生成新的 HTML，包含：
+ *    - fflate 解压库（内联）
+ *    - 压缩后的数据（Base64 字符串）
+ *    - 自动解压和执行代码
+ * 5. 运行时：浏览器自动解压并执行原始 HTML
+ * 
+ * 收益：
+ * - 体积减少约 66-68%（压缩后）
+ * - 解压速度极快（3-5ms）
+ * - 完美兼容所有浏览器（99%+）
+ * - fflate 包体积仅 8KB
+ * 
+ * 注意：
+ * - 仅在打正式包（生产环境）时使用
+ * - 压缩等级固定为 9（最高压缩）
+ * - 不保留原始文件
+ */const fflate=require("fflate");const fs=require("fs");const path=require("path");const{minify}=require("terser");class FflateCompressionPlugin{/**
+   * @param {Object} options - 插件配置选项
+   * @param {boolean} [options.enabled=true] - 是否启用压缩
+   * @param {number} [options.level=9] - 压缩等级（固定为 9）
+   * @param {boolean} [options.keepOriginal=false] - 是否保留原始文件（固定为 false）
+   * @param {boolean} [options.logStats=true] - 是否输出压缩统计
+   * @param {string} [options.googlePlayUrl] - Google Play 商店链接
+   * @param {string} [options.appStoreUrl] - App Store 商店链接
    */constructor(options={}){this.options={enabled:options.enabled!==false,level:options.level||9,keepOriginal:options.keepOriginal||false,logStats:options.logStats!==false,googlePlayUrl:options.googlePlayUrl||"https://play.google.com/store/games",appStoreUrl:options.appStoreUrl||"https://www.apple.com/app-store/"}}apply(compiler){if(!this.options.enabled){console.log("\u26A0\uFE0F  fflate compression is disabled");return}const webpack=require("webpack");// 使用 processAssets 钩子（Webpack 5），在 ZipPlugin 之前执行
 // 阶段顺序：OPTIMIZE_INLINE (700) → SUMMARIZE (1000) → OPTIMIZE_TRANSFER (3000)
 // HtmlWebpackPlugin + HtmlInlineScriptPlugin 在 OPTIMIZE_INLINE 阶段完成 HTML 生成
@@ -45,24 +45,24 @@ const minifiedFflate=await minify(fflateLibContent,{compress:{passes:2,dead_code
 const headContent=this.extractHeadContent(originalHtml);// 生成自解压 HTML
 const decompressedHtml=await this.generateDecompressHtml(base64String,fflateLibContent,headContent);const finalSize=Buffer.byteLength(decompressedHtml,"utf8");// 输出统计信息
 if(this.options.logStats){console.log(`\n📄 ${htmlFilename}`);console.log(`   原始大小:     ${(originalSize/1024).toFixed(2)} KB`);console.log(`   压缩后大小:   ${(compressedSize/1024).toFixed(2)} KB`);console.log(`   Base64 大小:  ${(base64Size/1024).toFixed(2)} KB`);console.log(`   最终大小:     ${(finalSize/1024).toFixed(2)} KB (含解压代码)`);console.log(`   压缩率:       ${compressionRatio}%`);console.log(`   体积减少:     ${originalSize-finalSize} bytes (${((1-finalSize/originalSize)*100).toFixed(2)}%)`);console.log(`   压缩耗时:     ${compressTime}ms`);if(finalSize<originalSize){const saved=originalSize-finalSize;console.log(`   ✅ 节省空间:   ${(saved/1024).toFixed(2)} KB (${(saved/originalSize*100).toFixed(2)}%)`)}else{console.log(`   ⚠️  压缩后反而变大了 ${finalSize-originalSize} bytes`);console.log(`   💡 建议: 对于小文件（<50KB），压缩可能不划算`)}}// 更新 webpack 资源（使用 Webpack 5 API）
-compilation.updateAsset(htmlFilename,new RawSource(decompressedHtml))}console.log("\n\u2705 fflate compression completed!\n")}catch(error){console.error("\n\u274C fflate compression failed:",error);throw error}}/**
-   * 从原始 HTML 中提取 <head> 内容
-   * 保留 meta 标签、外部 script 引用、link 标签、title 等
-   * 排除内联 style 和内联 script（这些会在解压后恢复）
-   * @param {string} html - 原始 HTML 内容
-   * @returns {string} 提取的 head 内容（HTML 字符串）
+compilation.updateAsset(htmlFilename,new RawSource(decompressedHtml))}console.log("\n\u2705 fflate compression completed!\n")}catch(error){console.error("\n\u274C fflate compression failed:",error);throw error}}/**
+   * 从原始 HTML 中提取 <head> 内容
+   * 保留 meta 标签、外部 script 引用、link 标签、title 等
+   * 排除内联 style 和内联 script（这些会在解压后恢复）
+   * @param {string} html - 原始 HTML 内容
+   * @returns {string} 提取的 head 内容（HTML 字符串）
    */extractHeadContent(html){// 提取 <head>...</head> 之间的内容
 const headMatch=html.match(/<head[^>]*>([\s\S]*?)<\/head>/i);if(!headMatch)return"";const headHtml=headMatch[1];const elements=[];// 提取所有 meta 标签（自闭合，排除 charset 和 viewport，因为模板已包含）
 const metaRegex=/<meta\s+[^>]*?\/?>/gi;let match;while((match=metaRegex.exec(headHtml))!==null){const tag=match[0];// 排除 charset 和 viewport（自解压模板已包含）
 if(/charset\s*=/i.test(tag))continue;if(/name\s*=\s*["']viewport["']/i.test(tag))continue;elements.push(tag)}// 提取 title 标签
 const titleMatch=headHtml.match(/<title[^>]*>[\s\S]*?<\/title>/i);if(titleMatch){elements.push(titleMatch[0])}// 提取外部 script 标签（有 src 属性的）
 const scriptRegex=/<script\s+[^>]*src\s*=\s*["'][^"']+["'][^>]*>[\s\S]*?<\/script>/gi;while((match=scriptRegex.exec(headHtml))!==null){elements.push(match[0])}// 提取 link 标签
-const linkRegex=/<link\s+[^>]*?\/?>/gi;while((match=linkRegex.exec(headHtml))!==null){elements.push(match[0])}return elements.join("\n  ")}/**
-   * 生成自解压 HTML 模板（极简压缩版本，无需 module）
-   * @param {string} compressedBase64 - 压缩后的 Base64 字符串
-   * @param {string} fflateLibCode - fflate 库代码（已压缩）
-   * @param {string} headContent - 从原始 HTML 提取的 head 内容
-   * @returns {Promise<string>} 完整的自解压 HTML
+const linkRegex=/<link\s+[^>]*?\/?>/gi;while((match=linkRegex.exec(headHtml))!==null){elements.push(match[0])}return elements.join("\n  ")}/**
+   * 生成自解压 HTML 模板（极简压缩版本，无需 module）
+   * @param {string} compressedBase64 - 压缩后的 Base64 字符串
+   * @param {string} fflateLibCode - fflate 库代码（已压缩）
+   * @param {string} headContent - 从原始 HTML 提取的 head 内容
+   * @returns {Promise<string>} 完整的自解压 HTML
    */async generateDecompressHtml(compressedBase64,fflateLibCode,headContent=""){// 可读的解压代码（保持格式以便维护）
 const decompressCodeReadable=`
 (function() {