@aamini/config 0.0.20 → 0.2.0

package/dist/merge-DThKwm_6.mjs

@@ -0,0 +1,193 @@
+import { mergeConfig } from "vite-plus";
+//#region src/vite-plus/fmt.ts
+const fmt = {
+	singleQuote: true,
+	semi: false,
+	useTabs: true,
+	experimentalTailwindcss: {},
+	experimentalSortImports: {},
+	printWidth: 80,
+	experimentalSortPackageJson: false,
+	proseWrap: "always",
+	ignorePatterns: [
+		"**/.output",
+		"**/.vite",
+		"**/dist/**",
+		"pnpm-lock.yaml",
+		"env.d.ts",
+		"**/routeTree.gen.ts"
+	],
+	overrides: [{
+		files: ["*.{yaml,yml}"],
+		options: { useTabs: false }
+	}]
+};
+//#endregion
+//#region src/vite-plus/lint.ts
+const basePlugins = [
+	"eslint",
+	"unicorn",
+	"typescript",
+	"oxc",
+	"import",
+	"jsdoc",
+	"node",
+	"promise"
+];
+const frameworkPlugins = {
+	react: [
+		"react",
+		"react-perf",
+		"jsx-a11y"
+	],
+	astro: ["jsx-a11y"],
+	node: []
+};
+const antiSlopRules = {
+	"anti-slop/no-array-filter-map": "error",
+	"anti-slop/no-reduce-accumulator-copy": "error",
+	"anti-slop/no-chained-type-assertions": "error",
+	"anti-slop/no-conditional-empty-object-spread": "error",
+	"anti-slop/no-known-value-widening": "error",
+	"anti-slop/no-object-parameters": "error",
+	"anti-slop/no-reflect-apply": "error",
+	"anti-slop/no-reflect-get": "error",
+	"anti-slop/no-runtime-typeof": "error",
+	"anti-slop/no-shape-in-symbol-names": "error",
+	"anti-slop/no-unknown-parameters": "error",
+	"anti-slop/no-unknown-returns": "error",
+	"anti-slop/no-unknown-type-aliases": "error",
+	"anti-slop/no-unsafe-dictionary-type": "error",
+	"anti-slop/no-widen-then-assert": "error",
+	"anti-slop/require-readable-spacing": "error",
+	"anti-slop/require-safety-comment-for-type-assertion": "error"
+};
+const frameworkRules = {
+	react: { "eslint-js/no-restricted-syntax": ["error", {
+		selector: "JSXAttribute[name.name=\"className\"] TemplateLiteral",
+		message: "Do not build className with template literals. Use cn() from \"cn\" instead."
+	}] },
+	astro: {},
+	node: {}
+};
+const browserSettings = {
+	"jsx-a11y": {
+		components: {},
+		attributes: {}
+	},
+	react: {
+		formComponents: [],
+		linkComponents: []
+	}
+};
+const frameworkSettings = {
+	react: browserSettings,
+	astro: browserSettings,
+	node: {}
+};
+/** Oxlint preset for one framework. Every app shares the base and anti-slop rules. */
+function lint(framework) {
+	return {
+		plugins: [...basePlugins, ...frameworkPlugins[framework]],
+		jsPlugins: [{
+			name: "eslint-js",
+			specifier: "oxlint-plugin-eslint"
+		}, {
+			name: "anti-slop",
+			specifier: "@aamini/config/anti-slop"
+		}],
+		categories: {},
+		options: {
+			maxWarnings: 0,
+			typeAware: true,
+			typeCheck: true
+		},
+		rules: {
+			"no-empty-pattern": "off",
+			"no-console": ["error", { allow: ["warn", "error"] }],
+			"typescript/consistent-type-assertions": ["error", { assertionStyle: "never" }],
+			"oxc/no-accumulating-spread": "error",
+			...antiSlopRules,
+			...frameworkRules[framework]
+		},
+		overrides: [{
+			files: [
+				"mise-tasks/**",
+				"scripts/**",
+				"**/*.server.ts"
+			],
+			rules: { "no-console": "off" }
+		}],
+		settings: {
+			...frameworkSettings[framework],
+			jsdoc: {
+				ignorePrivate: false,
+				ignoreInternal: false,
+				ignoreReplacesDocs: true,
+				overrideReplacesDocs: true,
+				augmentsExtendsReplacesDocs: false,
+				implementsReplacesDocs: false,
+				exemptDestructuredRootsFromChecks: false,
+				tagNamePreference: {}
+			}
+		},
+		env: { builtin: true },
+		globals: {},
+		ignorePatterns: ["**/dist/**", "**/.output/**"]
+	};
+}
+//#endregion
+//#region src/vite-plus/merge.ts
+function isConfigNode(value) {
+	if (value === null || Array.isArray(value)) return false;
+	return Object.getPrototypeOf(value) === Object.prototype;
+}
+function isReplacer(value) {
+	return value instanceof Function;
+}
+/**
+* Applies the replacer functions in `override` to `preset`. Returns the
+* updated preset and the override without the applied replacers.
+*
+* A function counts as a replacer only when the preset holds a non-function
+* value at the same path. Other functions, for example a new browser command
+* or a replacement for a preset command, stay plain values for `mergeConfig`.
+*/
+function applyReplacers(preset, override, path) {
+	const nextPreset = { ...preset };
+	const rest = {};
+	for (const [key, value] of Object.entries(override)) {
+		const current = preset[key];
+		if (isReplacer(value) && current !== void 0 && !isReplacer(current)) {
+			nextPreset[key] = value(current);
+			continue;
+		}
+		if (path.at(-1) === "rules" && Array.isArray(value)) {
+			nextPreset[key] = value;
+			continue;
+		}
+		if (isConfigNode(value) && current !== void 0 && isConfigNode(current)) {
+			const [childPreset, childRest] = applyReplacers(current, value, [...path, key]);
+			nextPreset[key] = childPreset;
+			rest[key] = childRest;
+			continue;
+		}
+		rest[key] = value;
+	}
+	return [nextPreset, rest];
+}
+/**
+* Merges an app override into a toolkit preset. Replacer functions run
+* first. `mergeConfig` from Vite+ merges the rest: objects merge deep, arrays
+* append, and scalars replace.
+*/
+function mergeToolkitConfig(preset, override = {}) {
+	if (override instanceof Function) return override(preset);
+	if (!isConfigNode(preset) || !isConfigNode(override)) throw new TypeError("Toolkit config must be a plain object");
+	const [nextPreset, rest] = applyReplacers(preset, override, []);
+	return mergeConfig(nextPreset, rest);
+}
+//#endregion
+export { lint as n, fmt as r, mergeToolkitConfig as t };
+
+//# sourceMappingURL=merge-DThKwm_6.mjs.map

