@playcraft/devkit 1.0.31-beta.10 → 1.0.31-beta.11

package/core/engines/web/webpack.common.js

@@ -1,11 +1,177 @@
-"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',
-//   exclude: /node_modules/,
-// },
-{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|mpeg|mp4|m4a|ogg|wav|glb|fbx|obj)$/i,type:"asset/inline"},{test:/\.json5$/i,type:"javascript/auto",use:{loader:"json5-loader",options:{esModule:false}}},// 处理 json?url → base64
-{test:/\.json$/i,resourceQuery:/url/,type:"asset/inline",generator:{dataUrl:content=>`data:application/json;base64,${content.toString("base64")}`}},{test:/\.(svg|xml)$/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;
+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',
+      //   exclude: /node_modules/,
+      // },
+      {
+        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|mpeg|mp4|m4a|ogg|wav|glb|fbx|obj)$/i,
+        type: 'asset/inline'
+      },
+      {
+        test: /\.json5$/i,
+        type: 'javascript/auto',
+        use: {
+          loader: 'json5-loader',
+          options: {
+            esModule: false
+          }
+        }
+      },
+      // 处理 json?url → base64
+      {
+        test: /\.json$/i,
+        resourceQuery: /url/,
+        type: 'asset/inline',
+        generator: {
+          dataUrl: (content) => `data:application/json;base64,${content.toString('base64')}`
+        }
+      },
+      {
+        test: /\.(svg|xml)$/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/engines/web/webpack.dev.js

@@ -1,16 +1,98 @@
-"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");const{PlaycraftOrientationInjectorPlugin}=require("../../plugins/PlaycraftOrientationInjectorPlugin.js");/**
+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');
+const { PlaycraftOrientationInjectorPlugin } = require('../../plugins/PlaycraftOrientationInjectorPlugin.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||{};/** @type {'both'|'landscape'|'portrait'} */const playcraftOrientationValue=devOptions.playcraftOrientationValue||"both";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"}}),// 注入 window.playcraftOrientation 全局变量，标识当前构建产物对应的横竖屏方向版本
-new PlaycraftOrientationInjectorPlugin(playcraftOrientationValue),new webpack.DefinePlugin({...buildDefines(devOptions),...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"],playcraftOrientationValue});return webpackConfig}/**
+ */
+function makeWebpackDevConfig(customOptions, customDefines, webpackCustomConfig) {
+  const devOptions = mergeOptions(options, customOptions);
+  logOptions(devOptions)
+  customDefines = customDefines || {};
+  webpackCustomConfig = webpackCustomConfig || {};
+
+  /** @type {'both'|'landscape'|'portrait'} */
+  const playcraftOrientationValue = devOptions.playcraftOrientationValue || 'both';
+
+  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'
+          }
+        }),
+        // 注入 window.playcraftOrientation 全局变量，标识当前构建产物对应的横竖屏方向版本
+        new PlaycraftOrientationInjectorPlugin(playcraftOrientationValue),
+
+        new webpack.DefinePlugin({
+          ...buildDefines(devOptions),
+          ...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'],
+    playcraftOrientationValue
+  });
+
+  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;
+ */
+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/core/index.js

