@kcconfigs/vitest 0.0.1 → 0.1.0-beta.0

package/CHANGELOG.md

@@ -0,0 +1,35 @@
+# Changelog
+
+## 0.1.0-beta.0 (2025-12-28)
+
+
+### Features
+
+* **core:** move all packages into packages/* directory ([58230cd](https://github.com/kc-workspace/kcws/commit/58230cd286d0dea953d232806c91508ebfc57701))
+* **kcconfigs/vitest:** add @kcconfigs/vitest/mocks for mocking data and add setupMocks() ([e81927a](https://github.com/kc-workspace/kcws/commit/e81927afa84e33bc280319d1b1e8ced1ca3bc569))
+* **kcconfigs/vitest:** add source and typedoc conditions in exports ([2c9e1c3](https://github.com/kc-workspace/kcws/commit/2c9e1c3c046ab5798c51dead219bac2953233f07))
+
+
+### Performance Improvements
+
+* **kcconfigs/vitest:** automatically include all ts files in coverage report ([5e2cd8f](https://github.com/kc-workspace/kcws/commit/5e2cd8fd2dad10fc4fc8d5715e3da9b7cf7c8225))
+* **kcconfigs/vitest:** only enabled junit and html for test and text, lcov, and html for coverage ([bf2ef9e](https://github.com/kc-workspace/kcws/commit/bf2ef9e16f6b9792b3a531a92b467c5120fa35d7))
+* **kcconfigs/vitest:** use __mocks__ instead of mocks to ignore from coverage automatically ([9767ff2](https://github.com/kc-workspace/kcws/commit/9767ff20a6dd6dce68fd3bf54bccf502a709b2a1))
+
+
+### Bugfixes
+
+* homepage contains invalid url ([0ee37d6](https://github.com/kc-workspace/kcws/commit/0ee37d641fe5b04fb019099915c8aa3ddfed3be7))
+* **kcconfigs/vitest:** remove unused dependencies from package.json file ([9c237d1](https://github.com/kc-workspace/kcws/commit/9c237d151240e466f3c43f3f03f6f013e0426bd5))
+* **kcconfigs/vitest:** temporary ignore biome useLiteralKeys as it conflict with ts(4111) ([d186810](https://github.com/kc-workspace/kcws/commit/d1868101d2cdb1d865747a24be9d1fc08322b706))
+* trigger re-release please ([65447a7](https://github.com/kc-workspace/kcws/commit/65447a776ed2f8638f6f35a4d00277d407143114))
+* update all [@kcconfigs](https://github.com/kcconfigs) description so it trigger new deployment with new tag separator ([cf5be8c](https://github.com/kc-workspace/kcws/commit/cf5be8cc02fba8becb7e8f31fd6f3a741c0f0b95))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * devDependencies
+    * @kcconfigs/tsconfig bumped to 0.1.0-beta.1
+    * @kcconfigs/tsdown bumped to 0.1.0-beta.1
+    * @kcconfigs/biome bumped to 0.1.1

package/dist/index.cjs

@@ -0,0 +1,141 @@
+// @generated by tsdown, DO NOT edit it manually
+let vitest_config = require("vitest/config");
+let node_path = require("node:path");
+
+//#region src/utils/mergeConfig.ts
+/**
+* Merges multiple configuration objects into a single configuration.
+* later addons taking precedence over earlier ones.
+*
+* No object will be mutated during this process.
+*
+* @template C - The configuration object type that extends a Record with string keys
+* @param defaults - The default configuration object
+* @param addons - One or more configuration objects to merge into the defaults
+* @returns The merged configuration object
+*/
+const mergeConfig = (defaults, ...addons) => {
+	return addons.filter((addon) => addon !== void 0 && addon !== null).reduce((merged, addon) => (0, vitest_config.mergeConfig)(merged, addon), defaults);
+};
+
+//#endregion
+//#region src/utils/defineEmptyProject.ts
+const defineEmptyProject = (...configs) => {
+	return (0, vitest_config.defineProject)(mergeConfig({}, ...configs));
+};
+
+//#endregion
+//#region src/utils/defineEmptyRoot.ts
+const defineEmptyRoot = (...configs) => {
+	return (0, vitest_config.defineConfig)(mergeConfig({}, ...configs));
+};
+
+//#endregion
+//#region src/constants.ts
+/** @internal */
+const baseRootConfig = { test: {
+	restoreMocks: true,
+	mockReset: true,
+	clearMocks: true,
+	unstubGlobals: true,
+	unstubEnvs: true,
+	environment: "node",
+	reporters: [
+		"default",
+		"html",
+		"junit"
+	],
+	outputFile: {
+		html: "reports/test-results/index.html",
+		junit: "reports/test-results/junit.xml"
+	},
+	coverage: {
+		enabled: true,
+		provider: "v8",
+		reporter: [
+			["text"],
+			["lcovonly"],
+			["html", { subdir: "html" }]
+		],
+		reportsDirectory: "reports/coverage",
+		thresholds: { perFile: true },
+		include: ["**/*.{ts,tsx}"],
+		exclude: [
+			"**/[.]**",
+			"**/*{.,-}{test,spec}?(-d).?(c|m)[jt]s?(x)",
+			"**/__mocks__/**",
+			"**/dist/**",
+			"**/*.d.{ts,cts,mts}",
+			"**/*.example.?(c|m)[jt]s?(x)",
+			"**/*.config.?(c|m)[jt]s?(x)",
+			"**/*.schema.?(c|m)[jt]s?(x)"
+		]
+	}
+} };
+/** @internal */
+const baseProjectConfig = {};
+
+//#endregion
+//#region src/utils/defineProject.ts
+/**
+* Defines the root Vitest configuration for the workspace.
+* Merges the base root configuration with any provided user configuration.
+*
+* @param config - Optional user-provided Vitest configuration overrides
+* @returns The merged root Vitest configuration
+*
+* @includeExample
+*/
+const defineProject = (...config) => {
+	return defineEmptyProject(baseRootConfig, baseProjectConfig, ...config);
+};
+
+//#endregion
+//#region src/utils/defineProjectOrRoot.ts
+/**
+* Defines the root Vitest configuration for the workspace.
+* Merges the base root configuration with any provided user configuration.
+*
+* @param config - Optional user-provided Vitest configuration overrides
+* @returns The merged root Vitest configuration
+*
+* @includeExample
+*/
+const defineProjectOrRoot = (...config) => {
+	return defineEmptyRoot(baseRootConfig, baseProjectConfig, ...config);
+};
+
+//#endregion
+//#region src/utils/defineRoot.ts
+/**
+* Defines the root Vitest configuration for the workspace.
+* Merges the base root configuration with any provided user configuration.
+*
+* @param config - Optional user-provided Vitest configuration overrides
+* @returns The merged root Vitest configuration
+*
+* @includeExample
+*/
+const defineRoot = (...config) => {
+	return defineEmptyRoot(baseRootConfig, ...config);
+};
+
+//#endregion
+//#region src/utils/setupMocks.ts
+const resolvePath = (name) => {
+	return (0, node_path.join)(__dirname, "..", "__mocks__", `${name}.ts`);
+};
+const setupMocks = (flag) => {
+	return Object.keys(flag).map((key) => flag[key] === true ? resolvePath(key) : void 0).filter((path) => path !== void 0);
+};
+
+//#endregion
+exports.defineEmptyProject = defineEmptyProject;
+exports.defineEmptyRoot = defineEmptyRoot;
+exports.defineProject = defineProject;
+exports.defineProjectOrRoot = defineProjectOrRoot;
+exports.defineRoot = defineRoot;
+exports.mergeConfig = mergeConfig;
+exports.setupMocks = setupMocks;
+// Generated by @kcconfigs/tsdown
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["baseRootConfig: UserConfig","baseProjectConfig: UserConfig"],"sources":["../src/utils/mergeConfig.ts","../src/utils/defineEmptyProject.ts","../src/utils/defineEmptyRoot.ts","../src/constants.ts","../src/utils/defineProject.ts","../src/utils/defineProjectOrRoot.ts","../src/utils/defineRoot.ts","../src/utils/setupMocks.ts"],"sourcesContent":["import { mergeConfig as _mergeConfig } from \"vitest/config\";\nimport type { AnyConfig } from \"../models\";\n\n/**\n * Merges multiple configuration objects into a single configuration.\n * later addons taking precedence over earlier ones.\n *\n * No object will be mutated during this process.\n *\n * @template C - The configuration object type that extends a Record with string keys\n * @param defaults - The default configuration object\n * @param addons - One or more configuration objects to merge into the defaults\n * @returns The merged configuration object\n */\nexport const mergeConfig = <C extends AnyConfig>(\n\tdefaults: C,\n\t...addons: Optional<C>[]\n): C => {\n\treturn addons\n\t\t.filter((addon) => addon !== undefined && addon !== null)\n\t\t.reduce(\n\t\t\t(merged, addon) =>\n\t\t\t\t_mergeConfig(\n\t\t\t\t\tmerged as Record<string, unknown>,\n\t\t\t\t\taddon as Record<string, unknown>,\n\t\t\t\t) as C,\n\t\t\tdefaults,\n\t\t);\n};\n","import { defineProject } from \"vitest/config\";\nimport type { ProjectConfig } from \"../models\";\nimport { mergeConfig } from \"./mergeConfig\";\n\nexport const defineEmptyProject = (\n\t...configs: Optional<ProjectConfig>[]\n): ProjectConfig => {\n\treturn defineProject(mergeConfig({}, ...configs));\n};\n","import { defineConfig } from \"vitest/config\";\nimport type { UserConfig } from \"../models\";\nimport { mergeConfig } from \"./mergeConfig\";\n\nexport const defineEmptyRoot = (\n\t...configs: Optional<UserConfig>[]\n): UserConfig => {\n\treturn defineConfig(mergeConfig({}, ...configs));\n};\n","import type { UserConfig } from \"./models\";\n\n/** @internal */\nexport const baseRootConfig: UserConfig = {\n\ttest: {\n\t\trestoreMocks: true,\n\t\tmockReset: true,\n\t\tclearMocks: true,\n\t\tunstubGlobals: true,\n\t\tunstubEnvs: true,\n\t\tenvironment: \"node\",\n\t\treporters: [\"default\", \"html\", \"junit\"],\n\t\toutputFile: {\n\t\t\thtml: \"reports/test-results/index.html\",\n\t\t\tjunit: \"reports/test-results/junit.xml\",\n\t\t},\n\t\tcoverage: {\n\t\t\tenabled: true,\n\t\t\tprovider: \"v8\",\n\t\t\treporter: [[\"text\"], [\"lcovonly\"], [\"html\", { subdir: \"html\" }]],\n\t\t\treportsDirectory: \"reports/coverage\",\n\t\t\tthresholds: {\n\t\t\t\tperFile: true,\n\t\t\t},\n\t\t\tinclude: [\"**/*.{ts,tsx}\"],\n\t\t\texclude: [\n\t\t\t\t// Ignored hidden files\n\t\t\t\t\"**/[.]**\",\n\t\t\t\t// Ignored test files\n\t\t\t\t\"**/*{.,-}{test,spec}?(-d).?(c|m)[jt]s?(x)\",\n\t\t\t\t\"**/__mocks__/**\",\n\t\t\t\t// Ignored dist files\n\t\t\t\t\"**/dist/**\",\n\t\t\t\t// Ignored typescript definition files\n\t\t\t\t\"**/*.d.{ts,cts,mts}\",\n\t\t\t\t// Ignored example files\n\t\t\t\t\"**/*.example.?(c|m)[jt]s?(x)\",\n\t\t\t\t// Ignored configuration files\n\t\t\t\t\"**/*.config.?(c|m)[jt]s?(x)\",\n\t\t\t\t// Ignored schema files\n\t\t\t\t\"**/*.schema.?(c|m)[jt]s?(x)\",\n\t\t\t],\n\t\t},\n\t},\n};\n\n/** @internal */\nexport const baseProjectConfig: UserConfig = {};\n","import { baseProjectConfig, baseRootConfig } from \"../constants\";\nimport type { ProjectConfig } from \"../models\";\nimport { defineEmptyProject } from \"./defineEmptyProject\";\n\n/**\n * Defines the root Vitest configuration for the workspace.\n * Merges the base root configuration with any provided user configuration.\n *\n * @param config - Optional user-provided Vitest configuration overrides\n * @returns The merged root Vitest configuration\n *\n * @includeExample\n */\nexport const defineProject = (\n\t...config: Optional<ProjectConfig>[]\n): ProjectConfig => {\n\treturn defineEmptyProject(baseRootConfig, baseProjectConfig, ...config);\n};\n","import { baseProjectConfig, baseRootConfig } from \"../constants\";\nimport type { ProjectConfig, UserConfig } from \"../models\";\nimport { defineEmptyRoot } from \"./defineEmptyRoot\";\n\n/**\n * Defines the root Vitest configuration for the workspace.\n * Merges the base root configuration with any provided user configuration.\n *\n * @param config - Optional user-provided Vitest configuration overrides\n * @returns The merged root Vitest configuration\n *\n * @includeExample\n */\nexport const defineProjectOrRoot = (\n\t...config: Optional<UserConfig>[]\n): ProjectConfig => {\n\treturn defineEmptyRoot(baseRootConfig, baseProjectConfig, ...config);\n};\n","import { baseRootConfig } from \"../constants\";\nimport type { UserConfig } from \"../models\";\nimport { defineEmptyRoot } from \"./defineEmptyRoot\";\n\n/**\n * Defines the root Vitest configuration for the workspace.\n * Merges the base root configuration with any provided user configuration.\n *\n * @param config - Optional user-provided Vitest configuration overrides\n * @returns The merged root Vitest configuration\n *\n * @includeExample\n */\nexport const defineRoot = (...config: Optional<UserConfig>[]): UserConfig => {\n\treturn defineEmptyRoot(baseRootConfig, ...config);\n};\n","import { join } from \"node:path\";\n\nexport interface MockFlag {\n\tfs?: true;\n\tfsPromises?: true;\n\tprocess?: true;\n\tos?: true;\n}\n\nexport type MockFlagKey = keyof MockFlag;\n\nconst resolvePath = (name: string) => {\n\t// import.meta.dirname is resolved to `dist` directory\n\treturn join(import.meta.dirname, \"..\", \"__mocks__\", `${name}.ts`);\n};\n\nexport const setupMocks = (flag: MockFlag): string[] => {\n\tconst keys = Object.keys(flag) as MockFlagKey[];\n\treturn keys\n\t\t.map((key) => (flag[key] === true ? resolvePath(key) : undefined))\n\t\t.filter((path) => path !== undefined);\n};\n"],"mappings":";;;;;;;;;;;;;;;;AAcA,MAAa,eACZ,UACA,GAAG,WACI;AACP,QAAO,OACL,QAAQ,UAAU,UAAU,UAAa,UAAU,KAAK,CACxD,QACC,QAAQ,yCAEP,QACA,MACA,EACF,SACA;;;;;ACvBH,MAAa,sBACZ,GAAG,YACgB;AACnB,yCAAqB,YAAY,EAAE,EAAE,GAAG,QAAQ,CAAC;;;;;ACHlD,MAAa,mBACZ,GAAG,YACa;AAChB,wCAAoB,YAAY,EAAE,EAAE,GAAG,QAAQ,CAAC;;;;;;ACJjD,MAAaA,iBAA6B,EACzC,MAAM;CACL,cAAc;CACd,WAAW;CACX,YAAY;CACZ,eAAe;CACf,YAAY;CACZ,aAAa;CACb,WAAW;EAAC;EAAW;EAAQ;EAAQ;CACvC,YAAY;EACX,MAAM;EACN,OAAO;EACP;CACD,UAAU;EACT,SAAS;EACT,UAAU;EACV,UAAU;GAAC,CAAC,OAAO;GAAE,CAAC,WAAW;GAAE,CAAC,QAAQ,EAAE,QAAQ,QAAQ,CAAC;GAAC;EAChE,kBAAkB;EAClB,YAAY,EACX,SAAS,MACT;EACD,SAAS,CAAC,gBAAgB;EAC1B,SAAS;GAER;GAEA;GACA;GAEA;GAEA;GAEA;GAEA;GAEA;GACA;EACD;CACD,EACD;;AAGD,MAAaC,oBAAgC,EAAE;;;;;;;;;;;;;AClC/C,MAAa,iBACZ,GAAG,WACgB;AACnB,QAAO,mBAAmB,gBAAgB,mBAAmB,GAAG,OAAO;;;;;;;;;;;;;;ACHxE,MAAa,uBACZ,GAAG,WACgB;AACnB,QAAO,gBAAgB,gBAAgB,mBAAmB,GAAG,OAAO;;;;;;;;;;;;;;ACHrE,MAAa,cAAc,GAAG,WAA+C;AAC5E,QAAO,gBAAgB,gBAAgB,GAAG,OAAO;;;;;ACHlD,MAAM,eAAe,SAAiB;AAErC,uCAAiC,MAAM,aAAa,GAAG,KAAK,KAAK;;AAGlE,MAAa,cAAc,SAA6B;AAEvD,QADa,OAAO,KAAK,KAAK,CAE5B,KAAK,QAAS,KAAK,SAAS,OAAO,YAAY,IAAI,GAAG,OAAW,CACjE,QAAQ,SAAS,SAAS,OAAU"}