package/dist/merge-DThKwm_6.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-DThKwm_6.mjs","names":[],"sources":["../src/vite-plus/fmt.ts","../src/vite-plus/lint.ts","../src/vite-plus/merge.ts"],"sourcesContent":["import type { UserConfig } from 'vite-plus'\n\nexport const fmt = {\n\tsingleQuote: true,\n\tsemi: false,\n\tuseTabs: true,\n\texperimentalTailwindcss: {},\n\texperimentalSortImports: {},\n\tprintWidth: 80,\n\texperimentalSortPackageJson: false,\n\tproseWrap: 'always',\n\tignorePatterns: [\n\t\t'**/.output',\n\t\t'**/.vite',\n\t\t'**/dist/**',\n\t\t'pnpm-lock.yaml',\n\t\t'env.d.ts',\n\t\t'**/routeTree.gen.ts',\n\t],\n\toverrides: [\n\t\t{\n\t\t\tfiles: ['*.{yaml,yml}'],\n\t\t\toptions: { useTabs: false },\n\t\t},\n\t],\n} satisfies UserConfig['fmt']\n","import type { UserConfig } from 'vite-plus'\n\ntype LintConfig = NonNullable<UserConfig['lint']>\n\nexport type Framework = 'react' | 'astro' | 'node'\n\nconst basePlugins = [\n\t'eslint',\n\t'unicorn',\n\t'typescript',\n\t'oxc',\n\t'import',\n\t'jsdoc',\n\t'node',\n\t'promise',\n] satisfies LintConfig['plugins']\n\nconst frameworkPlugins = {\n\treact: ['react', 'react-perf', 'jsx-a11y'],\n\tastro: ['jsx-a11y'],\n\tnode: [],\n} satisfies Record<Framework, LintConfig['plugins']>\n\nconst antiSlopRules = {\n\t'anti-slop/no-array-filter-map': 'error',\n\t'anti-slop/no-reduce-accumulator-copy': 'error',\n\t'anti-slop/no-chained-type-assertions': 'error',\n\t'anti-slop/no-conditional-empty-object-spread': 'error',\n\t'anti-slop/no-known-value-widening': 'error',\n\t'anti-slop/no-object-parameters': 'error',\n\t'anti-slop/no-reflect-apply': 'error',\n\t'anti-slop/no-reflect-get': 'error',\n\t'anti-slop/no-runtime-typeof': 'error',\n\t'anti-slop/no-shape-in-symbol-names': 'error',\n\t'anti-slop/no-unknown-parameters': 'error',\n\t'anti-slop/no-unknown-returns': 'error',\n\t'anti-slop/no-unknown-type-aliases': 'error',\n\t'anti-slop/no-unsafe-dictionary-type': 'error',\n\t'anti-slop/no-widen-then-assert': 'error',\n\t'anti-slop/require-readable-spacing': 'error',\n\t'anti-slop/require-safety-comment-for-type-assertion': 'error',\n} satisfies LintConfig['rules']\n\nconst reactRules = {\n\t'eslint-js/no-restricted-syntax': [\n\t\t'error',\n\t\t{\n\t\t\tselector: 'JSXAttribute[name.name=\"className\"] TemplateLiteral',\n\t\t\tmessage:\n\t\t\t\t'Do not build className with template literals. Use cn() from \"cn\" instead.',\n\t\t},\n\t],\n} satisfies LintConfig['rules']\n\nconst frameworkRules = {\n\treact: reactRules,\n\tastro: {},\n\tnode: {},\n} satisfies Record<Framework, LintConfig['rules']>\n\nconst browserSettings = {\n\t'jsx-a11y': { components: {}, attributes: {} },\n\treact: { formComponents: [], linkComponents: [] },\n}\n\nconst frameworkSettings = {\n\treact: browserSettings,\n\tastro: browserSettings,\n\tnode: {},\n} satisfies Record<Framework, LintConfig['settings']>\n\n/** Oxlint preset for one framework. Every app shares the base and anti-slop rules. */\nexport function lint(framework: Framework) {\n\treturn {\n\t\tplugins: [...basePlugins, ...frameworkPlugins[framework]],\n\t\tjsPlugins: [\n\t\t\t{ name: 'eslint-js', specifier: 'oxlint-plugin-eslint' },\n\t\t\t{ name: 'anti-slop', specifier: '@aamini/config/anti-slop' },\n\t\t],\n\t\tcategories: {},\n\t\toptions: {\n\t\t\tmaxWarnings: 0,\n\t\t\ttypeAware: true,\n\t\t\ttypeCheck: true,\n\t\t},\n\t\trules: {\n\t\t\t'no-empty-pattern': 'off',\n\t\t\t'no-console': ['error', { allow: ['warn', 'error'] }],\n\t\t\t'typescript/consistent-type-assertions': [\n\t\t\t\t'error',\n\t\t\t\t{ assertionStyle: 'never' },\n\t\t\t],\n\t\t\t'oxc/no-accumulating-spread': 'error',\n\t\t\t...antiSlopRules,\n\t\t\t...frameworkRules[framework],\n\t\t},\n\t\toverrides: [\n\t\t\t{\n\t\t\t\tfiles: ['mise-tasks/**', 'scripts/**', '**/*.server.ts'],\n\t\t\t\trules: { 'no-console': 'off' },\n\t\t\t},\n\t\t],\n\t\tsettings: {\n\t\t\t...frameworkSettings[framework],\n\t\t\tjsdoc: {\n\t\t\t\tignorePrivate: false,\n\t\t\t\tignoreInternal: false,\n\t\t\t\tignoreReplacesDocs: true,\n\t\t\t\toverrideReplacesDocs: true,\n\t\t\t\taugmentsExtendsReplacesDocs: false,\n\t\t\t\timplementsReplacesDocs: false,\n\t\t\t\texemptDestructuredRootsFromChecks: false,\n\t\t\t\ttagNamePreference: {},\n\t\t\t},\n\t\t},\n\t\tenv: { builtin: true },\n\t\tglobals: {},\n\t\tignorePatterns: ['**/dist/**', '**/.output/**'],\n\t} satisfies LintConfig\n}\n","import { mergeConfig, type UserConfig } from 'vite-plus'\n\n// Any function type is assignable to this signature, whatever it returns.\ntype AnyFunction = (...args: never[]) => void\n\ntype Replacer<T> = (preset: T) => T\n\ntype OverrideValue<T> = T extends AnyFunction\n\t? T\n\t: T extends readonly unknown[]\n\t\t? T\n\t\t: T extends object\n\t\t\t? { [K in keyof T]?: ConfigOverride<T[K]> }\n\t\t\t: T\n\n/**\n * A partial override of `T`. Any value that the preset sets can also be a\n * function that receives the preset value and returns its replacement.\n */\nexport type ConfigOverride<T> = [NonNullable<T>] extends [AnyFunction]\n\t? T\n\t: OverrideValue<NonNullable<T>> | Replacer<NonNullable<T>>\n\n/** App-owned Vite+ config. The toolkit merges it over the preset. */\nexport type ToolkitConfig = OverrideValue<UserConfig>\n\ntype ConfigNode = { [key: string]: ConfigValue }\n\ntype ConfigValue =\n\t| ConfigNode\n\t| readonly ConfigValue[]\n\t| string\n\t| number\n\t| boolean\n\t| bigint\n\t| symbol\n\t| null\n\t| undefined\n\t| ((...args: never[]) => ConfigValue)\n\nfunction isConfigNode(\n\tvalue: ConfigValue | UserConfig | ToolkitConfig | Replacer<UserConfig>,\n): value is ConfigNode {\n\tif (value === null || Array.isArray(value)) return false\n\n\treturn Object.getPrototypeOf(value) === Object.prototype\n}\n\nfunction isReplacer(\n\tvalue: ConfigValue,\n): value is (preset: ConfigValue) => ConfigValue {\n\treturn value instanceof Function\n}\n\n/**\n * Applies the replacer functions in `override` to `preset`. Returns the\n * updated preset and the override without the applied replacers.\n *\n * A function counts as a replacer only when the preset holds a non-function\n * value at the same path. Other functions, for example a new browser command\n * or a replacement for a preset command, stay plain values for `mergeConfig`.\n */\nfunction applyReplacers(\n\tpreset: ConfigNode,\n\toverride: ConfigNode,\n\tpath: readonly string[],\n): [ConfigNode, ConfigNode] {\n\tconst nextPreset = { ...preset }\n\tconst rest: ConfigNode = {}\n\n\tfor (const [key, value] of Object.entries(override)) {\n\t\tconst current = preset[key]\n\n\t\tif (isReplacer(value) && current !== undefined && !isReplacer(current)) {\n\t\t\tnextPreset[key] = value(current)\n\t\t\tcontinue\n\t\t}\n\n\t\t// Oxlint rule entries are tuples such as ['error', options]. Array\n\t\t// concatenation from mergeConfig would corrupt them, so they replace.\n\t\tif (path.at(-1) === 'rules' && Array.isArray(value)) {\n\t\t\tnextPreset[key] = value\n\t\t\tcontinue\n\t\t}\n\n\t\tif (isConfigNode(value) && current !== undefined && isConfigNode(current)) {\n\t\t\tconst [childPreset, childRest] = applyReplacers(current, value, [\n\t\t\t\t...path,\n\t\t\t\tkey,\n\t\t\t])\n\n\t\t\tnextPreset[key] = childPreset\n\t\t\trest[key] = childRest\n\t\t\tcontinue\n\t\t}\n\n\t\trest[key] = value\n\t}\n\n\treturn [nextPreset, rest]\n}\n\n/**\n * Merges an app override into a toolkit preset. Replacer functions run\n * first. `mergeConfig` from Vite+ merges the rest: objects merge deep, arrays\n * append, and scalars replace.\n */\nexport function mergeToolkitConfig(\n\tpreset: UserConfig,\n\toverride: ToolkitConfig | Replacer<UserConfig> = {},\n): UserConfig {\n\tif (override instanceof Function) return override(preset)\n\n\tif (!isConfigNode(preset) || !isConfigNode(override)) {\n\t\tthrow new TypeError('Toolkit config must be a plain object')\n\t}\n\n\tconst [nextPreset, rest] = applyReplacers(preset, override, [])\n\n\treturn mergeConfig(nextPreset, rest)\n}\n"],"mappings":"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"}

