@playcraft/devkit 1.0.6 → 1.0.7

package/core/plugins/PangleInjectorPlugin.js

@@ -1,4 +1,4 @@
-"use strict";const HtmlWebpackPlugin=require("html-webpack-plugin");/**
- * Webpack plugin that injects Pangle Playable SDK script into the HTML head.
- * @implements {import('webpack').WebpackPluginInstance}
+"use strict";const HtmlWebpackPlugin=require("html-webpack-plugin");/**
+ * Webpack plugin that injects Pangle Playable SDK script into the HTML head.
+ * @implements {import('webpack').WebpackPluginInstance}
  */class PangleInjectorPlugin{apply(compiler){compiler.hooks.compilation.tap("PangleInjectorPlugin",compilation=>{HtmlWebpackPlugin.getHooks(compilation).alterAssetTagGroups.tapAsync("PangleInjectorPlugin",(data,callback)=>{data.headTags.splice(0,0,{tagName:"script",voidTag:false,meta:{plugin:"html-inline-script-webpack-plugin"},attributes:{src:"https://sf3-ttcdn-tos.pstatp.com/obj/union-fe-nc/playable/sdk/playable-sdk.js",type:"text/javascript"}});callback(null,data)})})}}exports.PangleInjectorPlugin=PangleInjectorPlugin;

package/core/plugins/SnapchatInjectorPlugin.js