package/dist/index.d.cts

@@ -0,0 +1,93 @@
+// @generated by tsdown, DO NOT edit it manually
+import { UserWorkspaceConfig, ViteUserConfig } from "vitest/config";
+
+//#region src/models.d.ts
+
+/**
+* Generic configuration type allowing any string keys and values.
+* Used as a flexible type for configuration merging operations.
+*/
+type AnyConfig = Record<string, any>;
+/**
+* Vitest user configuration type for root workspace setup.
+* Extends Vite's user configuration with Vitest-specific test settings.
+*
+* @see https://vitest.dev/config/
+*/
+type UserConfig = ViteUserConfig;
+/**
+* Vitest project configuration type for workspace projects.
+* Extends Vite's workspace config with project-specific test settings.
+*
+* @see https://vitest.dev/config/
+*/
+type ProjectConfig = UserWorkspaceConfig;
+//#endregion
+//#region src/utils/defineEmptyProject.d.ts
+declare const defineEmptyProject: (...configs: Optional<ProjectConfig>[]) => ProjectConfig;
+//#endregion
+//#region src/utils/defineEmptyRoot.d.ts
+declare const defineEmptyRoot: (...configs: Optional<UserConfig>[]) => UserConfig;
+//#endregion
+//#region src/utils/defineProject.d.ts
+/**
+* Defines the root Vitest configuration for the workspace.
+* Merges the base root configuration with any provided user configuration.
+*
+* @param config - Optional user-provided Vitest configuration overrides
+* @returns The merged root Vitest configuration
+*
+* @includeExample
+*/
+declare const defineProject: (...config: Optional<ProjectConfig>[]) => ProjectConfig;
+//#endregion
+//#region src/utils/defineProjectOrRoot.d.ts
+/**
+* Defines the root Vitest configuration for the workspace.
+* Merges the base root configuration with any provided user configuration.
+*
+* @param config - Optional user-provided Vitest configuration overrides
+* @returns The merged root Vitest configuration
+*
+* @includeExample
+*/
+declare const defineProjectOrRoot: (...config: Optional<UserConfig>[]) => ProjectConfig;
+//#endregion
+//#region src/utils/defineRoot.d.ts
+/**
+* Defines the root Vitest configuration for the workspace.
+* Merges the base root configuration with any provided user configuration.
+*
+* @param config - Optional user-provided Vitest configuration overrides
+* @returns The merged root Vitest configuration
+*
+* @includeExample
+*/
+declare const defineRoot: (...config: Optional<UserConfig>[]) => UserConfig;
+//#endregion
+//#region src/utils/mergeConfig.d.ts
+/**
+* Merges multiple configuration objects into a single configuration.
+* later addons taking precedence over earlier ones.
+*
+* No object will be mutated during this process.
+*
+* @template C - The configuration object type that extends a Record with string keys
+* @param defaults - The default configuration object
+* @param addons - One or more configuration objects to merge into the defaults
+* @returns The merged configuration object
+*/
+declare const mergeConfig: <C extends AnyConfig>(defaults: C, ...addons: Optional<C>[]) => C;
+//#endregion
+//#region src/utils/setupMocks.d.ts
+interface MockFlag {
+  fs?: true;
+  fsPromises?: true;
+  process?: true;
+  os?: true;
+}
+declare const setupMocks: (flag: MockFlag) => string[];
+//#endregion
+export { type AnyConfig, type ProjectConfig, type UserConfig, defineEmptyProject, defineEmptyRoot, defineProject, defineProjectOrRoot, defineRoot, mergeConfig, setupMocks };
+// Generated by @kcconfigs/tsdown
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/models.ts","../src/utils/defineEmptyProject.ts","../src/utils/defineEmptyRoot.ts","../src/utils/defineProject.ts","../src/utils/defineProjectOrRoot.ts","../src/utils/defineRoot.ts","../src/utils/mergeConfig.ts","../src/utils/setupMocks.ts"],"sourcesContent":[],"mappings":";;;;;;;AAUA;AAQA;AAQY,KAhBA,SAAA,GAAY,MAgBZ,CAAgB,MAAA,EAAA,GAAA,CAAA;;;;ACtB5B;;;AAEG,KDYS,UAAA,GAAa,cCZtB;;;;;ACFH;;AACa,KFqBD,aAAA,GAAgB,mBErBf;;;cDDA,iCACA,SAAS,qBACnB;;;cCFU,8BACA,SAAS,kBACnB;;;;;AFIH;AAQA;AAQA;;;;ACtBA;AACsB,cEQT,aFRS,EAAA,CAAA,GAAA,MAAA,EESV,QFTU,CESD,aFTC,CAAA,EAAA,EAAA,GEUnB,aFVmB;;;;;ADKtB;AAQA;AAQA;;;;ACtBA;AACsB,cGQT,mBHRS,EAAA,CAAA,GAAA,MAAA,EGSV,QHTU,CGSD,UHTC,CAAA,EAAA,EAAA,GGUnB,aHVmB;;;;;ADKtB;AAQA;AAQA;;;;ACtBA;AACsB,cIQT,UJRS,EAAA,CAAA,GAAA,MAAA,EIQgB,QJRhB,CIQyB,UJRzB,CAAA,EAAA,EAAA,GIQyC,UJRzC;;;;;ADKtB;AAQA;AAQA;;;;ACtBA;;;AAEG,cKQU,WLRV,EAAA,CAAA,UKQmC,SLRnC,CAAA,CAAA,QAAA,EKSQ,CLTR,EAAA,GAAA,MAAA,EKUS,QLVT,CKUkB,CLVlB,CAAA,EAAA,EAAA,GKWA,CLXA;;;UMJc,QAAA;;;EPQjB,OAAY,CAAA,EAAA,IAAA;EAQZ,EAAA,CAAY,EAAA,IAAA;AAQZ;cOVa,mBAAoB"}