package/dist/playwright.d.mts

@@ -1,7 +1,12 @@
 import { PlaywrightTestConfig } from "@playwright/test";
-
 //#region src/playwright.d.ts
-declare const baseConfig: (overrides?: PlaywrightTestConfig) => Promise<PlaywrightTestConfig<{}, {}>>;
+export interface PlaywrightOptions {
+  testDir: string;
+  /** Default: `BASE_URL`, then the local app on `APP_PORT` (3000). */
+  baseURL?: string;
+  webServer?: PlaywrightTestConfig['webServer'];
+}
+/** Smoke tests against a running app. Runs against any `BASE_URL`. */
+export declare function playwrightConfig(options: PlaywrightOptions): PlaywrightTestConfig<{}, {}>;
 //#endregion
-export { baseConfig };
 //# sourceMappingURL=playwright.d.mts.map

package/dist/playwright.mjs

@@ -1,20 +1,27 @@
 import { defineConfig, devices } from "@playwright/test";
 //#region src/playwright.ts
-const baseConfig = async (overrides) => {
-	return defineConfig({
-		testDir: "./e2e",
+function defaultBaseURL() {
+	return process.env.BASE_URL?.trim() || `http://localhost:${process.env.APP_PORT ?? "3000"}`;
+}
+const launchOptions = { args: ["--disable-lcd-text", "--headless=new"] };
+/** Smoke tests against a running app. Runs against any `BASE_URL`. */
+function playwrightConfig(options) {
+	const baseURL = options.baseURL ?? defaultBaseURL();
+	const config = {
+		testDir: options.testDir,
 		outputDir: ".playwright/test-results",
 		fullyParallel: true,
 		workers: process.env.CI ? 1 : "50%",
-		forbidOnly: !!process.env.CI,
+		forbidOnly: Boolean(process.env.CI),
 		retries: process.env.CI ? 3 : 0,
 		reporter: [["html", {
 			open: "never",
 			outputFolder: ".playwright/report"
 		}]],
 		use: {
-			colorScheme: "dark",
-			baseURL: process.env.BASE_URL,
+			baseURL,
+			channel: "chromium",
+			ignoreHTTPSErrors: !process.env.CI && baseURL.startsWith("https://"),
 			trace: "retain-on-first-failure",
 			screenshot: "on",
 			video: "retain-on-failure"
@@ -25,7 +32,7 @@ const baseConfig = async (overrides) => {
 			name: "chromium",
 			use: {
 				...devices["Desktop Chrome"],
-				launchOptions: { args: ["--disable-lcd-text"] }
+				launchOptions
 			}
 		}, {
 			name: "mobile",
@@ -35,12 +42,14 @@ const baseConfig = async (overrides) => {
 					width: 320,
 					height: 800
 				},
-				launchOptions: { args: ["--disable-lcd-text"] }
+				launchOptions
 			}
 		}]
-	}, overrides ?? {});
-};
+	};
+	if (options.webServer) config.webServer = options.webServer;
+	return defineConfig(config);
+}
 //#endregion
-export { baseConfig };
+export { playwrightConfig };
 
 //# sourceMappingURL=playwright.mjs.map

