@playcraft/devkit 1.0.27 → 1.0.29

package/core/utils/validateThemeData.js

@@ -1,17 +1,4 @@
-'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 =
-  '// [自动生成的备份] 此文件由打包流程创建。\n' +
-  '// 如果打包中断，可以移除 ".backup" 后缀，\n' +
-  '// 并用此文件替换原始的 "theme.schema.json5" 来恢复。\n';
-
-/**
+"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` 值。
  *
  * - 对于 "object" 类型：递归遍历 `properties` 并构建嵌套对象。
@@ -19,42 +6,15 @@ const SCHEMA_BACKUP_COMMENT =
  *
  * @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;
-}
-
-/**
+ */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}/**
  * Check whether the parsed content of theme.schema.json5 is a real JSON Schema
  * (has "type" and "properties" fields) or has already been overwritten with
  * plain merged data (e.g. due to a previous interrupted build).
  *
  * @param {object} obj - Parsed content of theme.schema.json5
  * @returns {boolean} true if it looks like a valid JSON Schema definition
- */
-function isJsonSchema(obj) {
-  return obj && typeof obj === 'object' && obj.type === 'object' && typeof obj.properties === 'object';
-}
-
-/**
+ */function isJsonSchema(obj){return obj&&typeof obj==="object"&&obj.type==="object"&&typeof obj.properties==="object"}/**
  * 根据 schema 校验指定主题的主题数据。
  *
  * 项目中预期的文件结构：
@@ -75,151 +35,40 @@ function isJsonSchema(obj) {
  *   mergedData   – schema 默认值与主题数据合并后的完整数据
  *   isPlainData  – 如果 schema 文件已经是纯数据（非 schema 格式）则为 true
  *   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,
-      mergedData: null,
-      isPlainData: false,
-      errors: [`未找到 Schema 文件: ${schemaPath}`],
-    };
-  }
-
-  const schemaContent = JSON5.parse(fs.readFileSync(schemaPath, 'utf8'));
-
-  // Safety check: if the file is already plain data (not a JSON Schema),
-  // it was likely left over from a previous interrupted build.
-  // Use it directly without validation or overwriting.
-  if (!isJsonSchema(schemaContent)) {
-    return {
-      defaultData: schemaContent,
-      mergedData: schemaContent,
-      isPlainData: true,
-      errors: null,
-    };
-  }
-
-  // 从 schema 提取默认值
-  const defaultData = extractDefaultsFromSchema(schemaContent) || {};
-
-  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 });
-  let validate;
-  try {
-    validate = ajv.compile(schemaContent);
-  } catch (schemaErr) {
-    // schema 文件被之前的构建中断污染（mergedData 覆盖了 schema）→ 按纯数据恢复
-    console.warn(`[validateThemeData] schema 编译失败（可能被覆盖），降级为纯数据: ${schemaErr.message}`);
-    return { defaultData: merged, mergedData: merged, isPlainData: true, errors: null };
-  }
-  const valid = validate(merged);
-
-  if (!valid) {
-    const errors = validate.errors.map(err => {
-      const field = err.instancePath || '(root)';
-      return `${field} ${err.message}`;
-    });
-    return { defaultData, mergedData: merged, isPlainData: false, errors };
-  }
-
-  return { defaultData, mergedData: merged, isPlainData: false, 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,mergedData:null,isPlainData:false,errors:[`未找到 Schema 文件: ${schemaPath}`]}}const schemaContent=JSON5.parse(fs.readFileSync(schemaPath,"utf8"));// Safety check: if the file is already plain data (not a JSON Schema),
+// it was likely left over from a previous interrupted build.
+// Use it directly without validation or overwriting.
+if(!isJsonSchema(schemaContent)){return{defaultData:schemaContent,mergedData:schemaContent,isPlainData:true,errors:null}}// 从 schema 提取默认值
+const defaultData=extractDefaultsFromSchema(schemaContent)||{};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});let validate;try{validate=ajv.compile(schemaContent)}catch(schemaErr){// schema 文件被之前的构建中断污染（mergedData 覆盖了 schema）→ 按纯数据恢复
+console.warn(`[validateThemeData] schema 编译失败（可能被覆盖），降级为纯数据: ${schemaErr.message}`);return{defaultData:merged,mergedData:merged,isPlainData:true,errors:null}}const valid=validate(merged);if(!valid){const errors=validate.errors.map(err=>{const field=err.instancePath||"(root)";return`${field} ${err.message}`});return{defaultData,mergedData:merged,isPlainData:false,errors}}return{defaultData,mergedData:merged,isPlainData:false,errors:null}}/**
  * 深度合并两个普通对象。`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;
-}
-
-/**
+ */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}/**
  * 备份原始的 theme.schema.json5 文件。
  * 备份文件包含注释头，说明如何手动恢复。
  *
  * @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;
-}
-
-/**
+ */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}/**
  * 从备份文件恢复 theme.schema.json5 并删除备份。
  *
  * @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);
-}
-
-/**
+ */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)}/**
  * 用合并后的数据（schema 默认值 + 主题覆盖值）覆写 theme.schema.json5，
  * 以便打包工具在构建时可以直接使用。
  *
  * @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');
-}
-
-/**
+ */function overwriteSchemaWithMerged(schemaPath,mergedData){const content=JSON.stringify(mergedData,null,2);fs.writeFileSync(schemaPath,content,"utf8")}/**
  * 执行主题校验并输出标准日志。
  * 单次构建（build.js）和批量构建（batch-build.js）共用此函数。
  *
@@ -240,60 +89,10 @@ function overwriteSchemaWithMerged(schemaPath, mergedData) {
  *   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', warn: '\x1b[33m' };
-    const reset = '\x1b[0m';
-    const color = colors[level] || '';
-    console.log(`${color}${msg}${reset}`);
-  };
-
-  logFn(`校验主题数据: ${themeName}`, 'info');
-
-  const { defaultData, mergedData, isPlainData, errors } = validateThemeData(themeName, projectRoot, themeConfig);
-
-  // Safety: schema file is already plain data (previous build was interrupted)
-  // Use it directly, no need to backup/overwrite
-  if (isPlainData) {
-    logFn(`⚠️  theme.schema.json5 已经是纯数据格式（可能上次构建中断未恢复），直接使用`, 'warn');
-    // schemaPath is returned as null so that restoreSchema won't be called
-    // (there's nothing to restore — the file is already data, not a schema)
-    return { valid: true, errors: null, schemaPath: null };
-  }
-
-  if (errors) {
-    logFn(`主题 "${themeName}" 数据校验失败:`, 'error');
-    errors.forEach(e => logFn(`  - ${e}`, 'error'));
-    return { valid: false, errors, schemaPath };
-  }
-
-  logFn(`主题 "${themeName}" 数据校验通过`, 'success');
-
-  // 备份原始 schema，然后用合并后的数据覆写以供构建使用
-  backupSchema(schemaPath);
-  overwriteSchemaWithMerged(schemaPath, mergedData);
-  logFn(`已备份 schema 并写入合并后的主题数据`, 'info');
-
-  return { valid: true, errors: null, schemaPath };
-}
-
-module.exports = {
-  validateThemeData,
-  deepMerge,
-  extractDefaultsFromSchema,
-  isJsonSchema,
-  runThemeValidation,
-  backupSchema,
-  restoreSchema,
-  overwriteSchemaWithMerged,
-};
+ */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",warn:"\x1B[33m"};const reset="\x1B[0m";const color=colors[level]||"";console.log(`${color}${msg}${reset}`)};logFn(`校验主题数据: ${themeName}`,"info");const{defaultData,mergedData,isPlainData,errors}=validateThemeData(themeName,projectRoot,themeConfig);// Safety: schema file is already plain data (previous build was interrupted)
+// Use it directly, no need to backup/overwrite
+if(isPlainData){logFn(`⚠️  theme.schema.json5 已经是纯数据格式（可能上次构建中断未恢复），直接使用`,"warn");// schemaPath is returned as null so that restoreSchema won't be called
+// (there's nothing to restore — the file is already data, not a schema)
+return{valid:true,errors:null,schemaPath:null}}if(errors){logFn(`主题 "${themeName}" 数据校验失败:`,"error");errors.forEach(e=>logFn(`  - ${e}`,"error"));return{valid:false,errors,schemaPath}}logFn(`主题 "${themeName}" 数据校验通过`,"success");// 备份原始 schema，然后用合并后的数据覆写以供构建使用
+backupSchema(schemaPath);overwriteSchemaWithMerged(schemaPath,mergedData);logFn(`已备份 schema 并写入合并后的主题数据`,"info");return{valid:true,errors:null,schemaPath}}module.exports={validateThemeData,deepMerge,extractDefaultsFromSchema,isJsonSchema,runThemeValidation,backupSchema,restoreSchema,overwriteSchemaWithMerged};