package/dist/index.d.ts

@@ -0,0 +1,93 @@
+// @generated by tsdown, DO NOT edit it manually
+import { UserWorkspaceConfig, ViteUserConfig } from "vitest/config";
+
+//#region src/models.d.ts
+
+/**
+* Generic configuration type allowing any string keys and values.
+* Used as a flexible type for configuration merging operations.
+*/
+type AnyConfig = Record<string, any>;
+/**
+* Vitest user configuration type for root workspace setup.
+* Extends Vite's user configuration with Vitest-specific test settings.
+*
+* @see https://vitest.dev/config/
+*/
+type UserConfig = ViteUserConfig;
+/**
+* Vitest project configuration type for workspace projects.
+* Extends Vite's workspace config with project-specific test settings.
+*
+* @see https://vitest.dev/config/
+*/
+type ProjectConfig = UserWorkspaceConfig;
+//#endregion
+//#region src/utils/defineEmptyProject.d.ts
+declare const defineEmptyProject: (...configs: Optional<ProjectConfig>[]) => ProjectConfig;
+//#endregion
+//#region src/utils/defineEmptyRoot.d.ts
+declare const defineEmptyRoot: (...configs: Optional<UserConfig>[]) => UserConfig;
+//#endregion
+//#region src/utils/defineProject.d.ts
+/**
+* Defines the root Vitest configuration for the workspace.
+* Merges the base root configuration with any provided user configuration.
+*
+* @param config - Optional user-provided Vitest configuration overrides
+* @returns The merged root Vitest configuration
+*
+* @includeExample
+*/
+declare const defineProject: (...config: Optional<ProjectConfig>[]) => ProjectConfig;
+//#endregion
+//#region src/utils/defineProjectOrRoot.d.ts
+/**
+* Defines the root Vitest configuration for the workspace.
+* Merges the base root configuration with any provided user configuration.
+*
+* @param config - Optional user-provided Vitest configuration overrides
+* @returns The merged root Vitest configuration
+*
+* @includeExample
+*/
+declare const defineProjectOrRoot: (...config: Optional<UserConfig>[]) => ProjectConfig;
+//#endregion
+//#region src/utils/defineRoot.d.ts
+/**
+* Defines the root Vitest configuration for the workspace.
+* Merges the base root configuration with any provided user configuration.
+*
+* @param config - Optional user-provided Vitest configuration overrides
+* @returns The merged root Vitest configuration
+*
+* @includeExample
+*/
+declare const defineRoot: (...config: Optional<UserConfig>[]) => UserConfig;
+//#endregion
+//#region src/utils/mergeConfig.d.ts
+/**
+* Merges multiple configuration objects into a single configuration.
+* later addons taking precedence over earlier ones.
+*
+* No object will be mutated during this process.
+*
+* @template C - The configuration object type that extends a Record with string keys
+* @param defaults - The default configuration object
+* @param addons - One or more configuration objects to merge into the defaults
+* @returns The merged configuration object
+*/
+declare const mergeConfig: <C extends AnyConfig>(defaults: C, ...addons: Optional<C>[]) => C;
+//#endregion
+//#region src/utils/setupMocks.d.ts
+interface MockFlag {
+  fs?: true;
+  fsPromises?: true;
+  process?: true;
+  os?: true;
+}
+declare const setupMocks: (flag: MockFlag) => string[];
+//#endregion
+export { type AnyConfig, type ProjectConfig, type UserConfig, defineEmptyProject, defineEmptyRoot, defineProject, defineProjectOrRoot, defineRoot, mergeConfig, setupMocks };
+// Generated by @kcconfigs/tsdown
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/models.ts","../src/utils/defineEmptyProject.ts","../src/utils/defineEmptyRoot.ts","../src/utils/defineProject.ts","../src/utils/defineProjectOrRoot.ts","../src/utils/defineRoot.ts","../src/utils/mergeConfig.ts","../src/utils/setupMocks.ts"],"sourcesContent":[],"mappings":";;;;;;;AAUA;AAQA;AAQY,KAhBA,SAAA,GAAY,MAgBZ,CAAgB,MAAA,EAAA,GAAA,CAAA;;;;ACtB5B;;;AAEG,KDYS,UAAA,GAAa,cCZtB;;;;;ACFH;;AACa,KFqBD,aAAA,GAAgB,mBErBf;;;cDDA,iCACA,SAAS,qBACnB;;;cCFU,8BACA,SAAS,kBACnB;;;;;AFIH;AAQA;AAQA;;;;ACtBA;AACsB,cEQT,aFRS,EAAA,CAAA,GAAA,MAAA,EESV,QFTU,CESD,aFTC,CAAA,EAAA,EAAA,GEUnB,aFVmB;;;;;ADKtB;AAQA;AAQA;;;;ACtBA;AACsB,cGQT,mBHRS,EAAA,CAAA,GAAA,MAAA,EGSV,QHTU,CGSD,UHTC,CAAA,EAAA,EAAA,GGUnB,aHVmB;;;;;ADKtB;AAQA;AAQA;;;;ACtBA;AACsB,cIQT,UJRS,EAAA,CAAA,GAAA,MAAA,EIQgB,QJRhB,CIQyB,UJRzB,CAAA,EAAA,EAAA,GIQyC,UJRzC;;;;;ADKtB;AAQA;AAQA;;;;ACtBA;;;AAEG,cKQU,WLRV,EAAA,CAAA,UKQmC,SLRnC,CAAA,CAAA,QAAA,EKSQ,CLTR,EAAA,GAAA,MAAA,EKUS,QLVT,CKUkB,CLVlB,CAAA,EAAA,EAAA,GKWA,CLXA;;;UMJc,QAAA;;;EPQjB,OAAY,CAAA,EAAA,IAAA;EAQZ,EAAA,CAAY,EAAA,IAAA;AAQZ;cOVa,mBAAoB"}

