@bluelovers/jest-config 1.1.11 → 1.1.13

package/index.d.ts

@@ -0,0 +1,142 @@
+import { Table } from '@yarn-tool/table';
+import { TableConstructorOptions } from 'cli-table3';
+import { InitialOptionsTsJest, JestConfigWithTsJest } from 'ts-jest';
+import { ITSWriteable } from 'ts-type/lib/helper/readonly';
+import { ITSValueOrArrayMaybeReadonly } from 'ts-type/lib/type/base';
+
+export type IJestConfig = InitialOptionsTsJest | JestConfigWithTsJest;
+export interface IRuntime<T extends IJestConfig = IJestConfig> {
+	jestConfig: T;
+	autoPrint: boolean;
+	options: IOptionsPrintJestConfigInfo;
+	newJestConfig?: T;
+}
+export declare function _newTableBorderless(options?: TableConstructorOptions): Table.Table;
+export interface IOptionsPrintJestConfigInfo {
+	cwd?: string;
+	file?: string;
+}
+export declare function printJestConfigInfo(jestConfig: IJestConfig, options?: IOptionsPrintJestConfigInfo): void;
+export declare function _requireResolve(name: string): string;
+export declare function makeTestRegexConfig<T extends string>(testExt: ITSValueOrArrayMaybeReadonly<T>): Pick<InitialOptionsTsJest, "testMatch" | "testRegex">;
+export declare function _handleFileExtensionsCore<T extends string>(testExt: ITSValueOrArrayMaybeReadonly<T>): T[];
+export declare function _handleFileExtensions<T extends string>(testExt: ITSValueOrArrayMaybeReadonly<T>, sep: string): string;
+export declare function fixJestConfig<T extends IJestConfig>(jestConfig: T): T;
+export declare function defaultTestFileExtensions(): [
+	"ts",
+	"tsx",
+	"mts",
+	"cts"
+];
+/**
+ * @see https://jestjs.io/docs/configuration#options
+ */
+export declare function defaultModuleFileExtensions(): [
+	"js",
+	"mjs",
+	"cjs",
+	"jsx",
+	"ts",
+	"mts",
+	"cts",
+	"tsx",
+	"json",
+	"node"
+];
+export declare function defaultCoverageFileExtensions(): [
+	"js",
+	"mjs",
+	"cjs",
+	"jsx",
+	"ts",
+	"mts",
+	"cts",
+	"tsx"
+];
+export declare function defaultTransformFileExtensions(): [
+	"ts",
+	"tsx",
+	"mts",
+	"cts"
+];
+export declare function defaultCoveragePathIgnorePatterns(): [
+	"/node_modules/",
+	"/__snapshots__/",
+	"/__tests__/",
+	"/__test__/",
+	"/dist/",
+	"/test/",
+	"/fixture/",
+	"/__file_snapshots__/",
+	"/__fixtures__/"
+];
+export declare function defaultTestPathIgnorePatterns(): [
+	"/node_modules/",
+	"/__fixtures__/",
+	"/__file_snapshots__/",
+	"/fixtures/",
+	"/__tests__/helpers/",
+	"/__tests__/utils/",
+	"__mocks__",
+	"/dist/"
+];
+export declare function defaultTransform(runtime: IRuntime): ITSWriteable<{
+	readonly [x: string]: import("@jest/types/build/Config").TransformerConfig;
+}>;
+export declare const cacheDirectory: string;
+export declare function mixinJestConfig<T extends IJestConfig>(jestConfig?: T, autoPrint?: boolean, options?: IOptionsPrintJestConfigInfo): {
+	testPathIgnorePatterns: [
+		"/node_modules/",
+		"/__fixtures__/",
+		"/__file_snapshots__/",
+		"/fixtures/",
+		"/__tests__/helpers/",
+		"/__tests__/utils/",
+		"__mocks__",
+		"/dist/"
+	];
+	setupFilesAfterEnv: any[];
+	verbose: true;
+	/**
+	 * if didn't set `coverageProvider` to `v8`
+	 * with `collectCoverage` `true`, nodejs debug point maybe will fail
+	 */
+	coverageProvider: "v8";
+	collectCoverage: false;
+	coveragePathIgnorePatterns: [
+		"/node_modules/",
+		"/__snapshots__/",
+		"/__tests__/",
+		"/__test__/",
+		"/dist/",
+		"/test/",
+		"/fixture/",
+		"/__file_snapshots__/",
+		"/__fixtures__/"
+	];
+	testMatch?: string[];
+	testRegex?: string | string[];
+	globals: {};
+	cacheDirectory: string;
+	maxWorkers: number;
+	clearMocks: true;
+	passWithNoTests: true;
+	moduleFileExtensions: [
+		"js",
+		"mjs",
+		"cjs",
+		"jsx",
+		"ts",
+		"mts",
+		"cts",
+		"tsx",
+		"json",
+		"node"
+	];
+} & T;
+
+export {
+	mixinJestConfig as default,
+};
+
+export {};