@@ -1,7 +1,7 @@
-"use strict";const HtmlWebpackPlugin=require("html-webpack-plugin");/**
- * Snapchat SDK 注入插件
- * 在 HTML 头部注入 Snapchat Playable SDK 脚本
- * 文档: https://businesshelp.snapchat.com/s/article/app-playables
+"use strict";const HtmlWebpackPlugin=require("html-webpack-plugin");/**
+ * Snapchat SDK 注入插件
+ * 在 HTML 头部注入 Snapchat Playable SDK 脚本
+ * 文档: https://businesshelp.snapchat.com/s/article/app-playables
  */class SnapchatInjectorPlugin{apply(compiler){compiler.hooks.compilation.tap("SnapchatInjectorPlugin",compilation=>{HtmlWebpackPlugin.getHooks(compilation).alterAssetTagGroups.tapAsync("SnapchatInjectorPlugin",(data,callback)=>{// 在头部注入 Snapchat SDK 脚本标签
 data.headTags.splice(0,0,{tagName:"script",voidTag:false,meta:{plugin:"html-inline-script-webpack-plugin"},attributes:{type:"text/javascript"},innerHTML:`
 // Snapchat Playable Ad SDK Mock (开发环境)

package/core/plugins/TikTokInjectorPlugin.js

@@ -1,4 +1,4 @@
-"use strict";const HtmlWebpackPlugin=require("html-webpack-plugin");/**
- * Webpack plugin that injects TikTok Playable SDK script into the HTML head.
- * @implements {import('webpack').WebpackPluginInstance}
+"use strict";const HtmlWebpackPlugin=require("html-webpack-plugin");/**
+ * Webpack plugin that injects TikTok Playable SDK script into the HTML head.
+ * @implements {import('webpack').WebpackPluginInstance}
  */class TikTokInjectorPlugin{apply(compiler){compiler.hooks.compilation.tap("TikTokInjectorPlugin",compilation=>{HtmlWebpackPlugin.getHooks(compilation).alterAssetTagGroups.tapAsync("TikTokInjectorPlugin",(data,callback)=>{data.headTags.splice(0,0,{tagName:"script",voidTag:false,meta:{plugin:"html-inline-script-webpack-plugin"},attributes:{src:"https://sf16-muse-va.ibytedtos.com/obj/union-fe-nc-i18n/playable/sdk/playable-sdk.js",type:"text/javascript"}});callback(null,data)})})}}exports.TikTokInjectorPlugin=TikTokInjectorPlugin;

package/core/plugins/UnityInjectorPlugin.js

@@ -1,16 +1,16 @@
-"use strict";const HtmlWebpackPlugin=require("html-webpack-plugin");/**
- * Unity Ads SDK 注入插件
- * 根据 Unity Ads Playable 标准，注入 MRAID SDK 引用
- * 
- * 文档: https://storage.googleapis.com/unity-ads-aui-prod-deployments/external-app/UnityAds_Playable_guide.pdf
- * 
- * Unity Ads 要求：
- * 1. 使用 MRAID 2.0 标准
- * 2. 必须等待 mraid ready 事件
- * 3. 使用 mraid.open() 处理点击跳转
- * 4. 必须调用 mraid.close() 关闭广告
- * 5. 使用 mraid.fireTrackingEvent() 上报游戏事件
- * 6. 不允许使用 window.top（Unity 平台限制）
+"use strict";const HtmlWebpackPlugin=require("html-webpack-plugin");/**
+ * Unity Ads SDK 注入插件
+ * 根据 Unity Ads Playable 标准，注入 MRAID SDK 引用
+ * 
+ * 文档: https://storage.googleapis.com/unity-ads-aui-prod-deployments/external-app/UnityAds_Playable_guide.pdf
+ * 
+ * Unity Ads 要求：
+ * 1. 使用 MRAID 2.0 标准
+ * 2. 必须等待 mraid ready 事件
+ * 3. 使用 mraid.open() 处理点击跳转
+ * 4. 必须调用 mraid.close() 关闭广告
+ * 5. 使用 mraid.fireTrackingEvent() 上报游戏事件
+ * 6. 不允许使用 window.top（Unity 平台限制）
  */class UnityInjectorPlugin{apply(compiler){compiler.hooks.compilation.tap("UnityInjectorPlugin",compilation=>{// 1. 注入 mraid.js 标签
 HtmlWebpackPlugin.getHooks(compilation).alterAssetTagGroups.tapAsync("UnityInjectorPlugin",(data,callback)=>{// Unity Ads 使用标准 MRAID 协议
 // 在生产环境中，mraid.js 由 Unity Ads 平台提供

package/core/resources/snapchat-config.json

@@ -1 +1 @@
-{ "orientation": 1 }
+{ "orientation": 1 }

package/core/resources/tiktok-config.json

@@ -1 +1 @@
-{ "playable_orientation": 0 }
+{ "playable_orientation": 0 }

package/core/utils/buildDefines.js

@@ -1,3 +1,3 @@
-"use strict";const{options}=require("../options");/**
- * Build's default defines list for dev & prod builds
+"use strict";const{options}=require("../options");/**
+ * Build's default defines list for dev & prod builds
  */exports.buildDefines=function buildDefines(){const defines={__DEV__:JSON.stringify(options["dev"]===undefined?false:options["dev"]),GOOGLE_PLAY_URL:JSON.stringify(options.googlePlayUrl),APP_STORE_URL:JSON.stringify(options.appStoreUrl),AD_NETWORK:JSON.stringify(options["network"]),AD_PROTOCOL:JSON.stringify(options["protocol"]),APP:JSON.stringify(options.app),NAME:JSON.stringify(options.name),VERSION:JSON.stringify(options.version),BUILD_HASH:JSON.stringify((+new Date).toString(36)),LANGUAGE:JSON.stringify(options.language),ORIENTATION:JSON.stringify(options.orientation)};/** @type {AD_NETWORK} */let adNetworkDefine=options["network"];if(adNetworkDefine==="pangle")adNetworkDefine="tiktok";if(adNetworkDefine==="mytarget"||adNetworkDefine==="moloco")adNetworkDefine="facebook";defines["AD_NETWORK"]=JSON.stringify(adNetworkDefine);return defines};

package/core/utils/buildTemplateString.js

@@ -1,5 +1,5 @@
-"use strict";const{options}=require("../options");const{getCurrentDateFormatted}=require("./date");const path=require("path");/** @type {Record<string, string>} Mapping of ad network identifiers to their display names in filenames */const adNetworkFileNameMap={preview:"Preview",bigoads:"bigo"};/**
- * Build's result string from template. Used for outDir or filename
+"use strict";const{options}=require("../options");const{getCurrentDateFormatted}=require("./date");const path=require("path");/** @type {Record<string, string>} Mapping of ad network identifiers to their display names in filenames */const adNetworkFileNameMap={preview:"Preview",bigoads:"bigo"};/**
+ * Build's result string from template. Used for outDir or filename
  */exports.buildTemplateString=function buildTemplateString(template,customOptions){customOptions=customOptions||options;/** @type {AD_NETWORK} */const adNetwork=customOptions["network"];/** @type {AD_PROTOCOL} */// const adProtocol = customOptions['protocol'];
 let networkName=customOptions.adNetworkNames[adNetwork]||adNetworkFileNameMap[adNetwork]||adNetwork;// if (adProtocol === 'dapi') networkName += '_DAPI';
 // 如果是绝对路径，直接返回，不做模板替换

package/core/utils/generateAdikteevHtmlWebpackPluginConfig.js

@@ -1,35 +1,35 @@
-"use strict";const fs=require("fs");const path=require("path");/**
- * Adikteev 平台要求的占位符变量
- * 这些变量会在生产环境中被 Adikteev 平台替换为实际值
- * 
- * 文档: https://help.adikteev.com/hc/en-us/articles/10549028250130
- * 
- * 官方要求:
- * 1. HTML 片段（不是完整 HTML 文档）
- * 2. CSS 必须单独提取为 style.css，通过 <link rel="stylesheet"> 引用
- * 3. JS 必须单独为 creative.js，通过 <script src> 引用
- * 4. JS 和 CSS 文件会被上传到 Adikteev CDN
+"use strict";const fs=require("fs");const path=require("path");/**
+ * Adikteev 平台要求的占位符变量
+ * 这些变量会在生产环境中被 Adikteev 平台替换为实际值
+ * 
+ * 文档: https://help.adikteev.com/hc/en-us/articles/10549028250130
+ * 
+ * 官方要求:
+ * 1. HTML 片段（不是完整 HTML 文档）
+ * 2. CSS 必须单独提取为 style.css，通过 <link rel="stylesheet"> 引用
+ * 3. JS 必须单独为 creative.js，通过 <script src> 引用
+ * 4. JS 和 CSS 文件会被上传到 Adikteev CDN
  */const AdikteevPlaceholders=`<meta charset="UTF-8">
 <link rel="stylesheet" href="style.css">
 <script type="application/javascript">
   var AK_CLICK_DESTINATION_URL = "PLACEHOLDER_CLICK_REDIRECT";
   var AK_CLICK_PIXEL_URL = "PLACEHOLDER_CLICK_PIXEL";
 </script>
-<script type="application/javascript" src="creative.js"></script>`;/**
- * 生成 Adikteev 平台所需的 HTML 配置
- * 
- * Adikteev 特殊要求:
- * 1. 必须是 HTML 代码片段，不是完整 HTML 文档
- * 2. CSS 必须单独提取为 style.css（通过 MiniCssExtractPlugin）
- * 3. JS 必须单独为 creative.js
- * 4. 必须包含 AK_CLICK_DESTINATION_URL 和 AK_CLICK_PIXEL_URL 占位符
- * 5. 使用 <link> 和 <script> 标签引用外部文件
- * 6. 禁止固定宽高，必须响应式布局
- * 
- * 文件上传:
- * - style.css → 上传到 Adikteev CDN
- * - creative.js → 上传到 Adikteev CDN
- * - index.html → HTML 片段（引用上述文件）
+<script type="application/javascript" src="creative.js"></script>`;/**
+ * 生成 Adikteev 平台所需的 HTML 配置
+ * 
+ * Adikteev 特殊要求:
+ * 1. 必须是 HTML 代码片段，不是完整 HTML 文档
+ * 2. CSS 必须单独提取为 style.css（通过 MiniCssExtractPlugin）
+ * 3. JS 必须单独为 creative.js
+ * 4. 必须包含 AK_CLICK_DESTINATION_URL 和 AK_CLICK_PIXEL_URL 占位符
+ * 5. 使用 <link> 和 <script> 标签引用外部文件
+ * 6. 禁止固定宽高，必须响应式布局
+ * 
+ * 文件上传:
+ * - style.css → 上传到 Adikteev CDN
+ * - creative.js → 上传到 Adikteev CDN
+ * - index.html → HTML 片段（引用上述文件）
  */exports.generateAdikteevHtmlWebpackPluginConfig=function generateAdikteevHtmlWebpackPluginConfig(originalHtmlContentPath){originalHtmlContentPath=originalHtmlContentPath||"src/index.html";let originalBody="";try{const content=fs.readFileSync(path.resolve(originalHtmlContentPath),"utf8");const match=content.match(/<body>([\s\S]*?)<\/body>/);if(match){originalBody=match[1].trim();// 移除缩进以获得更清晰的输出
 originalBody=originalBody.replaceAll("    ","").replaceAll("\t","")}}catch(e){console.warn("[Adikteev] Could not read original HTML body:",e.message)}return{filename:"index.html",inject:false,minify:false,templateContent:({htmlWebpackPlugin})=>{// 生成 HTML 代码片段（非完整文档）
 // 结构: CSS 引用 → 占位符变量 → JS 引用 → body 内容

package/core/utils/generateInMobiHtmlWebpackPluginConfig.js

@@ -1,12 +1,12 @@
-"use strict";const fs=require("fs");const path=require("path");/**
- * InMobi 追踪宏定义
- * 文档: https://support.inmobi.com/dsp/in/inmobi-dsp-india/creative-specifications-and-guidelines/
- * 
- * InMobi 要求:
- * 1. 单个 index.html 文件（所有资源内联）或 ZIP 包
- * 2. 必须包含 INMOBI_DSPMACROS 追踪变量
- * 3. 引用外部 mraid.js（由 InMobi 平台提供）
- * 4. 支持 MRAID 3.0 标准
+"use strict";const fs=require("fs");const path=require("path");/**
+ * InMobi 追踪宏定义
+ * 文档: https://support.inmobi.com/dsp/in/inmobi-dsp-india/creative-specifications-and-guidelines/
+ * 
+ * InMobi 要求:
+ * 1. 单个 index.html 文件（所有资源内联）或 ZIP 包
+ * 2. 必须包含 INMOBI_DSPMACROS 追踪变量
+ * 3. 引用外部 mraid.js（由 InMobi 平台提供）
+ * 4. 支持 MRAID 3.0 标准
  */const InMobiPlaceholders=`<script>
   var INMOBI_DSPMACROS = {
     "Ad_Load_Start": ["$P_AD_LOAD_START"],
@@ -23,13 +23,13 @@
     "Spent_30_Seconds": ["$P_TIMESPENT_30"]
   };
 </script>
-<script src="mraid.js"></script>`;/**
- * 生成 InMobi 平台所需的 HTML 配置
- * 
- * 策略: 
- * 1. 使用标准的 HtmlWebpackPlugin 配置（不是 templateContent）
- * 2. JS 会通过 HtmlInlineScriptPlugin 自动内联到 HTML 中
- * 3. 通过修改 template 文件注入 InMobi 追踪脚本
+<script src="mraid.js"></script>`;/**
+ * 生成 InMobi 平台所需的 HTML 配置
+ * 
+ * 策略: 
+ * 1. 使用标准的 HtmlWebpackPlugin 配置（不是 templateContent）
+ * 2. JS 会通过 HtmlInlineScriptPlugin 自动内联到 HTML 中
+ * 3. 通过修改 template 文件注入 InMobi 追踪脚本
  */exports.generateInMobiHtmlWebpackPluginConfig=function generateInMobiHtmlWebpackPluginConfig(originalHtmlContentPath,buildOptions){originalHtmlContentPath=originalHtmlContentPath||"src/index.html";const placeholder=InMobiPlaceholders.replaceAll("{GOOGLE_PLAY_URL}",buildOptions.googlePlayUrl).replaceAll("{APP_STORE_URL}",buildOptions.appStoreUrl);// 读取原始 HTML 模板
 let htmlContent="";try{htmlContent=fs.readFileSync(path.resolve(originalHtmlContentPath),"utf8")}catch(e){console.warn("[InMobi] Could not read HTML template:",e.message)}// 在 </head> 之前注入 InMobi 追踪脚本
 htmlContent=htmlContent.replace("</head>",`${placeholder}\n</head>`);return{filename:"index.html",inject:"head",// webpack 会自动注入 JS，然后 HtmlInlineScriptPlugin 内联

package/core/utils/injectSDKPlugins.js

@@ -1,13 +1,13 @@
-"use strict";/**
- * 根据 AD_NETWORK 和 AD_PROTOCOL 注入对应的渠道 SDK 脚本插件
- * 此函数被 webpack.dev.js 和 webpack.build.js 共用
- */const{ExitAPIInjectorPlugin}=require("../plugins/ExitAPIInjectorPlugin.js");const{DAPIInjectorPlugin}=require("../plugins/DAPIInjectorPlugin.js");const{PangleInjectorPlugin}=require("../plugins/PangleInjectorPlugin.js");const{TikTokInjectorPlugin}=require("../plugins/TikTokInjectorPlugin.js");const{MintegralInjectorPlugin}=require("../plugins/MintegralInjectorPlugin.js");const{MRAIDInjectorPlugin}=require("../plugins/MRAIDInjectorPlugin.js");const{BigoAdsInjectorPlugin}=require("../plugins/BigoAdsInjectorPlugin.js");const{LiftoffInjectorPlugin}=require("../plugins/LiftoffInjectorPlugin.js");const{SnapchatInjectorPlugin}=require("../plugins/SnapchatInjectorPlugin.js");const{AdikteevInjectorPlugin}=require("../plugins/AdikteevInjectorPlugin.js");const{UnityInjectorPlugin}=require("../plugins/UnityInjectorPlugin.js");/**
- * 注入渠道 SDK 插件到 webpack 配置中
- * @param {import('webpack').Configuration} webpackConfig - webpack 配置对象
- * @param {Object} options - 配置选项
- * @param {AD_NETWORK} options.network - 广告网络
- * @param {AD_PROTOCOL} options.protocol - 广告协议
- * @param {string} [options.orientation] - 屏幕方向（google 渠道需要）
+"use strict";/**
+ * 根据 AD_NETWORK 和 AD_PROTOCOL 注入对应的渠道 SDK 脚本插件
+ * 此函数被 webpack.dev.js 和 webpack.build.js 共用
+ */const{ExitAPIInjectorPlugin}=require("../plugins/ExitAPIInjectorPlugin.js");const{DAPIInjectorPlugin}=require("../plugins/DAPIInjectorPlugin.js");const{PangleInjectorPlugin}=require("../plugins/PangleInjectorPlugin.js");const{TikTokInjectorPlugin}=require("../plugins/TikTokInjectorPlugin.js");const{MintegralInjectorPlugin}=require("../plugins/MintegralInjectorPlugin.js");const{MRAIDInjectorPlugin}=require("../plugins/MRAIDInjectorPlugin.js");const{BigoAdsInjectorPlugin}=require("../plugins/BigoAdsInjectorPlugin.js");const{LiftoffInjectorPlugin}=require("../plugins/LiftoffInjectorPlugin.js");const{SnapchatInjectorPlugin}=require("../plugins/SnapchatInjectorPlugin.js");const{AdikteevInjectorPlugin}=require("../plugins/AdikteevInjectorPlugin.js");const{UnityInjectorPlugin}=require("../plugins/UnityInjectorPlugin.js");/**
+ * 注入渠道 SDK 插件到 webpack 配置中
+ * @param {import('webpack').Configuration} webpackConfig - webpack 配置对象
+ * @param {Object} options - 配置选项
+ * @param {AD_NETWORK} options.network - 广告网络
+ * @param {AD_PROTOCOL} options.protocol - 广告协议
+ * @param {string} [options.orientation] - 屏幕方向（google 渠道需要）
  */function injectSDKPlugins(webpackConfig,options){const{network:adNetwork,protocol:adProtocol,orientation}=options;// 协议层注入
 if("dapi"===adProtocol){webpackConfig.plugins.push(new DAPIInjectorPlugin)}else if("mraid"===adProtocol){// 只有 ironsource 才注入 MRAIDInjectorPlugin
 // Unity 使用专门的 UnityInjectorPlugin（在渠道特定注入中处理）

package/core/utils/logOptions.js

@@ -1,5 +1,5 @@
-"use strict";var prettyjson=require("prettyjson");/**
- * Log provided options into console output
+"use strict";var prettyjson=require("prettyjson");/**
+ * Log provided options into console output
  */exports.logOptions=function logOptions(options){let logOptions={mode:process.env.NODE_ENV,...options};let isProduction=false;if(process.env.NODE_ENV==="production"){isProduction=true;delete logOptions.port;delete logOptions.open}else if(process.env.NODE_ENV==="development"){delete logOptions.outDir}if(Object.keys(logOptions.compilation).length===0||!isProduction)delete logOptions.compilation;if(Object.keys(logOptions.adNetworkNames).length===0||!isProduction)delete logOptions.adNetworkNames;if(Object.keys(logOptions.defines).length===0)delete logOptions.defines;if(logOptions.zip===false||!isProduction)delete logOptions.zip;if(logOptions.tsConfig==="tsconfig.json")delete logOptions.tsConfig;if(logOptions.jsConfig==="jsconfig.json")delete logOptions.jsConfig;if(logOptions.buildConfig==="build.json")delete logOptions.buildConfig;if(logOptions.language==="en")delete logOptions.language;if(logOptions.orientation==="both")delete logOptions.orientation;// 在 dev 模式下，如果 network 为默认值 preview 则不显示
 if(!isProduction&&logOptions.network==="preview")delete logOptions.network;// 在 dev 模式下，如果 protocol 为默认值 none 则不显示
 if(!isProduction&&logOptions.protocol==="none")delete logOptions.protocol;delete logOptions.filename;delete logOptions.app;delete logOptions.name;delete logOptions.googlePlayUrl;delete logOptions.appStoreUrl;if(logOptions.obfuscateLevel===2)delete logOptions.obfuscateLevel;console.log(prettyjson.render(logOptions,{},2))};

package/core/utils/mergeOptions.js

@@ -1,6 +1,6 @@
-"use strict";/**
- * Merges two option objects with deep merge for 'defines' and 'build' properties
- * @param {import('../index').CLIOptions} options1 - First options object
- * @param {Partial<import('../index').CLIOptions>} [options2] - Second options object
- * @returns {import('../index').CLIOptions} Merged options object with combined defines and build properties
+"use strict";/**
+ * Merges two option objects with deep merge for 'defines' and 'build' properties
+ * @param {import('../index').CLIOptions} options1 - First options object
+ * @param {Partial<import('../index').CLIOptions>} [options2] - Second options object
+ * @returns {import('../index').CLIOptions} Merged options object with combined defines and build properties
  */exports.mergeOptions=function mergeOptions(options1,options2){if(!options1)return{};if(!options2)return options1;const defines=Object.assign({},options1.defines,options2.defines);const build=Object.assign({},options1.build,options2.build);const compilation=Object.assign({},options1.compilation,options2.compilation);const adNetworkNames=Object.assign({},options1.adNetworkNames,options2.adNetworkNames);const options=Object.assign({},options1,options2);options.defines=defines;options.compilation=compilation;options.adNetworkNames=adNetworkNames;options.build=build;return options};

package/core/utils/parseArgvOptions.js

@@ -1,7 +1,7 @@
-"use strict";/** @type {string[]} List of supported advertising networks */const allowedAdNetworks=["preview","applovin","unity","google","ironsource","facebook","moloco","adcolony","mintegral","vungle","tapjoy","snapchat","tiktok","appreciate","chartboost","pangle","mytarget","liftoff","smadex","adikteev","bigabid","inmobi","bigoads"];/** @type {AD_PROTOCOL[]} List of supported advertising protocols */const allowedAdProtocols=["none","mraid","dapi"];/** @type {AD_NETWORK[]} List of advertising partners that support MRAID protocol */const mraidPartners=["ironsource","applovin","unity","appreciate","chartboost","mytarget","liftoff","adcolony","adikteev","bigabid","inmobi"];/** @type {LANGUAGE[]} */const allowedLanguages=["auto","en","es","zh","hi","ar","fr","de","ja","pt"];/** @type {ORIENTATION[]} */const allowedOrientations=["both","portrait","landscape","square"];/**
- * Parses command line arguments based on provided options configuration
- * @param {import('../index').CLIOptionConfig[]} posiibleOptions - Array of possible options to parse
- * @returns {Record<string, any>} Parsed options object with values from command line arguments
+"use strict";/** @type {string[]} List of supported advertising networks */const allowedAdNetworks=["preview","applovin","unity","google","ironsource","facebook","moloco","adcolony","mintegral","vungle","tapjoy","snapchat","tiktok","appreciate","chartboost","pangle","mytarget","liftoff","smadex","adikteev","bigabid","inmobi","bigoads"];/** @type {AD_PROTOCOL[]} List of supported advertising protocols */const allowedAdProtocols=["none","mraid","dapi"];/** @type {AD_NETWORK[]} List of advertising partners that support MRAID protocol */const mraidPartners=["ironsource","applovin","unity","appreciate","chartboost","mytarget","liftoff","adcolony","adikteev","bigabid","inmobi"];/** @type {LANGUAGE[]} */const allowedLanguages=["auto","en","es","zh","hi","ar","fr","de","ja","pt"];/** @type {ORIENTATION[]} */const allowedOrientations=["both","portrait","landscape","square"];/**
+ * Parses command line arguments based on provided options configuration
+ * @param {import('../index').CLIOptionConfig[]} posiibleOptions - Array of possible options to parse
+ * @returns {Record<string, any>} Parsed options object with values from command line arguments
  */exports.parseArgvOptions=function parseArgvOptions(posiibleOptions){const argvOptions={};for(let possibleOption of posiibleOptions){if(possibleOption.defaultValue!==undefined)argvOptions[possibleOption.alias||possibleOption.name]=possibleOption.defaultValue}let adNetwork=null;for(let i=2;i<process.argv.length;i++){let key=process.argv[i];let inlineValue=null;// 支持 --key=value 格式
 if(key.includes("=")){const eqIndex=key.indexOf("=");inlineValue=key.slice(eqIndex+1);key=key.slice(0,eqIndex)}const allowedOption=posiibleOptions.find(e=>"--"+e.name===key);if(allowedOption){let value=true;if(allowedOption.hasValue){// 优先使用内联值（--key=value），否则使用下一个参数
 value=inlineValue!==null?inlineValue:process.argv[++i];if(allowedOption.parser)value=allowedOption.parser(value)}argvOptions[allowedOption.alias||allowedOption.name]=value}else if(!adNetwork)adNetwork=key}if(posiibleOptions.find(e=>e.name==="network")){if(adNetwork&&allowedAdNetworks.includes(adNetwork)){argvOptions["network"]=adNetwork}if(posiibleOptions.find(e=>e.name==="protocol")){if(mraidPartners.includes(argvOptions["network"])&&argvOptions["protocol"]==="none"){argvOptions["protocol"]="mraid"}}}return argvOptions};exports.allowedAdNetworks=allowedAdNetworks;exports.allowedAdProtocols=allowedAdProtocols;exports.mraidPartners=mraidPartners;exports.allowedLanguages=allowedLanguages;exports.allowedOrientations=allowedOrientations;

package/core/utils/resolveChannelFold2Zip.js

@@ -1,14 +1,14 @@
-"use strict";/**
- * 解析 isChannelFold2Zip 相关标志
- *
- * isChannelFold2Zip：所有渠道（排除 preview）输出 dist/渠道名称.zip
- * - ZIP 渠道（google/tiktok 等）：正常 ZIP 流程，输出路径改为 dist/渠道名称.zip
- * - 非 ZIP 渠道（facebook 默认等）：强制将 HTML 打包成 zip，输出 dist/渠道名称.zip
- *
- * @param {object} params
- * @param {boolean} params.isChannelFold2ZipOption - buildOptions.isChannelFold2Zip 的值
- * @param {string} params.adNetwork - 当前渠道名称
- * @param {boolean} params.isZipOutput - 当前渠道是否本身就走 ZIP 输出流程
- * @returns {{ isChannelFold2Zip: boolean, isZipOutputFinal: boolean }}
+"use strict";/**
+ * 解析 isChannelFold2Zip 相关标志
+ *
+ * isChannelFold2Zip：所有渠道（排除 preview）输出 dist/渠道名称.zip
+ * - ZIP 渠道（google/tiktok 等）：正常 ZIP 流程，输出路径改为 dist/渠道名称.zip
+ * - 非 ZIP 渠道（facebook 默认等）：强制将 HTML 打包成 zip，输出 dist/渠道名称.zip
+ *
+ * @param {object} params
+ * @param {boolean} params.isChannelFold2ZipOption - buildOptions.isChannelFold2Zip 的值
+ * @param {string} params.adNetwork - 当前渠道名称
+ * @param {boolean} params.isZipOutput - 当前渠道是否本身就走 ZIP 输出流程
+ * @returns {{ isChannelFold2Zip: boolean, isZipOutputFinal: boolean }}
  */function resolveChannelFold2Zip({isChannelFold2ZipOption,adNetwork,isZipOutput}){const isChannelFold2Zip=!!(isChannelFold2ZipOption&&adNetwork!=="preview");// 非 ZIP 渠道启用 isChannelFold2Zip 时，需要强制走 ZIP 输出流程
 const isZipOutputFinal=isZipOutput||isChannelFold2Zip;if(isChannelFold2Zip){console.log(`✅ isChannelFold2Zip enabled: output will be dist/${adNetwork}.zip`)}return{isChannelFold2Zip,isZipOutputFinal}}exports.resolveChannelFold2Zip=resolveChannelFold2Zip;

package/core/utils/validateThemeData.js

@@ -0,0 +1,78 @@
+"use strict";const fs=require("fs");const path=require("path");const JSON5=require("json5");const Ajv=require("ajv");const SCHEMA_BACKUP_SUFFIX=".backup";const SCHEMA_BACKUP_COMMENT="// [AUTO-GENERATED BACKUP] This file was created by the build process.\n"+"// If the build was interrupted, you can restore it by removing the \".backup\" suffix\n"+"// and replacing the original \"theme.schema.json5\" with this file.\n";/**
+ * Recursively extract `default` values from a JSON Schema definition.
+ *
+ * - For "object" types: recurse into `properties` and build a nested object.
+ * - For primitive types: return the `default` value if present.
+ *
+ * @param {object} schema - A JSON Schema (or sub-schema) object
+ * @returns {*} The extracted default value tree, or undefined if none
+ */function extractDefaultsFromSchema(schema){if(!schema||typeof schema!=="object")return undefined;if(schema.type==="object"&&schema.properties){const result={};for(const[key,propSchema]of Object.entries(schema.properties)){const val=extractDefaultsFromSchema(propSchema);if(val!==undefined){result[key]=val}}return Object.keys(result).length>0?result:undefined}// Primitive or array type with a default value
+if("default"in schema){return schema.default}return undefined}/**
+ * Validate theme data for a given theme against the schema.
+ *
+ * File layout expected under the project:
+ *   src/theme/theme.schema.json5              – JSON Schema (JSON5 format)
+ *   src/theme/{themeName}/theme.data.json5    – Per-theme data
+ *
+ * Default values are extracted from the schema's `default` fields via extractDefaultsFromSchema,
+ * then deep-merged with theme data (theme data takes priority) before validation.
+ *
+ * @param {string} themeName   - Name of the theme directory
+ * @param {string} projectRoot - Absolute path to the project root
+ * @param {object} [themeConfig] - Optional theme config (themes section from builds.config.js)
+ * @returns {{ defaultData: object, errors: string[] | null }}
+ *   defaultData – The extracted default values from schema
+ *   errors     – null if validation passed, otherwise an array of error messages
+ */function validateThemeData(themeName,projectRoot,themeConfig){const sourceDir=themeConfig&&themeConfig.sourceDir||"src/theme";const themeBaseDir=path.join(projectRoot,sourceDir);// --- Resolve file paths ---
+const schemaPath=path.join(themeBaseDir,"theme.schema.json5");const dataPath=path.join(themeBaseDir,themeName,"theme.data.json5");// --- Read & parse files ---
+if(!fs.existsSync(schemaPath)){return{defaultData:null,errors:[`Schema file not found: ${schemaPath}`]}}const schema=JSON5.parse(fs.readFileSync(schemaPath,"utf8"));// Extract default values from schema
+const defaultData=extractDefaultsFromSchema(schema)||{};let themeData={};if(fs.existsSync(dataPath)){themeData=JSON5.parse(fs.readFileSync(dataPath,"utf8"))}// Deep merge (theme data overrides schema defaults), then validate
+const merged=deepMerge(defaultData,themeData);// --- Validate merged data against schema ---
+const ajv=new Ajv({allErrors:true,strict:false});const validate=ajv.compile(schema);const valid=validate(merged);if(!valid){const errors=validate.errors.map(err=>{const field=err.instancePath||"(root)";return`${field} ${err.message}`});return{defaultData,errors}}return{defaultData,errors:null}}/**
+ * Deep merge two plain objects. Values in `override` take priority.
+ * Arrays are replaced entirely (not concatenated).
+ *
+ * @param {object} base
+ * @param {object} override
+ * @returns {object}
+ */function deepMerge(base,override){const result={...base};for(const key of Object.keys(override)){const baseVal=base[key];const overVal=override[key];if(overVal!==null&&typeof overVal==="object"&&!Array.isArray(overVal)&&baseVal!==null&&typeof baseVal==="object"&&!Array.isArray(baseVal)){result[key]=deepMerge(baseVal,overVal)}else{result[key]=overVal}}return result}/**
+ * Backup the original theme.schema.json5 file.
+ * The backup file includes a comment header explaining how to restore it manually.
+ *
+ * @param {string} schemaPath - Absolute path to theme.schema.json5
+ * @returns {string} The backup file path
+ */function backupSchema(schemaPath){const backupPath=schemaPath+SCHEMA_BACKUP_SUFFIX;const originalContent=fs.readFileSync(schemaPath,"utf8");fs.writeFileSync(backupPath,SCHEMA_BACKUP_COMMENT+originalContent,"utf8");return backupPath}/**
+ * Restore theme.schema.json5 from its backup file and remove the backup.
+ *
+ * @param {string} schemaPath - Absolute path to theme.schema.json5
+ */function restoreSchema(schemaPath){const backupPath=schemaPath+SCHEMA_BACKUP_SUFFIX;if(!fs.existsSync(backupPath))return;const backupContent=fs.readFileSync(backupPath,"utf8");// Strip the auto-generated comment header (lines starting with "//")
+const lines=backupContent.split("\n");const contentStart=lines.findIndex(line=>!line.startsWith("//"));const originalContent=lines.slice(contentStart>=0?contentStart:0).join("\n");fs.writeFileSync(schemaPath,originalContent,"utf8");fs.unlinkSync(backupPath)}/**
+ * Overwrite theme.schema.json5 with the merged data (schema defaults + theme overrides)
+ * so that the bundler can consume it directly during the build.
+ *
+ * @param {string} schemaPath - Absolute path to theme.schema.json5
+ * @param {object} mergedData - The merged theme data to write
+ */function overwriteSchemaWithMerged(schemaPath,mergedData){const content=JSON.stringify(mergedData,null,2);fs.writeFileSync(schemaPath,content,"utf8")}/**
+ * Run theme validation with standard logging.
+ * Shared by both single build (build.js) and batch build (batch-build.js).
+ *
+ * Flow:
+ *   1. Validate theme.data.json5 against theme.schema.json5
+ *   2. Backup theme.schema.json5 (with restore instructions)
+ *   3. Extract defaults from schema via extractDefaultsFromSchema
+ *   4. Overwrite theme.schema.json5 with default data for the build
+ *
+ * After the build (success or failure), call restoreSchema() to restore the original.
+ *
+ * @param {string} themeName   - Name of the theme directory
+ * @param {string} projectRoot - Absolute path to the project root
+ * @param {object} [themeConfig] - Optional theme config (themes section from builds.config.js)
+ * @param {object} [options]
+ * @param {function} [options.log] - Custom log function(message, level). Defaults to console.log.
+ * @returns {{ valid: boolean, errors: string[]|null, schemaPath: string|null }}
+ *   valid      – true if schema file doesn't exist (skip) or validation passed
+ *   errors     – null if validation passed, otherwise an array of error messages
+ *   schemaPath – Absolute path to theme.schema.json5 (for restoreSchema calls), or null
+ */function runThemeValidation(themeName,projectRoot,themeConfig,options){const sourceDir=themeConfig&&themeConfig.sourceDir||"src/theme";const themeBaseDir=path.join(projectRoot,sourceDir);const schemaPath=path.join(themeBaseDir,"theme.schema.json5");// No schema file → skip validation entirely
+if(!fs.existsSync(schemaPath)){return{valid:true,errors:null,schemaPath:null}}const logFn=options&&options.log||function defaultLog(msg,level){const colors={info:"\x1B[36m",success:"\x1B[32m",error:"\x1B[31m"};const reset="\x1B[0m";const color=colors[level]||"";console.log(`${color}${msg}${reset}`)};logFn(`校验主题数据: ${themeName}`,"info");const{defaultData,errors}=validateThemeData(themeName,projectRoot,themeConfig);if(errors){logFn(`主题 "${themeName}" 数据校验失败:`,"error");errors.forEach(e=>logFn(`  - ${e}`,"error"));return{valid:false,errors,schemaPath}}logFn(`主题 "${themeName}" 数据校验通过`,"success");// Backup original schema, then overwrite with default data for the build
+backupSchema(schemaPath);overwriteSchemaWithMerged(schemaPath,defaultData);logFn(`已备份 schema 并写入默认数据`,"info");return{valid:true,errors:null,schemaPath}}module.exports={validateThemeData,deepMerge,extractDefaultsFromSchema,runThemeValidation,backupSchema,restoreSchema,overwriteSchemaWithMerged};

package/core/webpack.build.js

@@ -1,10 +1,10 @@
 "use strict";const{merge}=require("webpack-merge");const{webpackCommonConfig}=require("./webpack.common.js");const webpack=require("webpack");const TerserPlugin=require("terser-webpack-plugin");const CopyWebpackPlugin=require("copy-webpack-plugin");const HtmlInlineScriptPlugin=require("html-inline-script-webpack-plugin");const HtmlWebpackPlugin=require("html-webpack-plugin");const MiniCssExtractPlugin=require("mini-css-extract-plugin");const{ZipPlugin}=require("./plugins/ZipPlugin.js");const{FflateCompressionPlugin}=require("./plugins/FflateCompressionPlugin.js");const{generateAdikteevHtmlWebpackPluginConfig}=require("./utils/generateAdikteevHtmlWebpackPluginConfig.js");const{generateBigabidHtmlWebpackPluginConfig}=require("./utils/generateBigabidHtmlWebpackPluginConfig.js");const{generateInMobiHtmlWebpackPluginConfig}=require("./utils/generateInMobiHtmlWebpackPluginConfig.js");const path=require("path");const{mergeOptions}=require("./utils/mergeOptions.js");const{options}=require("./options.js");const{buildDefines}=require("./utils/buildDefines.js");const{buildTemplateString}=require("./utils/buildTemplateString.js");const{logOptions}=require("./utils/logOptions.js");const{injectSDKPlugins}=require("./utils/injectSDKPlugins.js");const{resolveChannelFold2Zip}=require("./utils/resolveChannelFold2Zip.js");/** @type {AD_NETWORK[]} *//** @type {AD_NETWORK[]} */const zipOutputNetworks=["google","pangle","tiktok","vungle","mytarget","mintegral","adikteev","bigabid","inmobi",// InMobi 支持 ZIP 格式（包含 index.html + 资源文件）
-"snapchat","bigoads","liftoff"];/** @type {AD_NETWORK[]} */const zipOutputAllowedNetworks=["facebook","moloco"];/**
- * Creates webpack configuration for production build
- * @param {Partial<import('./index').CLIOptions>} [customOptions] - Custom options to merge with default options
- * @param {Record<string, any>} [customDefines] - Additional defines for webpack.DefinePlugin
- * @param {import('webpack').Configuration} [webpackCustomConfig] - Custom webpack config to merge
- * @returns {import('webpack').Configuration} Final webpack production configuration
+"snapchat","bigoads","liftoff"];/** @type {AD_NETWORK[]} */const zipOutputAllowedNetworks=["facebook","moloco"];/**
+ * Creates webpack configuration for production build
+ * @param {Partial<import('./index').CLIOptions>} [customOptions] - Custom options to merge with default options
+ * @param {Record<string, any>} [customDefines] - Additional defines for webpack.DefinePlugin
+ * @param {import('webpack').Configuration} [webpackCustomConfig] - Custom webpack config to merge
+ * @returns {import('webpack').Configuration} Final webpack production configuration
  */function makeWebpackBuildConfig(customOptions,customDefines,webpackCustomConfig){const buildOptions=mergeOptions(options,customOptions);logOptions(buildOptions);customDefines=customDefines||{};webpackCustomConfig=webpackCustomConfig||{};/** @type {AD_NETWORK} */const adNetwork=buildOptions["network"];/** @type {AD_PROTOCOL} */const adProtocol=buildOptions["protocol"];let outDir=buildTemplateString(buildOptions.outDir,buildOptions);function getFileName(){let filename=buildTemplateString(buildOptions.filename,buildOptions);if(adNetwork==="mintegral")return filename.replace(/\s+/g,"").replace(/[^a-zA-Z0-9]/g,"_").replace("_fullhash_6_","[fullhash:6]");return filename}const isZipOutput=zipOutputNetworks.includes(adNetwork)||buildOptions.zip&&zipOutputAllowedNetworks.includes(adNetwork);const{isChannelFold2Zip,isZipOutputFinal}=resolveChannelFold2Zip({isChannelFold2ZipOption:buildOptions.isChannelFold2Zip,adNetwork,isZipOutput});let htmlFileName="";if(adNetwork==="mintegral")htmlFileName="index.html";// 修改为 index.html
 else if(isZipOutputFinal)htmlFileName="index.html";else htmlFileName=`${getFileName()}.html`;const metaTags={viewport:"width=device-width,initial-scale=1.0,viewport-fit=cover,maximum-scale=1.0,user-scalable=no"};if(adNetwork==="mintegral"){metaTags["viewport"]="width=device-width,user-scalable=no,initial-scale=1.0,minimum-scale=1.0,maximum-scale=1.0"}if(!buildOptions.skipRecommendedMeta){metaTags["HandheldFriendly"]="True";metaTags["cleartype"]={"http-equiv":"cleartype",content:"on"};metaTags["apple-mobile-web-app-capable"]="yes";metaTags["mobile-web-app-capable"]="yes";metaTags["X-UA-Compatible"]={"http-equiv":"X-UA-Compatible",content:"IE=10"}}let htmlWebpackPluginConfig={template:path.resolve("src/index.html"),filename:htmlFileName,title:`${buildOptions.name} - ${buildOptions.app}`,inlineSource:".(js|css|png|jpg|webp|svg|xml|atlas|mp3|gif|glb|fbx|obj)$",meta:metaTags};if(adNetwork==="adikteev")htmlWebpackPluginConfig=generateAdikteevHtmlWebpackPluginConfig("src/index.html");else if(adNetwork==="bigabid")htmlWebpackPluginConfig=generateBigabidHtmlWebpackPluginConfig("src/index.html");else if(adNetwork==="inmobi")htmlWebpackPluginConfig=generateInMobiHtmlWebpackPluginConfig("src/index.html",buildOptions);const webpackConfig=merge(webpackCommonConfig,{mode:"production",stats:"errors-only",optimization:{usedExports:true,minimize:true,minimizer:[new TerserPlugin({extractComments:false,terserOptions:{safari10:true,mangle:{reserved:["$"],// ⚠️ 不要开启 properties: true，会混淆 Phaser 等框架的属性名导致运行时错误
 // properties: true,
@@ -51,12 +51,12 @@ injectSDKPlugins(webpackConfig,{network:adNetwork,protocol:adProtocol,orientatio
 webpackConfig.plugins.push(new CopyWebpackPlugin({patterns:[{from:path.join(__dirname,"resources","bigoads-config.json"),to:"config.json"}]}))}webpackConfig.plugins.push(new ZipPlugin({filename:isChannelFold2Zip?adNetwork:getFileName(),path:path.resolve(outDir),cleanTempFolder:true// 🗑️ 生成 zip 后删除临时文件夹
 }));webpackConfig.output.path=path.resolve(outDir,adNetwork);if(adNetwork==="adikteev"){webpackConfig.output.filename="creative.js";// Adikteev 需要将 CSS 单独提取为 style.css 文件
 webpackConfig.plugins.push(new MiniCssExtractPlugin({filename:"style.css"}))}else if(adNetwork==="bigabid")webpackConfig.output.filename="main.js";else if(adNetwork==="inmobi")webpackConfig.output.filename="main.js"}// 添加 fflate 压缩插件（仅在打正式包时生效）
-if(buildOptions.fflateCompression){console.log("\u2705 fflate compression enabled (production build only)");webpackConfig.plugins.push(new FflateCompressionPlugin({enabled:true,level:9,keepOriginal:false,logStats:true,googlePlayUrl:buildOptions.googlePlayUrl,appStoreUrl:buildOptions.appStoreUrl}))}return webpackConfig}/**
- * Runs webpack production build
- * @param {import('webpack').Configuration} [webpackConfig] - Webpack configuration to use, creates default if not provided
- * @param {Partial<import('./index').CLIOptions>} [customOptions] - Custom options to merge with default options
- * @param {Record<string, any>} [customDefines] - Additional defines for webpack.DefinePlugin
- * @param {import('webpack').Configuration} [webpackCustomConfig] - Custom webpack config to merge
+if(buildOptions.fflateCompression){console.log("\u2705 fflate compression enabled (production build only)");webpackConfig.plugins.push(new FflateCompressionPlugin({enabled:true,level:9,keepOriginal:false,logStats:true,googlePlayUrl:buildOptions.googlePlayUrl,appStoreUrl:buildOptions.appStoreUrl}))}return webpackConfig}/**
+ * Runs webpack production build
+ * @param {import('webpack').Configuration} [webpackConfig] - Webpack configuration to use, creates default if not provided
+ * @param {Partial<import('./index').CLIOptions>} [customOptions] - Custom options to merge with default options
+ * @param {Record<string, any>} [customDefines] - Additional defines for webpack.DefinePlugin
+ * @param {import('webpack').Configuration} [webpackCustomConfig] - Custom webpack config to merge
  */function runBuild(webpackConfig,customOptions,customDefines,webpackCustomConfig){return new Promise((resolve,reject)=>{if(!webpackConfig)webpackConfig=makeWebpackBuildConfig(customOptions,customDefines,webpackCustomConfig);const compiler=webpack(webpackConfig);compiler.run((err,stats)=>{if(err){console.error("Build failed:",err.stack||err);if(err.details){console.error("Error details:",err.details)}return reject(err)}if(stats.hasErrors()){const errors=stats.compilation.errors;console.error(`\n❌ Build finished with ${errors.length} error(s):\n`);// 打印每个错误的详细信息
 errors.forEach((error,index)=>{console.error(`\n[Error ${index+1}/${errors.length}]`);console.error(error.message||error);if(error.stack){console.error(error.stack)}});// 拒绝 Promise 时传递格式化的错误消息
 const errorMessage=errors.map((e,i)=>`[${i+1}] ${e.message||e}`).join("\n");reject(new Error(`Webpack build failed with ${errors.length} error(s):\n${errorMessage}`))}else{console.log(`Build successful!`);resolve()}})})}exports.makeWebpackBuildConfig=makeWebpackBuildConfig;exports.runBuild=runBuild;

package/core/webpack.common.js

@@ -1,4 +1,4 @@
-"use strict";const path=require("path");const fs=require("fs");const TsconfigPathsPlugin=require("tsconfig-paths-webpack-plugin");const{VueLoaderPlugin}=require("vue-loader");const{options}=require("./options");const tsConfigPath=path.resolve(options.tsConfig);const jsConfigPath=path.resolve(options.jsConfig);let jsTsConfigPath=null;if(fs.existsSync(tsConfigPath)){jsTsConfigPath=tsConfigPath}else if(fs.existsSync(jsConfigPath)){jsTsConfigPath=jsConfigPath}/** @type {string[]} List of file extensions that webpack will resolve */const allowedExtensions=[".vue",".ts",".tsx",".js",".json",".png",".glb",".fbx",".obj",".jpg",".webp",".mp3",".svg",".xml",".atlas",".fnt",".css",".gif",".mp4",".woff",".woff2",".ttf",".otf"];/** @type {import('webpack').Configuration} Base webpack configuration used by both development and build configs */const webpackConfig={entry:path.resolve("src/index"),resolve:{extensions:allowedExtensions,alias:{assets:path.resolve("assets"),vue:"vue/dist/vue.esm-bundler.js","@":path.resolve("src")},plugins:jsTsConfigPath?[new TsconfigPathsPlugin({configFile:jsTsConfigPath,extensions:allowedExtensions})]:[]},output:{filename:"build.js",path:path.resolve("dist")},module:{rules:[// Vue 单文件组件
+"use strict";const path=require("path");const fs=require("fs");const TsconfigPathsPlugin=require("tsconfig-paths-webpack-plugin");const{VueLoaderPlugin}=require("vue-loader");const{options}=require("./options");const tsConfigPath=path.resolve(options.tsConfig);const jsConfigPath=path.resolve(options.jsConfig);let jsTsConfigPath=null;if(fs.existsSync(tsConfigPath)){jsTsConfigPath=tsConfigPath}else if(fs.existsSync(jsConfigPath)){jsTsConfigPath=jsConfigPath}/** @type {string[]} List of file extensions that webpack will resolve */const allowedExtensions=[".vue",".ts",".tsx",".js",".json",".json5",".png",".glb",".fbx",".obj",".jpg",".webp",".mp3",".svg",".xml",".atlas",".fnt",".css",".gif",".mp4",".woff",".woff2",".ttf",".otf"];/** @type {import('webpack').Configuration} Base webpack configuration used by both development and build configs */const webpackConfig={entry:path.resolve("src/index"),resolve:{extensions:allowedExtensions,alias:{assets:path.resolve("assets"),vue:"vue/dist/vue.esm-bundler.js","@":path.resolve("src")},plugins:jsTsConfigPath?[new TsconfigPathsPlugin({configFile:jsTsConfigPath,extensions:allowedExtensions})]:[]},output:{filename:"build.js",path:path.resolve("dist")},module:{rules:[// Vue 单文件组件
 {test:/\.vue$/,loader:"vue-loader"},// {
 //   test: /\.tsx?$/,
 //   use: 'ts-loader',
@@ -7,4 +7,4 @@
 {test:/\.ts?$/,exclude:/node_modules/,use:[{loader:"babel-loader",options:{// presets: ['@babel/preset-env'],
 plugins:options.compilation.allowTemplateLiterals===false?["@babel/plugin-transform-template-literals"]:[]}},{loader:"esbuild-loader",options:{loader:"ts",target:"es2015"}}]},{test:/\.css$/,use:["style-loader","css-loader"]},{test:/\.(js|mjs)$/,// exclude: /node_modules/,
 use:{loader:"babel-loader",options:{// presets: ['@babel/preset-env'],
-plugins:options.compilation.allowTemplateLiterals===false?["@babel/plugin-transform-template-literals"]:[]}}},{test:/\.(gltf)$/,loader:path.join(__dirname,"loaders/gltf-loader.js")},{test:/\.(gif|png|jpe?g|webp|mp3|mp4|m4a|ogg|wav|glb|fbx|obj)$/i,type:"asset/inline"},{test:/\.(svg|xml|json)$/i,type:"asset/source"},{test:/\.atlas$/,type:"asset/inline",generator:{dataUrl:content=>{return`data:text/atlas;base64,${content.toString("base64")}`}}},{test:/\.fnt$/i,type:"asset/inline",generator:{dataUrl:content=>{return`data:text/plain;base64,${content.toString("base64")}`}}},{test:/\.(woff|woff2|eot|ttf|otf)$/i,type:"asset/inline"}]},plugins:[new VueLoaderPlugin]};exports.allowedExtensions=allowedExtensions;exports.webpackCommonConfig=webpackConfig;
+plugins:options.compilation.allowTemplateLiterals===false?["@babel/plugin-transform-template-literals"]:[]}}},{test:/\.(gltf)$/,loader:path.join(__dirname,"loaders/gltf-loader.js")},{test:/\.(gif|png|jpe?g|webp|mp3|mp4|m4a|ogg|wav|glb|fbx|obj)$/i,type:"asset/inline"},{test:/\.json5$/i,type:"javascript/auto",use:{loader:"json5-loader",options:{esModule:false}}},{test:/\.(svg|xml|json)$/i,type:"asset/source"},{test:/\.atlas$/,type:"asset/inline",generator:{dataUrl:content=>{return`data:text/atlas;base64,${content.toString("base64")}`}}},{test:/\.fnt$/i,type:"asset/inline",generator:{dataUrl:content=>{return`data:text/plain;base64,${content.toString("base64")}`}}},{test:/\.(woff|woff2|eot|ttf|otf)$/i,type:"asset/inline"}]},plugins:[new VueLoaderPlugin]};exports.allowedExtensions=allowedExtensions;exports.webpackCommonConfig=webpackConfig;

package/core/webpack.dev.js

@@ -1,15 +1,15 @@
-"use strict";const{merge}=require("webpack-merge");const webpack=require("webpack");const HtmlWebpackPlugin=require("html-webpack-plugin");const WebpackDevServer=require("webpack-dev-server");const{webpackCommonConfig}=require("./webpack.common.js");const path=require("path");const{DebuggerInjectionPlugin}=require("./plugins/DebuggerInjectionPlugin.js");const{options}=require("./options.js");const{mergeOptions}=require("./utils/mergeOptions.js");const{buildDefines}=require("./utils/buildDefines.js");const{logOptions}=require("./utils/logOptions.js");const{injectSDKPlugins}=require("./utils/injectSDKPlugins.js");/**
- * Creates webpack configuration for development
- * @param {Partial<import('./index').CLIOptions>} [customOptions] - Custom options to merge with default options
- * @param {Record<string, any>} [customDefines] - Additional defines for webpack.DefinePlugin
- * @param {import('webpack').Configuration} [webpackCustomConfig] - Custom webpack config to merge
- * @returns {import('webpack').Configuration} Final webpack development configuration
+"use strict";const{merge}=require("webpack-merge");const webpack=require("webpack");const HtmlWebpackPlugin=require("html-webpack-plugin");const WebpackDevServer=require("webpack-dev-server");const{webpackCommonConfig}=require("./webpack.common.js");const path=require("path");const{DebuggerInjectionPlugin}=require("./plugins/DebuggerInjectionPlugin.js");const{options}=require("./options.js");const{mergeOptions}=require("./utils/mergeOptions.js");const{buildDefines}=require("./utils/buildDefines.js");const{logOptions}=require("./utils/logOptions.js");const{injectSDKPlugins}=require("./utils/injectSDKPlugins.js");/**
+ * Creates webpack configuration for development
+ * @param {Partial<import('./index').CLIOptions>} [customOptions] - Custom options to merge with default options
+ * @param {Record<string, any>} [customDefines] - Additional defines for webpack.DefinePlugin
+ * @param {import('webpack').Configuration} [webpackCustomConfig] - Custom webpack config to merge
+ * @returns {import('webpack').Configuration} Final webpack development configuration
  */function makeWebpackDevConfig(customOptions,customDefines,webpackCustomConfig){const devOptions=mergeOptions(options,customOptions);logOptions(devOptions);customDefines=customDefines||{};webpackCustomConfig=webpackCustomConfig||{};const webpackConfig=merge(webpackCommonConfig,{mode:"development",devtool:"inline-source-map",devServer:{static:{directory:path.resolve("dist")},hot:true,// compress: true,
 port:devOptions["port"],allowedHosts:"all",open:devOptions["open"]},plugins:[new HtmlWebpackPlugin({template:path.resolve("src/index.html"),inlineSource:".(js|css|png|jpg|webp|svg|xml|atlas|mp3|gif|glb|fbx|obj)$",meta:{viewport:"width=device-width,initial-scale=1.0,viewport-fit=cover,maximum-scale=1.0,user-scalable=no"}}),new webpack.DefinePlugin({...buildDefines(),...devOptions.defines,__DEV__:JSON.stringify(devOptions["dev"]===undefined?true:devOptions["dev"]),...customDefines})]},webpackCustomConfig);if(devOptions["debugger"]){webpackConfig.plugins.push(new DebuggerInjectionPlugin(devOptions["debugger"]))}// 注入渠道 SDK 插件（与 build 保持一致）
-injectSDKPlugins(webpackConfig,{network:devOptions["network"],protocol:devOptions["protocol"],orientation:devOptions["orientation"]});return webpackConfig}/**
- * Starts webpack development server
- * @param {import('webpack').Configuration} [webpackConfig] - Webpack configuration to use, creates default if not provided
- * @param {Partial<import('./index').CLIOptions>} [customOptions] - Custom options to merge with default options
- * @param {Record<string, any>} [customDefines] - Additional defines for webpack.DefinePlugin
- * @param {import('webpack').Configuration} [webpackCustomConfig] - Custom webpack config to merge
+injectSDKPlugins(webpackConfig,{network:devOptions["network"],protocol:devOptions["protocol"],orientation:devOptions["orientation"]});return webpackConfig}/**
+ * Starts webpack development server
+ * @param {import('webpack').Configuration} [webpackConfig] - Webpack configuration to use, creates default if not provided
+ * @param {Partial<import('./index').CLIOptions>} [customOptions] - Custom options to merge with default options
+ * @param {Record<string, any>} [customDefines] - Additional defines for webpack.DefinePlugin
+ * @param {import('webpack').Configuration} [webpackCustomConfig] - Custom webpack config to merge
  */function runDev(webpackConfig,customOptions,customDefines,webpackCustomConfig){if(!webpackConfig)webpackConfig=makeWebpackDevConfig(customOptions,customDefines,webpackCustomConfig);const compiler=webpack(webpackConfig);const server=new WebpackDevServer(webpackConfig.devServer,compiler);server.start()}exports.makeWebpackDevConfig=makeWebpackDevConfig;exports.runDev=runDev;

package/defines.d.ts

@@ -1,54 +1,54 @@
-declare module '*.png';
-declare module '*.jpg';
-declare module '*.svg';
-declare module '*.webp';
-declare module '*.xml';
-declare module '*.atlas';
-declare module '*.glb';
-declare module '*.gltf';
-declare module '*.fbx';
-declare module '*.obj';
-declare module '*.mp3';
-declare module '*.mp4';
-declare module '*.otf';
-declare module '*.ttf';
-declare module '*.woff';
-declare module '*.woff2';
- 
-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 APP: string;
-declare const NAME: string;
-declare const VERSION: string;
-declare const LANGUAGE: 'auto' | 'en' | 'es' | 'zh' | 'hi' | 'ar' | 'fr' | 'de' | 'ja' | 'pt';
-declare const ORIENTATION: 'both' | 'portrait' | 'landscape' | 'square';
-declare const BUILD_HASH: string;
-
-declare const __DEV__: boolean;
+declare module '*.png';
+declare module '*.jpg';
+declare module '*.svg';
+declare module '*.webp';
+declare module '*.xml';
+declare module '*.atlas';
+declare module '*.glb';
+declare module '*.gltf';
+declare module '*.fbx';
+declare module '*.obj';
+declare module '*.mp3';
+declare module '*.mp4';
+declare module '*.otf';
+declare module '*.ttf';
+declare module '*.woff';
+declare module '*.woff2';
+ 
+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 APP: string;
+declare const NAME: string;
+declare const VERSION: string;
+declare const LANGUAGE: 'auto' | 'en' | 'es' | 'zh' | 'hi' | 'ar' | 'fr' | 'de' | 'ja' | 'pt';
+declare const ORIENTATION: 'both' | 'portrait' | 'landscape' | 'square';
+declare const BUILD_HASH: string;
+
+declare const __DEV__: boolean;