package/dist/index.js

@@ -0,0 +1,135 @@
+// @generated by tsdown, DO NOT edit it manually
+import { defineConfig, defineProject as defineProject$1, mergeConfig as mergeConfig$1 } from "vitest/config";
+import { join } from "node:path";
+
+//#region src/utils/mergeConfig.ts
+/**
+* Merges multiple configuration objects into a single configuration.
+* later addons taking precedence over earlier ones.
+*
+* No object will be mutated during this process.
+*
+* @template C - The configuration object type that extends a Record with string keys
+* @param defaults - The default configuration object
+* @param addons - One or more configuration objects to merge into the defaults
+* @returns The merged configuration object
+*/
+const mergeConfig = (defaults, ...addons) => {
+	return addons.filter((addon) => addon !== void 0 && addon !== null).reduce((merged, addon) => mergeConfig$1(merged, addon), defaults);
+};
+
+//#endregion
+//#region src/utils/defineEmptyProject.ts
+const defineEmptyProject = (...configs) => {
+	return defineProject$1(mergeConfig({}, ...configs));
+};
+
+//#endregion
+//#region src/utils/defineEmptyRoot.ts
+const defineEmptyRoot = (...configs) => {
+	return defineConfig(mergeConfig({}, ...configs));
+};
+
+//#endregion
+//#region src/constants.ts
+/** @internal */
+const baseRootConfig = { test: {
+	restoreMocks: true,
+	mockReset: true,
+	clearMocks: true,
+	unstubGlobals: true,
+	unstubEnvs: true,
+	environment: "node",
+	reporters: [
+		"default",
+		"html",
+		"junit"
+	],
+	outputFile: {
+		html: "reports/test-results/index.html",
+		junit: "reports/test-results/junit.xml"
+	},
+	coverage: {
+		enabled: true,
+		provider: "v8",
+		reporter: [
+			["text"],
+			["lcovonly"],
+			["html", { subdir: "html" }]
+		],
+		reportsDirectory: "reports/coverage",
+		thresholds: { perFile: true },
+		include: ["**/*.{ts,tsx}"],
+		exclude: [
+			"**/[.]**",
+			"**/*{.,-}{test,spec}?(-d).?(c|m)[jt]s?(x)",
+			"**/__mocks__/**",
+			"**/dist/**",
+			"**/*.d.{ts,cts,mts}",
+			"**/*.example.?(c|m)[jt]s?(x)",
+			"**/*.config.?(c|m)[jt]s?(x)",
+			"**/*.schema.?(c|m)[jt]s?(x)"
+		]
+	}
+} };
+/** @internal */
+const baseProjectConfig = {};
+
+//#endregion
+//#region src/utils/defineProject.ts
+/**
+* Defines the root Vitest configuration for the workspace.
+* Merges the base root configuration with any provided user configuration.
+*
+* @param config - Optional user-provided Vitest configuration overrides
+* @returns The merged root Vitest configuration
+*
+* @includeExample
+*/
+const defineProject = (...config) => {
+	return defineEmptyProject(baseRootConfig, baseProjectConfig, ...config);
+};
+
+//#endregion
+//#region src/utils/defineProjectOrRoot.ts
+/**
+* Defines the root Vitest configuration for the workspace.
+* Merges the base root configuration with any provided user configuration.
+*
+* @param config - Optional user-provided Vitest configuration overrides
+* @returns The merged root Vitest configuration
+*
+* @includeExample
+*/
+const defineProjectOrRoot = (...config) => {
+	return defineEmptyRoot(baseRootConfig, baseProjectConfig, ...config);
+};
+
+//#endregion
+//#region src/utils/defineRoot.ts
+/**
+* Defines the root Vitest configuration for the workspace.
+* Merges the base root configuration with any provided user configuration.
+*
+* @param config - Optional user-provided Vitest configuration overrides
+* @returns The merged root Vitest configuration
+*
+* @includeExample
+*/
+const defineRoot = (...config) => {
+	return defineEmptyRoot(baseRootConfig, ...config);
+};
+
+//#endregion
+//#region src/utils/setupMocks.ts
+const resolvePath = (name) => {
+	return join(import.meta.dirname, "..", "__mocks__", `${name}.ts`);
+};
+const setupMocks = (flag) => {
+	return Object.keys(flag).map((key) => flag[key] === true ? resolvePath(key) : void 0).filter((path) => path !== void 0);
+};
+
+//#endregion
+export { defineEmptyProject, defineEmptyRoot, defineProject, defineProjectOrRoot, defineRoot, mergeConfig, setupMocks };
+// Generated by @kcconfigs/tsdown
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["_mergeConfig","defineProject","baseRootConfig: UserConfig","baseProjectConfig: UserConfig"],"sources":["../src/utils/mergeConfig.ts","../src/utils/defineEmptyProject.ts","../src/utils/defineEmptyRoot.ts","../src/constants.ts","../src/utils/defineProject.ts","../src/utils/defineProjectOrRoot.ts","../src/utils/defineRoot.ts","../src/utils/setupMocks.ts"],"sourcesContent":["import { mergeConfig as _mergeConfig } from \"vitest/config\";\nimport type { AnyConfig } from \"../models\";\n\n/**\n * Merges multiple configuration objects into a single configuration.\n * later addons taking precedence over earlier ones.\n *\n * No object will be mutated during this process.\n *\n * @template C - The configuration object type that extends a Record with string keys\n * @param defaults - The default configuration object\n * @param addons - One or more configuration objects to merge into the defaults\n * @returns The merged configuration object\n */\nexport const mergeConfig = <C extends AnyConfig>(\n\tdefaults: C,\n\t...addons: Optional<C>[]\n): C => {\n\treturn addons\n\t\t.filter((addon) => addon !== undefined && addon !== null)\n\t\t.reduce(\n\t\t\t(merged, addon) =>\n\t\t\t\t_mergeConfig(\n\t\t\t\t\tmerged as Record<string, unknown>,\n\t\t\t\t\taddon as Record<string, unknown>,\n\t\t\t\t) as C,\n\t\t\tdefaults,\n\t\t);\n};\n","import { defineProject } from \"vitest/config\";\nimport type { ProjectConfig } from \"../models\";\nimport { mergeConfig } from \"./mergeConfig\";\n\nexport const defineEmptyProject = (\n\t...configs: Optional<ProjectConfig>[]\n): ProjectConfig => {\n\treturn defineProject(mergeConfig({}, ...configs));\n};\n","import { defineConfig } from \"vitest/config\";\nimport type { UserConfig } from \"../models\";\nimport { mergeConfig } from \"./mergeConfig\";\n\nexport const defineEmptyRoot = (\n\t...configs: Optional<UserConfig>[]\n): UserConfig => {\n\treturn defineConfig(mergeConfig({}, ...configs));\n};\n","import type { UserConfig } from \"./models\";\n\n/** @internal */\nexport const baseRootConfig: UserConfig = {\n\ttest: {\n\t\trestoreMocks: true,\n\t\tmockReset: true,\n\t\tclearMocks: true,\n\t\tunstubGlobals: true,\n\t\tunstubEnvs: true,\n\t\tenvironment: \"node\",\n\t\treporters: [\"default\", \"html\", \"junit\"],\n\t\toutputFile: {\n\t\t\thtml: \"reports/test-results/index.html\",\n\t\t\tjunit: \"reports/test-results/junit.xml\",\n\t\t},\n\t\tcoverage: {\n\t\t\tenabled: true,\n\t\t\tprovider: \"v8\",\n\t\t\treporter: [[\"text\"], [\"lcovonly\"], [\"html\", { subdir: \"html\" }]],\n\t\t\treportsDirectory: \"reports/coverage\",\n\t\t\tthresholds: {\n\t\t\t\tperFile: true,\n\t\t\t},\n\t\t\tinclude: [\"**/*.{ts,tsx}\"],\n\t\t\texclude: [\n\t\t\t\t// Ignored hidden files\n\t\t\t\t\"**/[.]**\",\n\t\t\t\t// Ignored test files\n\t\t\t\t\"**/*{.,-}{test,spec}?(-d).?(c|m)[jt]s?(x)\",\n\t\t\t\t\"**/__mocks__/**\",\n\t\t\t\t// Ignored dist files\n\t\t\t\t\"**/dist/**\",\n\t\t\t\t// Ignored typescript definition files\n\t\t\t\t\"**/*.d.{ts,cts,mts}\",\n\t\t\t\t// Ignored example files\n\t\t\t\t\"**/*.example.?(c|m)[jt]s?(x)\",\n\t\t\t\t// Ignored configuration files\n\t\t\t\t\"**/*.config.?(c|m)[jt]s?(x)\",\n\t\t\t\t// Ignored schema files\n\t\t\t\t\"**/*.schema.?(c|m)[jt]s?(x)\",\n\t\t\t],\n\t\t},\n\t},\n};\n\n/** @internal */\nexport const baseProjectConfig: UserConfig = {};\n","import { baseProjectConfig, baseRootConfig } from \"../constants\";\nimport type { ProjectConfig } from \"../models\";\nimport { defineEmptyProject } from \"./defineEmptyProject\";\n\n/**\n * Defines the root Vitest configuration for the workspace.\n * Merges the base root configuration with any provided user configuration.\n *\n * @param config - Optional user-provided Vitest configuration overrides\n * @returns The merged root Vitest configuration\n *\n * @includeExample\n */\nexport const defineProject = (\n\t...config: Optional<ProjectConfig>[]\n): ProjectConfig => {\n\treturn defineEmptyProject(baseRootConfig, baseProjectConfig, ...config);\n};\n","import { baseProjectConfig, baseRootConfig } from \"../constants\";\nimport type { ProjectConfig, UserConfig } from \"../models\";\nimport { defineEmptyRoot } from \"./defineEmptyRoot\";\n\n/**\n * Defines the root Vitest configuration for the workspace.\n * Merges the base root configuration with any provided user configuration.\n *\n * @param config - Optional user-provided Vitest configuration overrides\n * @returns The merged root Vitest configuration\n *\n * @includeExample\n */\nexport const defineProjectOrRoot = (\n\t...config: Optional<UserConfig>[]\n): ProjectConfig => {\n\treturn defineEmptyRoot(baseRootConfig, baseProjectConfig, ...config);\n};\n","import { baseRootConfig } from \"../constants\";\nimport type { UserConfig } from \"../models\";\nimport { defineEmptyRoot } from \"./defineEmptyRoot\";\n\n/**\n * Defines the root Vitest configuration for the workspace.\n * Merges the base root configuration with any provided user configuration.\n *\n * @param config - Optional user-provided Vitest configuration overrides\n * @returns The merged root Vitest configuration\n *\n * @includeExample\n */\nexport const defineRoot = (...config: Optional<UserConfig>[]): UserConfig => {\n\treturn defineEmptyRoot(baseRootConfig, ...config);\n};\n","import { join } from \"node:path\";\n\nexport interface MockFlag {\n\tfs?: true;\n\tfsPromises?: true;\n\tprocess?: true;\n\tos?: true;\n}\n\nexport type MockFlagKey = keyof MockFlag;\n\nconst resolvePath = (name: string) => {\n\t// import.meta.dirname is resolved to `dist` directory\n\treturn join(import.meta.dirname, \"..\", \"__mocks__\", `${name}.ts`);\n};\n\nexport const setupMocks = (flag: MockFlag): string[] => {\n\tconst keys = Object.keys(flag) as MockFlagKey[];\n\treturn keys\n\t\t.map((key) => (flag[key] === true ? resolvePath(key) : undefined))\n\t\t.filter((path) => path !== undefined);\n};\n"],"mappings":";;;;;;;;;;;;;;;;AAcA,MAAa,eACZ,UACA,GAAG,WACI;AACP,QAAO,OACL,QAAQ,UAAU,UAAU,UAAa,UAAU,KAAK,CACxD,QACC,QAAQ,UACRA,cACC,QACA,MACA,EACF,SACA;;;;;ACvBH,MAAa,sBACZ,GAAG,YACgB;AACnB,QAAOC,gBAAc,YAAY,EAAE,EAAE,GAAG,QAAQ,CAAC;;;;;ACHlD,MAAa,mBACZ,GAAG,YACa;AAChB,QAAO,aAAa,YAAY,EAAE,EAAE,GAAG,QAAQ,CAAC;;;;;;ACJjD,MAAaC,iBAA6B,EACzC,MAAM;CACL,cAAc;CACd,WAAW;CACX,YAAY;CACZ,eAAe;CACf,YAAY;CACZ,aAAa;CACb,WAAW;EAAC;EAAW;EAAQ;EAAQ;CACvC,YAAY;EACX,MAAM;EACN,OAAO;EACP;CACD,UAAU;EACT,SAAS;EACT,UAAU;EACV,UAAU;GAAC,CAAC,OAAO;GAAE,CAAC,WAAW;GAAE,CAAC,QAAQ,EAAE,QAAQ,QAAQ,CAAC;GAAC;EAChE,kBAAkB;EAClB,YAAY,EACX,SAAS,MACT;EACD,SAAS,CAAC,gBAAgB;EAC1B,SAAS;GAER;GAEA;GACA;GAEA;GAEA;GAEA;GAEA;GAEA;GACA;EACD;CACD,EACD;;AAGD,MAAaC,oBAAgC,EAAE;;;;;;;;;;;;;AClC/C,MAAa,iBACZ,GAAG,WACgB;AACnB,QAAO,mBAAmB,gBAAgB,mBAAmB,GAAG,OAAO;;;;;;;;;;;;;;ACHxE,MAAa,uBACZ,GAAG,WACgB;AACnB,QAAO,gBAAgB,gBAAgB,mBAAmB,GAAG,OAAO;;;;;;;;;;;;;;ACHrE,MAAa,cAAc,GAAG,WAA+C;AAC5E,QAAO,gBAAgB,gBAAgB,GAAG,OAAO;;;;;ACHlD,MAAM,eAAe,SAAiB;AAErC,QAAO,KAAK,OAAO,KAAK,SAAS,MAAM,aAAa,GAAG,KAAK,KAAK;;AAGlE,MAAa,cAAc,SAA6B;AAEvD,QADa,OAAO,KAAK,KAAK,CAE5B,KAAK,QAAS,KAAK,SAAS,OAAO,YAAY,IAAI,GAAG,OAAW,CACjE,QAAQ,SAAS,SAAS,OAAU"}