package/jest-preset.cjs

@@ -1,3 +1,23 @@
+/**
+ * Jest Preset (CommonJS) - Jest 預設配置（CommonJS 版本）
+ *
+ * 此檔案是發布模組時的必要檔案，用於支援 CommonJS 環境的 Jest 配置載入
+ * This file is required for npm publishing, used for Jest configuration loading in CommonJS environments
+ *
+ * 發布注意事項 / Publishing Notes:
+ * - 此檔案必須包含在 npm 發布中 / This file must be included in npm publish
+ * - 對應的 exports 配置: "./jest-preset": { "require": "./jest-preset.cjs", ... }
+ * - 請確保 .npmignore 中有 `!jest-preset.cjs` 以保留此檔案
+ * - Please ensure .npmignore has `!jest-preset.cjs` to keep this file
+ *
+ * @see https://jestjs.io/docs/configuration#preset-string
+ * @see package.json exports 配置 / package.json exports configuration
+ */
+
 const { mixinJestConfig } = require('./dist/index.cjs.development.cjs');
 
+/**
+ * 匯出預設的 Jest 配置物件
+ * Export default Jest configuration object
+ */
 module.exports = mixinJestConfig();

package/jest-preset.mjs

@@ -1,3 +1,28 @@
+/**
+ * Jest Preset (ES Module) - Jest 預設配置（ES 模組版本）
+ *
+ * 此檔案是發布模組時的必要檔案，用於支援 ESM 環境的 Jest 配置載入
+ * This file is required for npm publishing, used for Jest configuration loading in ESM environments
+ *
+ * 發布注意事項 / Publishing Notes:
+ * - 此檔案必須包含在 npm 發布中 / This file must be included in npm publish
+ * - 對應的 exports 配置: "./jest-preset": { ..., "import": "./jest-preset.mjs" }
+ * - 請確保 .npmignore 中有 `!jest-preset.mjs` 以保留此檔案
+ * - Please ensure .npmignore has `!jest-preset.mjs` to keep this file
+ *
+ * 關於 jest-preset.js / About jest-preset.js:
+ * - jest-preset.js 不需要實際存在 / jest-preset.js does not need to physically exist
+ * - package.json exports 中已定義其映射關係至 .cjs 和 .mjs
+ * - The mapping is defined in package.json exports to .cjs and .mjs
+ *
+ * @see https://jestjs.io/docs/configuration#preset-string
+ * @see package.json exports 配置 / package.json exports configuration
+ */
+
 import { mixinJestConfig } from './dist/index.esm.mjs';
 
+/**
+ * 匯出預設的 Jest 配置物件
+ * Export default Jest configuration object
+ */
 export default mixinJestConfig();

package/jest.config.js

@@ -1,18 +1,62 @@
 // @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');
 
 /**
- * // @type { import('@jest/types').Config.InitialOptions }
- * @type { import('ts-jest').InitialOptionsTsJest }
+ * 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
  */
