@playcraft/devkit 1.0.19 → 1.0.21

package/core/webpack.common.js

@@ -1,177 +1,11 @@
-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|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;
+"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|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/webpack.dev.js

@@ -1,92 +1,15 @@
-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');
-
-/**
+"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;
-}
-
-/**
+ */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
- */
-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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@playcraft/devkit",
-  "version": "1.0.19",
+  "version": "1.0.21",
   "description": "HTML5 Playable Ads 构建工具，支持多广告渠道打包",
   "main": "core/index.js",
   "module": "core/index.js",
@@ -15,7 +15,6 @@
     "defines.d.ts"
   ],
   "scripts": {
-    "build": "node scripts/build.js",
     "deploy": "npm run build && cd dist && npm publish --registry https://registry.npmjs.org/ --access public",
     "deploy:beta": "npm run build && cd dist && npm publish --registry https://registry.npmjs.org/ --access public --tag beta"
   },
@@ -83,4 +82,4 @@
   "publishConfig": {
     "registry": "https://www.npmjs.com/registry"
   }
-}
+}

package/README.md

@@ -1,259 +0,0 @@
-# @tencent/playable-scripts
-
-HTML5 Playable Ads 构建工具，支持多广告渠道打包。
-
-## 特性
-
-- 🚀 **一键构建** - 轻松为不同广告渠道生成构建包
-- ⚡ **自动优化** - 包含压缩、Tree-shaking 和死代码消除
-- 🗜️ **fflate 压缩** - 编译时压缩，运行时解压，体积减少 40-60%
-- 🎯 **多渠道支持** - 支持 Google Ads、Meta、AppLovin、Unity、IronSource、BigoAds 等
-- 🎨 **主题系统** - 支持多主题批量构建
-- 🔄 **并发构建** - 智能并发，大幅提升构建效率
-
-## 快速开始
-
-### 安装
-
-```bash
-tnpm install --save-dev @tencent/playable-scripts
-```
-
-### 配置 package.json
-
-```json
-{
-  "scripts": {
-    "dev": "playable-scripts dev",
-    "build": "playable-scripts build",
-    "builds": "playable-scripts builds"
-  }
-}
-```
-
-### 启动开发服务器
-
-```bash
-npm run dev                 # 默认预览模式
-npm run dev bigoads         # 指定渠道调试
-npm run dev -- --port 8080  # 指定端口
-```
-
-### 构建指定渠道
-
-```bash
-npm run build google        # Google Ads
-npm run build facebook      # Meta
-npm run build unity         # Unity Ads
-npm run build bigoads       # BigoAds
-```
-
-### 批量构建
-
-```bash
-npm run builds                              # 构建所有渠道
-npm run builds -- -t "theme1,theme2"        # 指定主题
-npm run builds -- -c "google,facebook"      # 指定渠道
-npm run builds -- --parallel 4              # 指定并发数
-
-# Windows PowerShell 兼容格式（推荐）
-npm run builds -- "theme1" "google"         # 位置参数：主题 渠道
-npm run builds -- --themes="theme1,theme2" --channels="google,facebook"
-```
-
-## 支持的广告渠道
-
-| 渠道 | 命令 | 协议 |
-|------|------|------|
-| Preview (预览) | `preview` | none |
-| Google Ads | `google` | none |
-| Meta (Facebook) | `facebook` | none |
-| AppLovin | `applovin` | mraid |
-| Unity Ads | `unity` | mraid |
-| IronSource | `ironsource` | mraid/dapi |
-| TikTok / Pangle | `tiktok` | none |
-| BigoAds | `bigoads` | bigo-mraid |
-| Adikteev | `adikteev` | mraid |
-| Moloco | `moloco` | none |
-| Liftoff | `liftoff` | mraid (ZIP) |
-| InMobi | `inmobi` | mraid |
-| Snapchat | `snapchat` | snapchat |
-
-## CLI 参数
-
-| 参数 | 描述             | 默认值       |
-|------|----------------|-----------|
-| **广告渠道** | 目标广告渠道         | `preview` |
-| `--out-dir` | 输出目录           | `dist`    |
-| `--obfuscate-level` | 代码混淆等级 (1-4)   | `4`       |
-| `--fflate-compression` | 启用 fflate 压缩   | `true`    |
-| `--protocol` | 广告协议           | 渠道自动决定    |
-| `--zip` | ZIP 输出结果       | `false`   |
-| `--port` | 开发服务器端口        | `3000`    |
-| `--open` | 自动打开浏览器        | `false`   |
-| `--language` | 语言代码           | `en`      |
-| `--is-channel-fold2zip ` | 所有渠道输出为 ZIP 结果 | `false`   |
-
-## 配置文件
-
-支持两种配置文件（推荐使用 `builds.config.js`）：
-
-### builds.config.js（推荐）
-
-```javascript
-module.exports = {
-  // 项目基本信息
-  projectName: 'My-Game',                    // 可选，默认 'Phaser Game'
-  googlePlayUrl: 'https://play.google.com/...', // 可选
-  appStoreUrl: 'https://apps.apple.com/...',    // 可选
-  
-  // 渠道配置
-  channels: ['google', 'facebook', 'unity'],    // 可选，有默认值
-  
-  // 主题配置（可选）
-  themes: {
-    enabled: true,                              // 默认 false
-    sourceDir: 'src/theme',                     // 默认 'src/theme'
-    entryFile: 'src/theme/index.ts',          // 默认 'src/theme/index.ts'
-    whitelist: null,                            // 可选，过滤函数
-  },
-  
-  // 文件命名配置（可选）
-  naming: {
-    language: 'EN',                             // 默认 'EN'
-    format: '无',                               // 默认 '无'
-    supplier: 'AIX',                            // 默认 'AIX'
-    follower: 'ZQL',                            // 默认 'ZQL'
-    generator: null,                            // 可选，自定义生成函数
-  },
-  
-  // 构建配置（可选）
-  build: {
-    outputDir: 'dist-all',                      // 默认 'dist-all'
-    tempDirPrefix: 'dist-temp',                 // 默认 'dist-temp'
-    continueOnError: true,                      // 默认 true
-    cleanTemp: true,                            // 默认 true
-    parallel: undefined,                        // 默认自动计算（CPU核心数-1，最小2最大8）
-  },
-  cosConfig: {
-    enabled: true,                              // 是否启用 COS 上传
-    SecretId: 'YOUR_SECRET_ID',                 // 腾讯云 SecretId
-    SecretKey: 'YOUR_SECRET_KEY',               // 腾讯云 SecretKey
-    Bucket: 'your-bucket-1234567890',           // COS 存储桶名称
-    Region: 'ap-guangzhou',                     // COS 区域
-    CdnDomain: 'your-cdn-domain.com',           // CDN 域名（用于生成访问链接）
-    PathPrefix: 'playable/preview',             // COS 路径前缀（可选）
-  },
-  // 打包参数（可选）
-  obfuscateLevel: 4,                            // 默认 4
-  fflateCompression: false,                      // 默认 true
-};
-```
-
-### build.json（向后兼容）
-
-```json
-{
-  "app": "AppName",
-  "name": "ConceptName",
-  "google_play_url": "https://play.google.com/...",
-  "app_store_url": "https://apps.apple.com/..."
-}
-```
-
-### 配置优先级
-
-```
-命令行参数 > build.json > builds.config.js > 默认值
-```
-
-## 代码混淆等级
-
-| 等级 | 名称 | 说明 | 体积影响 |
-|------|------|------|----------|
-| **1** | terser-only | 仅 Terser 压缩 | 基准 |
-| **2** | basic | 控制流平坦化 + 字符串编码 | +5~10% |
-| **3** | dead-code | 等级 2 + 死代码注入 | +15~25% |
-| **4** | maximum | 全部拉满（默认） | +30~50% |
-
-## fflate 压缩
-
-| 指标 | 效果 |
-|------|------|
-| **压缩率** | 66-68% |
-| **体积减少** | 40-60% |
-| **解压速度** | 3-5ms |
-| **兼容性** | 99%+ 浏览器 |
-
-## 批量构建
-
-### 特性
-
-1. **智能并发** - 自动根据 CPU 核心数优化（默认：核心数-1，最小2最大8）
-2. **独立临时目录** - 每个任务使用独立目录，避免冲突
-3. **主题切换** - 自动切换主题入口文件
-4. **错误容忍** - 单个失败不影响其他构建
-
-### 命令行参数
-
-| 参数 | 缩写 | 描述 | 示例 |
-|------|------|------|------|
-| `--themes` | `-t` | 指定主题列表（逗号分隔） | `-t "theme1,theme2"` |
-| `--channels` | `-c` | 指定渠道列表（逗号分隔） | `-c "google,facebook"` |
-| `--parallel` | `-p` | 指定并发数 | `-p 4` |
-| 位置参数 | - | 第一个参数=主题，第二个=渠道 | `"theme1" "google"` |
-| `=` 格式 | - | Windows PowerShell 兼容 | `--themes="theme1"` |
-
-**注意**：
-- **Mac/Linux**：所有格式均可使用
-- **Windows PowerShell**：推荐使用位置参数或 `--themes=value` 格式
-- **Windows CMD**：所有格式均可使用
-
-### 输出结构
-
-```
-dist-all/
-├── theme1/
-│   ├── google/
-│   │   └── theme1-EN-无-3月-20260304-AIX-ZQL-google.html
-│   └── facebook/
-│       └── theme1-EN-无-3月-20260304-AIX-ZQL-facebook.html
-└── theme2/
-    └── ...
-```
-
-## 全局变量
-
-构建时自动注入：
-
-| 变量 | 描述 | 示例 |
-|------|------|------|
-| `__DEV__` | 开发模式标志 | `true` / `false` |
-| `AD_NETWORK` | 当前广告渠道 | `"google"`, `"bigoads"` |
-| `AD_PROTOCOL` | 当前广告协议 | `"none"`, `"mraid"` |
-| `GOOGLE_PLAY_URL` | Google Play 链接 | `"https://..."` |
-| `APP_STORE_URL` | App Store 链接 | `"https://..."` |
-
-## 配套 SDK
-
-配合 `@tencent/playable-sdk` 使用：
-
-```bash
-tnpm install @tencent/playable-sdk
-```
-
-```javascript
-import { sdk } from '@tencent/playable-sdk';
-
-sdk.init((width, height) => {
-  new Game(width, height);
-});
-
-sdk.start();              // 游戏开始
-sdk.finish();             // 游戏结束
-sdk.install();            // 跳转商店
-```
-
-## 许可证
-
-MIT License