@playcraft/devkit 1.0.16 → 1.0.18

package/core/vite.dev.js

@@ -1,25 +1,341 @@
-"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");/**
+'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 开发服务器
+ */
+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 {
+      const JSON5 = require('json5');
+      const configContent = fs.readFileSync(configFilePath, 'utf-8');
+      const config = JSON5.parse(configContent);
+      const paths = config.compilerOptions?.paths || {};
+      for (const [alias, targets] of Object.entries(paths)) {
+        // 将 tsconfig paths 格式 "foo/*" -> ["src/foo/*"] 转换为 vite alias
+        const cleanAlias = alias.replace('/*', '');
+        const cleanTarget = targets[0]?.replace('/*', '') || '';
+        if (cleanAlias && cleanTarget) {
+          aliasConfig[cleanAlias] = path.resolve(cleanTarget);
+        }
+      }
+    } catch (err) {
+      console.log('\x1b[33m⚠️  读取路径配置失败: ' + 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,
+          };
+        }
+      },
+    };
+  }
+
+  // 字体注入插件（dev 模式：读取字体文件 base64 内联到 index.html）
+  function fontFamilyPlugin() {
+    const { getOrGenerateFontCSS } = require('./utils/fontResolver');
+    let _themeName = null;
+    let _themeConfig = null;
+
+    // 尝试检测当前主题名（与 build.js 中 detectCurrentTheme 逻辑一致）
+    function detectTheme() {
+      const root = process.cwd();
+      const buildsConfigPath = path.join(root, 'builds.config.js');
+      let config = { sourceDir: 'src/theme', entryFile: 'src/theme/index.ts' };
+      if (fs.existsSync(buildsConfigPath)) {
+        try {
+          delete require.cache[require.resolve(buildsConfigPath)];
+          const buildsConfig = require(buildsConfigPath);
+          if (buildsConfig.themes) {
+            config = { ...config, ...buildsConfig.themes };
+          }
+        } catch (_) { /* ignore */ }
+      }
+      let name = null;
+      const entryPath = path.join(root, config.entryFile);
+      if (fs.existsSync(entryPath)) {
+        const content = fs.readFileSync(entryPath, 'utf8');
+        const match = content.match(/from\s+['"]\.\/([^'"]+)['"]/);
+        if (match) name = match[1];
+      }
+      return { themeName: name, themeConfig: config };
+    }
+
+    return {
+      name: 'vite-plugin-font-family',
+      apply: 'serve',
+      transformIndexHtml: {
+        order: 'pre',
+        handler() {
+          if (_themeName === null) {
+            const detected = detectTheme();
+            _themeName = detected.themeName;
+            _themeConfig = detected.themeConfig;
+          }
+          if (!_themeName) return '';
+          const css = getOrGenerateFontCSS({
+            projectRoot: process.cwd(),
+            themeName: _themeName,
+            themeConfig: _themeConfig,
+          });
+          return css ? [{ tag: 'style', attrs: { 'data-playable-fonts': '' }, children: css.replace(/<\/?style[^>]*>/g, ''), injectTo: 'head' }] : [];
+        },
+      },
+    };
+  }
+
+  /** @type {import('vite').UserConfig} */
+  const viteConfig = {
+    root: '.',
+    resolve: {
+      alias: aliasConfig,
+    },
+    plugins: [json5Plugin(), assetInlinePlugin(), fontFamilyPlugin()],
+    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 配置对象。override 覆盖 base。
+ * 数组会拼接（plugins），其余字段浅覆盖。
+ */
+function deepMergeViteConfig(base, override) {
+  if (!override || typeof override !== 'object') return base;
+  const result = { ...base };
+  for (const key of Object.keys(override)) {
+    const bv = base[key];
+    const ov = override[key];
+    if (key === 'plugins' && Array.isArray(bv) && Array.isArray(ov)) {
+      result[key] = [...bv, ...ov];
+    } else if (
+      ov !== null && typeof ov === 'object' && !Array.isArray(ov) &&
+      bv !== null && typeof bv === 'object' && !Array.isArray(bv)
+    ) {
+      result[key] = { ...bv, ...ov };
+    } else {
+      result[key] = ov;
+    }
+  }
+  return result;
+}
+
+/**
+ * 尝试加载项目根目录的 vite.config.ts。
+ * 使用 Vite 内置的 loadConfigFromFile API。
+ * 注意：vite 是项目的 devDependency，不是 scripts 的依赖，
+ * 因此需要通过 createRequire 从项目根目录解析 require 路径。
+ */
+async function loadProjectViteConfig(root) {
+  const candidates = ['vite.config.ts', 'vite.config.js', 'vite.config.mjs'];
+  let configPath = null;
+  for (const c of candidates) {
+    const p = path.join(root, c);
+    if (fs.existsSync(p)) { configPath = p; break; }
+  }
+  if (!configPath) return null;
+
+  // 从项目根目录创建 require，解决 vite 模块解析路径问题
+  const { createRequire } = require('module');
+  let projRequire;
+  try {
+    projRequire = createRequire(path.join(root, 'package.json'));
+  } catch (_) {
+    projRequire = createRequire(path.join(root, 'noop.js'));
+  }
+
+  // 通过项目的 require 路径加载 vite
+  let loadConfigFromFile;
+  try {
+    loadConfigFromFile = projRequire('vite').loadConfigFromFile;
+  } catch (_) {
+    try {
+      loadConfigFromFile = projRequire('vite/dist/node/config').loadConfigFromFile;
+    } catch (_2) {
+      console.log('\x1b[33m⚠️  [vite] Cannot load project config (loadConfigFromFile unavailable), using scripts default\x1b[0m');
+      return null;
+    }
+  }
+
+  if (!loadConfigFromFile) return null;
+
+  try {
+    const result = await loadConfigFromFile(
+      { command: 'serve', mode: process.env.NODE_ENV || 'development' },
+      configPath,
+      root
+    );
+    if (result && result.config) {
+      console.log(`[vite] Loaded project config: ${path.relative(root, configPath)}`);
+      return result.config;
+    }
+    return null;
+  } catch (err) {
+    console.log(`\x1b[33m⚠️  [vite] Failed to load ${path.relative(root, configPath)}: ${err.message}, using scripts default\x1b[0m`);
+    return null;
+  }
+}
+
+/**
+ * 启动 Vite 开发服务器。
+ *
+ * 配置优先级（从低到高）：
+ *   1. makeViteDevConfig 构建的默认配置（fontFamilyPlugin、json5Plugin 等）
+ *   2. 项目根目录的 vite.config.ts（如果存在，覆盖/扩充默认配置）
+ *   3. 传入的 viteConfig / customOptions / customDefines / viteCustomConfig
+ *
  * @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;
+ */
+async function runViteDev(viteConfig, customOptions, customDefines, viteCustomConfig) {
+  if (!viteConfig) {
+    viteConfig = makeViteDevConfig(customOptions, customDefines, viteCustomConfig);
+  }
+
+  // 加载项目根目录的 vite 配置文件并合并（项目配置覆盖 scripts 默认）
+  const projectRoot = process.cwd();
+  const projectConfig = await loadProjectViteConfig(projectRoot);
+  if (projectConfig) {
+    viteConfig = deepMergeViteConfig(viteConfig, projectConfig);
+  }
+
+  // vite 是项目的 devDependency，从项目目录解析
+  const { createRequire } = require('module');
+  const projRequire = createRequire(path.join(projectRoot, 'package.json'));
+  const { createServer } = projRequire('vite');
+  // configFile: false 防止 Vite 再次加载项目的 vite.config.ts（已经手动合并了）
+  const server = await createServer({ ...viteConfig, configFile: false });
+  await server.listen();
+  server.printUrls();
+}
+
+exports.makeViteDevConfig = makeViteDevConfig;
+exports.runViteDev = runViteDev;