@playcraft/devkit 1.0.7 → 1.0.9

package/cli/bin/playable-scripts.js

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-"use strict";process.on("unhandledRejection",err=>{throw err});const spawn=require("cross-spawn");const args=process.argv.slice(2);const scriptIndex=args.findIndex(x=>x==="build"||x==="dev"||x==="builds"||x==="pack");const script=scriptIndex===-1?args[0]:args[scriptIndex];const nodeArgs=scriptIndex>0?args.slice(0,scriptIndex):[];if(["build","dev","builds","pack"].includes(script)){const result=spawn.sync(process.execPath,nodeArgs.concat(require.resolve("../commands/"+script)).concat(args.slice(scriptIndex+1)),{stdio:"inherit"});if(result.signal){if(result.signal==="SIGKILL"){console.log("The build failed because the process exited too early. "+"This probably means the system ran out of memory or someone called "+"`kill -9` on the process.")}else if(result.signal==="SIGTERM"){console.log("The build failed because the process exited too early. "+"Someone might have called `kill` or `killall`, or the system could "+"be shutting down.")}process.exit(1)}process.exit(result.status)}else{console.log("Unknown script \""+script+"\".")}
+"use strict";process.on("unhandledRejection",err=>{throw err});const spawn=require("cross-spawn");const args=process.argv.slice(2);const scriptIndex=args.findIndex(x=>x==="build"||x==="dev"||x==="vite-dev"||x==="builds"||x==="pack");const script=scriptIndex===-1?args[0]:args[scriptIndex];const nodeArgs=scriptIndex>0?args.slice(0,scriptIndex):[];if(["build","dev","vite-dev","builds","pack"].includes(script)){const result=spawn.sync(process.execPath,nodeArgs.concat(require.resolve("../commands/"+script)).concat(args.slice(scriptIndex+1)),{stdio:"inherit"});if(result.signal){if(result.signal==="SIGKILL"){console.log("The build failed because the process exited too early. "+"This probably means the system ran out of memory or someone called "+"`kill -9` on the process.")}else if(result.signal==="SIGTERM"){console.log("The build failed because the process exited too early. "+"Someone might have called `kill` or `killall`, or the system could "+"be shutting down.")}process.exit(1)}process.exit(result.status)}else{console.log("Unknown script \""+script+"\".")}

package/cli/commands/build.js

@@ -1,13 +1,12 @@
 "use strict";process.env.BABEL_ENV="production";process.env.NODE_ENV="production";const fs=require("fs");const path=require("path");const{runBuild}=require("../../core/webpack.build.js");const{runThemeValidation,restoreSchema}=require("../../core/utils/validateThemeData");/**
- * Detect the current theme name from the theme entry file.
- * Supports patterns like:
+ * 从主题入口文件中检测当前主题名称。
+ * 支持以下模式：
  *   export { default } from './themeName';
  *   import Theme from './themeName';
- *   export { default } from "./themeName";
- */function detectCurrentTheme(projectRoot){// Try to load builds.config.js for theme config
-const buildsConfigPath=path.join(projectRoot,"builds.config.js");let themeConfig={sourceDir:"src/theme",entryFile:"src/theme/index.ts"};if(fs.existsSync(buildsConfigPath)){try{delete require.cache[buildsConfigPath];const config=require(buildsConfigPath);if(config.themes){themeConfig={...themeConfig,...config.themes}}}catch(e){// ignore
-}}const entryPath=path.join(projectRoot,themeConfig.entryFile);if(!fs.existsSync(entryPath)){return{themeName:null,themeConfig}}const content=fs.readFileSync(entryPath,"utf8");// Match: export { default } from './themeName'  or  import ... from './themeName'
-const match=content.match(/from\s+['"]\.\/([^'"]+)['"]/);if(match){return{themeName:match[1],themeConfig}}return{themeName:null,themeConfig}}// --- Main ---
-const projectRoot=process.cwd();const{themeName,themeConfig}=detectCurrentTheme(projectRoot);let schemaPathToRestore=null;if(themeName){const buildLog=(msg,level)=>{const colors={info:"\x1B[36m",success:"\x1B[32m",error:"\x1B[31m"};const reset="\x1B[0m";const color=colors[level]||"";console.log(`${color}[build] ${msg}${reset}`)};const{valid,schemaPath}=runThemeValidation(themeName,projectRoot,themeConfig,{log:buildLog});schemaPathToRestore=schemaPath;if(!valid){// Restore schema on validation failure (backup may have been created)
-if(schemaPathToRestore)restoreSchema(schemaPathToRestore);process.exit(1)}}// Run build, then always restore schema regardless of success/failure
+ */function detectCurrentTheme(projectRoot){// 尝试加载 builds.config.js 获取主题配置
+const buildsConfigPath=path.join(projectRoot,"builds.config.js");let themeConfig={sourceDir:"src/theme",entryFile:"src/theme/index.ts"};if(fs.existsSync(buildsConfigPath)){try{delete require.cache[buildsConfigPath];const config=require(buildsConfigPath);if(config.themes){themeConfig={...themeConfig,...config.themes}}}catch(e){// 忽略错误
+}}const entryPath=path.join(projectRoot,themeConfig.entryFile);if(!fs.existsSync(entryPath)){return{themeName:null,themeConfig}}const content=fs.readFileSync(entryPath,"utf8");// 匹配: export { default } from './themeName' 或 import ... from './themeName'
+const match=content.match(/from\s+['"]\.\/([^'"]+)['"]/);if(match){return{themeName:match[1],themeConfig}}return{themeName:null,themeConfig}}// --- 主流程 ---
+const projectRoot=process.cwd();const{themeName,themeConfig}=detectCurrentTheme(projectRoot);let schemaPathToRestore=null;if(themeName){const buildLog=(msg,level)=>{const colors={info:"\x1B[36m",success:"\x1B[32m",error:"\x1B[31m"};const reset="\x1B[0m";const color=colors[level]||"";console.log(`${color}[build] ${msg}${reset}`)};const{valid,schemaPath}=runThemeValidation(themeName,projectRoot,themeConfig,{log:buildLog});schemaPathToRestore=schemaPath;if(!valid){// 校验失败时恢复 schema（备份可能已创建）
+if(schemaPathToRestore)restoreSchema(schemaPathToRestore);process.exit(1)}}// 执行构建，无论成功或失败都恢复 schema
 runBuild().then(()=>{if(schemaPathToRestore)restoreSchema(schemaPathToRestore)}).catch(err=>{if(schemaPathToRestore)restoreSchema(schemaPathToRestore);console.error(err);process.exit(1)});

package/cli/commands/pack.js

