@yarn-tool/static-file 3.0.17 → 3.0.18

package/CHANGELOG.md

@@ -3,6 +3,16 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [3.0.18](https://github.com/bluelovers/ws-yarn-workspaces/compare/@yarn-tool/static-file@3.0.17...@yarn-tool/static-file@3.0.18) (2026-09-08)
+
+
+
+### ⚙️　Continuous Integration
+
+* **@yarn-tool/static-file:** 自動化更新 .gitignore 與 .npmignore 中的靜態檔案排除清單 ([1841063](https://github.com/bluelovers/ws-yarn-workspaces/commit/1841063c025c0d9e561386b8b4e91e19c24d8bfc))
+
+
+
 ## [3.0.17](https://github.com/bluelovers/ws-yarn-workspaces/compare/@yarn-tool/static-file@3.0.16...@yarn-tool/static-file@3.0.17) (2026-09-06)
 
 

package/file/jest.config.auto.js

@@ -0,0 +1,208 @@
+// @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

package/file/test/__root.ts

@@ -0,0 +1,47 @@
+/**
+ * 測試路徑架構 / Test Path Structure
+ *
+ * test/
+ * ├── fixtures/              ← 測試資料夾（唯讀）
+ * └── temp/                 ← 臨時檔案（可寫，永遠建立子資料夾）
+ *     ├── fake-lib/
+ *     └── temp-pkg/
+ */
+/// <reference types="node" />
+import path from 'upath2';
+// @ts-ignore
+import { __ROOT_CORE as __ROOT } from './__root-core.cjs';
+
+/**
+ * 專案根目錄
+ */
+export { __ROOT }
+
+export const isWin = process.platform === "win32";
+
+/**
+ * 測試資料夾
+ *
+ * @default test
+ */
+export const __TEST_ROOT = path.join(__ROOT, 'test');
+
+/**
+ * 測試資料夾（唯讀）
+ *
+ * @default test/fixtures
+ */
+export const __TEST_FIXTURES = path.join(__TEST_ROOT, 'fixtures');
+
+/**
+ * 臨時檔案（可寫，永遠建立子資料夾）
+ *
+ * test/
+ * ├── fixtures/              ← 測試資料夾（唯讀）
+ * └── temp/                 ← 臨時檔案（可寫，永遠建立子資料夾）
+ *     ├── fake-lib/
+ *     └── temp-pkg/
+ *
+ * @default test/temp
+ */
+export const __TEST_TEMP = path.join(__TEST_ROOT, 'temp');

package/file/test/temp.ts

@@ -0,0 +1,2 @@
+/// <reference types="node" />
+

package/file/tsconfig.esm.json.tpl

@@ -0,0 +1,14 @@
+{
+  "extends": "@bluelovers/tsconfig/esm/module.json",
+  "compilerOptions": {
+    "sourceRoot": "./lib",
+    "outDir": "./esm",
+    "rootDir": "./lib",
+    "module": "esnext",
+    "noImplicitAny": true,
+    "types": [
+      "jest",
+      "node"
+    ]
+  }
+}

package/file/tsdx.config.js

@@ -0,0 +1,14 @@
+// Not transpiled with TypeScript or Babel, so use plain Es6/Node.js!
+module.exports = {
+
+	/**
+	 * This function will run for each entry/format/env combination
+	 */
+	rollup(config, options) {
+
+		config.output.preferConst = true;
+
+		return config;
+	},
+
+};

package/file/ws-root/__root_ws.ts

@@ -0,0 +1,5 @@
+import { join } from "path";
+
+export const __ROOT_WS = join(__dirname);
+
+export const isWin = process.platform === "win32";

package/file/ws-root/jest.config.js

@@ -0,0 +1,13 @@
+// DO NOT EDIT THIS FILE
+const { resolve } = require('path');
+
+/**
+ * @_type { import('@jest/types').Config.InitialOptions }
+ * @_type { import('ts-jest').InitialOptionsTsJest }
+ * @type { import('ts-jest').JestConfigWithTsJest }
+ */
+const jestConfig = {
+	preset: __dirname,
+};
+
+module.exports = jestConfig

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yarn-tool/static-file",
-  "version": "3.0.17",
+  "version": "3.0.18",
   "description": "",
   "homepage": "https://github.com/bluelovers/ws-yarn-workspaces/tree/master/packages/@yarn-tool/static-file#readme",
   "bugs": {
@@ -15,8 +15,6 @@
   "author": "",
   "main": "index.js",
   "scripts": {
-    "coverage": "npx nyc npm run test",
-    "lint": "npx eslint **/*.ts",
     "test": "node --run test:jest --",
     "test:jest": "jest --passWithNoTests",
     "test:jest:coverage": "pnpm run test:jest -- --coverage",
@@ -25,10 +23,10 @@
     "test:tsd": "ynpx tsd",
     "npm:publish": "npm publish",
     "preversion": "pnpm run test",
-    "prepublishOnly": "echo prepublishOnly",
-    "postpublish_": "git commit -m \"chore(release): publish\" .",
-    "ncu": "npx yarn-tool ncu -u",
-    "sort-package-json": "npx yarn-tool sort",
+    "prepublishOnly": "node --run fix:ignore",
+    "ncu": "yarn-tool ncu -u",
+    "sort-package-json": "yarn-tool sort",
+    "fix:ignore": "tsx test/scripts/update-npmignore-static-files.ts",
     "tsc:showConfig": "ynpx get-current-tsconfig -p"
   },
   "dependencies": {
@@ -38,5 +36,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "008888d233d299e89673cbc45a2712ba9bf825c1"
+  "gitHead": "98d097882fd29058be00d45ff225929538d323d0"
 }

package/file/test/__root.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"__root.js","sourceRoot":"","sources":["__root.ts"],"names":[],"mappings":";;;;AAAA;;;;;;;;GAQG;AACH,8BAA8B;AAC9B,4DAA0B;AAC1B,aAAa;AACb,uDAA0D;AAKjD,uFALe,6BAAM,OAKf;AAEF,QAAA,KAAK,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC;AAElD;;;;GAIG;AACU,QAAA,WAAW,GAAG,gBAAI,CAAC,IAAI,CAAC,6BAAM,EAAE,MAAM,CAAC,CAAC;AAErD;;;;GAIG;AACU,QAAA,eAAe,GAAG,gBAAI,CAAC,IAAI,CAAC,mBAAW,EAAE,UAAU,CAAC,CAAC;AAElE;;;;;;;;;;GAUG;AACU,QAAA,WAAW,GAAG,gBAAI,CAAC,IAAI,CAAC,mBAAW,EAAE,MAAM,CAAC,CAAC","sourcesContent":["/**\n * 測試路徑架構 / Test Path Structure\n *\n * test/\n * ├── fixtures/              ← 測試資料夾（唯讀）\n * └── temp/                 ← 臨時檔案（可寫，永遠建立子資料夾）\n *     ├── fake-lib/\n *     └── temp-pkg/\n */\n/// <reference types=\"node\" />\nimport path from 'upath2';\n// @ts-ignore\nimport { __ROOT_CORE as __ROOT } from './__root-core.cjs';\n\n/**\n * 專案根目錄\n */\nexport { __ROOT }\n\nexport const isWin = process.platform === \"win32\";\n\n/**\n * 測試資料夾\n *\n * @default test\n */\nexport const __TEST_ROOT = path.join(__ROOT, 'test');\n\n/**\n * 測試資料夾（唯讀）\n *\n * @default test/fixtures\n */\nexport const __TEST_FIXTURES = path.join(__TEST_ROOT, 'fixtures');\n\n/**\n * 臨時檔案（可寫，永遠建立子資料夾）\n *\n * test/\n * ├── fixtures/              ← 測試資料夾（唯讀）\n * └── temp/                 ← 臨時檔案（可寫，永遠建立子資料夾）\n *     ├── fake-lib/\n *     └── temp-pkg/\n *\n * @default test/temp\n */\nexport const __TEST_TEMP = path.join(__TEST_ROOT, 'temp');\n"]}

package/file/test/temp.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"temp.js","sourceRoot":"","sources":["temp.ts"],"names":[],"mappings":";AAAA,8BAA8B","sourcesContent":["/// <reference types=\"node\" />\n\n"]}

package/file/tsdx/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.cjs","sourceRoot":"","sources":["index.cts"],"names":[],"mappings":";;AAAA,4DAAwB;AAGxB,iBAAS,eAAC,CAAA","sourcesContent":["import _ from './index';\n\n// @ts-ignore\nexport = _\n"]}

package/file/ws-root/__root_ws.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"__root_ws.js","sourceRoot":"","sources":["__root_ws.ts"],"names":[],"mappings":";;;AAAA,+BAA4B;AAEf,QAAA,SAAS,GAAG,IAAA,WAAI,EAAC,SAAS,CAAC,CAAC;AAE5B,QAAA,KAAK,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC","sourcesContent":["import { join } from \"path\";\n\nexport const __ROOT_WS = join(__dirname);\n\nexport const isWin = process.platform === \"win32\";\n"]}