@@ -1,7 +1,101 @@
-"use strict";const{allowedExtensions,webpackCommonConfig}=require("./webpack.common.js");const{parseArgvOptions}=require("./utils/parseArgvOptions.js");const{mergeOptions}=require("./utils/mergeOptions.js");const{options}=require("./options.js");const{DAPIInjectorPlugin}=require("./plugins/DAPIInjectorPlugin.js");const{DebuggerInjectionPlugin}=require("./plugins/DebuggerInjectionPlugin.js");const{ExitAPIInjectorPlugin}=require("./plugins/ExitAPIInjectorPlugin.js");const{runBuild,makeWebpackBuildConfig}=require("./webpack.build.js");const{runDev,makeWebpackDevConfig}=require("./webpack.dev.js");const{runViteDev,makeViteDevConfig,json5Plugin,assetInlinePlugin,fontFamilyPlugin}=require("./vite.dev.js");// 字体注入
-const{FontInjectionWebpackPlugin}=require("./plugins/FontInjectionWebpackPlugin.js");const{FONT_REGISTRY,getRegisteredFontKeys,isBuiltin:isBuiltinFont,getFontEntry}=require("./utils/fontRegistry.js");const{getOrGenerateFontCSS}=require("./utils/fontResolver.js");// 验证器
-const{runPreBuildChecks,runTrackingCheck,registerChecker,toggleChecker,listCheckers}=require("./validators/pre-build-checker.js");const{validateTracking,printValidationResult,TRACKING_METHODS,SDK_TO_TRACKING_MAP}=require("./validators/tracking-validator.js");exports.mergeOptions=mergeOptions;exports.parseArgvOptions=parseArgvOptions;exports.options=options;exports.allowedExtensions=allowedExtensions;exports.webpackCommonConfig=webpackCommonConfig;exports.makeWebpackDevConfig=makeWebpackDevConfig;exports.makeWebpackBuildConfig=makeWebpackBuildConfig;exports.runDev=runDev;exports.runBuild=runBuild;exports.DAPIInjectorPlugin=DAPIInjectorPlugin;exports.ExitAPIInjectorPlugin=ExitAPIInjectorPlugin;exports.DebuggerInjectionPlugin=DebuggerInjectionPlugin;exports.makeViteDevConfig=makeViteDevConfig;exports.runViteDev=runViteDev;// 公共 Vite 插件（供项目 vite.config.ts 直接引用）
-exports.json5Plugin=json5Plugin;exports.assetInlinePlugin=assetInlinePlugin;exports.fontFamilyPlugin=fontFamilyPlugin;// 编译前检查器导出
-exports.runPreBuildChecks=runPreBuildChecks;exports.runTrackingCheck=runTrackingCheck;exports.registerChecker=registerChecker;exports.toggleChecker=toggleChecker;exports.listCheckers=listCheckers;// 埋点验证器导出
-exports.validateTracking=validateTracking;exports.printValidationResult=printValidationResult;exports.TRACKING_METHODS=TRACKING_METHODS;exports.SDK_TO_TRACKING_MAP=SDK_TO_TRACKING_MAP;// 字体注入导出
-exports.FontInjectionWebpackPlugin=FontInjectionWebpackPlugin;exports.FONT_REGISTRY=FONT_REGISTRY;exports.getRegisteredFontKeys=getRegisteredFontKeys;exports.isBuiltinFont=isBuiltinFont;exports.getFontEntry=getFontEntry;exports.getOrGenerateFontCSS=getOrGenerateFontCSS;const{runCocosBuild,syncThemeForPreview}=require("./engines/cocos/pack.js");const{runCocosEngineBuild}=require("./engines/cocos/cli-build.js");const{prepareWritableCocosCli}=require("./engines/cocos/writable-cli.js");const{syncGeneratedTheme}=require("./engines/cocos/theme-assets.js");const{refreshAssets}=require("./engines/cocos/mcp-refresh.js");const{spawnCocos,needsXvfb}=require("./engines/cocos/cli.js");const{stripAdsdkCjsImport,stripSocialShareFromDir,isSocialMediaNetwork}=require("./engines/cocos/strip-social-share.js");const{runCocosDev}=require("./engines/cocos/dev-server.js");exports.runCocosBuild=runCocosBuild;exports.syncThemeForPreview=syncThemeForPreview;exports.runCocosEngineBuild=runCocosEngineBuild;exports.prepareWritableCocosCli=prepareWritableCocosCli;exports.syncGeneratedTheme=syncGeneratedTheme;exports.refreshAssets=refreshAssets;exports.spawnCocos=spawnCocos;exports.needsXvfb=needsXvfb;exports.stripAdsdkCjsImport=stripAdsdkCjsImport;exports.stripSocialShareFromDir=stripSocialShareFromDir;exports.isSocialMediaNetwork=isSocialMediaNetwork;exports.runCocosDev=runCocosDev;
+const { allowedExtensions, webpackCommonConfig } = require('./webpack.common.js');
+const { parseArgvOptions } = require('./utils/parseArgvOptions.js');
+const { mergeOptions } = require('./utils/mergeOptions.js');
+const { options } = require('./options.js');
+const { DAPIInjectorPlugin } = require('./plugins/DAPIInjectorPlugin.js');
+const { DebuggerInjectionPlugin } = require('./plugins/DebuggerInjectionPlugin.js');
+const { ExitAPIInjectorPlugin } = require('./plugins/ExitAPIInjectorPlugin.js');
+const { runBuild, makeWebpackBuildConfig } = require('./webpack.build.js');
+const { runDev, makeWebpackDevConfig } = require('./webpack.dev.js');
+const { runViteDev, makeViteDevConfig, json5Plugin, assetInlinePlugin, fontFamilyPlugin } = require('./vite.dev.js');
+
+// 字体注入
+const { FontInjectionWebpackPlugin } = require('./plugins/FontInjectionWebpackPlugin.js');
+const { FONT_REGISTRY, getRegisteredFontKeys, isBuiltin: isBuiltinFont, getFontEntry } = require('./utils/fontRegistry.js');
+const { getOrGenerateFontCSS } = require('./utils/fontResolver.js');
+
+// 验证器
+const { 
+  runPreBuildChecks, 
+  runTrackingCheck,
+  registerChecker,
+  toggleChecker,
+  listCheckers 
+} = require('./validators/pre-build-checker.js');
+
+const { 
+  validateTracking, 
+  printValidationResult,
+  TRACKING_METHODS,
+  SDK_TO_TRACKING_MAP 
+} = require('./validators/tracking-validator.js');
+
+exports.mergeOptions = mergeOptions;
+exports.parseArgvOptions = parseArgvOptions;
+
+exports.options = options;
+
+exports.allowedExtensions = allowedExtensions;
+exports.webpackCommonConfig = webpackCommonConfig;
+exports.makeWebpackDevConfig = makeWebpackDevConfig;
+exports.makeWebpackBuildConfig = makeWebpackBuildConfig;
+exports.runDev = runDev;
+exports.runBuild = runBuild;
+
+exports.DAPIInjectorPlugin = DAPIInjectorPlugin;
+exports.ExitAPIInjectorPlugin = ExitAPIInjectorPlugin;
+exports.DebuggerInjectionPlugin = DebuggerInjectionPlugin;
+
+exports.makeViteDevConfig = makeViteDevConfig;
+exports.runViteDev = runViteDev;
+
+// 公共 Vite 插件（供项目 vite.config.ts 直接引用）
+exports.json5Plugin = json5Plugin;
+exports.assetInlinePlugin = assetInlinePlugin;
+exports.fontFamilyPlugin = fontFamilyPlugin;
+
+// 编译前检查器导出
+exports.runPreBuildChecks = runPreBuildChecks;
+exports.runTrackingCheck = runTrackingCheck;
+exports.registerChecker = registerChecker;
+exports.toggleChecker = toggleChecker;
+exports.listCheckers = listCheckers;
+
+// 埋点验证器导出
+exports.validateTracking = validateTracking;
+exports.printValidationResult = printValidationResult;
+exports.TRACKING_METHODS = TRACKING_METHODS;
+exports.SDK_TO_TRACKING_MAP = SDK_TO_TRACKING_MAP;
+
+// 字体注入导出
+exports.FontInjectionWebpackPlugin = FontInjectionWebpackPlugin;
+exports.FONT_REGISTRY = FONT_REGISTRY;
+exports.getRegisteredFontKeys = getRegisteredFontKeys;
+exports.isBuiltinFont = isBuiltinFont;
+exports.getFontEntry = getFontEntry;
+exports.getOrGenerateFontCSS = getOrGenerateFontCSS;
+
+const { runCocosBuild, syncThemeForPreview } = require('./engines/cocos/pack.js');
+const { runCocosEngineBuild } = require('./engines/cocos/cli-build.js');
+const { prepareWritableCocosCli } = require('./engines/cocos/writable-cli.js');
+const { syncGeneratedTheme } = require('./engines/cocos/theme-assets.js');
+const { refreshAssets } = require('./engines/cocos/mcp-refresh.js');
+const { spawnCocos, needsXvfb } = require('./engines/cocos/cli.js');
+const {
+  stripAdsdkCjsImport,
+  stripSocialShareFromDir,
+  isSocialMediaNetwork,
+} = require('./engines/cocos/strip-social-share.js');
+const { runCocosDev } = require('./engines/cocos/dev-server.js');
+exports.runCocosBuild = runCocosBuild;
+exports.syncThemeForPreview = syncThemeForPreview;
+exports.runCocosEngineBuild = runCocosEngineBuild;
+exports.prepareWritableCocosCli = prepareWritableCocosCli;
+exports.syncGeneratedTheme = syncGeneratedTheme;
+exports.refreshAssets = refreshAssets;
+exports.spawnCocos = spawnCocos;
+exports.needsXvfb = needsXvfb;
+exports.stripAdsdkCjsImport = stripAdsdkCjsImport;
+exports.stripSocialShareFromDir = stripSocialShareFromDir;
+exports.isSocialMediaNetwork = isSocialMediaNetwork;
+exports.runCocosDev = runCocosDev;