-let jestConfig = {
+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;
 }
 
 /**
- * @param {string} name
- * @returns {string}
+ * 嘗試使用 `@yarn-tool/require-resolve` 解析模組路徑的工具函數
+ * Utility function for resolving module paths
+ *
+ * @param {string} name - 模組名稱 Module name
+ * @returns {string} - 解析後的路徑 Resolved path
  * @private
  */
 function _requireResolve(name)
@@ -21,9 +65,13 @@ function _requireResolve(name)
 
 	try
 	{
-		// @ts-ignore
-		const { requireResolveExtra, requireResolveCore } = require('@yarn-tool/require-resolve');
+		/** @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,
@@ -40,6 +88,10 @@ function _requireResolve(name)
 
 	}
 
+	/**
+	 * 如果都失敗，使用標準 resolve
+	 * If all failed, use standard resolve
+	 */
 	result = result || require.resolve(name);
 
 	console.info('[require.resolve]', name, '=>', result)
@@ -47,18 +99,34 @@ function _requireResolve(name)
 	return result
 }
 
-let _ok = true;
+/**
+ * 配置解析狀態標誌
+ * Configuration resolution status flag
+ */
+let _isNeedConfig = true;
 
 try
 {
+	/**
+	 * 第一層：搜尋工作區中的配置檔案
+	 * First level: Search for configuration files in workspace
+	 */
 	if (!jestConfig.preset)
 	{
-
-		let result = require('@yarn-tool/ws-find-up-paths').findUpPathsWorkspaces([
+		/** @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;
 
@@ -68,9 +136,19 @@ try
 
 			switch (name)
 			{
+				/**
+				 * 如果是 jest-preset.js，使用其目錄作為 preset
+				 * If it's jest-preset.js, use its directory as preset
+				 */
 				case 'jest-preset':
-					jestConfig.preset = dirname(result);
+					// @ts-ignore
+					// jestConfig.preset = dirname(result);
+					jestConfig.preset = result;
 					break;
+				/**
+				 * 其他情況，載入配置檔案內容
+				 * Otherwise, load the configuration file content
+				 */
 				default:
 					jestConfig = {
 						...require(result),
@@ -79,7 +157,7 @@ try
 					break;
 			}
 
-			_ok = false;
+			_isNeedConfig = false;
 		}
 	}
 }
@@ -90,13 +168,18 @@ catch (e)
 
 try
 {
-	if (_ok && !jestConfig.preset)
+	/**
+	 * 第二層：嘗試解析 @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);
-			_ok = false;
+			_isNeedConfig = false;
 		}
 	}
 }
@@ -105,12 +188,21 @@ catch (e)
 
 }
 
-if (_ok && !jestConfig.preset)
+if (_isNeedConfig && !jestConfig.preset)
 {
+	/**
+	 * 第三層：使用預設的 @bluelovers/jest-config
+	 * Third level: Use default @bluelovers/jest-config
+	 */
+	// @ts-ignore
 	jestConfig.preset = '@bluelovers/jest-config';
-	_ok = false;
+	_isNeedConfig = false;
 }
 
+/**
+ * 輸出最終的 preset 設定
+ * Output the final preset configuration
+ */
 console.info(`jest.config.preset: ${jestConfig.preset}`);
 
 module.exports = jestConfig

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@bluelovers/jest-config",
-  "version": "1.1.11",
-  "description": "Jest preset configuration with ts-jest typescript",
+  "version": "1.1.13",
+  "description": "Jest configuration preset with TypeScript support, providing automatic ts-jest transform chain integration, cache management, and coverage settings / 具備 TypeScript 支援的 Jest 配置預設套件，提供自動 ts-jest 轉換鏈整合、快取管理和覆蓋率設定",
   "keywords": [
     "jest-preset",
     "jest",
@@ -33,23 +33,23 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.esm.mjs",
-      "require": "./dist/index.cjs"
+      "require": "./dist/index.cjs",
+      "import": "./dist/index.esm.mjs"
     },
     "./dist/jest-preset.cjs": "./jest-preset.cjs",
     "./dist/jest-preset.js": {
-      "import": "./jest-preset.mjs",
-      "require": "./jest-preset.cjs"
+      "require": "./jest-preset.cjs",
+      "import": "./jest-preset.mjs"
     },
     "./dist/jest-preset.mjs": "./jest-preset.mjs",
     "./jest-preset": {
-      "import": "./jest-preset.mjs",
-      "require": "./jest-preset.cjs"
+      "require": "./jest-preset.cjs",
+      "import": "./jest-preset.mjs"
     },
     "./jest-preset.cjs": "./jest-preset.cjs",
     "./jest-preset.js": {
-      "import": "./jest-preset.mjs",
-      "require": "./jest-preset.cjs"
+      "require": "./jest-preset.cjs",
+      "import": "./jest-preset.mjs"
     },
     "./jest-preset.mjs": "./jest-preset.mjs",
     "./package.json": "./package.json",
@@ -61,59 +61,49 @@
   "types": "dist/index.d.ts",
   "typings": "dist/index.d.ts",
   "scripts": {
-    "review": "yarn run review:coverage",
-    "review:coverage": "yarn run lint && yarn run coverage",
-    "review:test": "yarn run lint && yarn run test",
-    "coverage": "yarn run test -- --coverage",
-    "lint": "yarn run lint:eslint",
-    "lint:eslint": "ynpx eslint --ext .ts,.tsx,.mts,.cts ./",
-    "pretest": "echo pretest",
+    "pretest": "pnpm run build",
     "test": "jest --passWithNoTests",
     "test:jest": "jest --passWithNoTests",
-    "test:jest:snapshot": "yarn run test:jest -- -u",
+    "test:jest:coverage": "pnpm run test:jest -- --coverage",
+    "test:jest:snapshot": "pnpm run test:jest -- -u",
     "test:mocha": "ynpx --quiet -p ts-node -p mocha mocha -- --require ts-node/register \"!(node_modules)/**/*.{test,spec}.{ts,tsx}\"",
-    "test:snapshot": "yarn run test -- -u",
+    "test:snapshot": "pnpm run test -u",
     "test:tsd": "ynpx tsd",
     "test:tsdx": "ynpx @bluelovers/tsdx test --passWithNoTests",
-    "posttest": "yarn run build",
-    "build": "yarn run build:tsdx && yarn run build:dts:bundle",
-    "build:dts:bundle": "ynpx dts-bundle-generator -o ./dist/index.d.ts ./src/index.ts --no-banner --inline-declare-global & echo build:dts:bundle",
+    "build": "pnpm run build:tsdx && pnpm run build:dts:bundle",
+    "build:dts:bundle": "node --run build:dts:copy2 & ynpx @bluelovers/dts-bundle-generator -o ./dist/index.d.ts ./src/index.ts --no-banner --inline-declare-global & echo build:dts:bundle",
     "build:dts:copy": "copy .\\src\\index.d.ts .\\dist\\index.d.ts & echo build:dts",
-    "build:dts:tsc": "yarn run build:dts:tsc:emit && yarn run build:dts:copy",
-    "build:dts:tsc:emit": "tsc --emitDeclarationOnly --declaration --noEmit false",
+    "build:dts:copy2": "copy .\\index.d.ts .\\dist\\index.d.ts & echo copy:dts",
+    "build:dts:tsc": "pnpm run build:dts:tsc:emit & pnpm run build:dts:copy",
+    "build:dts:tsc:emit": "cd src && tsc --emitDeclarationOnly --declaration --noEmit false",
     "build:microbundle": "ynpx microbundle --target node",
     "build:tsdx": "ynpx @bluelovers/tsdx build --target node --name index",
     "ci:install": "echo ci:install",
     "ci:build": "echo ci:build",
-    "preversion": "yarn run test",
+    "preversion": "pnpm run test",
     "version": "echo version",
-    "postversion": "echo postversion && yarn run test & git commit ./dist -m \"build(dist): update build\" & echo update build",
-    "prepublish": "echo prepublish",
-    "prepare": "echo prepare",
+    "postversion": "echo postversion && pnpm run test & git commit ./dist -m \"build(dist): update build\" & echo update build",
     "prepublishOnly": "echo prepublishOnly",
-    "prepublishOnly:update": "yarn run ncu && yarn run sort-package-json",
-    "prepack": "echo prepack",
-    "pack": "echo pack",
-    "postpack": "echo postpack",
+    "prepublishOnly:update": "pnpm run ncu && pnpm run sort-package-json",
     "publish": "echo publish",
-    "postpublish": "echo postpublish",
     "postpublishOnly": "echo postpublishOnly",
     "ncu": "yarn-tool ncu -u",
     "sort-package-json": "yarn-tool sort",
     "tsc:showConfig": "ynpx get-current-tsconfig -p"
   },
   "dependencies": {
-    "@yarn-tool/require-resolve": "^3.0.0",
-    "@yarn-tool/table": "^2.0.13",
-    "array-hyper-unique": "^2.1.4",
+    "@yarn-tool/require-resolve": "^4.0.9",
+    "@yarn-tool/table": "^2.0.22",
+    "array-hyper-unique": "^2.1.8",
+    "cli-table3": "^0.6.5",
     "debug-color2": "^1.3.2",
-    "jest-cache-directory": "^1.0.6",
-    "jest-chain-transform": "^0.0.5",
-    "ts-type": ">=2"
+    "jest-cache-directory": "^1.0.7",
+    "jest-chain-transform": "^0.0.8",
+    "regexp-helper-core": "^2.0.13",
+    "ts-type": ">=3.0.8"
   },
-  "packageManager": "yarn@1.22.19",
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "4afc40e52c2dbf807ec50ccab179c969c36f270d"
+  "gitHead": "aebbf6f90595ed291660067da304cfd9110d6314"
 }

