// @ts-check /** * Jest 自動配置模組 * Jest Auto Configuration Module * * 此模組自動偵測並配置 Jest 測試環境,支援多層級配置解析 * This module automatically detects and configures Jest test environment with multi-level configuration resolution */ const { basename, extname, dirname } = require('path'); /** * Jest 配置物件 * Jest configuration object * * @type { import('ts-jest').JestConfigWithTsJest } */ let jestConfig = {} /** * 嘗試使用 `@yarn-tool/require-resolve` 載入模組的工具函數 * Utility function for lazy loading modules * * @param {string} name - 模組名稱 Module name * @param {string[]} [paths] - 搜尋路徑 Search paths * @private */ function _lazyRequire(name, paths) { let m; try { /** * 嘗試使用 require-resolve 工具載入模組 * Try to load module using require-resolve tool */ m = require('@yarn-tool/require-resolve').requireExtra(name, { includeCurrentDirectory: true, includeGlobal: true, paths, }); } catch (e) {} /** * 如果失敗則使用標準 require * If failed, use standard require */ return typeof m === 'undefined' ? require(name) : m; } /** * 嘗試使用 `@yarn-tool/require-resolve` 解析模組路徑的工具函數 * Utility function for resolving module paths * * @param {string} name - 模組名稱 Module name * @returns {string} - 解析後的路徑 Resolved path * @private */ function _requireResolve(name) { let result; try { /** @type {import('@yarn-tool/require-resolve')} */ const { requireResolveExtra, requireResolveCore } = _lazyRequire('@yarn-tool/require-resolve'); /** * 嘗試從多個路徑解析 TSDX 相關模組 * Try to resolve TSDX related modules from multiple paths */ const paths = [ requireResolveExtra('@bluelovers/tsdx').result, requireResolveExtra('tsdx').result, ].filter(Boolean); result = requireResolveCore(name, { includeGlobal: true, includeCurrentDirectory: true, paths, }) } catch (e) { } /** * 如果都失敗,使用標準 resolve * If all failed, use standard resolve */ result = result || require.resolve(name); console.info('[require.resolve]', name, '=>', result) return result } /** * 配置解析狀態標誌 * Configuration resolution status flag */ let _isNeedConfig = true; try { /** * 第一層:搜尋工作區中的配置檔案 * First level: Search for configuration files in workspace */ if (!jestConfig.preset) { /** @type {import('@yarn-tool/ws-find-up-paths')} */ const { findUpPathsWorkspaces } = _lazyRequire('@yarn-tool/ws-find-up-paths'); /** * 向上搜尋 jest-preset.js 和 jest.config.js * Search upwards for jest-preset.js and jest.config.js */ let result = findUpPathsWorkspaces([ 'jest-preset.js', 'jest.config.js', ], { /** 忽略當前套件 / Ignore current package */ ignoreCurrentPackage: true, /** 只搜尋檔案 / Only search for files */ onlyFiles: true, }).result; if (result) { let name = basename(result, extname(result)) switch (name) { /** * 如果是 jest-preset.js,使用其目錄作為 preset * If it's jest-preset.js, use its directory as preset */ case 'jest-preset': // @ts-ignore // jestConfig.preset = dirname(result); jestConfig.preset = result; break; /** * 其他情況,載入配置檔案內容 * Otherwise, load the configuration file content */ default: jestConfig = { ...require(result), jestConfig, }; break; } _isNeedConfig = false; } } } catch (e) { } try { /** * 第二層:嘗試解析 @bluelovers/jest-config * Second level: Try to resolve @bluelovers/jest-config */ if (_isNeedConfig && !jestConfig.preset) { let result = _requireResolve('@bluelovers/jest-config/package.json'); if (result) { // @ts-ignore jestConfig.preset = dirname(result); _isNeedConfig = false; } } } catch (e) { } if (_isNeedConfig && !jestConfig.preset) { /** * 第三層:使用預設的 @bluelovers/jest-config * Third level: Use default @bluelovers/jest-config */ // @ts-ignore jestConfig.preset = '@bluelovers/jest-config'; _isNeedConfig = false; } /** * 輸出最終的 preset 設定 * Output the final preset configuration */ console.info(`jest.config.preset: ${jestConfig.preset}`); module.exports = jestConfig