package/dist/playwright.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"playwright.mjs","names":[],"sources":["../src/playwright.ts"],"sourcesContent":["import {\n\tdefineConfig,\n\tdevices,\n\ttype PlaywrightTestConfig,\n} from '@playwright/test'\n\nexport const baseConfig = async (overrides?: PlaywrightTestConfig) => {\n\treturn defineConfig(\n\t\t{\n\t\t\ttestDir: './e2e',\n\t\t\toutputDir: '.playwright/test-results',\n\t\t\tfullyParallel: true,\n\t\t\tworkers: process.env.CI ? 1 : '50%',\n\t\t\tforbidOnly: !!process.env.CI,\n\t\t\tretries: process.env.CI ? 3 : 0,\n\t\t\treporter: [\n\t\t\t\t['html', { open: 'never', outputFolder: '.playwright/report' }],\n\t\t\t],\n\t\t\tuse: {\n\t\t\t\tcolorScheme: 'dark',\n\t\t\t\tbaseURL: process.env.BASE_URL,\n\t\t\t\ttrace: 'retain-on-first-failure',\n\t\t\t\tscreenshot: 'on',\n\t\t\t\tvideo: 'retain-on-failure',\n\t\t\t},\n\t\t\ttimeout: 15_000,\n\t\t\texpect: { timeout: 5_000 },\n\t\t\tprojects: [\n\t\t\t\t{\n\t\t\t\t\tname: 'chromium',\n\t\t\t\t\tuse: {\n\t\t\t\t\t\t...devices['Desktop Chrome'],\n\t\t\t\t\t\tlaunchOptions: { args: ['--disable-lcd-text'] },\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tname: 'mobile',\n\t\t\t\t\tuse: {\n\t\t\t\t\t\t...devices['Desktop Chrome'],\n\t\t\t\t\t\tviewport: { width: 320, height: 800 },\n\t\t\t\t\t\tlaunchOptions: { args: ['--disable-lcd-text'] },\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t],\n\t\t},\n\t\toverrides ?? {},\n\t)\n}\n"],"mappings":";;AAMA,MAAa,aAAa,OAAO,cAAqC;CACrE,OAAO,aACN;EACC,SAAS;EACT,WAAW;EACX,eAAe;EACf,SAAS,QAAQ,IAAI,KAAK,IAAI;EAC9B,YAAY,CAAC,CAAC,QAAQ,IAAI;EAC1B,SAAS,QAAQ,IAAI,KAAK,IAAI;EAC9B,UAAU,CACT,CAAC,QAAQ;GAAE,MAAM;GAAS,cAAc;GAAsB,CAAC,CAC/D;EACD,KAAK;GACJ,aAAa;GACb,SAAS,QAAQ,IAAI;GACrB,OAAO;GACP,YAAY;GACZ,OAAO;GACP;EACD,SAAS;EACT,QAAQ,EAAE,SAAS,KAAO;EAC1B,UAAU,CACT;GACC,MAAM;GACN,KAAK;IACJ,GAAG,QAAQ;IACX,eAAe,EAAE,MAAM,CAAC,qBAAqB,EAAE;IAC/C;GACD,EACD;GACC,MAAM;GACN,KAAK;IACJ,GAAG,QAAQ;IACX,UAAU;KAAE,OAAO;KAAK,QAAQ;KAAK;IACrC,eAAe,EAAE,MAAM,CAAC,qBAAqB,EAAE;IAC/C;GACD,CACD;EACD,EACD,aAAa,EAAE,CACf"}
+{"version":3,"file":"playwright.mjs","names":[],"sources":["../src/playwright.ts"],"sourcesContent":["import {\n\tdefineConfig,\n\tdevices,\n\ttype PlaywrightTestConfig,\n} from '@playwright/test'\n\nexport interface PlaywrightOptions {\n\ttestDir: string\n\t/** Default: `BASE_URL`, then the local app on `APP_PORT` (3000). */\n\tbaseURL?: string\n\twebServer?: PlaywrightTestConfig['webServer']\n}\n\nfunction defaultBaseURL() {\n\treturn (\n\t\tprocess.env.BASE_URL?.trim() ||\n\t\t`http://localhost:${process.env.APP_PORT ?? '3000'}`\n\t)\n}\n\nconst launchOptions = { args: ['--disable-lcd-text', '--headless=new'] }\n\n/** Smoke tests against a running app. Runs against any `BASE_URL`. */\nexport function playwrightConfig(options: PlaywrightOptions) {\n\tconst baseURL = options.baseURL ?? defaultBaseURL()\n\n\tconst config: PlaywrightTestConfig = {\n\t\ttestDir: options.testDir,\n\t\toutputDir: '.playwright/test-results',\n\t\tfullyParallel: true,\n\t\tworkers: process.env.CI ? 1 : '50%',\n\t\tforbidOnly: Boolean(process.env.CI),\n\t\tretries: process.env.CI ? 3 : 0,\n\t\treporter: [['html', { open: 'never', outputFolder: '.playwright/report' }]],\n\t\tuse: {\n\t\t\tbaseURL,\n\t\t\tchannel: 'chromium',\n\t\t\tignoreHTTPSErrors: !process.env.CI && baseURL.startsWith('https://'),\n\t\t\ttrace: 'retain-on-first-failure',\n\t\t\tscreenshot: 'on',\n\t\t\tvideo: 'retain-on-failure',\n\t\t},\n\t\ttimeout: 15_000,\n\t\texpect: { timeout: 5_000 },\n\t\tprojects: [\n\t\t\t{\n\t\t\t\tname: 'chromium',\n\t\t\t\tuse: { ...devices['Desktop Chrome'], launchOptions },\n\t\t\t},\n\t\t\t{\n\t\t\t\tname: 'mobile',\n\t\t\t\tuse: {\n\t\t\t\t\t...devices['Desktop Chrome'],\n\t\t\t\t\tviewport: { width: 320, height: 800 },\n\t\t\t\t\tlaunchOptions,\n\t\t\t\t},\n\t\t\t},\n\t\t],\n\t}\n\n\tif (options.webServer) config.webServer = options.webServer\n\n\treturn defineConfig(config)\n}\n"],"mappings":";;AAaA,SAAS,iBAAiB;CACzB,OACC,QAAQ,IAAI,UAAU,KAAK,KAC3B,oBAAoB,QAAQ,IAAI,YAAY;AAE9C;AAEA,MAAM,gBAAgB,EAAE,MAAM,CAAC,sBAAsB,gBAAgB,EAAE;;AAGvE,SAAgB,iBAAiB,SAA4B;CAC5D,MAAM,UAAU,QAAQ,WAAW,eAAe;CAElD,MAAM,SAA+B;EACpC,SAAS,QAAQ;EACjB,WAAW;EACX,eAAe;EACf,SAAS,QAAQ,IAAI,KAAK,IAAI;EAC9B,YAAY,QAAQ,QAAQ,IAAI,EAAE;EAClC,SAAS,QAAQ,IAAI,KAAK,IAAI;EAC9B,UAAU,CAAC,CAAC,QAAQ;GAAE,MAAM;GAAS,cAAc;EAAqB,CAAC,CAAC;EAC1E,KAAK;GACJ;GACA,SAAS;GACT,mBAAmB,CAAC,QAAQ,IAAI,MAAM,QAAQ,WAAW,UAAU;GACnE,OAAO;GACP,YAAY;GACZ,OAAO;EACR;EACA,SAAS;EACT,QAAQ,EAAE,SAAS,IAAM;EACzB,UAAU,CACT;GACC,MAAM;GACN,KAAK;IAAE,GAAG,QAAQ;IAAmB;GAAc;EACpD,GACA;GACC,MAAM;GACN,KAAK;IACJ,GAAG,QAAQ;IACX,UAAU;KAAE,OAAO;KAAK,QAAQ;IAAI;IACpC;GACD;EACD,CACD;CACD;CAEA,IAAI,QAAQ,WAAW,OAAO,YAAY,QAAQ;CAElD,OAAO,aAAa,MAAM;AAC3B"}