package/dist/mockHelpers/index.cjs

@@ -0,0 +1,10 @@
+// @generated by tsdown, DO NOT edit it manually
+let memfs = require("memfs");
+
+Object.defineProperty(exports, 'vol', {
+  enumerable: true,
+  get: function () {
+    return memfs.vol;
+  }
+});
+// Generated by @kcconfigs/tsdown

package/dist/mockHelpers/index.d.cts

@@ -0,0 +1,4 @@
+// @generated by tsdown, DO NOT edit it manually
+import { vol } from "memfs";
+export { vol };
+// Generated by @kcconfigs/tsdown

package/dist/mockHelpers/index.d.ts

@@ -0,0 +1,4 @@
+// @generated by tsdown, DO NOT edit it manually
+import { vol } from "memfs";
+export { vol };
+// Generated by @kcconfigs/tsdown

package/dist/mockHelpers/index.js

@@ -0,0 +1,5 @@
+// @generated by tsdown, DO NOT edit it manually
+import { vol } from "memfs";
+
+export { vol };
+// Generated by @kcconfigs/tsdown

package/package.json

@@ -1,6 +1,50 @@
 {
   "name": "@kcconfigs/vitest",
-  "version": "0.0.1",
+  "version": "0.1.0-beta.0",
+  "description": "Shared vitest configuration",
+  "type": "module",
+  "dependencies": {
+    "vitest": "4.0.15",
+    "memfs": "4.51.1"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.3.10",
+    "tsdown": "0.18.1",
+    "@kcconfigs/tsdown": "0.1.0-beta.1",
+    "@kcconfigs/tsconfig": "0.1.0-beta.1",
+    "@kcconfigs/biome": "0.1.1"
+  },
+  "peerDependencies": {
+    "vitest": "^4.0.0"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.cts",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "typedoc": "./src/index.ts",
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      },
+      "default": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    },
+    "./mocks": {
+      "source": "./src/mockHelpers/index.ts",
+      "typedoc": "./src/mockHelpers/index.ts",
+      "require": {
+        "types": "./dist/mockHelpers/index.d.cts",
+        "default": "./dist/mockHelpers/index.cjs"
+      },
+      "default": {
+        "types": "./dist/mockHelpers/index.d.ts",
+        "default": "./dist/mockHelpers/index.js"
+      }
+    }
+  },
   "license": "AGPL-3.0-only",
   "homepage": "https://github.com/kc-workspace/kcws/tree/main/packages/@kcconfigs/vitest",
   "repository": {
@@ -13,10 +57,34 @@
     "email": "kcws@kc.in.th",
     "url": "https://github.com/kamontat"
   },
+  "keywords": [
+    "config",
+    "typescript",
+    "vitest",
+    "test"
+  ],
+  "files": [
+    "CHANGELOG.json",
+    "CHANGELOG.md",
+    "dist",
+    "src",
+    "mocks"
+  ],
   "engines": {
     "node": ">=14"
   },
   "publishConfig": {
     "access": "public"
+  },
+  "scripts": {
+    "test": "vitest run",
+    "build": "tsdown",
+    "fix": "biome check --fix --unsafe",
+    "check": "pnpm run lint:check && pnpm run format:check && pnpm run type:check",
+    "format": "biome format --fix",
+    "format:check": "biome format",
+    "lint": "biome lint --fix --unsafe",
+    "lint:check": "biome lint",
+    "type:check": "tsc --build"
   }
 }