package/src/default-setup-fles.ts

@@ -0,0 +1,49 @@
+import { IJestConfig, IRuntime } from './types';
+import { detectIncludes } from './util';
+import { _requireResolve2 } from './helper';
+import { ITSPickExtra } from 'ts-type';
+
+/** 環境設置載入的檔案 / Files to load environment setup */
+export function defaultSetupFiles(runtime?: ITSPickExtra<IRuntime, 'jestConfig'>)
+{
+	const jestConfig = runtime?.jestConfig ?? {} as IJestConfig;
+
+	let detect = detectIncludes(jestConfig.setupFiles, 'dotenv');
+
+	const setupFiles: IJestConfig['setupFiles'] = [
+		/**
+		 * @see https://lusbuab.medium.com/using-dotenv-with-jest-7e735b34e55f
+		 */
+		!detect['dotenv'] && _requireResolve2('dotenv/config').result,
+		...(jestConfig.setupFiles ?? []),
+
+	].filter(Boolean);
+
+	const setupFilesAfterEnv = [
+		// 可選擇性啟用的 Jest 擴充套件 / Optional Jest extensions
+		//"jest-chain",
+		//"jest-extended/all",
+		//"jest-extended-extra",
+		//"jest-num-close-with",
+		/**
+		 * 跨平台測試支援參考 / Cross-platform testing support reference
+		 * @see https://medium.com/doctolib/how-to-run-the-same-jest-test-suite-across-several-platforms-jest-os-detection-plugin-included-f8113832482b
+		 * @see https://github.com/doctolib/jest-os-detection
+		 */
+		//'jest-os-detection',
+		...(jestConfig.setupFilesAfterEnv ?? []),
+	].filter(Boolean);
+
+	const ret = {} as Pick<IJestConfig, 'setupFiles' | 'setupFilesAfterEnv'>;
+
+	if (setupFiles.length)
+	{
+		ret.setupFiles = setupFiles;
+	}
+	if (setupFilesAfterEnv.length)
+	{
+		ret.setupFilesAfterEnv = setupFilesAfterEnv;
+	}
+
+	return ret
+}