package/dist/root-U5B4x0aj.mjs

@@ -0,0 +1,15 @@
+import { resolve } from "node:path";
+//#region src/vitest/root.ts
+const rootKey = "aaminiToolkitRoot";
+/**
+* Resolves a path against the app root. Without a root, for example when the
+* app does not use `defineToolkit()`, the path resolves against the current
+* working directory.
+*/
+function resolveFromRoot(root, path) {
+	return resolve(root ?? process.cwd(), path);
+}
+//#endregion
+export { rootKey as n, resolveFromRoot as t };
+
+//# sourceMappingURL=root-U5B4x0aj.mjs.map

package/dist/root-U5B4x0aj.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"root-U5B4x0aj.mjs","names":[],"sources":["../src/vitest/root.ts"],"sourcesContent":["import { resolve } from 'node:path'\n\ndeclare module 'vitest' {\n\tinterface ProvidedContext {\n\t\t/** The app root. The TanStack `defineToolkit()` provides it. */\n\t\taaminiToolkitRoot?: string\n\t}\n}\n\nexport const rootKey = 'aaminiToolkitRoot'\n\n/**\n * Resolves a path against the app root. Without a root, for example when the\n * app does not use `defineToolkit()`, the path resolves against the current\n * working directory.\n */\nexport function resolveFromRoot(root: string | undefined, path: string) {\n\treturn resolve(root ?? process.cwd(), path)\n}\n"],"mappings":";;AASA,MAAa,UAAU;;;;;;AAOvB,SAAgB,gBAAgB,MAA0B,MAAc;CACvE,OAAO,QAAQ,QAAQ,QAAQ,IAAI,GAAG,IAAI;AAC3C"}

package/dist/tanstack/index.d.mts

@@ -0,0 +1,45 @@
+import { n as ToolkitConfig } from "../merge-BEomHgbw.mjs";
+import { ProjectOptions } from "../vitest/index.mjs";
+import { UserConfig } from "vite-plus";
+import tailwindcss from "@tailwindcss/vite";
+import { devtools } from "@tanstack/devtools-vite";
+import { tanstackStart } from "@tanstack/react-start/plugin/vite";
+import { varlockVitePlugin } from "@varlock/vite-integration";
+import viteReact, { reactCompilerPreset } from "@vitejs/plugin-react";
+import { nitro } from "nitro/vite";
+//#region src/tanstack/index.d.ts
+type Options<T extends (...args: never[]) => void> = NonNullable<Parameters<T>[0]>;
+/** `false` removes the plugin. An object merges over the toolkit options. */
+type PluginSetting<T> = false | T;
+export interface TanstackPlugins {
+  tanstackStart?: PluginSetting<Options<typeof tanstackStart>>;
+  /** Dev only. Vitest runs without it. */
+  devtools?: PluginSetting<Options<typeof devtools>>;
+  /** Dev and build only. Vitest runs without it. */
+  nitro?: PluginSetting<Options<typeof nitro>>;
+  tailwindcss?: PluginSetting<Options<typeof tailwindcss>>;
+  react?: PluginSetting<Options<typeof viteReact>>;
+  reactCompiler?: PluginSetting<Options<typeof reactCompilerPreset>>;
+  varlock?: PluginSetting<Options<typeof varlockVitePlugin>>;
+}
+/** `false` removes the project. An object merges over the toolkit options. */
+export interface TanstackTests {
+  unit?: false | ProjectOptions;
+  server?: false | ProjectOptions;
+  /** Vitest browser mode, `desktop` and `mobile` instances. */
+  browser?: false | ProjectOptions;
+}
+export interface TanstackToolkitOptions {
+  /** The app root. Pass `import.meta.dirname` from `vite.config.ts`. */
+  root?: string;
+  plugins?: TanstackPlugins;
+  /** Adds the `@shadcn/lint` rules. */
+  shadcn?: boolean;
+  tests?: TanstackTests;
+  /** Vite+ config merged last. App plugins in `config.plugins` run after the toolkit plugins. */
+  config?: ToolkitConfig;
+}
+/** The complete Vite+ config for a TanStack Start app. */
+export declare function defineToolkit(options?: TanstackToolkitOptions): Promise<UserConfig>;
+//#endregion
+//# sourceMappingURL=index.d.mts.map

package/dist/tanstack/index.mjs

