@playcraft/devkit 1.0.15-beta.1 → 1.0.17

package/cli/commands/pack.js

@@ -1,33 +1,145 @@
-"use strict";const fs=require("fs");const path=require("path");const yazl=require("yazl");// ==================== 配置 ====================
-const projectRoot=process.cwd();/**
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const yazl = require('yazl');
+
+// ==================== 配置 ====================
+
+const projectRoot = process.cwd();
+
+/**
  * 解析 appName，依次从 builds.config.js、build.json 或 CLI 参数中获取。
  * 优先级: CLI --app-name > builds.config.js > build.json > 文件夹名称
  * @returns {string}
- */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){// 忽略错误
-}}// 4. 兜底: 使用项目文件夹名称
-return path.basename(projectRoot)}/**
+ */
+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) {
+      // 忽略错误
+    }
+  }
+
+  // 4. 兜底: 使用项目文件夹名称
+  return path.basename(projectRoot);
+}
+
+/**
  * 从 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"}// ==================== 忽略规则解析 ====================
+ */
+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';
+}
+
+// ==================== 忽略规则解析 ====================
+
 /**
  * 解析单个忽略文件，返回规范化后的模式数组。
  * @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}/**
+ */
+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;
+}
+
+/**
  * 解析 .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  \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}}}/**
+ */
+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⚠️  未找到 .gitignore 或 .playcraftignore 文件，将打包所有文件。\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,
+    },
+  };
+}
+
+/**
  * 将 gitignore 风格的模式转换为正则表达式。
  *
  * gitignore 语义:
@@ -38,44 +150,201 @@ const seen=new Set;const merged=[];for(const p of[...gitignorePatterns,...playcr
  *
  * @param {string} pattern
  * @returns {RegExp}
- */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}(/|$)`)}/**
+ */
+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}(/|$)`);
+}
+
+/**
  * 检查相对路径是否应被忽略。
  * @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}// ==================== 文件收集 ====================
+ */
+function shouldIgnore(relativePath, regexPatterns) {
+  for (const regex of regexPatterns) {
+    if (regex.test(relativePath)) return true;
+  }
+  return false;
+}
+
+// ==================== 文件收集 ====================
+
 /**
  * 递归收集目录下的所有文件，遵循忽略规则。
  * @param {string} dir - 目录的绝对路径
  * @param {string} baseDir - 项目根目录，用于计算相对路径
  * @param {RegExp[]} ignoreRegexes
  * @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 创建 ====================
+ */
+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 创建 ====================
+
 /**
  * 根据收集到的文件创建 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();// 确保输出目录存在
-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)})}// ==================== 格式化工具 ====================
+ */
+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);
+  });
+}
+
+// ==================== 格式化工具 ====================
+
 /**
  * 将字节数格式化为可读字符串。
  * @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`}// ==================== 主流程 ====================
-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();
+ */
+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📦 playable-scripts 打包\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❌ 没有可打包的文件！请检查 .playcraftignore 规则。\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('  正在打包...');
+
+  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

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