package/src/default-transform.ts

@@ -0,0 +1,96 @@
+import { IJestConfig, IRuntime } from './types';
+import { _handleFileExtensions, _requireResolve } from './helper';
+import { defaultTsJestTransformerOptions } from './plugin/ts-jest';
+import { defaultTransformFileExtensions } from './defaults';
+import { IOptionsRequireResolve as IOptions, requireResolveExtra } from '@yarn-tool/require-resolve';
+import { ITSWriteable } from 'ts-type';
+
+/**
+ * 建立預設的轉換器配置
+ * Create default transformer configuration
+ *
+ * 配置 ts-jest 作為主要轉換器，並在可用時整合 jest-tsd-transform 和 jest-chain-transform
+ * Configures ts-jest as the main transformer, integrating jest-tsd-transform and jest-chain-transform when available
+ *
+ * @param {IRuntime} runtime - 執行時期配置 / Runtime configuration
+ * @returns {object} 轉換器配置物件 / Transformer configuration object
+ */
+export function defaultTransform(runtime: IRuntime)
+{
+	/**
+	 * 搜尋路徑列表，用於解析相關模組
+	 * Search paths list for resolving related modules
+	 */
+	const paths: string[] = [
+		requireResolveExtra('@bluelovers/jest-config').result,
+	].filter(Boolean);
+
+	/**
+	 * 模組解析選項 / Module resolution options
+	 */
+	const opts: IOptions = {
+		includeGlobal: true,
+		includeCurrentDirectory: true,
+		paths,
+	};
+
+	/**
+	 * ts-jest 轉換器配置
+	 * ts-jest transformer configuration
+	 */
+	let ts_transform: IJestConfig["transform"][string] = _requireResolve('ts-jest') as 'ts-jest';
+
+	/**
+	 * 將 ts-jest 與其選項合併
+	 * Merge ts-jest with its options
+	 */
+	ts_transform = [ts_transform, defaultTsJestTransformerOptions(runtime)];
+
+	/**
+	 * 嘗試解析 jest-tsd-transform（TypeScript 宣告檔轉換器）
+	 * Try to resolve jest-tsd-transform (TypeScript declaration file transformer)
+	 */
+	const { result: tsd } = requireResolveExtra('jest-tsd-transform', opts);
+
+	/**
+	 * 如果 jest-tsd-transform 可用，嘗試建立轉換鏈
+	 * If jest-tsd-transform is available, try to create transform chain
+	 */
+	if (tsd?.length)
+	{
+		/**
+		 * 嘗試解析 jest-chain-transform（轉換鏈協調器）
+		 * Try to resolve jest-chain-transform (transform chain coordinator)
+		 */
+		const { result: chain } = requireResolveExtra('jest-chain-transform', opts);
+
+		/**
+		 * 如果 jest-chain-transform 可用，建立轉換鏈
+		 * If jest-chain-transform is available, create transform chain
+		 */
+		if (chain?.length)
+		{
+			ts_transform = [
+				chain as 'jest-chain-transform', {
+					transformers: [
+						tsd as 'jest-tsd-transform',
+						// @ts-ignore
+						ts_transform as 'ts-jest',
+					],
+				},
+			] satisfies [
+				string,
+				Record<string, unknown>
+			]
+		}
+	}
+
+	/**
+	 * 建立最終的轉換器配置物件
+	 * Create final transformer configuration object
+	 */
+	const value = {
+		[`.(${_handleFileExtensions(defaultTransformFileExtensions(), '|')})$`]: ts_transform,
+	} as const
+	return value as ITSWriteable<typeof value>;
+}