package/core/injectors/apply.js

@@ -1 +1,94 @@
-"use strict";const{load}=require("cheerio");const{META,LIFTOFF_FONT}=require("./spec");function renderTag(tag){const attrs=tag.attributes||{};const attrStr=Object.entries(attrs).map(([k,v])=>`${k}="${String(v).replace(/"/g,"&quot;")}"`).join(" ");if(tag.tagName==="meta"){return`<meta ${attrStr} />`}const inner=tag.innerHTML||"";return`<script${attrStr?" "+attrStr:""}>${inner}</script>`}function applyMeta($,spec){const viewport=spec.viewport||META.COMMON_VIEWPORT;if($("meta[charset]").length){$("meta[charset]").first().attr("charset",META.COMMON_CHARSET)}else{$("head").prepend(`<meta charset="${META.COMMON_CHARSET}" />`)}if($("meta[name=\"viewport\"]").length){$("meta[name=\"viewport\"]").attr("content",viewport)}else{$("head").prepend(`<meta name="viewport" content="${viewport}" />`)}if(!spec.skipRecommendedMeta){if(!$("meta[name=\"HandheldFriendly\"]").length){$("head").append("<meta name=\"HandheldFriendly\" content=\"True\" />")}if(!$("meta[http-equiv=\"cleartype\"]").length){$("head").append("<meta http-equiv=\"cleartype\" content=\"on\" />")}if(!$("meta[name=\"apple-mobile-web-app-capable\"]").length){$("head").append("<meta name=\"apple-mobile-web-app-capable\" content=\"yes\" />")}if(!$("meta[name=\"mobile-web-app-capable\"]").length){$("head").append("<meta name=\"mobile-web-app-capable\" content=\"yes\" />")}if(!$("meta[http-equiv=\"X-UA-Compatible\"]").length){$("head").append("<meta http-equiv=\"X-UA-Compatible\" content=\"IE=10\" />")}}if(spec.liftoffFont){$("head").append(LIFTOFF_FONT)}}function applyInjections(html,spec){const $=load(html);applyMeta($,spec);const tags=(spec.headTags||[]).slice().reverse();for(const tag of tags){$("head").prepend(renderTag(tag))}let out=$.html();for(const transform of spec.htmlTransforms||[]){out=transform(out)}if(spec.scanStubHtml){if(/<\/body>/i.test(out)){out=out.replace(/<\/body>/i,`${spec.scanStubHtml}</body>`)}else{out+=spec.scanStubHtml}}return out}function extractInlineScripts(html){const $=load(html);const scripts=[];$("script").each((_i,el)=>{const $el=$(el);if($el.attr("src"))return;scripts.push($el.html()||"");$el.remove()});return{html:$.html(),scripts}}function extractBodyScripts(html){return extractInlineScripts(html)}module.exports={applyInjections,extractBodyScripts,extractInlineScripts,renderTag};
+'use strict';
+
+const { load } = require('cheerio');
+const { META, LIFTOFF_FONT } = require('./spec');
+
+function renderTag(tag) {
+  const attrs = tag.attributes || {};
+  const attrStr = Object.entries(attrs)
+    .map(([k, v]) => `${k}="${String(v).replace(/"/g, '&quot;')}"`)
+    .join(' ');
+  if (tag.tagName === 'meta') {
+    return `<meta ${attrStr} />`;
+  }
+  const inner = tag.innerHTML || '';
+  return `<script${attrStr ? ' ' + attrStr : ''}>${inner}</script>`;
+}
+
+function applyMeta($, spec) {
+  const viewport = spec.viewport || META.COMMON_VIEWPORT;
+  if ($('meta[charset]').length) {
+    $('meta[charset]').first().attr('charset', META.COMMON_CHARSET);
+  } else {
+    $('head').prepend(`<meta charset="${META.COMMON_CHARSET}" />`);
+  }
+  if ($('meta[name="viewport"]').length) {
+    $('meta[name="viewport"]').attr('content', viewport);
+  } else {
+    $('head').prepend(`<meta name="viewport" content="${viewport}" />`);
+  }
+  if (!spec.skipRecommendedMeta) {
+    if (!$('meta[name="HandheldFriendly"]').length) {
+      $('head').append('<meta name="HandheldFriendly" content="True" />');
+    }
+    if (!$('meta[http-equiv="cleartype"]').length) {
+      $('head').append('<meta http-equiv="cleartype" content="on" />');
+    }
+    if (!$('meta[name="apple-mobile-web-app-capable"]').length) {
+      $('head').append('<meta name="apple-mobile-web-app-capable" content="yes" />');
+    }
+    if (!$('meta[name="mobile-web-app-capable"]').length) {
+      $('head').append('<meta name="mobile-web-app-capable" content="yes" />');
+    }
+    if (!$('meta[http-equiv="X-UA-Compatible"]').length) {
+      $('head').append('<meta http-equiv="X-UA-Compatible" content="IE=10" />');
+    }
+  }
+  if (spec.liftoffFont) {
+    $('head').append(LIFTOFF_FONT);
+  }
+}
+
+function applyInjections(html, spec) {
+  const $ = load(html);
+  applyMeta($, spec);
+  const tags = (spec.headTags || []).slice().reverse();
+  for (const tag of tags) {
+    $('head').prepend(renderTag(tag));
+  }
+  let out = $.html();
+  for (const transform of spec.htmlTransforms || []) {
+    out = transform(out);
+  }
+  if (spec.scanStubHtml) {
+    if (/<\/body>/i.test(out)) {
+      out = out.replace(/<\/body>/i, `${spec.scanStubHtml}</body>`);
+    } else {
+      out += spec.scanStubHtml;
+    }
+  }
+  return out;
+}
+
+function extractInlineScripts(html) {
+  const $ = load(html);
+  const scripts = [];
+  $('script').each((_i, el) => {
+    const $el = $(el);
+    if ($el.attr('src')) return;
+    scripts.push($el.html() || '');
+    $el.remove();
+  });
+  return { html: $.html(), scripts };
+}
+
+function extractBodyScripts(html) {
+  return extractInlineScripts(html);
+}
+
+module.exports = {
+  applyInjections,
+  extractBodyScripts,
+  extractInlineScripts,
+  renderTag,
+};

