@playcraft/devkit 1.0.16 → 1.0.17

package/core/utils/parseArgvOptions.js

@@ -1,8 +1,113 @@
-"use strict";/** @type {string[]} List of supported advertising networks */const allowedAdNetworks=["preview","applovin","unity","google","ironsource","facebook","moloco","adcolony","mintegral","vungle","tapjoy","snapchat","tiktok","appreciate","chartboost","pangle","mytarget","liftoff","smadex","adikteev","bigabid","inmobi","bigoads"];/** @type {AD_PROTOCOL[]} List of supported advertising protocols */const allowedAdProtocols=["none","mraid","dapi"];/** @type {AD_NETWORK[]} List of advertising partners that support MRAID protocol */const mraidPartners=["ironsource","applovin","unity","appreciate","chartboost","mytarget","liftoff","adcolony","adikteev","bigabid","inmobi"];/** @type {LANGUAGE[]} */const allowedLanguages=["auto","en","es","zh","hi","ar","fr","de","ja","pt"];/** @type {ORIENTATION[]} */const allowedOrientations=["both","portrait","landscape","square"];/**
+/** @type {string[]} List of supported advertising networks */
+const allowedAdNetworks = [
+  'preview',
+  'applovin',
+  'unity',
+  'google',
+  'ironsource',
+  'facebook',
+  'moloco',
+  'adcolony',
+  'mintegral',
+  'vungle',
+  'tapjoy',
+  'snapchat',
+  'tiktok',
+  'appreciate',
+  'chartboost',
+  'pangle',
+  'mytarget',
+  'liftoff',
+  'smadex',
+  'adikteev',
+  'bigabid',
+  'inmobi',
+  'bigoads'
+];
+/** @type {AD_PROTOCOL[]} List of supported advertising protocols */
+const allowedAdProtocols = ['none', 'mraid', 'dapi'];
+
+/** @type {AD_NETWORK[]} List of advertising partners that support MRAID protocol */
+const mraidPartners = [
+  'ironsource',
+  'applovin',
+  'unity',
+  'appreciate',
+  'chartboost',
+  'mytarget',
+  'liftoff',
+  'adcolony',
+  'adikteev',
+  'bigabid',
+  'inmobi'
+];
+
+/** @type {LANGUAGE[]} */
+const allowedLanguages = ['auto', 'en', 'es', 'zh', 'hi', 'ar', 'fr', 'de', 'ja', 'pt'];
+
+/** @type {ORIENTATION[]} */
+const allowedOrientations = ['both', 'portrait', 'landscape', 'square'];
+
+/**
  * 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={};// 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)}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;
+ */
+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);
+      }
+      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/resolveChannelFold2Zip.js

@@ -1,4 +1,4 @@
-"use strict";/**
+/**
  * 解析 isChannelFold2Zip 相关标志
  *
  * isChannelFold2Zip：所有渠道（排除 preview）输出 dist/渠道名称.zip
@@ -10,5 +10,17 @@
  * @param {string} params.adNetwork - 当前渠道名称
  * @param {boolean} params.isZipOutput - 当前渠道是否本身就走 ZIP 输出流程
  * @returns {{ isChannelFold2Zip: boolean, isZipOutputFinal: boolean }}
- */function resolveChannelFold2Zip({isChannelFold2ZipOption,adNetwork,isZipOutput}){const isChannelFold2Zip=!!(isChannelFold2ZipOption&&adNetwork!=="preview");// 非 ZIP 渠道启用 isChannelFold2Zip 时，需要强制走 ZIP 输出流程
-const isZipOutputFinal=isZipOutput||isChannelFold2Zip;if(isChannelFold2Zip){console.log(`✅ isChannelFold2Zip enabled: output will be dist/${adNetwork}.zip`)}return{isChannelFold2Zip,isZipOutputFinal}}exports.resolveChannelFold2Zip=resolveChannelFold2Zip;
+ */
+function resolveChannelFold2Zip({ isChannelFold2ZipOption, adNetwork, isZipOutput }) {
+  const isChannelFold2Zip = !!(isChannelFold2ZipOption && adNetwork !== 'preview');
+  // 非 ZIP 渠道启用 isChannelFold2Zip 时，需要强制走 ZIP 输出流程
+  const isZipOutputFinal = isZipOutput || isChannelFold2Zip;
+
+  if (isChannelFold2Zip) {
+    console.log(`✅ isChannelFold2Zip enabled: output will be dist/${adNetwork}.zip`);
+  }
+
+  return { isChannelFold2Zip, isZipOutputFinal };
+}
+
+exports.resolveChannelFold2Zip = resolveChannelFold2Zip;

package/core/utils/validateThemeData.js

@@ -1,4 +1,17 @@
-"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";/**
+'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';
+
+/**
  * 递归提取 JSON Schema 定义中的 `default` 值。
  *
  * - 对于 "object" 类型：递归遍历 `properties` 并构建嵌套对象。
@@ -6,15 +19,42 @@
  *
  * @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 校验指定主题的主题数据。
  *
  * 项目中预期的文件结构：
@@ -35,39 +75,144 @@ if("default"in schema){return schema.default}return undefined}/**
  *   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});const validate=ajv.compile(schemaContent);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 });
+  const validate = ajv.compile(schemaContent);
+  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）共用此函数。
  *
@@ -88,10 +233,60 @@ const lines=backupContent.split("\n");const contentStart=lines.findIndex(line=>!
  *   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,
+};