@@ -1,81 +1,81 @@
-"use strict";const fs=require("fs");const path=require("path");const yazl=require("yazl");// ==================== Configuration ====================
+"use strict";const fs=require("fs");const path=require("path");const yazl=require("yazl");// ==================== 配置 ====================
 const projectRoot=process.cwd();/**
- * Resolve the appName from builds.config.js, build.json, or CLI args.
- * Priority: CLI --app-name > builds.config.js > build.json > folder name
+ * 解析 appName，依次从 builds.config.js、build.json 或 CLI 参数中获取。
+ * 优先级: CLI --app-name > builds.config.js > build.json > 文件夹名称
  * @returns {string}
- */function resolveAppName(){// 1. CLI argument: --app-name=xxx
-const args=process.argv.slice(2);for(const arg of args){if(arg.startsWith("--app-name=")){return arg.split("=")[1].trim()}}// 2. builds.config.js → appName or title
-const buildsConfigPath=path.join(projectRoot,"builds.config.js");if(fs.existsSync(buildsConfigPath)){try{delete require.cache[buildsConfigPath];const config=require(buildsConfigPath);if(config.appName)return config.appName;if(config.title)return config.title}catch(e){// ignore
+ */function resolveAppName(){// 1. CLI 参数: --app-name=xxx
+const args=process.argv.slice(2);for(const arg of args){if(arg.startsWith("--app-name=")){return arg.split("=")[1].trim()}}// 2. builds.config.js → appName 或 title
+const buildsConfigPath=path.join(projectRoot,"builds.config.js");if(fs.existsSync(buildsConfigPath)){try{delete require.cache[buildsConfigPath];const config=require(buildsConfigPath);if(config.appName)return config.appName;if(config.title)return config.title}catch(e){// 忽略错误
 }}// 3. build.json → app
-const buildJsonPath=path.join(projectRoot,"build.json");if(fs.existsSync(buildJsonPath)){try{const data=JSON.parse(fs.readFileSync(buildJsonPath,"utf8"));if(data.app)return data.app}catch(e){// ignore
-}}// 4. Fallback: project folder name
+const buildJsonPath=path.join(projectRoot,"build.json");if(fs.existsSync(buildJsonPath)){try{const data=JSON.parse(fs.readFileSync(buildJsonPath,"utf8"));if(data.app)return data.app}catch(e){// 忽略错误
+}}// 4. 兜底: 使用项目文件夹名称
 return path.basename(projectRoot)}/**
- * Resolve the output directory from CLI args.
+ * 从 CLI 参数中解析输出目录。
  * @returns {string}
- */function resolveOutputDir(){const args=process.argv.slice(2);for(const arg of args){if(arg.startsWith("--out-dir=")){return arg.split("=")[1].trim()}}return"dist"}// ==================== Ignore Pattern Parsing ====================
+ */function resolveOutputDir(){const args=process.argv.slice(2);for(const arg of args){if(arg.startsWith("--out-dir=")){return arg.split("=")[1].trim()}}return"dist"}// ==================== 忽略规则解析 ====================
 /**
- * Parse a single ignore file and return an array of normalized patterns.
- * @param {string} filePath - Absolute path to the ignore file
- * @returns {string[]} Array of normalized ignore patterns
- */function parseSingleIgnoreFile(filePath){if(!fs.existsSync(filePath)){return[]}const content=fs.readFileSync(filePath,"utf8");const patterns=[];for(const rawLine of content.split(/\r?\n/)){const line=rawLine.trim();// Skip empty lines and comments
-if(!line||line.startsWith("#"))continue;// Warn about negation patterns (not supported)
-if(line.startsWith("!")){console.log(`\x1b[33m⚠️  Negation pattern not supported, skipping: ${line}\x1b[0m`);continue}// Normalize:
-//   - remove trailing slashes for directory matching
-//   - remove leading ./ (gitignore treats ./foo same as foo)
+ * 解析单个忽略文件，返回规范化后的模式数组。
+ * @param {string} filePath - 忽略文件的绝对路径
+ * @returns {string[]} 规范化后的忽略模式数组
+ */function parseSingleIgnoreFile(filePath){if(!fs.existsSync(filePath)){return[]}const content=fs.readFileSync(filePath,"utf8");const patterns=[];for(const rawLine of content.split(/\r?\n/)){const line=rawLine.trim();// 跳过空行和注释
+if(!line||line.startsWith("#"))continue;// 不支持取反模式，给出警告并跳过
+if(line.startsWith("!")){console.log(`\x1b[33m⚠️  不支持取反模式，已跳过: ${line}\x1b[0m`);continue}// 规范化:
+//   - 移除尾部斜杠（用于目录匹配）
+//   - 移除前导 ./（gitignore 中 ./foo 等同于 foo）
 let normalized=line.replace(/\/+$/,"");normalized=normalized.replace(/^\.\//g,"");patterns.push(normalized)}return patterns}/**
- * Parse .gitignore and .playcraftignore files, merge and deduplicate patterns.
- * .gitignore provides base ignore rules, .playcraftignore provides additional ones.
+ * 解析 .gitignore 和 .playcraftignore 文件，合并并去重。
+ * .gitignore 提供基础忽略规则，.playcraftignore 提供额外补充规则。
  * @returns {{ patterns: string[], sources: { gitignore: number, playcraftignore: number } }}
- */function parseIgnoreFiles(){const gitignorePath=path.join(projectRoot,".gitignore");const playcraftignorePath=path.join(projectRoot,".playcraftignore");const gitignorePatterns=parseSingleIgnoreFile(gitignorePath);const playcraftPatterns=parseSingleIgnoreFile(playcraftignorePath);if(gitignorePatterns.length===0&&playcraftPatterns.length===0){console.log("\x1B[33m\u26A0\uFE0F  No .gitignore or .playcraftignore file found, packing all files.\x1B[0m");return{patterns:[],sources:{gitignore:0,playcraftignore:0}}}// Merge and deduplicate (preserve order, .gitignore first)
+ */function parseIgnoreFiles(){const gitignorePath=path.join(projectRoot,".gitignore");const playcraftignorePath=path.join(projectRoot,".playcraftignore");const gitignorePatterns=parseSingleIgnoreFile(gitignorePath);const playcraftPatterns=parseSingleIgnoreFile(playcraftignorePath);if(gitignorePatterns.length===0&&playcraftPatterns.length===0){console.log("\x1B[33m\u26A0\uFE0F  \u672A\u627E\u5230 .gitignore \u6216 .playcraftignore \u6587\u4EF6\uFF0C\u5C06\u6253\u5305\u6240\u6709\u6587\u4EF6\u3002\x1B[0m");return{patterns:[],sources:{gitignore:0,playcraftignore:0}}}// 合并并去重（保持顺序，.gitignore 优先）
 const seen=new Set;const merged=[];for(const p of[...gitignorePatterns,...playcraftPatterns]){if(!seen.has(p)){seen.add(p);merged.push(p)}}return{patterns:merged,sources:{gitignore:gitignorePatterns.length,playcraftignore:playcraftPatterns.length}}}/**
- * Convert a gitignore-like pattern to a RegExp.
+ * 将 gitignore 风格的模式转换为正则表达式。
  *
- * Gitignore semantics:
- *   - Pattern without `/` → matches against the basename anywhere in the tree
- *   - Pattern with `/` (e.g. `scripts/foo`) → anchored to project root
- *   - Leading `/` means "root only" and is stripped before regex conversion
- *   - Leading `./` is treated the same as `/` (already stripped in parse phase)
+ * gitignore 语义:
+ *   - 不含 `/` 的模式 → 在目录树中任意位置匹配文件/目录名
+ *   - 含 `/` 的模式（如 `scripts/foo`）→ 锚定到项目根目录
+ *   - 前导 `/` 表示"仅匹配根目录"，构建正则前会被剥离
+ *   - 前导 `./` 与 `/` 等效（已在解析阶段被剥离）
  *
  * @param {string} pattern
  * @returns {RegExp}
- */function patternToRegex(pattern){let p=pattern;let anchored=false;// Leading / means root-anchored; strip it for regex building
-if(p.startsWith("/")){p=p.slice(1);anchored=true}// If the pattern contains a /, it is also root-anchored
-if(p.includes("/")){anchored=true}// Escape regex special chars except * and ?
-let regexStr=p.replace(/[.+^${}()|[\]\\]/g,"\\$&");// Handle ** (match any path segment including nested)
-regexStr=regexStr.replace(/\*\*/g,"{{GLOBSTAR}}");// Handle * (match anything except path separator)
-regexStr=regexStr.replace(/\*/g,"[^/]*");// Handle ?
-regexStr=regexStr.replace(/\?/g,"[^/]");// Restore globstar
-regexStr=regexStr.replace(/\{\{GLOBSTAR\}\}/g,".*");if(anchored){// Anchored: match from the start of the relative path
-return new RegExp(`^${regexStr}(/|$)`)}// Unanchored: match as a path segment anywhere in the tree
+ */function patternToRegex(pattern){let p=pattern;let anchored=false;// 前导 / 表示锚定到根目录；构建正则前剥离
+if(p.startsWith("/")){p=p.slice(1);anchored=true}// 如果模式中包含 /，同样视为锚定到根目录
+if(p.includes("/")){anchored=true}// 转义正则特殊字符（* 和 ? 除外）
+let regexStr=p.replace(/[.+^${}()|[\]\\]/g,"\\$&");// 处理 **（匹配任意路径层级，包括嵌套目录）
+regexStr=regexStr.replace(/\*\*/g,"{{GLOBSTAR}}");// 处理 *（匹配除路径分隔符外的任意字符）
+regexStr=regexStr.replace(/\*/g,"[^/]*");// 处理 ?（匹配除路径分隔符外的单个字符）
+regexStr=regexStr.replace(/\?/g,"[^/]");// 还原 globstar 占位符
+regexStr=regexStr.replace(/\{\{GLOBSTAR\}\}/g,".*");if(anchored){// 锚定模式：从相对路径的起始位置匹配
+return new RegExp(`^${regexStr}(/|$)`)}// 非锚定模式：在目录树中任意位置匹配路径段
 return new RegExp(`(^|/)${regexStr}(/|$)`)}/**
- * Check if a relative path should be ignored.
- * @param {string} relativePath - Forward-slash normalized relative path
+ * 检查相对路径是否应被忽略。
+ * @param {string} relativePath - 使用正斜杠规范化后的相对路径
  * @param {RegExp[]} regexPatterns
  * @returns {boolean}
- */function shouldIgnore(relativePath,regexPatterns){for(const regex of regexPatterns){if(regex.test(relativePath))return true}return false}// ==================== File Collection ====================
+ */function shouldIgnore(relativePath,regexPatterns){for(const regex of regexPatterns){if(regex.test(relativePath))return true}return false}// ==================== 文件收集 ====================
 /**
- * Recursively collect all files under a directory, respecting ignore patterns.
- * @param {string} dir - Absolute directory path
- * @param {string} baseDir - Project root for computing relative paths
+ * 递归收集目录下的所有文件，遵循忽略规则。
+ * @param {string} dir - 目录的绝对路径
+ * @param {string} baseDir - 项目根目录，用于计算相对路径
  * @param {RegExp[]} ignoreRegexes
- * @returns {string[]} Array of absolute file paths
- */function collectFiles(dir,baseDir,ignoreRegexes){const results=[];let entries;try{entries=fs.readdirSync(dir,{withFileTypes:true})}catch(e){console.warn(`\x1b[33m⚠️  Cannot read directory: ${dir}\x1b[0m`);return results}for(const entry of entries){const fullPath=path.join(dir,entry.name);// Use forward slashes for consistent matching
-const relativePath=path.relative(baseDir,fullPath).replace(/\\/g,"/");if(shouldIgnore(relativePath,ignoreRegexes)){continue}if(entry.isDirectory()){results.push(...collectFiles(fullPath,baseDir,ignoreRegexes))}else if(entry.isFile()||entry.isSymbolicLink()){results.push(fullPath)}}return results}// ==================== Zip Creation ====================
+ * @returns {string[]} 文件绝对路径数组
+ */function collectFiles(dir,baseDir,ignoreRegexes){const results=[];let entries;try{entries=fs.readdirSync(dir,{withFileTypes:true})}catch(e){console.warn(`\x1b[33m⚠️  无法读取目录: ${dir}\x1b[0m`);return results}for(const entry of entries){const fullPath=path.join(dir,entry.name);// 使用正斜杠以保持匹配一致性
+const relativePath=path.relative(baseDir,fullPath).replace(/\\/g,"/");if(shouldIgnore(relativePath,ignoreRegexes)){continue}if(entry.isDirectory()){results.push(...collectFiles(fullPath,baseDir,ignoreRegexes))}else if(entry.isFile()||entry.isSymbolicLink()){results.push(fullPath)}}return results}// ==================== Zip 创建 ====================
 /**
- * Create a zip file from the collected files.
- * @param {string[]} files - Absolute file paths
- * @param {string} rootFolderName - Root folder name inside the zip
- * @param {string} outputPath - Absolute path for the output zip file
+ * 根据收集到的文件创建 zip 压缩包。
+ * @param {string[]} files - 文件绝对路径数组
+ * @param {string} rootFolderName - zip 内的根文件夹名称
+ * @param {string} outputPath - 输出 zip 文件的绝对路径
  * @returns {Promise<{fileCount: number, zipSize: number}>}
- */function createZip(files,rootFolderName,outputPath){return new Promise((resolve,reject)=>{const zipFile=new yazl.ZipFile;let fileCount=0;for(const filePath of files){const relativePath=path.relative(projectRoot,filePath).replace(/\\/g,"/");const zipEntryPath=`${rootFolderName}/${relativePath}`;zipFile.addFile(filePath,zipEntryPath);fileCount++}zipFile.end();// Ensure output directory exists
-const outputDir=path.dirname(outputPath);if(!fs.existsSync(outputDir)){fs.mkdirSync(outputDir,{recursive:true})}const writeStream=fs.createWriteStream(outputPath);writeStream.on("error",err=>{reject(err)});writeStream.on("close",()=>{const stats=fs.statSync(outputPath);resolve({fileCount,zipSize:stats.size})});zipFile.outputStream.pipe(writeStream)})}// ==================== Formatting Helpers ====================
+ */function createZip(files,rootFolderName,outputPath){return new Promise((resolve,reject)=>{const zipFile=new yazl.ZipFile;let fileCount=0;for(const filePath of files){const relativePath=path.relative(projectRoot,filePath).replace(/\\/g,"/");const zipEntryPath=`${rootFolderName}/${relativePath}`;zipFile.addFile(filePath,zipEntryPath);fileCount++}zipFile.end();// 确保输出目录存在
+const outputDir=path.dirname(outputPath);if(!fs.existsSync(outputDir)){fs.mkdirSync(outputDir,{recursive:true})}const writeStream=fs.createWriteStream(outputPath);writeStream.on("error",err=>{reject(err)});writeStream.on("close",()=>{const stats=fs.statSync(outputPath);resolve({fileCount,zipSize:stats.size})});zipFile.outputStream.pipe(writeStream)})}// ==================== 格式化工具 ====================
 /**
- * Format bytes to human-readable string.
+ * 将字节数格式化为可读字符串。
  * @param {number} bytes
  * @returns {string}
- */function formatSize(bytes){if(bytes<1024)return`${bytes} B`;if(bytes<1024*1024)return`${(bytes/1024).toFixed(2)} KB`;return`${(bytes/(1024*1024)).toFixed(2)} MB`}// ==================== Main ====================
-async function main(){console.log("\x1B[36m\uD83D\uDCE6 playable-scripts pack\x1B[0m\n");// 1. Resolve appName
-const appName=resolveAppName();console.log(`  App Name:     \x1b[1m${appName}\x1b[0m`);// 2. Parse ignore patterns (merge .gitignore + .playcraftignore)
-const{patterns,sources}=parseIgnoreFiles();const ignoreRegexes=patterns.map(patternToRegex);if(patterns.length>0){const parts=[];if(sources.gitignore>0)parts.push(`${sources.gitignore} from .gitignore`);if(sources.playcraftignore>0)parts.push(`${sources.playcraftignore} from .playcraftignore`);console.log(`  Ignore rules: \x1b[33m${patterns.length}\x1b[0m patterns (${parts.join(", ")})`)}// 3. Collect files
-console.log(`  Scanning project files...`);const files=collectFiles(projectRoot,projectRoot,ignoreRegexes);if(files.length===0){console.error("\x1B[31m\u274C No files to pack! Check your .playcraftignore rules.\x1B[0m");process.exit(1)}console.log(`  Found:        \x1b[32m${files.length}\x1b[0m files to pack`);// 4. Create zip
-const outDir=resolveOutputDir();const outputPath=path.resolve(projectRoot,outDir,`${appName}.zip`);console.log(`  Output:       ${outputPath}\n`);console.log("  Packing...");try{const{fileCount,zipSize}=await createZip(files,appName,outputPath);console.log(`\n\x1b[32m✅ Pack complete!\x1b[0m`);console.log(`   Files:  ${fileCount}`);console.log(`   Size:   ${formatSize(zipSize)}`);console.log(`   Output: ${outputPath}`)}catch(err){console.error(`\n\x1b[31m❌ Pack failed: ${err.message}\x1b[0m`);process.exit(1)}}main();
+ */function formatSize(bytes){if(bytes<1024)return`${bytes} B`;if(bytes<1024*1024)return`${(bytes/1024).toFixed(2)} KB`;return`${(bytes/(1024*1024)).toFixed(2)} MB`}// ==================== 主流程 ====================
+async function main(){console.log("\x1B[36m\uD83D\uDCE6 playable-scripts \u6253\u5305\x1B[0m\n");// 1. 解析 appName
+const appName=resolveAppName();console.log(`  应用名称:     \x1b[1m${appName}\x1b[0m`);// 2. 解析忽略规则（合并 .gitignore + .playcraftignore）
+const{patterns,sources}=parseIgnoreFiles();const ignoreRegexes=patterns.map(patternToRegex);if(patterns.length>0){const parts=[];if(sources.gitignore>0)parts.push(`${sources.gitignore} 条来自 .gitignore`);if(sources.playcraftignore>0)parts.push(`${sources.playcraftignore} 条来自 .playcraftignore`);console.log(`  忽略规则:     \x1b[33m${patterns.length}\x1b[0m 条模式 (${parts.join(", ")})`)}// 3. 收集文件
+console.log(`  正在扫描项目文件...`);const files=collectFiles(projectRoot,projectRoot,ignoreRegexes);if(files.length===0){console.error("\x1B[31m\u274C \u6CA1\u6709\u53EF\u6253\u5305\u7684\u6587\u4EF6\uFF01\u8BF7\u68C0\u67E5 .playcraftignore \u89C4\u5219\u3002\x1B[0m");process.exit(1)}console.log(`  文件数量:     \x1b[32m${files.length}\x1b[0m 个待打包文件`);// 4. 创建 zip 压缩包
+const outDir=resolveOutputDir();const outputPath=path.resolve(projectRoot,outDir,`${appName}.zip`);console.log(`  输出路径:     ${outputPath}\n`);console.log("  \u6B63\u5728\u6253\u5305...");try{const{fileCount,zipSize}=await createZip(files,appName,outputPath);console.log(`\n\x1b[32m✅ 打包完成！\x1b[0m`);console.log(`   文件数: ${fileCount}`);console.log(`   大小:   ${formatSize(zipSize)}`);console.log(`   输出:   ${outputPath}`)}catch(err){console.error(`\n\x1b[31m❌ 打包失败: ${err.message}\x1b[0m`);process.exit(1)}}main();

package/cli/commands/vite-dev.js

@@ -0,0 +1 @@
+"use strict";process.env.BABEL_ENV="development";process.env.NODE_ENV="development";const{runViteDev}=require("../../core/vite.dev.js");runViteDev();

package/core/index.d.ts

@@ -1,5 +1,6 @@
 import { Configuration as WebpackConfig } from 'webpack';
 import { WebpackPluginInstance } from 'webpack';
+import { UserConfig as ViteUserConfig } from 'vite';
 
 /** Supported file extensions for webpack resolution */
 export declare const allowedExtensions: string[];
@@ -167,3 +168,18 @@ export declare class DebuggerInjectionPlugin implements WebpackPluginInstance {
 export declare class ExitAPIInjectorPlugin implements WebpackPluginInstance {
   apply(compiler: any): void;
 }
+
+/** Create Vite config for development */
+export declare function makeViteDevConfig(
+  customOptions?: Partial<CLIOptions>,
+  customDefines?: Record<string, any>,
+  viteCustomConfig?: Partial<ViteUserConfig>
+): ViteUserConfig;
+
+/** Start Vite development server */
+export declare function runViteDev(
+  viteConfig?: ViteUserConfig,
+  customOptions?: Partial<CLIOptions>,
+  customDefines?: Record<string, any>,
+  viteCustomConfig?: Partial<ViteUserConfig>
+): Promise<void>;

package/core/index.js

@@ -1 +1 @@
-"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");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;
+"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}=require("./vite.dev.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;

package/core/options.js

@@ -1,5 +1,6 @@
 "use strict";const{parseArgvOptions,allowedAdProtocols,allowedAdNetworks,allowedOrientations,allowedLanguages}=require("./utils/parseArgvOptions");const path=require("path");const fs=require("fs");const{name,version}=require("../package.json");const possibleOptions=[{name:"out-dir",alias:"outDir",defaultValue:"dist",hasValue:true,description:"Output directory for build files"},{name:"build-config",alias:"buildConfig",defaultValue:"build.json",hasValue:true,description:"Path to build.json configuration file"},{name:"ts-config",alias:"tsConfig",defaultValue:"tsconfig.json",hasValue:true,description:"For TypeScript projects, path to tsconfig.json file"},{name:"js-config",alias:"jsConfig",defaultValue:"jsconfig.json",hasValue:true,description:"For JavaScript projects, path to jsconfig.json file"},{name:"port",hasValue:true,defaultValue:3000,description:"Development server port number",parser:function(rawValue){const value=+rawValue;if(isNaN(value))throw new Error("--port should be a number");return value}},{name:"open",defaultValue:false,hasValue:false,description:"Open browser automatically when server starts"},{name:"protocol",hasValue:true,defaultValue:"none",description:"Ad protocol to use (none, mraid, or dapi)",parser:function(rawValue){if(!allowedAdProtocols.includes(rawValue)){throw new Error(`--protocol should have one of the value: ${allowedAdProtocols.join(", ")}`)}return rawValue}},{name:"network",defaultValue:"preview",hasValue:true,description:"Target Ad network",parser:function(rawValue){if(!allowedAdNetworks.includes(rawValue)){throw new Error(`--network should have one of the value: ${allowedAdNetworks.join(", ")}`)}return rawValue}},{name:"zip",defaultValue:false,hasValue:false,description:"Should the build be zipped? (only for some ad networks)"},{name:"is-channel-fold2zip",defaultValue:false,hasValue:false,description:"\u5F53\u542F\u7528\u65F6\uFF0C\u6784\u5EFA\u4EA7\u7269\u683C\u5F0F\u4E3A\u300C\u4E3B\u9898\u6587\u4EF6\u540D/\u6E20\u9053.zip\u300D"},{name:"dev",hasValue:true,description:"Enable development mode (true/false)",parser:function(rawValue){if(!(rawValue==="true"||rawValue==="false"))throw new Error("--dev should have either true or false value");return rawValue==="true"}},{name:"filename",defaultValue:"{app}_{name}_{version}_{date}_{language}_{network}",hasValue:true,description:"Specifies the build filename template"},{name:"app",defaultValue:"AppName",hasValue:true,description:"Specifies the application name used in build filename and APP define"},{name:"name",defaultValue:"ConceptName",hasValue:true,description:"Specifies the concept name used in build filename and NAME define"},{name:"version",defaultValue:"v1",hasValue:true,description:"Specifies the version name used in build filename and VERSION define"},{name:"language",defaultValue:"en",hasValue:true,description:"Specifies the language of the build used in LANGUAGE define",parser:function(rawValue){if(!allowedLanguages.includes(rawValue)){throw new Error(`--platform should have one of the value: ${allowedLanguages.join(", ")}`)}return rawValue}},{name:"orientation",defaultValue:"both",hasValue:true,description:"Specifies the ad orientation used in ORIENTATION define and some network specific configurations",parser:function(rawValue){if(!allowedOrientations.includes(rawValue)){throw new Error(`--orientation should have one of the value: ${allowedOrientations.join(", ")}`)}return rawValue}},{name:"google-play-url",alias:"googlePlayUrl",defaultValue:"https://play.google.com/store/games",hasValue:true,description:"Google Play Store URL for the app"},{name:"app-store-url",alias:"appStoreUrl",defaultValue:"https://www.apple.com/app-store/",hasValue:true,description:"App Store URL for the app"},{name:"skip-recommended-meta",alias:"skipRecommendedMeta",hasValue:false,description:"Don't inject recommended for playable ads META tags"},{name:"debugger",hasValue:true,description:"URL of debugger script to inject into code"},{name:"obfuscate-level",alias:"obfuscateLevel",defaultValue:4,hasValue:true,description:"Code obfuscation level: 1=terser only, 2=obfuscator basic(default), 3=obfuscator+dead code, 4=maximum obfuscation",parser:function(rawValue){const value=+rawValue;if(isNaN(value)||value<1||value>4){throw new Error("--obfuscate-level should be a number between 1 and 4")}return value}},{name:"fflate-compression",alias:"fflateCompression",defaultValue:false,hasValue:true,description:"Enable fflate compression for HTML output (level 9, production only)",parser:function(rawValue){// 支持 true/false 字符串和布尔值
-if(rawValue==="true"||rawValue===true||rawValue==="1")return true;if(rawValue==="false"||rawValue===false||rawValue==="0")return false;return Boolean(rawValue)}},{name:"exclude-compress-dirs",alias:"excludeCompressDirs",defaultValue:[],hasValue:true,description:"Directories to exclude from compression (comma-separated list of paths)",parser:function(rawValue){if(!rawValue)return[];return rawValue.split(",").map(dir=>dir.trim()).filter(Boolean)}}];/** @type {import('./index').CLIOptions} */const options=parseArgvOptions(possibleOptions);options.defines={};options.compilation={};options.adNetworkNames={};// ==================== 配置文件加载 ====================
+if(rawValue==="true"||rawValue===true||rawValue==="1")return true;if(rawValue==="false"||rawValue===false||rawValue==="0")return false;return Boolean(rawValue)}},{name:"exclude-compress-dirs",alias:"excludeCompressDirs",defaultValue:[],hasValue:true,description:"Directories to exclude from compression (comma-separated list of paths)",parser:function(rawValue){if(!rawValue)return[];return rawValue.split(",").map(dir=>dir.trim()).filter(Boolean)}}];/** @type {import('./index').CLIOptions} */const options=parseArgvOptions(possibleOptions);// Extract CLI explicit keys set, then remove it from options
+const cliExplicitKeys=options._cliExplicitKeys||new Set;delete options._cliExplicitKeys;options.defines={};options.compilation={};options.adNetworkNames={};// ==================== 配置文件加载 ====================
 //
 // 优先级（从低到高）:
 // 1. builds.config.js (新配置文件，优先读取)
@@ -11,15 +12,15 @@ if(rawValue==="true"||rawValue===true||rawValue==="1")return true;if(rawValue===
 // - build.json: google_play_url → googlePlayUrl, app_store_url → appStoreUrl
 // 1️⃣ 先尝试读取 builds.config.js
 const buildsConfigPath=path.resolve("builds.config.js");if(fs.existsSync(buildsConfigPath)){try{// 清除 require 缓存，确保读取最新配置
-delete require.cache[buildsConfigPath];const buildsConfig=require(buildsConfigPath);// 读取商店链接配置
-if(buildsConfig.googlePlayUrl){options.googlePlayUrl=buildsConfig.googlePlayUrl}if(buildsConfig.appStoreUrl){options.appStoreUrl=buildsConfig.appStoreUrl}// 读取其他特殊配置
+delete require.cache[buildsConfigPath];const buildsConfig=require(buildsConfigPath);// 读取商店链接配置（respect CLI args priority）
+if(buildsConfig.googlePlayUrl&&!cliExplicitKeys.has("googlePlayUrl")){options.googlePlayUrl=buildsConfig.googlePlayUrl}if(buildsConfig.appStoreUrl&&!cliExplicitKeys.has("appStoreUrl")){options.appStoreUrl=buildsConfig.appStoreUrl}// 读取其他特殊配置
 if(buildsConfig.defines)Object.assign(options.defines,buildsConfig.defines);if(buildsConfig.compilation)Object.assign(options.compilation,buildsConfig.compilation);if(buildsConfig.adNetworkNames)Object.assign(options.adNetworkNames,buildsConfig.adNetworkNames);// 读取所有通用配置字段（如果在 builds.config.js 中定义了）
 for(const key in buildsConfig){// 跳过已处理的特殊字段和批量构建专用字段
 if(["googlePlayUrl","appStoreUrl","defines","compilation","adNetworkNames","title","appName","projectCode","channels","themes","naming","build","hooks","cosConfig"].includes(key)){continue}// 查找对应的配置项定义
-const possibleOption=possibleOptions.find(e=>e.alias===key||e.name===key);if(possibleOption&&buildsConfig[key]!==undefined){options[key]=buildsConfig[key]}}}catch(err){console.log("\x1B[33m\u26A0\uFE0F  \u8BFB\u53D6 builds.config.js \u5931\u8D25: "+err.message+"\x1B[0m")}}// 2️⃣ 再尝试读取 build.json（会覆盖 builds.config.js 中的相同字段）
-try{const fileData=fs.readFileSync(path.resolve(options["buildConfig"]),"utf8");try{const customOptions=JSON.parse(fileData);for(let key in customOptions){if(key==="defines")Object.assign(options.defines,customOptions[key]);else if(key==="compilation")Object.assign(options.compilation,customOptions[key]);else if(key==="adNetworkNames")Object.assign(options.adNetworkNames,customOptions[key]);else if(key==="google_play_url")options.googlePlayUrl=customOptions.google_play_url;// 覆盖 builds.config.js
-else if(key==="app_store_url")options.appStoreUrl=customOptions.app_store_url;// 覆盖 builds.config.js
-else{const possibleOption=possibleOptions.find(e=>e.alias===key||e.name===key);if(possibleOption&&(options[key]===undefined||options[key]===possibleOption.defaultValue)){options[key]=customOptions[key]}}}}catch(err){console.log("\x1B[31mBuild config parsing error: "+err.message+"\x1B[0m")}}catch(err){// build.json 不存在是正常的（使用 builds.config.js）
+const possibleOption=possibleOptions.find(e=>e.alias===key||e.name===key);if(possibleOption&&buildsConfig[key]!==undefined){// Only override if not explicitly set by CLI args
+const optionKey=possibleOption.alias||possibleOption.name;if(!cliExplicitKeys.has(optionKey)){options[optionKey]=buildsConfig[key]}}}}catch(err){console.log("\x1B[33m\u26A0\uFE0F  \u8BFB\u53D6 builds.config.js \u5931\u8D25: "+err.message+"\x1B[0m")}}// 2️⃣ 再尝试读取 build.json（会覆盖 builds.config.js 中的相同字段）
+try{const fileData=fs.readFileSync(path.resolve(options["buildConfig"]),"utf8");try{const customOptions=JSON.parse(fileData);for(let key in customOptions){if(key==="defines")Object.assign(options.defines,customOptions[key]);else if(key==="compilation")Object.assign(options.compilation,customOptions[key]);else if(key==="adNetworkNames")Object.assign(options.adNetworkNames,customOptions[key]);else if(key==="google_play_url"&&!cliExplicitKeys.has("googlePlayUrl"))options.googlePlayUrl=customOptions.google_play_url;else if(key==="app_store_url"&&!cliExplicitKeys.has("appStoreUrl"))options.appStoreUrl=customOptions.app_store_url;else{const possibleOption=possibleOptions.find(e=>e.alias===key||e.name===key);if(possibleOption){const optionKey=possibleOption.alias||possibleOption.name;// Only override if not explicitly set by CLI args
+if(!cliExplicitKeys.has(optionKey)){options[optionKey]=customOptions[key]}}}}}catch(err){console.log("\x1B[31mBuild config parsing error: "+err.message+"\x1B[0m")}}catch(err){// build.json 不存在是正常的（使用 builds.config.js）
 }// 环境变量覆盖（用于批量构建时避免竞态条件）
 // 批量构建时通过 PLAYABLE_FILENAME 环境变量传递 filename，优先级最高
 if(process.env.PLAYABLE_FILENAME){options.filename=process.env.PLAYABLE_FILENAME}console.log(`${name} v${version}`);console.log("Options:",options);exports.options=options;

package/core/utils/parseArgvOptions.js

@@ -2,6 +2,7 @@
  * 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 格式
+ */exports.parseArgvOptions=function parseArgvOptions(posiibleOptions){const argvOptions={};// Track which options were explicitly set via CLI args
+const cliExplicitKeys=new Set;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;
+value=inlineValue!==null?inlineValue:process.argv[++i];if(allowedOption.parser)value=allowedOption.parser(value)}const optionKey=allowedOption.alias||allowedOption.name;argvOptions[optionKey]=value;cliExplicitKeys.add(optionKey)}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"}}}argvOptions._cliExplicitKeys=cliExplicitKeys;return argvOptions};exports.allowedAdNetworks=allowedAdNetworks;exports.allowedAdProtocols=allowedAdProtocols;exports.mraidPartners=mraidPartners;exports.allowedLanguages=allowedLanguages;exports.allowedOrientations=allowedOrientations;

package/core/utils/validateThemeData.js

@@ -1,78 +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.
+"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="// [\u81EA\u52A8\u751F\u6210\u7684\u5907\u4EFD] \u6B64\u6587\u4EF6\u7531\u6253\u5305\u6D41\u7A0B\u521B\u5EFA\u3002\n"+"// \u5982\u679C\u6253\u5305\u4E2D\u65AD\uFF0C\u53EF\u4EE5\u79FB\u9664 \".backup\" \u540E\u7F00\uFF0C\n"+"// \u5E76\u7528\u6B64\u6587\u4EF6\u66FF\u6362\u539F\u59CB\u7684 \"theme.schema.json5\" \u6765\u6062\u590D\u3002\n";/**
+ * 递归提取 JSON Schema 定义中的 `default` 值。
  *
- * - For "object" types: recurse into `properties` and build a nested object.
- * - For primitive types: return the `default` value if present.
+ * - 对于 "object" 类型：递归遍历 `properties` 并构建嵌套对象。
+ * - 对于基本类型：如果存在 `default` 值则返回。
  *
- * @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
+ * @param {object} schema - JSON Schema（或子 schema）对象
+ * @returns {*} 提取的默认值树，如果没有则返回 undefined
+ */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}// 基本类型或数组类型，带有默认值
 if("default"in schema){return schema.default}return undefined}/**
- * Validate theme data for a given theme against the schema.
+ * 根据 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
+ * 项目中预期的文件结构：
+ *   src/theme/theme.schema.json5              – JSON Schema（JSON5 格式）
+ *   src/theme/{themeName}/theme.data.json5    – 各主题的数据
  *
- * Default values are extracted from the schema's `default` fields via extractDefaultsFromSchema,
- * then deep-merged with theme data (theme data takes priority) before validation.
+ * 通过 extractDefaultsFromSchema 从 schema 的 `default` 字段提取默认值，
+ * 然后与主题数据深度合并（主题数据优先）后再进行校验。
  *
- * @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 {string} themeName   - 主题目录名称
+ * @param {string} projectRoot - 项目根目录的绝对路径
+ * @param {object} [themeConfig] - 可选的主题配置（builds.config.js 中的 themes 部分）
  * @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 ---
+ *   defaultData – 从 schema 提取的默认值
+ *   errors     – 校验通过为 null，否则为错误信息数组
+ */function validateThemeData(themeName,projectRoot,themeConfig){const sourceDir=themeConfig&&themeConfig.sourceDir||"src/theme";const themeBaseDir=path.join(projectRoot,sourceDir);// --- 解析文件路径 ---
+const schemaPath=path.join(themeBaseDir,"theme.schema.json5");const dataPath=path.join(themeBaseDir,themeName,"theme.data.json5");// --- 读取并解析文件 ---
+if(!fs.existsSync(schemaPath)){return{defaultData:null,errors:[`未找到 Schema 文件: ${schemaPath}`]}}const schema=JSON5.parse(fs.readFileSync(schemaPath,"utf8"));// 从 schema 提取默认值
+const defaultData=extractDefaultsFromSchema(schema)||{};let themeData={};if(fs.existsSync(dataPath)){themeData=JSON5.parse(fs.readFileSync(dataPath,"utf8"))}// 深度合并（主题数据覆盖 schema 默认值），然后校验
+const merged=deepMerge(defaultData,themeData);// --- 根据 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).
+ * 深度合并两个普通对象。`override` 中的值优先。
+ * 数组会被整体替换（不会拼接）。
  *
  * @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.
+ * 备份原始的 theme.schema.json5 文件。
+ * 备份文件包含注释头，说明如何手动恢复。
  *
- * @param {string} schemaPath - Absolute path to theme.schema.json5
- * @returns {string} The backup file path
+ * @param {string} schemaPath - theme.schema.json5 的绝对路径
+ * @returns {string} 备份文件路径
  */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.
+ * 从备份文件恢复 theme.schema.json5 并删除备份。
  *
- * @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 "//")
+ * @param {string} schemaPath - theme.schema.json5 的绝对路径
+ */function restoreSchema(schemaPath){const backupPath=schemaPath+SCHEMA_BACKUP_SUFFIX;if(!fs.existsSync(backupPath))return;const backupContent=fs.readFileSync(backupPath,"utf8");// 去除自动生成的注释头（以 "//" 开头的行）
 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.
+ * 用合并后的数据（schema 默认值 + 主题覆盖值）覆写 theme.schema.json5，
+ * 以便打包工具在构建时可以直接使用。
  *
- * @param {string} schemaPath - Absolute path to theme.schema.json5
- * @param {object} mergedData - The merged theme data to write
+ * @param {string} schemaPath - theme.schema.json5 的绝对路径
+ * @param {object} mergedData - 要写入的合并后的主题数据
  */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).
+ * 执行主题校验并输出标准日志。
+ * 单次构建（build.js）和批量构建（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
+ * 流程：
+ *   1. 根据 theme.schema.json5 校验 theme.data.json5
+ *   2. 备份 theme.schema.json5（包含恢复说明）
+ *   3. 通过 extractDefaultsFromSchema 从 schema 提取默认值
+ *   4. 用默认数据覆写 theme.schema.json5 以供构建使用
  *
- * After the build (success or failure), call restoreSchema() to restore the original.
+ * 构建完成后（无论成功或失败），调用 restoreSchema() 恢复原始文件。
  *
- * @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 {string} themeName   - 主题目录名称
+ * @param {string} projectRoot - 项目根目录的绝对路径
+ * @param {object} [themeConfig] - 可选的主题配置（builds.config.js 中的 themes 部分）
  * @param {object} [options]
- * @param {function} [options.log] - Custom log function(message, level). Defaults to console.log.
+ * @param {function} [options.log] - 自定义日志函数(message, level)。默认使用 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
+ *   valid      – schema 文件不存在（跳过）或校验通过时为 true
+ *   errors     – 校验通过为 null，否则为错误信息数组
+ *   schemaPath – theme.schema.json5 的绝对路径（用于 restoreSchema 调用），或 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");// 没有 schema 文件 → 完全跳过校验
+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");// 备份原始 schema，然后用默认数据覆写以供构建使用
 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/vite.dev.js

@@ -0,0 +1,25 @@
+"use strict";const path=require("path");const fs=require("fs");const{options}=require("./options.js");const{mergeOptions}=require("./utils/mergeOptions.js");const{buildDefines}=require("./utils/buildDefines.js");const{logOptions}=require("./utils/logOptions.js");/**
+ * 创建 Vite 开发配置
+ * @param {Partial<import('./index').CLIOptions>} [customOptions] - 自定义选项，会与默认选项合并
+ * @param {Record<string, any>} [customDefines] - 额外的 define 常量
+ * @param {import('vite').UserConfig} [viteCustomConfig] - 自定义 Vite 配置，会与默认配置合并
+ * @returns {import('vite').UserConfig} 最终的 Vite 开发配置
+ */function makeViteDevConfig(customOptions,customDefines,viteCustomConfig){const devOptions=mergeOptions(options,customOptions);logOptions(devOptions);customDefines=customDefines||{};viteCustomConfig=viteCustomConfig||{};// 构建 define 常量（复用 webpack 的 buildDefines 逻辑）
+const defines={...buildDefines(),...devOptions.defines,__DEV__:JSON.stringify(devOptions["dev"]===undefined?true:devOptions["dev"]),...customDefines};// 解析 tsconfig/jsconfig 路径别名
+const tsConfigPath=path.resolve(devOptions.tsConfig||"tsconfig.json");const jsConfigPath=path.resolve(devOptions.jsConfig||"jsconfig.json");let aliasConfig={};// 尝试从 tsconfig/jsconfig 中读取 paths 配置
+let configFilePath=null;if(fs.existsSync(tsConfigPath)){configFilePath=tsConfigPath}else if(fs.existsSync(jsConfigPath)){configFilePath=jsConfigPath}if(configFilePath){try{var _config$compilerOptio;const JSON5=require("json5");const configContent=fs.readFileSync(configFilePath,"utf-8");const config=JSON5.parse(configContent);const paths=((_config$compilerOptio=config.compilerOptions)===null||_config$compilerOptio===void 0?void 0:_config$compilerOptio.paths)||{};for(const[alias,targets]of Object.entries(paths)){var _targets$;// 将 tsconfig paths 格式 "foo/*" -> ["src/foo/*"] 转换为 vite alias
+const cleanAlias=alias.replace("/*","");const cleanTarget=((_targets$=targets[0])===null||_targets$===void 0?void 0:_targets$.replace("/*",""))||"";if(cleanAlias&&cleanTarget){aliasConfig[cleanAlias]=path.resolve(cleanTarget)}}}catch(err){console.log("\x1B[33m\u26A0\uFE0F  \u8BFB\u53D6\u8DEF\u5F84\u914D\u7F6E\u5931\u8D25: "+err.message+"\x1B[0m")}}// 默认别名
+aliasConfig={assets:path.resolve("assets"),"@":path.resolve("src"),...aliasConfig};// JSON5 插件
+function json5Plugin(){return{name:"vite-plugin-json5",transform(code,id){if(id.endsWith(".json5")){const JSON5=require("json5");const raw=fs.readFileSync(id,"utf-8");const parsed=JSON5.parse(raw);return{code:`export default ${JSON.stringify(parsed)};`,map:null}}}}}// 资源内联插件（模拟 webpack 的 asset/inline 行为）
+function assetInlinePlugin(){return{name:"vite-plugin-asset-inline",enforce:"pre",transform(code,id){// .atlas 文件 -> base64 data URL
+if(id.endsWith(".atlas")){const content=fs.readFileSync(id);const base64=content.toString("base64");return{code:`export default "data:text/atlas;base64,${base64}";`,map:null}}// .fnt 文件 -> base64 data URL
+if(id.endsWith(".fnt")){const content=fs.readFileSync(id);const base64=content.toString("base64");return{code:`export default "data:text/plain;base64,${base64}";`,map:null}}// .xml 文件 -> 原始文本
+if(id.endsWith(".xml")){const raw=fs.readFileSync(id,"utf-8");return{code:`export default ${JSON.stringify(raw)};`,map:null}}}}}/** @type {import('vite').UserConfig} */const viteConfig={root:".",resolve:{alias:aliasConfig},plugins:[json5Plugin(),assetInlinePlugin()],define:defines,server:{port:devOptions["port"]||3000,open:devOptions["open"]||false},build:{outDir:devOptions["outDir"]||"dist",sourcemap:true}};// 合并自定义配置
+if(viteCustomConfig){// 简单合并：自定义配置中的字段会覆盖默认配置
+const{plugins:customPlugins,define:customDefine,resolve:customResolve,server:customServer,build:customBuild,...rest}=viteCustomConfig;if(customPlugins){viteConfig.plugins=[...viteConfig.plugins,...customPlugins]}if(customDefine){viteConfig.define={...viteConfig.define,...customDefine}}if(customResolve){viteConfig.resolve={...viteConfig.resolve,...customResolve,alias:{...viteConfig.resolve.alias,...(customResolve.alias||{})}}}if(customServer){viteConfig.server={...viteConfig.server,...customServer}}if(customBuild){viteConfig.build={...viteConfig.build,...customBuild}}Object.assign(viteConfig,rest)}return viteConfig}/**
+ * 启动 Vite 开发服务器
+ * @param {import('vite').UserConfig} [viteConfig] - Vite 配置，不传则自动创建
+ * @param {Partial<import('./index').CLIOptions>} [customOptions] - 自定义选项
+ * @param {Record<string, any>} [customDefines] - 额外的 define 常量
+ * @param {import('vite').UserConfig} [viteCustomConfig] - 自定义 Vite 配置
+ */async function runViteDev(viteConfig,customOptions,customDefines,viteCustomConfig){if(!viteConfig){viteConfig=makeViteDevConfig(customOptions,customDefines,viteCustomConfig)}const{createServer}=require("vite");const server=await createServer(viteConfig);await server.listen();server.printUrls()}exports.makeViteDevConfig=makeViteDevConfig;exports.runViteDev=runViteDev;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@playcraft/devkit",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "description": "HTML5 Playable Ads 构建工具，支持多广告渠道打包",
   "main": "core/index.js",
   "module": "core/index.js",
@@ -42,6 +42,7 @@
     "tencentcloud-sdk-nodejs-cdn": "^4.1.161",
     "terser-webpack-plugin": "^5.3.10",
     "tsconfig-paths-webpack-plugin": "^4.2.0",
+    "vite": "^6.4.1",
     "vue": "^3.4.0",
     "vue-loader": "^17.4.2",
     "webpack": "^5.91.0",