@brnshkr/config 0.0.1-beta.2 → 0.0.1-beta.4

package/dist/stylelint/index.d.mts

@@ -1,7 +1,6 @@
 import { Config } from "stylelint";
-
 //#region ../src/js/stylelint/types/config.d.ts
-type Config$1 = { [Key in keyof Config]: Config[Key] };
+type Config$1 = { [Key in keyof Config]: Config[Key]; };
 //#endregion
 //#region ../src/js/stylelint/types/options.d.ts
 interface ConfigOptions {
@@ -31,13 +30,13 @@ interface ConfigOptions {
    */
   html: boolean;
   /**
-   * Enables `stylelint-plugin-logical-css`.
+   * Enables `stylelint-config-standard-less`.
    *
-   * @default `Enabled when "stylelint-plugin-logical-css" is installed.`
+   * @default `Enabled when "stylelint-config-standard-less" is installed.`
    *
-   * @see https://github.com/yuschick/stylelint-plugin-logical-css
+   * @see https://github.com/stylelint-less/stylelint-less/tree/main/packages/stylelint-config-standard-less
    */
-  logical: boolean;
+  less: boolean;
   /**
    * Enables `stylelint-config-css-modules`.
    *
@@ -88,10 +87,49 @@ interface ConfigOptions {
    */
   style: boolean;
 }
-type UserOptions = Partial<ConfigOptions> & Omit<Config$1, 'ignorePatterns' | '_processorFunctions'>;
+type UserOptions = Partial<ConfigOptions> & Omit<Config$1, 'computeEditInfo' | 'ignorePatterns' | '_processorFunctions'>;
 //#endregion
 //#region ../src/js/stylelint/index.d.ts
-declare const getConfig: (optionsAndGlobalConfig?: UserOptions, ...additionalConfigs: Config$1[]) => Config$1;
+/**
+ * Build the `@brnshkr` Stylelint config object.
+ *
+ * Merges sensible defaults for every supported module (SCSS, Less, HTML, etc.) with user
+ * overrides and any additional configs.
+ *
+ * @api
+ *
+ * @param optionsAndGlobalConfig per-module toggles and global Stylelint fields merged with the defaults
+ * @param additionalConfigs extra Stylelint config entries merged after the built-in ones
+ *
+ * @returns final Stylelint config ready to be consumed by Stylelint
+ *
+ * @see https://github.com/brnshkr/config/blob/master/docs/js/stylelint.md
+ *
+ * @example
+ * ```js
+ * import { getConfig } from '@brnshkr/config/stylelint';
+ *
+ * getConfig(undefined);
+ * getConfig({});
+ *
+ * getConfig({
+ *   scss: false,
+ *   ignoreFiles: ['dist/**'],
+ * }, {
+ *   rules: { 'color-no-hex': null },
+ * });
+ *
+ * getConfig(undefined, {
+ *   rules: { 'color-no-hex': null },
+ * });
+ * ```
+ */
+export declare const getConfig: (optionsAndGlobalConfig?: UserOptions, ...additionalConfigs: Config$1[]) => Config$1;
+/**
+ * Default-exported pre-built config for direct re-export from a Stylelint config file.
+ *
+ * @api
+ */
 declare const _default: Config$1;
 //#endregion
-export { _default as default, getConfig };
+export { _default as default };

package/dist/stylelint/index.mjs

@@ -1,5 +1,8 @@
-import { a as resolvePackagesSharedSynchronously, l as objectEntries, n as GLOB_IGNORES, p as packageOrganization, r as isModuleEnabledByDefault, s as STYLELINT_PACKAGES, t as QUOTES } from "../shared.mjs";
+import { E as objectKeys, O as packageOrganization, b as STYLELINT_PACKAGES, f as createModuleState, g as resolvePackagesSharedSynchronously, m as isModuleEnabledByDefault, n as QUOTES, u as GLOB_IGNORES, w as objectEntries } from "../shared.mjs";
 //#region ../src/js/stylelint/utils/module.ts
+/**
+* @internal @brnshkr/config/stylelint
+*/
 const MODULES = {
 	baseline: {
 		name: "baseline",
@@ -13,9 +16,9 @@ const MODULES = {
 		name: "html",
 		packages: { requiredAll: [STYLELINT_PACKAGES.POSTCSS_HTML, STYLELINT_PACKAGES.STYLELINT_CONFIG_HTML] }
 	},
-	logical: {
-		name: "logical",
-		packages: { requiredAll: [STYLELINT_PACKAGES.STYLELINT_PLUGIN_LOGICAL_CSS] }
+	less: {
+		name: "less",
+		packages: { requiredAll: [STYLELINT_PACKAGES.STYLELINT_CONFIG_STANDARD_LESS] }
 	},
 	modules: {
 		name: "modules",
@@ -45,14 +48,13 @@ const MODULES = {
 		packages: { requiredAll: [STYLELINT_PACKAGES.STYLISTIC_STYLELINT_CONFIG] }
 	}
 };
-const resolvePackages = (moduleInfo, type) => resolvePackagesSharedSynchronously(moduleInfo, type);
-const enabledStates = {};
-const isModuleEnabled = (moduleInfo) => enabledStates[moduleInfo.name] ?? isModuleEnabledByDefault(moduleInfo);
-const setModuleEnabled = (moduleInfo, state) => {
-	enabledStates[moduleInfo.name] = state;
-};
+const resolvePackages = resolvePackagesSharedSynchronously;
+const { isModuleEnabled, setModuleEnabled } = createModuleState();
 //#endregion
 //#region ../src/js/stylelint/configs/baseline.ts
+/**
+* @internal @brnshkr/config/stylelint
+*/
 const baseline = () => {
 	const { requiredAll: [isStylelintPluginUseBaselineInstalled] } = resolvePackages(MODULES.baseline);
 	if (!isStylelintPluginUseBaselineInstalled) return [];
@@ -69,6 +71,10 @@ const css = () => [{
 	reportInvalidScopeDisables: true,
 	reportNeedlessDisables: true,
 	reportUnscopedDisables: true,
+	languageOptions: { directionality: {
+		block: "top-to-bottom",
+		inline: "left-to-right"
+	} },
 	rules: {
 		"at-rule-disallowed-list": ["debug"],
 		"at-rule-property-required-list": { "font-face": [
@@ -106,20 +112,30 @@ const css = () => [{
 		"no-unknown-animations": true,
 		"no-unknown-custom-media": true,
 		"no-unknown-custom-properties": true,
+		"property-layout-mappings": "flow-relative",
+		"relative-selector-nesting-notation": "implicit",
 		"selector-class-pattern": ["^[a-z]([-]?[a-z0-9]+)*(__[a-z0-9]([-]?[a-z0-9]+)*)?(--[a-z0-9]([-]?[a-z0-9]+)*)?$", {
 			resolveNestedSelectors: true,
 			message: (value) => `Expected class selector "${value}" to match BEM methodology (https://getbem.com/). Selector validation tool: https://regexr.com/3apms`
 		}],
+		"selector-no-deprecated": true,
+		"selector-no-invalid": true,
+		"selector-no-unmatchable": true,
 		"string-no-newline": true,
+		"unit-layout-mappings": "flow-relative",
 		"unit-no-unknown": true,
 		"value-keyword-case": ["lower", {
 			camelCaseSvgKeywords: true,
 			ignoreKeywords: [/^geometricPrecision$/v]
-		}]
+		}],
+		"value-keyword-layout-mappings": "flow-relative"
 	}
 }];
 //#endregion
 //#region ../src/js/stylelint/configs/defensive.ts
+/**
+* @internal @brnshkr/config/stylelint
+*/
 const defensive = () => {
 	const { requiredAll: [isStylelintPluginDefensiveCssInstalled] } = resolvePackages(MODULES.defensive);
 	if (!isStylelintPluginDefensiveCssInstalled) return [];
@@ -142,12 +158,19 @@ const defensive = () => {
 };
 //#endregion
 //#region ../src/js/stylelint/types/overrides.ts
+/**
+* @internal @brnshkr/config/stylelint
+*/
 const OVERRIDES = {
+	LESS: "less",
 	SCSS: "scss",
 	SVELTE: "svelte"
 };
 //#endregion
 //#region ../src/js/stylelint/utils/config.ts
+/**
+* @internal @brnshkr/config/stylelint
+*/
 const buildOverrideName = (override) => [packageOrganization, override].filter(Boolean).join("/");
 const isValidGlobalAdditionalConfigKey = (key) => [
 	"extends",
@@ -170,21 +193,22 @@ const isValidGlobalAdditionalConfigKey = (key) => [
 	"allowEmptyInput",
 	"cache",
 	"fix",
-	"computeEditInfo",
-	"validate"
+	"validate",
+	"maxWarnings",
+	"referenceFiles"
 ].includes(key);
 const getGlobalAdditionalConfig = (options) => {
 	const config = {};
 	for (const [key, value] of objectEntries(options)) if (isValidGlobalAdditionalConfigKey(key)) config[key] = value;
-	if (Object.keys(config).length === 0) return;
+	if (objectKeys(config).length === 0) return;
 	return config;
 };
 const getUserConfigs = (resolvedOptions, additionalConfigs) => [getGlobalAdditionalConfig(resolvedOptions), ...additionalConfigs].filter(Boolean);
 const includeConfigs = (config, configsToInclude) => {
 	for (const configToInclude of configsToInclude) {
-		if (configToInclude.extends !== void 0) config.extends = [...new Set([...Array.isArray(config.extends) ? config.extends ?? [] : [config.extends].filter(Boolean), ...Array.isArray(configToInclude.extends) ? configToInclude.extends ?? [] : [configToInclude.extends].filter(Boolean)])];
-		if (configToInclude.plugins !== void 0) config.plugins = [...new Set([...Array.isArray(config.plugins) ? config.plugins ?? [] : [config.plugins].filter(Boolean), ...Array.isArray(configToInclude.plugins) ? configToInclude.plugins ?? [] : [configToInclude.plugins].filter(Boolean)])];
-		if (configToInclude.ignoreFiles !== void 0) config.ignoreFiles = [...new Set([...Array.isArray(config.ignoreFiles) ? config.ignoreFiles ?? [] : [config.ignoreFiles].filter(Boolean), ...Array.isArray(configToInclude.ignoreFiles) ? configToInclude.ignoreFiles ?? [] : [configToInclude.ignoreFiles].filter(Boolean)])];
+		if (configToInclude.extends !== void 0) config.extends = [.../* @__PURE__ */ new Set([...Array.isArray(config.extends) ? config.extends ?? [] : [config.extends].filter(Boolean), ...Array.isArray(configToInclude.extends) ? configToInclude.extends ?? [] : [configToInclude.extends].filter(Boolean)])];
+		if (configToInclude.plugins !== void 0) config.plugins = [.../* @__PURE__ */ new Set([...Array.isArray(config.plugins) ? config.plugins ?? [] : [config.plugins].filter(Boolean), ...Array.isArray(configToInclude.plugins) ? configToInclude.plugins ?? [] : [configToInclude.plugins].filter(Boolean)])];
+		if (configToInclude.ignoreFiles !== void 0) config.ignoreFiles = [.../* @__PURE__ */ new Set([...Array.isArray(config.ignoreFiles) ? config.ignoreFiles ?? [] : [config.ignoreFiles].filter(Boolean), ...Array.isArray(configToInclude.ignoreFiles) ? configToInclude.ignoreFiles ?? [] : [configToInclude.ignoreFiles].filter(Boolean)])];
 		if (configToInclude.rules !== void 0) config.rules = {
 			...config.rules,
 			...configToInclude.rules
@@ -199,11 +223,11 @@ const includeConfigs = (config, configsToInclude) => {
 		if (configToInclude.reportUnscopedDisables !== void 0) config.reportUnscopedDisables = configToInclude.reportUnscopedDisables;
 		if (configToInclude.configurationComment !== void 0) config.configurationComment = configToInclude.configurationComment;
 		if (configToInclude.overrides !== void 0) {
-			const overridesToIncude = configToInclude.overrides;
-			config.overrides = [...(config.overrides ?? []).filter((existingOverride) => !overridesToIncude.some((overrideToIncude) => overrideToIncude.name !== void 0 && overrideToIncude.name === existingOverride.name)), ...overridesToIncude];
+			const overridesToInclude = configToInclude.overrides;
+			config.overrides = [...(config.overrides ?? []).filter((existingOverride) => overridesToInclude.every((overrideToInclude) => overrideToInclude.name === void 0 || overrideToInclude.name !== existingOverride.name)), ...overridesToInclude];
 		}
 		if (configToInclude.customSyntax !== void 0) config.customSyntax = configToInclude.customSyntax;
-		if (configToInclude.processors !== void 0) config.processors = [...new Set([...config.processors ?? [], ...configToInclude.processors])];
+		if (configToInclude.processors !== void 0) config.processors = [.../* @__PURE__ */ new Set([...config.processors ?? [], ...configToInclude.processors])];
 		if (configToInclude.languageOptions !== void 0) config.languageOptions = {
 			...config.languageOptions,
 			...configToInclude.languageOptions,
@@ -212,7 +236,7 @@ const includeConfigs = (config, configsToInclude) => {
 					...config.languageOptions?.syntax?.atRules,
 					...configToInclude.languageOptions.syntax?.atRules
 				},
-				cssWideKeywords: [...new Set([...config.languageOptions?.syntax?.cssWideKeywords ?? [], ...configToInclude.languageOptions.syntax?.cssWideKeywords ?? []])],
+				cssWideKeywords: [.../* @__PURE__ */ new Set([...config.languageOptions?.syntax?.cssWideKeywords ?? [], ...configToInclude.languageOptions.syntax?.cssWideKeywords ?? []])],
 				properties: {
 					...config.languageOptions?.syntax?.properties,
 					...configToInclude.languageOptions.syntax?.properties
@@ -226,12 +250,14 @@ const includeConfigs = (config, configsToInclude) => {
 		if (configToInclude.allowEmptyInput !== void 0) config.allowEmptyInput = configToInclude.allowEmptyInput;
 		if (configToInclude.cache !== void 0) config.cache = configToInclude.cache;
 		if (configToInclude.fix !== void 0) config.fix = configToInclude.fix;
-		if (configToInclude.computeEditInfo !== void 0) config.computeEditInfo = configToInclude.computeEditInfo;
 		if (configToInclude.validate !== void 0) config.validate = configToInclude.validate;
 	}
 };
 //#endregion
 //#region ../src/js/stylelint/configs/html.ts
+/**
+* @internal @brnshkr/config/stylelint
+*/
 const html = () => {
 	const { requiredAll: [isPostcssHtmlInstalled, isStylelintConfigHtmlInstalled] } = resolvePackages(MODULES.html);
 	if (!isPostcssHtmlInstalled || !isStylelintConfigHtmlInstalled) return [];
@@ -249,19 +275,35 @@ const html = () => {
 };
 //#endregion
 //#region ../src/js/stylelint/configs/ignores.ts
-const ignores = () => [{ ignoreFiles: GLOB_IGNORES.map((glob) => glob.replace(/^\*\*/v, process.cwd())) }];
+/**
+* @internal @brnshkr/config/stylelint
+*/
+const ignores = () => [{ ignoreFiles: GLOB_IGNORES.map((glob) => glob.replace(/^\*\*/v, () => `${process.cwd()}/**`)) }];
 //#endregion
-//#region ../src/js/stylelint/configs/logical.ts
-const logical = () => {
-	const { requiredAll: [isStylelintPluginLogicalCssInstalled] } = resolvePackages(MODULES.logical);
-	if (!isStylelintPluginLogicalCssInstalled) return [];
-	return [{
-		plugins: STYLELINT_PACKAGES.STYLELINT_PLUGIN_LOGICAL_CSS,
-		extends: [`${STYLELINT_PACKAGES.STYLELINT_PLUGIN_LOGICAL_CSS}/configs/recommended`]
-	}];
+//#region ../src/js/stylelint/configs/less.ts
+/**
+* @internal @brnshkr/config/stylelint
+*/
+const less = () => {
+	const { requiredAll: [isStylelintConfigStandardLessInstalled] } = resolvePackages(MODULES.less);
+	if (!isStylelintConfigStandardLessInstalled) return [];
+	return [{ overrides: [{
+		name: buildOverrideName(OVERRIDES.LESS),
+		files: ["**/*.less"],
+		extends: STYLELINT_PACKAGES.STYLELINT_CONFIG_STANDARD_LESS,
+		rules: {
+			"function-no-unknown": null,
+			"less/color-hex-case": "lower",
+			"less/container-name-pattern": ["^(--)?([a-z][a-z0-9]*)(-[a-z0-9]+)*$"],
+			"less/declaration-property-value-no-unknown": true
+		}
+	}] }];
 };
 //#endregion
 //#region ../src/js/stylelint/configs/modules.ts
+/**
+* @internal @brnshkr/config/stylelint
+*/
 const modules = () => {
 	const { requiredAll: [isStylelintConfigCssModulesInstalled] } = resolvePackages(MODULES.modules);
 	if (!isStylelintConfigCssModulesInstalled) return [];
@@ -269,6 +311,9 @@ const modules = () => {
 };
 //#endregion
 //#region ../src/js/stylelint/configs/nesting.ts
+/**
+* @internal @brnshkr/config/stylelint
+*/
 const nesting = () => {
 	const { requiredAll: [isStylelintUseNestingInstalled] } = resolvePackages(MODULES.nesting);
 	if (!isStylelintUseNestingInstalled) return [];
@@ -279,6 +324,9 @@ const nesting = () => {
 };
 //#endregion
 //#region ../src/js/stylelint/configs/order.ts
+/**
+* @internal @brnshkr/config/stylelint
+*/
 const order = () => {
 	const { requiredAll: [isStylelintConfigRecessOrderInstalled] } = resolvePackages(MODULES.order);
 	if (!isStylelintConfigRecessOrderInstalled) return [];
@@ -286,10 +334,15 @@ const order = () => {
 };
 //#endregion
 //#region ../src/js/stylelint/configs/scss.ts
+/**
+* @internal @brnshkr/config/stylelint
+*/
 const scss = () => {
 	const { requiredAll: [isStylelintConfigStandardScssInstalled], optional: [isStylelintPluginUseBaselineInstalled] } = resolvePackages(MODULES.scss);
 	if (!isStylelintConfigStandardScssInstalled) return [];
-	return [{
+	return [{ overrides: [{
+		name: buildOverrideName(OVERRIDES.SCSS),
+		files: ["**/*.scss"],
 		extends: STYLELINT_PACKAGES.STYLELINT_CONFIG_STANDARD_SCSS,
 		rules: {
 			"scss/at-each-key-value-single-line": true,
@@ -322,22 +375,22 @@ const scss = () => {
 			"scss/no-unused-private-members": true,
 			"scss/partial-no-import": true,
 			"scss/at-import-partial-extension-disallowed-list": ["scss"],
+			"scss/declaration-property-value-no-unknown": true,
+			"function-no-unknown": null,
+			"scss/function-no-unknown": true,
 			"property-no-unknown": null,
 			"scss/property-no-unknown": true,
-			"scss/selector-no-redundant-nesting-selector": true
-		},
-		overrides: [{
-			name: buildOverrideName(OVERRIDES.SCSS),
-			files: ["**/*.scss"],
-			rules: {
-				"scss/comment-no-loud": true,
-				...isStylelintPluginUseBaselineInstalled ? { "plugin/use-baseline": [true, { ignoreAtRules: ["function"] }] } : void 0
-			}
-		}]
-	}];
+			"scss/selector-no-redundant-nesting-selector": true,
+			"scss/comment-no-loud": true,
+			...isStylelintPluginUseBaselineInstalled ? { "plugin/use-baseline": [true, { ignoreAtRules: ["function"] }] } : void 0
+		}
+	}] }];
 };
 //#endregion
 //#region ../src/js/stylelint/configs/strict.ts
+/**
+* @internal @brnshkr/config/stylelint
+*/
 const strict = () => {
 	const { requiredAll: [isStylelintDeclarationStrictValueInstalled] } = resolvePackages(MODULES.strict);
 	if (!isStylelintDeclarationStrictValueInstalled) return [];
@@ -352,6 +405,9 @@ const strict = () => {
 };
 //#endregion
 //#region ../src/js/stylelint/configs/style.ts
+/**
+* @internal @brnshkr/config/stylelint
+*/
 const style = () => {
 	const { requiredAll: [isStylisticStylelintConfigInstalled] } = resolvePackages(MODULES.style);
 	if (!isStylisticStylelintConfigInstalled) return [];
@@ -381,13 +437,16 @@ const style = () => {
 };
 //#endregion
 //#region ../src/js/stylelint/configs/index.ts
+/**
+* @internal @brnshkr/config/stylelint
+*/
 const configs = {
 	baseline,
 	css,
 	defensive,
 	html,
 	ignores,
-	logical,
+	less,
 	modules,
 	nesting,
 	order,
@@ -397,12 +456,46 @@ const configs = {
 };
 //#endregion
 //#region ../src/js/stylelint/index.ts
+/**
+* Build the `@brnshkr` Stylelint config object.
+*
+* Merges sensible defaults for every supported module (SCSS, Less, HTML, etc.) with user
+* overrides and any additional configs.
+*
+* @api
+*
+* @param optionsAndGlobalConfig per-module toggles and global Stylelint fields merged with the defaults
+* @param additionalConfigs extra Stylelint config entries merged after the built-in ones
+*
+* @returns final Stylelint config ready to be consumed by Stylelint
+*
+* @see https://github.com/brnshkr/config/blob/master/docs/js/stylelint.md
+*
+* @example
+* ```js
+* import { getConfig } from '@brnshkr/config/stylelint';
+*
+* getConfig(undefined);
+* getConfig({});
+*
+* getConfig({
+*   scss: false,
+*   ignoreFiles: ['dist/**'],
+* }, {
+*   rules: { 'color-no-hex': null },
+* });
+*
+* getConfig(undefined, {
+*   rules: { 'color-no-hex': null },
+* });
+* ```
+*/
 const getConfig = (optionsAndGlobalConfig, ...additionalConfigs) => {
 	const resolvedOptions = {
 		baseline: isModuleEnabledByDefault(MODULES.baseline),
 		defensive: isModuleEnabledByDefault(MODULES.defensive),
 		html: isModuleEnabledByDefault(MODULES.html),
-		logical: isModuleEnabledByDefault(MODULES.logical),
+		less: isModuleEnabledByDefault(MODULES.less),
 		modules: isModuleEnabledByDefault(MODULES.modules),
 		nesting: isModuleEnabledByDefault(MODULES.nesting),
 		order: isModuleEnabledByDefault(MODULES.order),
@@ -414,7 +507,7 @@ const getConfig = (optionsAndGlobalConfig, ...additionalConfigs) => {
 	setModuleEnabled(MODULES.baseline, resolvedOptions.baseline);
 	setModuleEnabled(MODULES.defensive, resolvedOptions.defensive);
 	setModuleEnabled(MODULES.html, resolvedOptions.html);
-	setModuleEnabled(MODULES.logical, resolvedOptions.logical);
+	setModuleEnabled(MODULES.less, resolvedOptions.less);
 	setModuleEnabled(MODULES.modules, resolvedOptions.modules);
 	setModuleEnabled(MODULES.nesting, resolvedOptions.nesting);
 	setModuleEnabled(MODULES.order, resolvedOptions.order);
@@ -426,9 +519,9 @@ const getConfig = (optionsAndGlobalConfig, ...additionalConfigs) => {
 	includeConfigs(config, configs.css());
 	if (isModuleEnabled(MODULES.baseline)) includeConfigs(config, configs.baseline());
 	if (isModuleEnabled(MODULES.defensive)) includeConfigs(config, configs.defensive());
-	if (isModuleEnabled(MODULES.logical)) includeConfigs(config, configs.logical());
 	if (isModuleEnabled(MODULES.nesting)) includeConfigs(config, configs.nesting());
 	if (isModuleEnabled(MODULES.order)) includeConfigs(config, configs.order());
+	if (isModuleEnabled(MODULES.less)) includeConfigs(config, configs.less());
 	if (isModuleEnabled(MODULES.scss)) includeConfigs(config, configs.scss());
 	if (isModuleEnabled(MODULES.html)) includeConfigs(config, configs.html());
 	if (isModuleEnabled(MODULES.modules)) includeConfigs(config, configs.modules());
@@ -437,6 +530,11 @@ const getConfig = (optionsAndGlobalConfig, ...additionalConfigs) => {
 	includeConfigs(config, getUserConfigs(resolvedOptions, additionalConfigs));
 	return config;
 };
+/**
+* Default-exported pre-built config for direct re-export from a Stylelint config file.
+*
+* @api
+*/
 var stylelint_default = getConfig();
 //#endregion
 export { stylelint_default as default, getConfig };

package/dist/vitest/index.d.mts

@@ -0,0 +1,73 @@
+import { ViteUserConfig } from "vitest/config";
+//#region ../src/js/vitest/types/config.d.ts
+type Config = ViteUserConfig;
+//#endregion
+//#region ../src/js/vitest/types/options.d.ts
+interface ConfigOptions {
+  /**
+   * Enables `happy-dom` or `jsdom`.
+   *
+   * @default `Enabled when "happy-dom" or "jsdom" is installed.`
+   *
+   * @see https://github.com/capricorn86/happy-dom
+   * @see https://github.com/jsdom/jsdom
+   */
+  environment: boolean;
+  /**
+   * Collects the spelling test this package ships, so a project writes none of its own for it.
+   *
+   * @default `true`
+   *
+   * @see https://github.com/brnshkr/config/blob/master/docs/spelling.md
+   */
+  spelling: boolean;
+  /**
+   * Enables `@vitest/ui`.
+   *
+   * @default `Enabled when "@vitest/ui" is installed.`
+   *
+   * @see https://github.com/vitest-dev/vitest/tree/main/packages/ui
+   */
+  ui: boolean;
+}
+type UserOptions = Partial<ConfigOptions> & Config;
+//#endregion
+//#region ../src/js/vitest/index.d.ts
+/**
+ * Build the `@brnshkr` Vitest config object.
+ *
+ * Collects the project's own tests and the spelling test this package ships, so a repository
+ * needs no test file of its own for it, and activates each module lazily, only when its
+ * optional peer dependency is installed.
+ *
+ * @api
+ *
+ * @param optionsAndGlobalConfig per-module toggles and global Vitest fields merged with the defaults
+ * @param additionalConfigs extra config entries merged after the built-in ones
+ *
+ * @returns final config ready to be consumed by Vitest
+ *
+ * @see https://github.com/brnshkr/config/blob/master/docs/js/vitest.md
+ *
+ * @example
+ * ```js
+ * import { getConfig } from '@brnshkr/config/vitest';
+ *
+ * getConfig(undefined);
+ * getConfig({});
+ *
+ * getConfig({
+ *   spelling: false,
+ *   test: { testTimeout: 120_000 },
+ * });
+ * ```
+ */
+export declare const getConfig: (optionsAndGlobalConfig?: UserOptions, ...additionalConfigs: Config[]) => Config;
+/**
+ * Default-exported pre-built config for direct re-export from a Vitest config file.
+ *
+ * @api
+ */
+declare const _default: import("vite").UserConfig;
+//#endregion
+export { _default as default };