@@ -0,0 +1,189 @@
+import { a as canResolve, c as mergeOptions, n as serverProject, o as importPeer, r as unitProject, s as requirePeer, t as browserProject } from "../vitest-CXdvqyRH.mjs";
+import { n as lint, r as fmt, t as mergeToolkitConfig } from "../merge-DThKwm_6.mjs";
+import { n as rootKey } from "../root-U5B4x0aj.mjs";
+import { resolve } from "node:path";
+//#region src/tanstack/index.ts
+const entry = "@aamini/config/tanstack";
+const peers = {
+	tanstackStart: {
+		name: "@tanstack/react-start",
+		specifier: "@tanstack/react-start/plugin/vite"
+	},
+	devtools: {
+		name: "@tanstack/devtools-vite",
+		specifier: "@tanstack/devtools-vite"
+	},
+	nitro: {
+		name: "nitro",
+		specifier: "nitro/vite"
+	},
+	tailwindcss: {
+		name: "@tailwindcss/vite",
+		specifier: "@tailwindcss/vite"
+	},
+	react: {
+		name: "@vitejs/plugin-react",
+		specifier: "@vitejs/plugin-react"
+	},
+	babel: {
+		name: "@rolldown/plugin-babel",
+		specifier: "@rolldown/plugin-babel"
+	},
+	reactCompiler: {
+		name: "babel-plugin-react-compiler",
+		specifier: "babel-plugin-react-compiler"
+	},
+	varlock: {
+		name: "@varlock/vite-integration",
+		specifier: "@varlock/vite-integration"
+	},
+	shadcn: {
+		name: "@shadcn/lint",
+		specifier: "@shadcn/lint"
+	}
+};
+const pluginDefaults = {
+	tanstackStart: {
+		router: { routeFileIgnorePattern: "(\\.test\\.tsx$|__screenshots__)" },
+		server: { build: { inlineCss: true } }
+	},
+	devtools: { injectSource: { enabled: false } },
+	nitro: {
+		sourcemap: true,
+		experimental: { sourcemapMinify: false }
+	},
+	tailwindcss: {},
+	react: {},
+	reactCompiler: {},
+	varlock: { ssrInjectMode: "resolved-env" }
+};
+const shadcnLint = {
+	jsPlugins: ["@shadcn/lint"],
+	rules: {
+		"shadcn/require-static-classes": "error",
+		"shadcn/no-raw-colors": "error",
+		"shadcn/no-unknown-classes": "error",
+		"shadcn/no-arbitrary-values": ["error", { allow: ["layout"] }],
+		"shadcn/no-inline-styles": "error",
+		"shadcn/no-restyle": ["error", { allow: ["layout"] }]
+	},
+	overrides: [{
+		files: ["src/components/ui/**"],
+		rules: {
+			"shadcn/require-static-classes": "off",
+			"shadcn/no-restyle": "off",
+			"shadcn/no-arbitrary-values": "off"
+		}
+	}]
+};
+function pluginOptions(defaults, setting) {
+	if (setting === false) return void 0;
+	return mergeOptions(defaults, setting);
+}
+/**
+* Builds the TanStack plugins in the toolkit order. Each import runs only
+* when its plugin is on, so an app never loads a plugin that it removes.
+*/
+async function tanstackPlugins(plugins) {
+	const underVitest = process.env.VITEST === "true";
+	const result = [];
+	const startOptions = pluginOptions(pluginDefaults.tanstackStart, plugins.tanstackStart);
+	if (startOptions) {
+		const { tanstackStart } = await importPeer(entry, peers.tanstackStart, () => import("@tanstack/react-start/plugin/vite"));
+		result.push(tanstackStart(startOptions));
+	}
+	const devtoolsOptions = pluginOptions(pluginDefaults.devtools, plugins.devtools);
+	if (devtoolsOptions && !underVitest) {
+		const { devtools } = await importPeer(entry, peers.devtools, () => import("@tanstack/devtools-vite"));
+		result.push(devtools(devtoolsOptions));
+	}
+	const nitroOptions = pluginOptions(pluginDefaults.nitro, plugins.nitro);
+	if (nitroOptions && !underVitest) {
+		const { nitro } = await importPeer(entry, peers.nitro, () => import("nitro/vite"));
+		result.push(nitro(nitroOptions));
+	}
+	const tailwindOptions = pluginOptions(pluginDefaults.tailwindcss, plugins.tailwindcss);
+	if (tailwindOptions) {
+		const { default: tailwindcss } = await importPeer(entry, peers.tailwindcss, () => import("@tailwindcss/vite"));
+		result.push(tailwindcss(tailwindOptions));
+	}
+	const reactOptions = pluginOptions(pluginDefaults.react, plugins.react);
+	if (reactOptions) {
+		const { default: viteReact } = await importPeer(entry, peers.react, () => import("@vitejs/plugin-react"));
+		result.push(viteReact(reactOptions));
+	}
+	const compilerOptions = pluginOptions(pluginDefaults.reactCompiler, plugins.reactCompiler);
+	if (compilerOptions) {
+		requirePeer(entry, peers.reactCompiler);
+		const { reactCompilerPreset } = await importPeer(entry, peers.react, () => import("@vitejs/plugin-react"));
+		const { default: babel } = await importPeer(entry, peers.babel, () => import("@rolldown/plugin-babel"));
+		result.push(babel({ presets: [reactCompilerPreset(compilerOptions)] }));
+	}
+	const varlockOptions = pluginOptions(pluginDefaults.varlock, plugins.varlock);
+	if (varlockOptions) {
+		const { varlockVitePlugin } = await importPeer(entry, peers.varlock, () => import("@varlock/vite-integration"));
+		result.push(varlockVitePlugin(varlockOptions));
+	}
+	return result;
+}
+async function testProjects(tests) {
+	const projects = [];
+	if (tests.unit !== false) projects.push(unitProject(tests.unit));
+	if (tests.server !== false) projects.push(serverProject(tests.server));
+	if (tests.browser !== false) projects.push(await browserProject(mergeOptions({ setupFiles: ["./src/styles.css"] }, tests.browser)));
+	return projects;
+}
+function browserTestDeps() {
+	const deps = ["vite-plus/test", "vite-plus/test/browser"];
+	for (const optional of [
+		"vitest-browser-react",
+		"msw",
+		"msw/browser"
+	]) if (canResolve(optional)) deps.push(optional);
+	return deps;
+}
+/** The complete Vite+ config for a TanStack Start app. */
+async function defineToolkit(options = {}) {
+	const root = options.root ?? process.cwd();
+	const shadcn = options.shadcn !== false;
+	const tests = options.tests ?? {};
+	if (shadcn) requirePeer(entry, peers.shadcn);
+	const preset = {
+		root,
+		staged: { "*": "vp check --fix" },
+		server: {
+			host: "127.0.0.1",
+			port: Number(process.env.APP_PORT ?? 3e3)
+		},
+		build: { rollupOptions: { checks: { moduleLevelDirective: false } } },
+		resolve: {
+			tsconfigPaths: true,
+			dedupe: ["react", "react-dom"],
+			alias: [{
+				find: "@",
+				replacement: resolve(root, "src")
+			}, {
+				find: "@tests",
+				replacement: resolve(root, "tests")
+			}]
+		},
+		plugins: await tanstackPlugins(options.plugins ?? {}),
+		fmt,
+		lint: lint("react"),
+		test: {
+			api: {
+				allowWrite: true,
+				allowExec: false
+			},
+			provide: { [rootKey]: root },
+			projects: await testProjects(tests)
+		}
+	};
+	if (tests.browser !== false) preset.optimizeDeps = { include: browserTestDeps() };
+	const withShadcn = shadcn ? mergeToolkitConfig(preset, { lint: shadcnLint }) : preset;
+	return mergeToolkitConfig(withShadcn, options.config);
+}
+//#endregion
+export { defineToolkit };
+
+//# sourceMappingURL=index.mjs.map

