@playcraft/devkit 1.0.11 → 1.0.13

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:(buildOptions.obfuscateLevel!==undefined?buildOptions.obfuscateLevel:2)>=1,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.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;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@playcraft/devkit",
-  "version": "1.0.11",
+  "version": "1.0.13",
   "description": "HTML5 Playable Ads 构建工具，支持多广告渠道打包",
   "main": "core/index.js",
   "module": "core/index.js",