package/core/injectors/check-channel-matrix.js

@@ -1,9 +1,137 @@
 #!/usr/bin/env node
-"use strict";/**
+'use strict';
+
+/**
  * Compare Cocos pack plan + injections against webpack.build.js rules.
  * Run: node core/injectors/check-channel-matrix.js
  *
  * Webpack is not modified. Known intentional Cocos diffs:
  *   facebook / mintegral zip = inlined index.html only
  *   (webpack still skips HtmlInlineScriptPlugin for those two)
- */const{allowedAdNetworks,mraidPartners}=require("../utils/parseArgvOptions");const{applyInjections}=require("./apply");const{getChannelPackPlan,zipOutputNetworks,zipOutputAllowedNetworks}=require("./spec");const WEBPACK_ZIP=["google","pangle","tiktok","vungle","mytarget","mintegral","adikteev","bigabid","inmobi","snapchat","bigoads","liftoff","facebook","remerge"];const WEBPACK_ZIP_OPTIONAL=["moloco"];const WEBPACK_SKIP_INLINE=["mintegral","adikteev","bigabid","facebook"];const INTENTIONAL_INLINE_ZIP=["facebook","mintegral"];function webpackProtocol(network){return mraidPartners.includes(network)?"mraid":"none"}function webpackExpect(network){const zip=WEBPACK_ZIP.includes(network);const skipInline=WEBPACK_SKIP_INLINE.includes(network)&&(zip||network==="mintegral"||network==="adikteev"||network==="bigabid");let files;if(!zip)files=["*.html"];else if(network==="adikteev")files=["index.html","creative.js","style.css"];else if(network==="bigabid")files=["index.html","main.js"];else if(network==="tiktok"||network==="snapchat"||network==="bigoads")files=["index.html","config.json"];else if(skipInline&&network==="facebook")files=["index.html","build.js"];else if(skipInline&&network==="mintegral")files=["index.html","build.js"];else files=["index.html"];return{zip,skipInline,files}}const INJECT_EXPECT={google:["exitapi.js","ad.size","ad.orientation"],tiktok:["union-fe-nc-i18n"],pangle:["union-fe-nc/playable/sdk"],mintegral:["mintGameStart"],unity:["src=\"mraid.js\""],ironsource:["src=\"mraid.js\""],remerge:["src=\"mraid.js\""],liftoff:["src=\"mraid.js\"","Helvetica Neue"],bigoads:["bgy-mraid-sdk.js"],snapchat:["ScPlayableAd"],inmobi:["INMOBI_DSPMACROS"],social_media:["og:type"]};const INJECT_FORBID={applovin:["src=\"mraid.js\""],facebook:["src=\"mraid.js\""],preview:["src=\"mraid.js\""],google:["src=\"mraid.js\""]};const baseHtml="<html><head></head><body><div id=\"GameDiv\"></div></body></html>";const failures=[];const rows=[];for(const network of allowedAdNetworks){const protocol=webpackProtocol(network);const buildOptions={network,protocol,zip:false,googlePlayUrl:"https://play.example",appStoreUrl:"https://app.example",playcraftOrientationValue:"both",filename:"Game"};const themePayload={mergedData:{gamePlay:{shareMeta:{title:"T"}}},i18nOverride:{},assetRecordByPath:{}};const plan=getChannelPackPlan(buildOptions,themePayload);const wx=webpackExpect(network);const html=applyInjections(baseHtml,plan.spec);const cocosFiles=plan.isZip?plan.zipEntries.filter((n,i,a)=>a.indexOf(n)===i):["*.html"];let expectedCocosFiles=wx.files;if(INTENTIONAL_INLINE_ZIP.includes(network))expectedCocosFiles=["index.html"];const zipMismatch=plan.isZip!==wx.zip;const filesMismatch=plan.isZip&&expectedCocosFiles.slice().sort().join()!==cocosFiles.slice().sort().join();for(const s of INJECT_EXPECT[network]||[]){if(!html.includes(s))failures.push(`${network}: missing inject "${s}"`)}for(const s of INJECT_FORBID[network]||[]){if(html.includes(s))failures.push(`${network}: unexpected inject "${s}"`)}if(zipMismatch)failures.push(`${network}: zip webpack=${wx.zip} cocos=${plan.isZip}`);if(filesMismatch)failures.push(`${network}: files webpack/cocos expected=${expectedCocosFiles} got=${cocosFiles}`);if(!html.includes("HandheldFriendly"))failures.push(`${network}: missing recommended meta`);if(!html.includes("FbPlayableAd.onCTAClick"))failures.push(`${network}: missing channel scan stub`);const note=INTENTIONAL_INLINE_ZIP.includes(network)&&wx.files.includes("build.js")?"cocos inlines (webpack still splits)":"";rows.push({network,zip:plan.isZip?"zip":"html",layout:plan.layout,files:cocosFiles.join(", "),note})}if(JSON.stringify(zipOutputNetworks.slice().sort())!==JSON.stringify(WEBPACK_ZIP.slice().sort())){failures.push(`zipOutputNetworks != webpack list`)}if(JSON.stringify(zipOutputAllowedNetworks)!==JSON.stringify(WEBPACK_ZIP_OPTIONAL)){failures.push(`zipOutputAllowedNetworks != webpack list`)}console.log("network".padEnd(14),"fmt".padEnd(6),"layout".padEnd(12),"files");console.log("-".repeat(80));for(const row of rows){console.log(row.network.padEnd(14),row.zip.padEnd(6),row.layout.padEnd(12),row.files,row.note?`  ← ${row.note}`:"")}if(failures.length){console.error("\nFAIL");failures.forEach(f=>console.error("  -",f));process.exit(1)}console.log("\nOK  all",allowedAdNetworks.length,"networks");console.log("Intentional diffs: facebook, mintegral zip contain only index.html (webpack comment still says split JS).");
+ */
+
+const { allowedAdNetworks, mraidPartners } = require('../utils/parseArgvOptions');
+const { applyInjections } = require('./apply');
+const { getChannelPackPlan, zipOutputNetworks, zipOutputAllowedNetworks } = require('./spec');
+
+const WEBPACK_ZIP = [
+  'google', 'pangle', 'tiktok', 'vungle', 'mytarget', 'mintegral', 'adikteev',
+  'bigabid', 'inmobi', 'snapchat', 'bigoads', 'liftoff', 'facebook', 'remerge'
+];
+const WEBPACK_ZIP_OPTIONAL = ['moloco'];
+const WEBPACK_SKIP_INLINE = ['mintegral', 'adikteev', 'bigabid', 'facebook'];
+const INTENTIONAL_INLINE_ZIP = ['facebook', 'mintegral'];
+
+function webpackProtocol(network) {
+  return mraidPartners.includes(network) ? 'mraid' : 'none';
+}
+
+function webpackExpect(network) {
+  const zip = WEBPACK_ZIP.includes(network);
+  const skipInline = WEBPACK_SKIP_INLINE.includes(network) && (zip || network === 'mintegral' || network === 'adikteev' || network === 'bigabid');
+  let files;
+  if (!zip) files = ['*.html'];
+  else if (network === 'adikteev') files = ['index.html', 'creative.js', 'style.css'];
+  else if (network === 'bigabid') files = ['index.html', 'main.js'];
+  else if (network === 'tiktok' || network === 'snapchat' || network === 'bigoads') files = ['index.html', 'config.json'];
+  else if (skipInline && network === 'facebook') files = ['index.html', 'build.js'];
+  else if (skipInline && network === 'mintegral') files = ['index.html', 'build.js'];
+  else files = ['index.html'];
+  return { zip, skipInline, files };
+}
+
+const INJECT_EXPECT = {
+  google: ['exitapi.js', 'ad.size', 'ad.orientation'],
+  tiktok: ['union-fe-nc-i18n'],
+  pangle: ['union-fe-nc/playable/sdk'],
+  mintegral: ['mintGameStart'],
+  unity: ['src="mraid.js"'],
+  ironsource: ['src="mraid.js"'],
+  remerge: ['src="mraid.js"'],
+  liftoff: ['src="mraid.js"', 'Helvetica Neue'],
+  bigoads: ['bgy-mraid-sdk.js'],
+  snapchat: ['ScPlayableAd'],
+  inmobi: ['INMOBI_DSPMACROS'],
+  social_media: ['og:type'],
+};
+
+const INJECT_FORBID = {
+  applovin: ['src="mraid.js"'],
+  facebook: ['src="mraid.js"'],
+  preview: ['src="mraid.js"'],
+  google: ['src="mraid.js"'],
+};
+
+const baseHtml = '<html><head></head><body><div id="GameDiv"></div></body></html>';
+const failures = [];
+const rows = [];
+
+for (const network of allowedAdNetworks) {
+  const protocol = webpackProtocol(network);
+  const buildOptions = {
+    network,
+    protocol,
+    zip: false,
+    googlePlayUrl: 'https://play.example',
+    appStoreUrl: 'https://app.example',
+    playcraftOrientationValue: 'both',
+    filename: 'Game',
+  };
+  const themePayload = { mergedData: { gamePlay: { shareMeta: { title: 'T' } } }, i18nOverride: {}, assetRecordByPath: {} };
+  const plan = getChannelPackPlan(buildOptions, themePayload);
+  const wx = webpackExpect(network);
+  const html = applyInjections(baseHtml, plan.spec);
+
+  const cocosFiles = plan.isZip
+    ? plan.zipEntries.filter((n, i, a) => a.indexOf(n) === i)
+    : ['*.html'];
+
+  let expectedCocosFiles = wx.files;
+  if (INTENTIONAL_INLINE_ZIP.includes(network)) expectedCocosFiles = ['index.html'];
+
+  const zipMismatch = plan.isZip !== wx.zip;
+  const filesMismatch = plan.isZip && expectedCocosFiles.slice().sort().join() !== cocosFiles.slice().sort().join();
+
+  for (const s of INJECT_EXPECT[network] || []) {
+    if (!html.includes(s)) failures.push(`${network}: missing inject "${s}"`);
+  }
+  for (const s of INJECT_FORBID[network] || []) {
+    if (html.includes(s)) failures.push(`${network}: unexpected inject "${s}"`);
+  }
+  if (zipMismatch) failures.push(`${network}: zip webpack=${wx.zip} cocos=${plan.isZip}`);
+  if (filesMismatch) failures.push(`${network}: files webpack/cocos expected=${expectedCocosFiles} got=${cocosFiles}`);
+  if (!html.includes('HandheldFriendly')) failures.push(`${network}: missing recommended meta`);
+  if (!html.includes('FbPlayableAd.onCTAClick')) failures.push(`${network}: missing channel scan stub`);
+
+  const note = INTENTIONAL_INLINE_ZIP.includes(network) && wx.files.includes('build.js')
+    ? 'cocos inlines (webpack still splits)'
+    : '';
+  rows.push({
+    network,
+    zip: plan.isZip ? 'zip' : 'html',
+    layout: plan.layout,
+    files: cocosFiles.join(', '),
+    note,
+  });
+}
+
+if (JSON.stringify(zipOutputNetworks.slice().sort()) !== JSON.stringify(WEBPACK_ZIP.slice().sort())) {
+  failures.push(`zipOutputNetworks != webpack list`);
+}
+if (JSON.stringify(zipOutputAllowedNetworks) !== JSON.stringify(WEBPACK_ZIP_OPTIONAL)) {
+  failures.push(`zipOutputAllowedNetworks != webpack list`);
+}
+
+console.log('network'.padEnd(14), 'fmt'.padEnd(6), 'layout'.padEnd(12), 'files');
+console.log('-'.repeat(80));
+for (const row of rows) {
+  console.log(row.network.padEnd(14), row.zip.padEnd(6), row.layout.padEnd(12), row.files, row.note ? `  ← ${row.note}` : '');
+}
+
+if (failures.length) {
+  console.error('\nFAIL');
+  failures.forEach((f) => console.error('  -', f));
+  process.exit(1);
+}
+console.log('\nOK  all', allowedAdNetworks.length, 'networks');
+console.log('Intentional diffs: facebook, mintegral zip contain only index.html (webpack comment still says split JS).');