package/dist/tanstack/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/tanstack/index.ts"],"sourcesContent":["import { resolve } from 'node:path'\n\nimport type tailwindcss from '@tailwindcss/vite'\nimport type { devtools } from '@tanstack/devtools-vite'\nimport type { tanstackStart } from '@tanstack/react-start/plugin/vite'\nimport type { varlockVitePlugin } from '@varlock/vite-integration'\nimport type { reactCompilerPreset } from '@vitejs/plugin-react'\nimport type viteReact from '@vitejs/plugin-react'\nimport type { nitro } from 'nitro/vite'\nimport type { PluginOption, UserConfig } from 'vite-plus'\n\nimport { mergeOptions } from '../options.ts'\nimport { canResolve, importPeer, requirePeer, type Peer } from '../peers.ts'\nimport { fmt } from '../vite-plus/fmt.ts'\nimport { lint } from '../vite-plus/lint.ts'\nimport { mergeToolkitConfig, type ToolkitConfig } from '../vite-plus/merge.ts'\nimport {\n\tbrowserProject,\n\tserverProject,\n\tunitProject,\n\ttype ProjectOptions,\n} from '../vitest/index.ts'\nimport { rootKey } from '../vitest/root.ts'\n\n// Any function type is assignable to this signature, whatever it returns.\ntype Options<T extends (...args: never[]) => void> = NonNullable<\n\tParameters<T>[0]\n>\n\n/** `false` removes the plugin. An object merges over the toolkit options. */\ntype PluginSetting<T> = false | T\n\nexport interface TanstackPlugins {\n\ttanstackStart?: PluginSetting<Options<typeof tanstackStart>>\n\t/** Dev only. Vitest runs without it. */\n\tdevtools?: PluginSetting<Options<typeof devtools>>\n\t/** Dev and build only. Vitest runs without it. */\n\tnitro?: PluginSetting<Options<typeof nitro>>\n\ttailwindcss?: PluginSetting<Options<typeof tailwindcss>>\n\treact?: PluginSetting<Options<typeof viteReact>>\n\treactCompiler?: PluginSetting<Options<typeof reactCompilerPreset>>\n\tvarlock?: PluginSetting<Options<typeof varlockVitePlugin>>\n}\n\n/** `false` removes the project. An object merges over the toolkit options. */\nexport interface TanstackTests {\n\tunit?: false | ProjectOptions\n\tserver?: false | ProjectOptions\n\t/** Vitest browser mode, `desktop` and `mobile` instances. */\n\tbrowser?: false | ProjectOptions\n}\n\nexport interface TanstackToolkitOptions {\n\t/** The app root. Pass `import.meta.dirname` from `vite.config.ts`. */\n\troot?: string\n\tplugins?: TanstackPlugins\n\t/** Adds the `@shadcn/lint` rules. */\n\tshadcn?: boolean\n\ttests?: TanstackTests\n\t/** Vite+ config merged last. App plugins in `config.plugins` run after the toolkit plugins. */\n\tconfig?: ToolkitConfig\n}\n\nconst entry = '@aamini/config/tanstack'\n\nconst peers = {\n\ttanstackStart: {\n\t\tname: '@tanstack/react-start',\n\t\tspecifier: '@tanstack/react-start/plugin/vite',\n\t},\n\tdevtools: {\n\t\tname: '@tanstack/devtools-vite',\n\t\tspecifier: '@tanstack/devtools-vite',\n\t},\n\tnitro: { name: 'nitro', specifier: 'nitro/vite' },\n\ttailwindcss: { name: '@tailwindcss/vite', specifier: '@tailwindcss/vite' },\n\treact: { name: '@vitejs/plugin-react', specifier: '@vitejs/plugin-react' },\n\tbabel: {\n\t\tname: '@rolldown/plugin-babel',\n\t\tspecifier: '@rolldown/plugin-babel',\n\t},\n\treactCompiler: {\n\t\tname: 'babel-plugin-react-compiler',\n\t\tspecifier: 'babel-plugin-react-compiler',\n\t},\n\tvarlock: {\n\t\tname: '@varlock/vite-integration',\n\t\tspecifier: '@varlock/vite-integration',\n\t},\n\tshadcn: { name: '@shadcn/lint', specifier: '@shadcn/lint' },\n} satisfies Record<string, Peer>\n\ntype PluginDefaults = Required<{\n\t[K in keyof TanstackPlugins]: Exclude<TanstackPlugins[K], false | undefined>\n}>\n\nconst pluginDefaults: PluginDefaults = {\n\ttanstackStart: {\n\t\trouter: { routeFileIgnorePattern: '(\\\\.test\\\\.tsx$|__screenshots__)' },\n\t\tserver: { build: { inlineCss: true } },\n\t},\n\tdevtools: { injectSource: { enabled: false } },\n\tnitro: { sourcemap: true, experimental: { sourcemapMinify: false } },\n\ttailwindcss: {},\n\treact: {},\n\treactCompiler: {},\n\tvarlock: { ssrInjectMode: 'resolved-env' },\n}\n\nconst shadcnLint = {\n\tjsPlugins: ['@shadcn/lint'],\n\trules: {\n\t\t'shadcn/require-static-classes': 'error',\n\t\t'shadcn/no-raw-colors': 'error',\n\t\t'shadcn/no-unknown-classes': 'error',\n\t\t'shadcn/no-arbitrary-values': ['error', { allow: ['layout'] }],\n\t\t'shadcn/no-inline-styles': 'error',\n\t\t'shadcn/no-restyle': ['error', { allow: ['layout'] }],\n\t},\n\toverrides: [\n\t\t{\n\t\t\tfiles: ['src/components/ui/**'],\n\t\t\trules: {\n\t\t\t\t'shadcn/require-static-classes': 'off',\n\t\t\t\t'shadcn/no-restyle': 'off',\n\t\t\t\t'shadcn/no-arbitrary-values': 'off',\n\t\t\t},\n\t\t},\n\t],\n} satisfies UserConfig['lint']\n\nfunction pluginOptions<T extends object>(\n\tdefaults: T,\n\tsetting: PluginSetting<T> | undefined,\n) {\n\tif (setting === false) return undefined\n\n\treturn mergeOptions(defaults, setting)\n}\n\n/**\n * Builds the TanStack plugins in the toolkit order. Each import runs only\n * when its plugin is on, so an app never loads a plugin that it removes.\n */\nasync function tanstackPlugins(plugins: TanstackPlugins) {\n\tconst underVitest = process.env.VITEST === 'true'\n\tconst result: PluginOption[] = []\n\n\tconst startOptions = pluginOptions(\n\t\tpluginDefaults.tanstackStart,\n\t\tplugins.tanstackStart,\n\t)\n\n\tif (startOptions) {\n\t\tconst { tanstackStart } = await importPeer(\n\t\t\tentry,\n\t\t\tpeers.tanstackStart,\n\t\t\t() => import('@tanstack/react-start/plugin/vite'),\n\t\t)\n\n\t\tresult.push(tanstackStart(startOptions))\n\t}\n\n\tconst devtoolsOptions = pluginOptions(\n\t\tpluginDefaults.devtools,\n\t\tplugins.devtools,\n\t)\n\n\tif (devtoolsOptions && !underVitest) {\n\t\tconst { devtools } = await importPeer(\n\t\t\tentry,\n\t\t\tpeers.devtools,\n\t\t\t() => import('@tanstack/devtools-vite'),\n\t\t)\n\n\t\tresult.push(devtools(devtoolsOptions))\n\t}\n\n\tconst nitroOptions = pluginOptions(pluginDefaults.nitro, plugins.nitro)\n\n\tif (nitroOptions && !underVitest) {\n\t\tconst { nitro } = await importPeer(\n\t\t\tentry,\n\t\t\tpeers.nitro,\n\t\t\t() => import('nitro/vite'),\n\t\t)\n\n\t\tresult.push(nitro(nitroOptions))\n\t}\n\n\tconst tailwindOptions = pluginOptions(\n\t\tpluginDefaults.tailwindcss,\n\t\tplugins.tailwindcss,\n\t)\n\n\tif (tailwindOptions) {\n\t\tconst { default: tailwindcss } = await importPeer(\n\t\t\tentry,\n\t\t\tpeers.tailwindcss,\n\t\t\t() => import('@tailwindcss/vite'),\n\t\t)\n\n\t\tresult.push(tailwindcss(tailwindOptions))\n\t}\n\n\tconst reactOptions = pluginOptions(pluginDefaults.react, plugins.react)\n\n\tif (reactOptions) {\n\t\tconst { default: viteReact } = await importPeer(\n\t\t\tentry,\n\t\t\tpeers.react,\n\t\t\t() => import('@vitejs/plugin-react'),\n\t\t)\n\n\t\tresult.push(viteReact(reactOptions))\n\t}\n\n\tconst compilerOptions = pluginOptions(\n\t\tpluginDefaults.reactCompiler,\n\t\tplugins.reactCompiler,\n\t)\n\n\tif (compilerOptions) {\n\t\t// Babel loads the compiler plugin by name, after this config resolves.\n\t\trequirePeer(entry, peers.reactCompiler)\n\n\t\tconst { reactCompilerPreset } = await importPeer(\n\t\t\tentry,\n\t\t\tpeers.react,\n\t\t\t() => import('@vitejs/plugin-react'),\n\t\t)\n\n\t\tconst { default: babel } = await importPeer(\n\t\t\tentry,\n\t\t\tpeers.babel,\n\t\t\t() => import('@rolldown/plugin-babel'),\n\t\t)\n\n\t\tresult.push(babel({ presets: [reactCompilerPreset(compilerOptions)] }))\n\t}\n\n\tconst varlockOptions = pluginOptions(pluginDefaults.varlock, plugins.varlock)\n\n\tif (varlockOptions) {\n\t\tconst { varlockVitePlugin } = await importPeer(\n\t\t\tentry,\n\t\t\tpeers.varlock,\n\t\t\t() => import('@varlock/vite-integration'),\n\t\t)\n\n\t\tresult.push(varlockVitePlugin(varlockOptions))\n\t}\n\n\treturn result\n}\n\nasync function testProjects(tests: TanstackTests) {\n\tconst projects = []\n\n\tif (tests.unit !== false) projects.push(unitProject(tests.unit))\n\n\tif (tests.server !== false) projects.push(serverProject(tests.server))\n\n\tif (tests.browser !== false) {\n\t\tprojects.push(\n\t\t\tawait browserProject(\n\t\t\t\tmergeOptions<ProjectOptions>(\n\t\t\t\t\t{ setupFiles: ['./src/styles.css'] },\n\t\t\t\t\ttests.browser,\n\t\t\t\t),\n\t\t\t),\n\t\t)\n\t}\n\n\treturn projects\n}\n\n// Pre-bundles the browser test stack at startup. Without it, Vite discovers\n// each dependency mid-run, and the re-optimization reload aborts the test\n// file that is loading.\nfunction browserTestDeps() {\n\tconst deps = ['vite-plus/test', 'vite-plus/test/browser']\n\n\tfor (const optional of ['vitest-browser-react', 'msw', 'msw/browser']) {\n\t\tif (canResolve(optional)) deps.push(optional)\n\t}\n\n\treturn deps\n}\n\n/** The complete Vite+ config for a TanStack Start app. */\nexport async function defineToolkit(\n\toptions: TanstackToolkitOptions = {},\n): Promise<UserConfig> {\n\tconst root = options.root ?? process.cwd()\n\tconst shadcn = options.shadcn !== false\n\tconst tests = options.tests ?? {}\n\n\t// Oxlint loads the shadcn rules by name when it lints.\n\tif (shadcn) requirePeer(entry, peers.shadcn)\n\n\tconst preset: UserConfig = {\n\t\troot,\n\t\tstaged: { '*': 'vp check --fix' },\n\t\tserver: { host: '127.0.0.1', port: Number(process.env.APP_PORT ?? 3000) },\n\t\t// TanStack Router ships RSC \"use client\" directives in its dist for RSC\n\t\t// compat. These apps build no RSC graph, so the bundling warnings are\n\t\t// noise.\n\t\tbuild: { rollupOptions: { checks: { moduleLevelDirective: false } } },\n\t\tresolve: {\n\t\t\ttsconfigPaths: true,\n\t\t\tdedupe: ['react', 'react-dom'],\n\t\t\talias: [\n\t\t\t\t{ find: '@', replacement: resolve(root, 'src') },\n\t\t\t\t{ find: '@tests', replacement: resolve(root, 'tests') },\n\t\t\t],\n\t\t},\n\t\tplugins: await tanstackPlugins(options.plugins ?? {}),\n\t\tfmt,\n\t\tlint: lint('react'),\n\t\ttest: {\n\t\t\t// Headless runs and screenshot baselines work with writes disabled.\n\t\t\t// allowWrite serves UI clients on the tailnet, which update snapshots\n\t\t\t// and baselines from the browser UI. Execution stays disabled.\n\t\t\tapi: { allowWrite: true, allowExec: false },\n\t\t\t// Test fixtures resolve app paths against this root, not the cwd.\n\t\t\tprovide: { [rootKey]: root },\n\t\t\tprojects: await testProjects(tests),\n\t\t},\n\t}\n\n\tif (tests.browser !== false) {\n\t\tpreset.optimizeDeps = { include: browserTestDeps() }\n\t}\n\n\tconst withShadcn = shadcn\n\t\t? mergeToolkitConfig(preset, { lint: shadcnLint })\n\t\t: preset\n\n\treturn mergeToolkitConfig(withShadcn, options.config)\n}\n"],"mappings":"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"}