webanvil 0.0.7 → 0.0.9

package/README.md

@@ -23,6 +23,7 @@ Table of contents
     - [Install](#install)
     - [Everyday commands](#everyday-commands)
     - [A web app](#a-web-app)
+    - [Storybook](#storybook)
     - [A Node project](#a-node-project)
 - [Configuration](#configuration)
     - [Tool selection](#tool-selection)
@@ -55,16 +56,17 @@ wa typecheck   # type-check the project
 What it includes
 ----------------
 
-| Project job                | WebAnvil command                   | Tool                             |
-| -------------------------- | ---------------------------------- | -------------------------------- |
-| Web builds and development | `wa build`, `wa dev`, `wa preview` | Vite                             |
-| Node builds and watch mode | `wa build`, `wa dev`               | Rolldown                         |
-| Tracked output cleanup     | `wa clean`                         | WebAnvil                         |
-| Static checks              | `wa check`                         | Oxfmt, Oxlint, TypeScript Native |
-| Tests                      | `wa test`                          | Vitest                           |
-| Linting                    | `wa lint`                          | Oxlint                           |
-| Formatting                 | `wa format`                        | Oxfmt                            |
-| Type checking              | `wa typecheck`                     | TypeScript Native                |
+| Project job                | WebAnvil command                                       | Tool                             |
+| -------------------------- | ------------------------------------------------------ | -------------------------------- |
+| Web builds and development | `wa build`, `wa dev`, `wa preview`                     | Vite                             |
+| Node builds and watch mode | `wa build`, `wa dev`                                   | Rolldown                         |
+| Storybook development      | `wa build --mode storybook`, `wa dev --mode storybook` | Storybook                        |
+| Tracked output cleanup     | `wa clean`                                             | WebAnvil                         |
+| Static checks              | `wa check`                                             | Oxfmt, Oxlint, TypeScript Native |
+| Tests                      | `wa test`                                              | Vitest                           |
+| Linting                    | `wa lint`                                              | Oxlint                           |
+| Formatting                 | `wa format`                                            | Oxfmt                            |
+| Type checking              | `wa typecheck`                                         | TypeScript Native                |
 
 Getting started
 ---------------
@@ -151,6 +153,53 @@ export default defineConfig({
 })
 ```
 
+### Storybook
+
+WebAnvil includes Storybook, the supported Vite framework adapters, Vitest's
+browser support, and Chromium. Add only a Storybook configuration and your
+project's normal framework dependencies.
+
+For example, a Svelte project can use this `.storybook/main.ts`:
+
+```ts
+import { framework, type StorybookConfig } from "webanvil/storybook/svelte"
+
+export default {
+    framework,
+    stories: ["../src/**/*.stories.@(js|ts|svelte)"]
+} satisfies StorybookConfig
+```
+
+Use `webanvil/storybook/react`, `webanvil/storybook/vue`, or
+`webanvil/storybook/web-components` for those frameworks. The WebAnvil wrapper
+uses the framework plugins already declared in `webanvil.config.*`.
+
+Set Storybook as the project's build mode when it is the primary development
+target:
+
+```ts
+import { defineConfig } from "webanvil"
+
+export default defineConfig({
+    build: { mode: "storybook" }
+})
+```
+
+Or select it for one command:
+
+```sh
+wa dev --mode storybook
+wa build --mode storybook
+```
+
+The build writes to `storybook-static` unless `storybook.outDir` in
+`webanvil.config.*` or `--out-dir` selects another directory. `wa test`
+automatically runs Storybook stories, including `play` functions, when it finds
+`.storybook/main.*`. Set `storybook.test: false` to exclude them. Chromium is
+downloaded by `@playwright/browser-chromium` when your package manager runs
+install scripts. If the project declares Vitest, Storybook tests require
+version `4.1.10` to match the bundled browser provider.
+
 ### A Node project
 
 Node mode is the default. Declare the package's public roots with `entry` or
@@ -268,6 +317,15 @@ export default defineConfig({
 })
 ```
 
+For a new WebAnvil project, keep Oxfmt and Oxlint settings in the `format` and
+`lint` blocks. `wa format`, `wa lint`, and `wa check` pass those options to the
+matching Oxc tool, so you do not need to create `.oxfmtrc.json` or
+`.oxlintrc.json`.
+
+Keep a native Oxc config when you are adopting an existing project configuration
+or need Oxc's native configuration lookup. A native Oxc config takes precedence
+over the matching WebAnvil block.
+
 ### Tool selection
 
 WebAnvil selects compatible project and workspace declarations before its own
@@ -280,6 +338,7 @@ invalid package identity, or is outside the supported range fails first.
 | -------------------------- | ------------------------------------ | ----------------------- |
 | Vite                       | `>=8.1.5 <9`                         | `8.1.5`                 |
 | Vitest                     | `>=4.1.10 <5`                        | `4.1.10`                |
+| Storybook                  | `>=10.5.9 <11`                       | `10.5.9`                |
 | Rolldown                   | `>=1.2.0 <2`                         | `1.2.0`                 |
 | Oxlint                     | `>=1.75.0 <2`                        | `1.75.0`                |
 | Oxfmt                      | `>=0.60.0 <0.61`                     | `0.60.0`                |
@@ -470,17 +529,17 @@ Your existing configuration stays in charge. A `vite.config.*` or
 `.oxfmtrc.json` and `.oxlintrc.json` do the same for Oxc. Explicit CLI values
 remain the final run-specific override.
 
-That lets a project standardize on `wa` now and move settings into `webanvil.config.ts` later, one part at a time. Start with a build entry when it makes sense, then bring over test, lint, or format settings as you touch them.
+That lets a project standardize on `wa` now and move settings into `webanvil.config.ts` later, one part at a time. New WebAnvil projects should keep Oxfmt and Oxlint settings in the `format` and `lint` blocks; move existing native Oxc configuration there when it makes sense.
 
 Command reference
 -----------------
 
 | Command                   | Description                                                           | Options                                                                                                                                                           |
 | ------------------------- | --------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `wa build [entry]`        | Builds with Vite in web mode or Rolldown in Node mode.                | `--mode`, `--out-dir`, `--copy`, `--bundle`, `--no-bundle`, `--formats`, `--declaration`, `--sourcemap`, `--minify`, `--platform`, `--target`                     |
+| `wa build [entry]`        | Builds with Vite in web mode, Rolldown in Node mode, or Storybook.    | `--mode`, `--out-dir`, `--copy`, `--bundle`, `--no-bundle`, `--formats`, `--declaration`, `--sourcemap`, `--minify`, `--platform`, `--target`                     |
 | `wa clean`                | Removes files emitted by prior WebAnvil builds.                       | No options                                                                                                                                                        |
 | `wa check`                | Checks formatting, linting, and types, stopping on the first failure. | `--fix`                                                                                                                                                           |
-| `wa dev [entry]`          | Starts a Vite server or a full Node build watcher.                    | `--mode`, `--out-dir`, `--host`, `--port`, `--copy`, `--bundle`, `--no-bundle`, `--formats`, `--declaration`, `--sourcemap`, `--minify`, `--platform`, `--target` |
+| `wa dev [entry]`          | Starts Vite, a Node build watcher, or Storybook.                      | `--mode`, `--out-dir`, `--host`, `--port`, `--copy`, `--bundle`, `--no-bundle`, `--formats`, `--declaration`, `--sourcemap`, `--minify`, `--platform`, `--target` |
 | `wa preview`              | Serves a Vite production build.                                       | `--out-dir`, `--host`, `--port`, `--open`                                                                                                                         |
 | `wa test [filters...]`    | Runs Vitest once, in watch mode, with coverage, or UI.                | `--environment`, `--watch`, `--coverage`, `--ui`, `--ui-port`                                                                                                     |
 | `wa lint [paths...]`      | Runs Oxlint and treats warnings as failures.                          | `--fix`                                                                                                                                                           |

package/dist/_chunks/commands.mjs

@@ -1,10 +1,9 @@
+import { assertSyntaxTarget, loadConfig, resolveEffectiveBuildConfig, resolveRolldownPlugins, resolveVitePlugins, syntaxTargetSchema, withConfig } from "./config.mjs";
 import { Module, createRequire, isBuiltin } from "node:module";
 import { defineArgument, defineCommand, defineOption } from "cmdore";
 import { dirname, isAbsolute, join, relative, resolve } from "pathe";
 import { glob } from "tinyglobby";
 import { access, copyFile, lstat, mkdir, mkdtemp, readFile, readdir, realpath, rename, rm, rmdir, writeFile } from "node:fs/promises";
-import { loadConfig } from "c12";
-import { defu } from "defu";
 import { z } from "zod";
 import { dirname as dirname$1, isAbsolute as isAbsolute$1, join as join$1, relative as relative$1, resolve as resolve$1 } from "node:path";
 import { getTsconfig, readTsconfig } from "get-tsconfig";
@@ -13,9 +12,11 @@ import { fileURLToPath, pathToFileURL } from "node:url";
 import { resolvePath } from "mlly";
 import { parse } from "yaml";
 import { resolvePackageJSON } from "pkg-types";
+import { execa } from "execa";
+import { playwright } from "@vitest/browser-playwright";
+import { storybookTest } from "@storybook/addon-vitest/vitest-plugin";
 import { consola } from "consola";
 import { randomUUID } from "node:crypto";
-import { execa } from "execa";
 const entry = defineArgument({
 	name: "entry",
 	description: "Web entry or Node public root; unbundled Node builds emit its reachable graph with preserveModules."
@@ -43,131 +44,16 @@ const hasToolConfig = async (name, cwd = process.cwd()) => {
 	].some((extension) => files.includes(`${name}.config.${extension}`));
 };
 const hasOxcConfig = (name, cwd = process.cwd()) => hasFile(join(cwd, name === "oxfmt" ? ".oxfmtrc.json" : ".oxlintrc.json"));
-const NODE_PLUGIN_ERROR = "Node builds require plugins created with definePlugin()";
-const definePlugin = (plugin, options) => ({
-	rolldown: () => plugin.rolldown(options),
-	vite: () => plugin.vite(options)
-});
-const isUnpluginAdapter = (plugin) => typeof plugin === "object" && plugin !== null && "rolldown" in plugin && typeof plugin.rolldown === "function" && "vite" in plugin && typeof plugin.vite === "function";
-const isWebAnvilPlugin = (plugin) => Array.isArray(plugin) || typeof plugin === "function" || typeof plugin === "object" && plugin !== null && "name" in plugin || isUnpluginAdapter(plugin);
-const resolveRolldownPlugins = (plugins) => plugins.flatMap((plugin) => {
-	if (!isUnpluginAdapter(plugin)) throw new Error(NODE_PLUGIN_ERROR);
-	return plugin.rolldown();
-});
-const resolveVitePlugins = (plugins) => plugins.map((plugin) => isUnpluginAdapter(plugin) ? plugin.vite() : plugin);
-const copyMappingSchema = z.strictObject({
-	from: z.string().min(1),
-	to: z.string().min(1)
-});
-const legacyPlatformTarget = (target) => (typeof target === "string" ? [target] : target).find((value) => value === "browser" || value === "neutral");
-const assertSyntaxTarget = (target) => {
-	if (target === void 0) return;
-	const legacy = legacyPlatformTarget(target);
-	if (legacy !== void 0) throw new Error(`build.target no longer selects a platform; use build.platform: "${legacy}" instead`);
-};
-const syntaxTargetSchema = z.union([z.string().min(1), z.array(z.string().min(1)).min(1)]).superRefine((target, context) => {
-	const legacy = legacyPlatformTarget(target);
-	if (legacy !== void 0) context.addIssue({
-		code: "custom",
-		message: `build.target no longer selects a platform; use build.platform: "${legacy}" instead`
-	});
-});
-const nativeConfigSchema = () => z.custom((value) => typeof value === "object" && value !== null && !Array.isArray(value), "Expected a configuration object");
-const buildConfigSchema = z.strictObject({
-	bundle: z.boolean().optional(),
-	mode: z.enum(["web", "node"]).optional(),
-	entry: z.string().min(1).optional(),
-	entries: z.record(z.string().min(1), z.string().min(1)).optional(),
-	outDir: z.string().min(1).optional(),
-	declaration: z.union([z.boolean(), nativeConfigSchema()]).optional(),
-	sourcemap: z.boolean().optional(),
-	minify: z.boolean().optional(),
-	copy: z.array(copyMappingSchema).optional(),
-	formats: z.array(z.enum(["esm", "cjs"])).min(1).optional(),
-	platform: z.enum([
-		"node",
-		"browser",
-		"neutral"
-	]).optional(),
-	target: syntaxTargetSchema.optional()
-});
-const formatConfigSchema = nativeConfigSchema();
-const lintConfigSchema = nativeConfigSchema();
-const rolldownConfigSchema = nativeConfigSchema();
-const testConfigSchema = nativeConfigSchema();
-const viteConfigSchema = nativeConfigSchema();
-const pluginSchema = z.custom(isWebAnvilPlugin, "Expected a Vite plugin or a WebAnvil plugin created with definePlugin()");
-const userConfigSchema = z.strictObject({
-	build: buildConfigSchema.optional(),
-	format: formatConfigSchema.optional(),
-	lint: lintConfigSchema.optional(),
-	rolldown: rolldownConfigSchema.optional(),
-	test: testConfigSchema.optional(),
-	vite: viteConfigSchema.optional(),
-	plugins: z.array(pluginSchema).optional()
-});
-const effectiveUserConfigSchema = userConfigSchema.superRefine((config, context) => {
-	const build = config.build ?? {};
-	if (build.entries !== void 0 && build.mode !== "node") context.addIssue({
-		code: "custom",
-		path: ["build", "entries"],
-		message: "build.entries is only available in Node mode"
-	});
-	if (build.mode === "web" && build.platform !== void 0) context.addIssue({
-		code: "custom",
-		path: ["build", "platform"],
-		message: "Web builds do not accept build.platform"
-	});
-	if (build.mode === "node") {
-		for (const [index, plugin] of (config.plugins ?? []).entries()) if (!isUnpluginAdapter(plugin)) context.addIssue({
-			code: "custom",
-			path: ["plugins", index],
-			message: NODE_PLUGIN_ERROR
-		});
-	}
-});
-const defaultConfig = {
-	build: {
-		mode: "node",
-		entry: "src/index.ts",
-		outDir: "dist"
-	},
-	test: { environment: "node" }
-};
-const toCommandArguments = (config) => Object.fromEntries(Object.entries(config).filter(([, value]) => value !== void 0).map(([key, value]) => [key.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`), value]));
-const defined = (arguments_) => Object.fromEntries(Object.entries(arguments_).filter(([, value]) => value !== void 0));
-const defineConfig = (config) => config;
-const loadConfig$1 = async (cwd = process.cwd()) => {
-	const { config, configFile } = await loadConfig({
-		name: "webanvil",
-		cwd,
-		configFile: "webanvil.config",
-		packageJson: false,
-		rcFile: false
-	});
-	return {
-		config: userConfigSchema.parse(defu(config, defaultConfig)),
-		configFile
-	};
-};
-const resolveEffectiveBuildConfig = (config, overrides, explicitEntry) => {
-	const build = {
-		...config.build,
-		...defined(overrides)
-	};
-	if (explicitEntry) delete build.entries;
-	return effectiveUserConfigSchema.parse({
-		...config,
-		build
-	}).build ?? {};
-};
-const withConfig = (select, run) => async (arguments_) => {
-	const { config } = await loadConfig$1();
-	const selectedConfig = select(config) ?? {};
-	return run({
-		...toCommandArguments(selectedConfig),
-		...defined(arguments_)
-	}, selectedConfig, config, arguments_);
+const hasStorybookConfig = async (configDir = ".storybook", cwd = process.cwd()) => {
+	const files = await readdir(resolve(cwd, configDir)).catch(() => []);
+	return [
+		"js",
+		"mjs",
+		"cjs",
+		"ts",
+		"mts",
+		"cts"
+	].some((extension) => files.includes(`main.${extension}`));
 };
 const path = (cwd) => resolve(cwd, ".webanvil", "buildinfo.json");
 const relativeOutput = (file, cwd) => {
@@ -241,6 +127,11 @@ const supportedTools = {
 		packageName: "vitest",
 		range: ">=4.1.10 <5"
 	},
+	storybook: {
+		packageName: "storybook",
+		range: ">=10.5.9 <11",
+		bin: "storybook"
+	},
 	rolldown: {
 		packageName: "rolldown",
 		range: ">=1.2.0 <2"
@@ -1217,6 +1108,52 @@ const useToolExecutable = async (name, toolchain = new Toolchain(process.cwd()))
 	if (tool.executable === void 0) throw new Error(`${tool.packageName} does not expose an executable`);
 	return tool.executable;
 };
+const storybookVitestVersion = "4.1.10";
+const storybookOutputDir = (config = {}, options = {}) => options.outDir ?? config.outDir ?? "storybook-static";
+const exitWithError = (action, exitCode) => {
+	throw new Error(`storybook ${action} exited with code ${exitCode ?? "unknown"}`);
+};
+const runStorybook = async (action, config = {}, options = {}, toolchain = new Toolchain(process.cwd())) => {
+	const executable = await useToolExecutable("storybook", toolchain);
+	const configDir = options.configDir ?? config.configDir;
+	const outDir = storybookOutputDir(config, options);
+	const result = await execa(executable, [
+		action,
+		...configDir === void 0 ? [] : ["--config-dir", configDir],
+		...action === "dev" && options.host !== void 0 ? ["--host", options.host] : [],
+		...action === "dev" && options.port !== void 0 ? ["--port", String(options.port)] : [],
+		...action === "build" ? ["--output-dir", outDir] : []
+	], {
+		reject: false,
+		stdio: "inherit"
+	});
+	if (result.exitCode !== 0) exitWithError(action, result.exitCode);
+};
+const createStorybookTestProject = async (config = {}, vitestVersion = storybookVitestVersion) => {
+	if (vitestVersion !== storybookVitestVersion) throw new Error(`Storybook tests require Vitest ${storybookVitestVersion}; Webanvil bundles @vitest/browser-playwright ${storybookVitestVersion}`);
+	const previousVitest = process.env.VITEST;
+	process.env.VITEST = "true";
+	let plugins;
+	try {
+		plugins = await storybookTest({ configDir: config.configDir });
+	} finally {
+		if (previousVitest === void 0) delete process.env.VITEST;
+		else process.env.VITEST = previousVitest;
+	}
+	return {
+		extends: true,
+		plugins,
+		test: {
+			name: "storybook",
+			browser: {
+				enabled: true,
+				headless: true,
+				provider: playwright(),
+				instances: [{ browser: "chromium" }]
+			}
+		}
+	};
+};
 const bundle = defineOption({
 	name: "bundle",
 	description: "Bundle the Node public roots; without it, emit their reachable graph with preserveModules.",
@@ -1280,9 +1217,13 @@ const minify = defineOption({
 });
 const mode = defineOption({
 	name: "mode",
-	description: "Build mode: web uses Vite and node uses Rolldown.",
+	description: "Build mode: web uses Vite, node uses Rolldown, and storybook runs Storybook.",
 	arity: 1,
-	schema: z.enum(["web", "node"])
+	schema: z.enum([
+		"web",
+		"node",
+		"storybook"
+	])
 });
 const open = defineOption({
 	name: "open",
@@ -1346,6 +1287,24 @@ const noBundle$1 = defineOption({
 	description: "Emit the reachable Node graph with preserveModules, overriding configuration that enables bundling.",
 	arity: 0
 });
+const assertStorybookArguments$1 = (explicit) => {
+	const option = [
+		"bundle",
+		"copy",
+		"declaration",
+		"entry",
+		"formats",
+		"minify",
+		"no-bundle",
+		"platform",
+		"sourcemap",
+		"target"
+	].find((name) => {
+		const value = explicit[name];
+		return name === "bundle" || name === "no-bundle" ? value === true : value !== void 0;
+	});
+	if (option !== void 0) throw new Error(`--${option} is not available in Storybook mode`);
+};
 const outputFiles = (result, outDir) => {
 	if ("on" in result) throw new Error("Web builds cannot use watch mode");
 	return (Array.isArray(result) ? result : [result]).flatMap((output) => output.output.map((file) => resolve(outDir, file.fileName)));
@@ -1422,6 +1381,21 @@ build.publicOutputFiles = async ({ outDir, publicDir }) => publicDir ? (await gl
 })).map((file) => resolve(outDir, file)) : [];
 build.web = async (web) => [...outputFiles(await web.vite.build(web.config), web.outDir), ...await build.publicOutputFiles(web)];
 const commandRun$1 = (toolchain) => withConfig((config) => config.build, ({ copy, declaration, formats, minify, mode, entry, "out-dir": outDir, platform, sourcemap, target }, buildConfig, resolvedConfig, explicit) => {
+	if (mode === "storybook") {
+		assertStorybookArguments$1(explicit);
+		const storybookOptions = { outDir: explicit["out-dir"] === void 0 ? void 0 : outDir };
+		const outputDirectory = storybookOutputDir(resolvedConfig.storybook, storybookOptions);
+		return (async () => {
+			const existing = await removeOutputsIn(outputDirectory);
+			await runStorybook("build", resolvedConfig.storybook, storybookOptions, toolchain);
+			const output = await glob("**/*", {
+				cwd: resolve(process.cwd(), outputDirectory),
+				dot: true,
+				onlyFiles: true
+			});
+			await writeBuildInfo([...existing.output, ...output.map((file) => resolve(outputDirectory, file))]);
+		})();
+	}
 	if (explicit.bundle && explicit["no-bundle"]) throw new Error("--bundle and --no-bundle cannot be used together");
 	const effective = resolveEffectiveBuildConfig(resolvedConfig, {
 		bundle: explicit["no-bundle"] ? false : explicit.bundle ? true : buildConfig.bundle,
@@ -1437,7 +1411,9 @@ const commandRun$1 = (toolchain) => withConfig((config) => config.build, ({ copy
 		sourcemap,
 		target
 	}, explicit.entry !== void 0);
-	return build(effective.mode, effective.entry, effective.outDir, effective, resolvedConfig.plugins ?? [], resolvedConfig.vite, resolvedConfig.rolldown, toolchain, {
+	const executableMode = effective.mode;
+	if (executableMode !== "web" && executableMode !== "node") throw new Error("Expected a web or Node build mode");
+	return build(executableMode, effective.entry, effective.outDir, effective, resolvedConfig.plugins ?? [], resolvedConfig.vite, resolvedConfig.rolldown, toolchain, {
 		...explicit.entry === void 0 ? {} : { entry },
 		...explicit["out-dir"] === void 0 ? {} : { outDir },
 		...explicit.minify === void 0 ? {} : { minify },
@@ -1462,9 +1438,12 @@ var build_default = defineCommand({
 		target
 	],
 	run: async (arguments_) => {
+		const config = arguments_.mode === void 0 ? (await loadConfig()).config : void 0;
+		const selectedMode = arguments_.mode ?? config?.build?.mode;
 		const toolchain = new Toolchain(process.cwd());
-		await Promise.all([toolchain.resolve("vite"), toolchain.resolve("rolldown")]);
-		return commandRun$1(toolchain)(arguments_);
+		if (selectedMode === "storybook") await toolchain.resolve("storybook");
+		else await Promise.all([toolchain.resolve("vite"), toolchain.resolve("rolldown")]);
+		return commandRun$1(toolchain)(arguments_, config);
 	}
 });
 const rebasePath = (path, cwd, configDirectory) => {
@@ -1621,7 +1600,7 @@ var check_default = defineCommand({
 			useTool("oxlint"),
 			useTool("typescript-native")
 		]);
-		const { config } = await loadConfig$1();
+		const { config } = await loadConfig();
 		await checkProject(fix, config);
 	}
 });
@@ -1649,6 +1628,25 @@ const noBundle = defineOption({
 	description: "Emit the reachable Node graph with preserveModules, overriding configuration that enables bundling.",
 	arity: 0
 });
+const assertStorybookArguments = (explicit) => {
+	const option = [
+		"bundle",
+		"copy",
+		"declaration",
+		"entry",
+		"formats",
+		"minify",
+		"no-bundle",
+		"out-dir",
+		"platform",
+		"sourcemap",
+		"target"
+	].find((name) => {
+		const value = explicit[name];
+		return name === "bundle" || name === "no-bundle" ? value === true : value !== void 0;
+	});
+	if (option !== void 0) throw new Error(`--${option} is not available in Storybook mode`);
+};
 const dev = async (mode, entry, outDir, host, port, plugins = [], options = {}, viteConfig = {}, rolldownConfig = {}, toolchain = new Toolchain(process.cwd())) => {
 	assertSyntaxTarget(options.target);
 	if (mode === "web" && options.platform !== void 0) throw new Error("Web development does not accept platform; platform applies only to Node builds");
@@ -1721,6 +1719,13 @@ dev.node = async (entry, outDir, plugins = [], waitForTermination = untilTermina
 	}
 };
 const commandRun = (toolchain) => withConfig((config) => config.build, ({ copy, declaration, formats, minify, mode, entry, "out-dir": outDir, host, platform, port, sourcemap, target }, buildConfig, resolvedConfig, explicit) => {
+	if (mode === "storybook") {
+		assertStorybookArguments(explicit);
+		return runStorybook("dev", resolvedConfig.storybook, {
+			host,
+			port
+		}, toolchain);
+	}
 	if (explicit.bundle && explicit["no-bundle"]) throw new Error("--bundle and --no-bundle cannot be used together");
 	const effective = resolveEffectiveBuildConfig(resolvedConfig, {
 		bundle: explicit["no-bundle"] ? false : explicit.bundle ? true : buildConfig.bundle,
@@ -1736,7 +1741,9 @@ const commandRun = (toolchain) => withConfig((config) => config.build, ({ copy,
 		sourcemap,
 		target
 	}, explicit.entry !== void 0);
-	return dev(effective.mode, effective.entry, effective.outDir, host, port, resolvedConfig.plugins ?? [], effective, resolvedConfig.vite, resolvedConfig.rolldown, toolchain);
+	const executableMode = effective.mode;
+	if (executableMode !== "web" && executableMode !== "node") throw new Error("Expected a web or Node build mode");
+	return dev(executableMode, effective.entry, effective.outDir, host, port, resolvedConfig.plugins ?? [], effective, resolvedConfig.vite, resolvedConfig.rolldown, toolchain);
 });
 var dev_default = defineCommand({
 	name: "dev",
@@ -1757,9 +1764,12 @@ var dev_default = defineCommand({
 		target
 	],
 	run: async (arguments_) => {
+		const config = arguments_.mode === void 0 ? (await loadConfig()).config : void 0;
+		const selectedMode = arguments_.mode ?? config?.build?.mode;
 		const toolchain = new Toolchain(process.cwd());
-		await Promise.all([toolchain.resolve("vite"), toolchain.resolve("rolldown")]);
-		return commandRun(toolchain)(arguments_);
+		if (selectedMode === "storybook") await toolchain.resolve("storybook");
+		else await Promise.all([toolchain.resolve("vite"), toolchain.resolve("rolldown")]);
+		return commandRun(toolchain)(arguments_, config);
 	}
 });
 const preview = async (outDir, host, port, useOutDir = false, waitForTermination = untilTerminated, openBrowser, viteConfig = {}) => {
@@ -1797,20 +1807,22 @@ var preview_default = defineCommand({
 	],
 	run: async ({ "out-dir": outDir, host, port, open }) => {
 		await useTool("vite");
-		const { config } = await loadConfig$1();
+		const { config } = await loadConfig();
 		return preview(outDir ?? config.build?.outDir ?? "dist", host, port, outDir !== void 0, untilTerminated, open, config.vite);
 	}
 });
-const test = async (filters, config = {}, options = {}, waitForTermination = untilTerminated) => {
+const test = async (filters, config = {}, options = {}, waitForTermination = untilTerminated, storybook = {}) => {
 	if (options.uiPort !== void 0 && options.ui !== true) throw new Error("--ui-port requires --ui");
 	logger.start("Running tests");
 	const hasVitestConfig = await hasToolConfig("vitest");
 	const persistent = options.watch === true || options.ui === true;
-	const { startVitest } = await useToolApi("vitest", "node");
+	const vitestTool = await useTool("vitest");
+	const { startVitest } = await vitestTool.import("node");
 	const nativeConfig = hasVitestConfig ? {} : config;
 	const nativeCoverage = typeof nativeConfig.coverage === "object" && nativeConfig.coverage !== null ? nativeConfig.coverage : {};
 	const nativeApi = typeof nativeConfig.api === "object" && nativeConfig.api !== null ? nativeConfig.api : {};
-	const vitest = await startVitest("test", filters, {
+	const storybookProject = storybook.test === false || !await hasStorybookConfig(storybook.configDir) ? void 0 : await createStorybookTestProject(storybook, vitestTool.version);
+	const vitestOptions = {
 		...nativeConfig,
 		passWithNoTests: true,
 		run: !persistent,
@@ -1828,27 +1840,38 @@ const test = async (filters, config = {}, options = {}, waitForTermination = unt
 			port: options.uiPort,
 			strictPort: true
 		} }
-	});
+	};
+	const vitests = hasVitestConfig && storybookProject !== void 0 ? [await startVitest("test", filters, vitestOptions), await startVitest("test", filters, {
+		...vitestOptions,
+		...options.ui ? {
+			api: false,
+			ui: false
+		} : {},
+		projects: [storybookProject]
+	})] : [await startVitest("test", filters, {
+		...vitestOptions,
+		...storybookProject === void 0 ? {} : { projects: [...nativeConfig.projects ?? [], storybookProject] }
+	})];
 	if (persistent) {
 		try {
 			await waitForTermination();
 		} finally {
-			await vitest.close();
+			await Promise.all(vitests.map((vitest) => vitest.close()));
 		}
 		return;
 	}
-	const failed = vitest.state.getFiles().some((file) => file.result?.state === "fail") || vitest.state.getUnhandledErrors().length > 0;
-	await vitest.close();
+	const failed = vitests.some((vitest) => vitest.state.getFiles().some((file) => file.result?.state === "fail") || vitest.state.getUnhandledErrors().length > 0);
+	await Promise.all(vitests.map((vitest) => vitest.close()));
 	if (failed) throw new Error("Tests failed");
 	logger.success("Tests passed");
 };
-const runTest = withConfig((config) => config.test, ({ filters, environment, coverage, ui, "ui-port": uiPort, watch }, config, _resolvedConfig, explicitArguments) => test(filters, config, {
+const runTest = withConfig((config) => config.test, ({ filters, environment, coverage, ui, "ui-port": uiPort, watch }, config, resolvedConfig, explicitArguments) => test(filters, config, {
 	coverage,
 	environment: explicitArguments.environment === void 0 ? void 0 : environment,
 	ui,
 	uiPort,
 	watch
-}));
+}, untilTerminated, resolvedConfig.storybook));
 var test_default = defineCommand({
 	name: "test",
 	arguments: [filters],
@@ -1864,4 +1887,4 @@ var test_default = defineCommand({
 		return runTest(arguments_);
 	}
 });
-export { assertSyntaxTarget, build, buildConfigSchema, build_default, bundle, check, checkProject, check_default, clean, clean_default, copy, copyMappingSchema, coverage, declaration, defaultConfig, defineConfig, definePlugin, dev, dev_default, effectiveUserConfigSchema, entry, environment, filters, fix$1 as fix, format, formatConfigSchema, format_default, formats, host, isUnpluginAdapter, isWebAnvilPlugin, lint, lintConfigSchema, lint_default, loadConfig$1 as loadConfig, logger, minify, mode, open, outDir, paths, platform, port, preview, preview_default, resolveEffectiveBuildConfig, resolveRolldownPlugins, resolveVitePlugins, rolldownConfigSchema, sourcemap, syntaxTargetSchema, target, test, testConfigSchema, test_default, typecheck, typecheck_default, ui, uiPort, userConfigSchema, viteConfigSchema, watch, withConfig };
+export { build, build_default, bundle, check, checkProject, check_default, clean, clean_default, copy, coverage, declaration, dev, dev_default, entry, environment, filters, fix$1 as fix, format, format_default, formats, host, lint, lint_default, logger, minify, mode, open, outDir, paths, platform, port, preview, preview_default, sourcemap, target, test, test_default, typecheck, typecheck_default, ui, uiPort, watch };

package/dist/_chunks/config.mjs

@@ -0,0 +1,140 @@
+import { loadConfig } from "c12";
+import { defu } from "defu";
+import { z } from "zod";
+const NODE_PLUGIN_ERROR = "Node builds require plugins created with definePlugin()";
+const definePlugin = (plugin, options) => ({
+	rolldown: () => plugin.rolldown(options),
+	vite: () => plugin.vite(options)
+});
+const isUnpluginAdapter = (plugin) => typeof plugin === "object" && plugin !== null && "rolldown" in plugin && typeof plugin.rolldown === "function" && "vite" in plugin && typeof plugin.vite === "function";
+const isWebAnvilPlugin = (plugin) => Array.isArray(plugin) || typeof plugin === "function" || typeof plugin === "object" && plugin !== null && "name" in plugin || isUnpluginAdapter(plugin);
+const resolveRolldownPlugins = (plugins) => plugins.flatMap((plugin) => {
+	if (!isUnpluginAdapter(plugin)) throw new Error(NODE_PLUGIN_ERROR);
+	return plugin.rolldown();
+});
+const resolveVitePlugins = (plugins) => plugins.map((plugin) => isUnpluginAdapter(plugin) ? plugin.vite() : plugin);
+const copyMappingSchema = z.strictObject({
+	from: z.string().min(1),
+	to: z.string().min(1)
+});
+const legacyPlatformTarget = (target) => (typeof target === "string" ? [target] : target).find((value) => value === "browser" || value === "neutral");
+const assertSyntaxTarget = (target) => {
+	if (target === void 0) return;
+	const legacy = legacyPlatformTarget(target);
+	if (legacy !== void 0) throw new Error(`build.target no longer selects a platform; use build.platform: "${legacy}" instead`);
+};
+const syntaxTargetSchema = z.union([z.string().min(1), z.array(z.string().min(1)).min(1)]).superRefine((target, context) => {
+	const legacy = legacyPlatformTarget(target);
+	if (legacy !== void 0) context.addIssue({
+		code: "custom",
+		message: `build.target no longer selects a platform; use build.platform: "${legacy}" instead`
+	});
+});
+const nativeConfigSchema = () => z.custom((value) => typeof value === "object" && value !== null && !Array.isArray(value), "Expected a configuration object");
+const buildConfigSchema = z.strictObject({
+	bundle: z.boolean().optional(),
+	mode: z.enum([
+		"web",
+		"node",
+		"storybook"
+	]).optional(),
+	entry: z.string().min(1).optional(),
+	entries: z.record(z.string().min(1), z.string().min(1)).optional(),
+	outDir: z.string().min(1).optional(),
+	declaration: z.union([z.boolean(), nativeConfigSchema()]).optional(),
+	sourcemap: z.boolean().optional(),
+	minify: z.boolean().optional(),
+	copy: z.array(copyMappingSchema).optional(),
+	formats: z.array(z.enum(["esm", "cjs"])).min(1).optional(),
+	platform: z.enum([
+		"node",
+		"browser",
+		"neutral"
+	]).optional(),
+	target: syntaxTargetSchema.optional()
+});
+const formatConfigSchema = nativeConfigSchema();
+const lintConfigSchema = nativeConfigSchema();
+const rolldownConfigSchema = nativeConfigSchema();
+const testConfigSchema = nativeConfigSchema();
+const viteConfigSchema = nativeConfigSchema();
+const storybookConfigSchema = z.strictObject({
+	configDir: z.string().min(1).optional(),
+	outDir: z.string().min(1).optional(),
+	test: z.boolean().optional()
+});
+const pluginSchema = z.custom(isWebAnvilPlugin, "Expected a Vite plugin or a WebAnvil plugin created with definePlugin()");
+const userConfigSchema = z.strictObject({
+	build: buildConfigSchema.optional(),
+	format: formatConfigSchema.optional(),
+	lint: lintConfigSchema.optional(),
+	rolldown: rolldownConfigSchema.optional(),
+	storybook: storybookConfigSchema.optional(),
+	test: testConfigSchema.optional(),
+	vite: viteConfigSchema.optional(),
+	plugins: z.array(pluginSchema).optional()
+});
+const effectiveUserConfigSchema = userConfigSchema.superRefine((config, context) => {
+	const build = config.build ?? {};
+	if (build.entries !== void 0 && build.mode !== "node") context.addIssue({
+		code: "custom",
+		path: ["build", "entries"],
+		message: "build.entries is only available in Node mode"
+	});
+	if (build.mode === "web" && build.platform !== void 0) context.addIssue({
+		code: "custom",
+		path: ["build", "platform"],
+		message: "Web builds do not accept build.platform"
+	});
+	if (build.mode === "node") {
+		for (const [index, plugin] of (config.plugins ?? []).entries()) if (!isUnpluginAdapter(plugin)) context.addIssue({
+			code: "custom",
+			path: ["plugins", index],
+			message: NODE_PLUGIN_ERROR
+		});
+	}
+});
+const defaultConfig = {
+	build: {
+		mode: "node",
+		entry: "src/index.ts",
+		outDir: "dist"
+	},
+	test: { environment: "node" }
+};
+const toCommandArguments = (config) => Object.fromEntries(Object.entries(config).filter(([, value]) => value !== void 0).map(([key, value]) => [key.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`), value]));
+const defined = (arguments_) => Object.fromEntries(Object.entries(arguments_).filter(([, value]) => value !== void 0));
+const defineConfig = (config) => config;
+const loadConfig$1 = async (cwd = process.cwd()) => {
+	const { config, configFile } = await loadConfig({
+		name: "webanvil",
+		cwd,
+		configFile: "webanvil.config",
+		packageJson: false,
+		rcFile: false
+	});
+	return {
+		config: userConfigSchema.parse(defu(config, defaultConfig)),
+		configFile
+	};
+};
+const resolveEffectiveBuildConfig = (config, overrides, explicitEntry) => {
+	const build = {
+		...config.build,
+		...defined(overrides)
+	};
+	if (explicitEntry) delete build.entries;
+	return effectiveUserConfigSchema.parse({
+		...config,
+		build
+	}).build ?? {};
+};
+const withConfig = (select, run) => async (arguments_, resolvedConfig) => {
+	const config = resolvedConfig ?? (await loadConfig$1()).config;
+	const selectedConfig = select(config) ?? {};
+	return run({
+		...toCommandArguments(selectedConfig),
+		...defined(arguments_)
+	}, selectedConfig, config, arguments_);
+};
+export { assertSyntaxTarget, buildConfigSchema, copyMappingSchema, defaultConfig, defineConfig, definePlugin, effectiveUserConfigSchema, formatConfigSchema, isUnpluginAdapter, isWebAnvilPlugin, lintConfigSchema, loadConfig$1 as loadConfig, resolveEffectiveBuildConfig, resolveRolldownPlugins, resolveVitePlugins, rolldownConfigSchema, storybookConfigSchema, syntaxTargetSchema, testConfigSchema, userConfigSchema, viteConfigSchema, withConfig };

package/dist/_chunks/project-vite.mjs

@@ -0,0 +1,9 @@
+import { loadConfig, resolveVitePlugins } from "./config.mjs";
+const withProjectVitePlugins = async (config) => {
+	const { config: webanvilConfig } = await loadConfig();
+	return {
+		...config,
+		plugins: [...resolveVitePlugins(webanvilConfig.plugins ?? []), ...config.plugins ?? []]
+	};
+};
+export { withProjectVitePlugins };

package/dist/index.d.mts

@@ -35,7 +35,7 @@ declare const isUnpluginAdapter: (plugin: unknown) => plugin is UnpluginAdapter;
 declare const isWebAnvilPlugin: (plugin: unknown) => plugin is WebAnvilPlugin;
 declare const resolveRolldownPlugins: (plugins: WebAnvilPlugin[]) => Plugin[];
 declare const resolveVitePlugins: (plugins: WebAnvilPlugin[]) => PluginOption[];
-type ToolName = "vite" | "vitest" | "rolldown" | "oxlint" | "oxfmt" | "typescript" | "typescript-native";
+type ToolName = "vite" | "vitest" | "rolldown" | "oxlint" | "oxfmt" | "storybook" | "typescript" | "typescript-native";
 type ToolSource = "project" | "webanvil";
 type ResolvedTool = {
   name: ToolName;
@@ -103,6 +103,7 @@ declare const buildConfigSchema: z.ZodObject<{
   mode: z.ZodOptional<z.ZodEnum<{
     web: "web";
     node: "node";
+    storybook: "storybook";
   }>>;
   entry: z.ZodOptional<z.ZodString>;
   entries: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -137,12 +138,18 @@ declare const lintConfigSchema: z.ZodCustom<LintConfig, LintConfig>;
 declare const rolldownConfigSchema: z.ZodCustom<RolldownConfig, RolldownConfig>;
 declare const testConfigSchema: z.ZodCustom<TestUserConfig, TestUserConfig>;
 declare const viteConfigSchema: z.ZodCustom<UserConfig$1, UserConfig$1>;
+declare const storybookConfigSchema: z.ZodObject<{
+  configDir: z.ZodOptional<z.ZodString>;
+  outDir: z.ZodOptional<z.ZodString>;
+  test: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
 declare const userConfigSchema: z.ZodObject<{
   build: z.ZodOptional<z.ZodObject<{
     bundle: z.ZodOptional<z.ZodBoolean>;
     mode: z.ZodOptional<z.ZodEnum<{
       web: "web";
       node: "node";
+      storybook: "storybook";
     }>>;
     entry: z.ZodOptional<z.ZodString>;
     entries: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -168,6 +175,11 @@ declare const userConfigSchema: z.ZodObject<{
   format: z.ZodOptional<z.ZodCustom<OxfmtConfig, OxfmtConfig>>;
   lint: z.ZodOptional<z.ZodCustom<LintConfig, LintConfig>>;
   rolldown: z.ZodOptional<z.ZodCustom<RolldownConfig, RolldownConfig>>;
+  storybook: z.ZodOptional<z.ZodObject<{
+    configDir: z.ZodOptional<z.ZodString>;
+    outDir: z.ZodOptional<z.ZodString>;
+    test: z.ZodOptional<z.ZodBoolean>;
+  }, z.core.$strict>>;
   test: z.ZodOptional<z.ZodCustom<TestUserConfig, TestUserConfig>>;
   vite: z.ZodOptional<z.ZodCustom<UserConfig$1, UserConfig$1>>;
   plugins: z.ZodOptional<z.ZodArray<z.ZodCustom<WebAnvilPlugin, WebAnvilPlugin>>>;
@@ -178,6 +190,7 @@ declare const effectiveUserConfigSchema: z.ZodObject<{
     mode: z.ZodOptional<z.ZodEnum<{
       web: "web";
       node: "node";
+      storybook: "storybook";
     }>>;
     entry: z.ZodOptional<z.ZodString>;
     entries: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -203,6 +216,11 @@ declare const effectiveUserConfigSchema: z.ZodObject<{
   format: z.ZodOptional<z.ZodCustom<OxfmtConfig, OxfmtConfig>>;
   lint: z.ZodOptional<z.ZodCustom<LintConfig, LintConfig>>;
   rolldown: z.ZodOptional<z.ZodCustom<RolldownConfig, RolldownConfig>>;
+  storybook: z.ZodOptional<z.ZodObject<{
+    configDir: z.ZodOptional<z.ZodString>;
+    outDir: z.ZodOptional<z.ZodString>;
+    test: z.ZodOptional<z.ZodBoolean>;
+  }, z.core.$strict>>;
   test: z.ZodOptional<z.ZodCustom<TestUserConfig, TestUserConfig>>;
   vite: z.ZodOptional<z.ZodCustom<UserConfig$1, UserConfig$1>>;
   plugins: z.ZodOptional<z.ZodArray<z.ZodCustom<WebAnvilPlugin, WebAnvilPlugin>>>;
@@ -212,6 +230,7 @@ type CopyMapping = z.infer<typeof copyMappingSchema>;
 type FormatConfig = OxfmtConfig;
 type TestConfig = TestUserConfig;
 type ViteConfig = UserConfig$1;
+type StorybookConfig = z.infer<typeof storybookConfigSchema>;
 type UserConfig = z.infer<typeof userConfigSchema>;
 type UserConfigFactory = () => UserConfig | Promise<UserConfig>;
 type ConfigExport = UserConfig | UserConfigFactory;
@@ -220,7 +239,7 @@ type ResolvedConfig = {
   configFile?: string;
 };
 type CommandArguments = Record<string, unknown>;
-type ConfigSection = BuildConfig | FormatConfig | LintConfig | TestConfig;
+type ConfigSection = BuildConfig | FormatConfig | LintConfig | StorybookConfig | TestConfig;
 type ResolvedArguments<TArguments extends CommandArguments> = { [TKey in keyof TArguments]-?: Exclude<TArguments[TKey], undefined>; };
 declare const defaultConfig: {
   build: {
@@ -234,7 +253,7 @@ declare const defaultConfig: {
 };
 declare const loadConfig: (cwd?: string) => Promise<ResolvedConfig>;
 declare const resolveEffectiveBuildConfig: (config: UserConfig, overrides: BuildConfig, explicitEntry: boolean) => BuildConfig;
-declare const withConfig: <TConfig extends ConfigSection, TArguments extends CommandArguments, TResult>(select: (config: UserConfig) => TConfig | undefined, run: (arguments_: ResolvedArguments<TArguments>, config: TConfig, resolvedConfig: UserConfig, explicitArguments: TArguments) => TResult | Promise<TResult>) => (arguments_: TArguments) => Promise<TResult>;
+declare const withConfig: <TConfig extends ConfigSection, TArguments extends CommandArguments, TResult>(select: (config: UserConfig) => TConfig | undefined, run: (arguments_: ResolvedArguments<TArguments>, config: TConfig, resolvedConfig: UserConfig, explicitArguments: TArguments) => TResult | Promise<TResult>) => (arguments_: TArguments, resolvedConfig?: UserConfig) => Promise<TResult>;
 type NodeBuildOptions = Pick<BuildConfig, "bundle" | "copy" | "declaration" | "entries" | "formats" | "minify" | "platform" | "sourcemap" | "target">;
 type BuildOptions = NodeBuildOptions;
 type ViteApi = typeof import("vite");
@@ -257,11 +276,12 @@ declare const build: {
 };
 declare const _default: import("cmdore").Command<readonly [{
   readonly name: "mode";
-  readonly description: "Build mode: web uses Vite and node uses Rolldown.";
+  readonly description: "Build mode: web uses Vite, node uses Rolldown, and storybook runs Storybook.";
   readonly arity: 1;
   readonly schema: import("zod").ZodEnum<{
     web: "web";
     node: "node";
+    storybook: "storybook";
   }>;
 }, {
   readonly name: "out-dir";
@@ -348,11 +368,12 @@ declare const dev: {
 };
 declare const _default$3: import("cmdore").Command<readonly [{
   readonly name: "mode";
-  readonly description: "Build mode: web uses Vite and node uses Rolldown.";
+  readonly description: "Build mode: web uses Vite, node uses Rolldown, and storybook runs Storybook.";
   readonly arity: 1;
   readonly schema: import("zod").ZodEnum<{
     web: "web";
     node: "node";
+    storybook: "storybook";
   }>;
 }, {
   readonly name: "out-dir";
@@ -477,7 +498,7 @@ declare const test: (filters: string[], config?: TestConfig, options?: {
   ui?: boolean;
   uiPort?: number;
   watch?: boolean;
-}, waitForTermination?: () => Promise<void>) => Promise<void>;
+}, waitForTermination?: () => Promise<void>, storybook?: StorybookConfig) => Promise<void>;
 declare const _default$7: import("cmdore").Command<readonly [{
   readonly name: "environment";
   readonly description: "Vitest environment to use for this run.";
@@ -577,11 +598,12 @@ declare const minify$1: {
 };
 declare const mode: {
   readonly name: "mode";
-  readonly description: "Build mode: web uses Vite and node uses Rolldown.";
+  readonly description: "Build mode: web uses Vite, node uses Rolldown, and storybook runs Storybook.";
   readonly arity: 1;
   readonly schema: z.ZodEnum<{
     web: "web";
     node: "node";
+    storybook: "storybook";
   }>;
 };
 declare const open: {
@@ -643,4 +665,4 @@ declare const watch: {
 };
 declare function defineConfig(config: UserConfig): UserConfig;
 declare function defineConfig(config: UserConfigFactory): UserConfigFactory;
-export { BuildConfig, ConfigExport, CopyMapping, FormatConfig, LintConfig, ResolvedConfig, RolldownConfig, SyntaxTarget, TestConfig, UnpluginAdapter, UserConfig, UserConfigFactory, ViteConfig, WebAnvilPlugin, WebAnvilUnplugin, assertSyntaxTarget, build, _default as buildCommand, buildConfigSchema, bundle$1 as bundle, check, _default$1 as checkCommand, checkProject, clean, _default$2 as cleanCommand, copy, copyMappingSchema, coverage, declaration, defaultConfig, defineConfig, definePlugin, dev, _default$3 as devCommand, effectiveUserConfigSchema, entry$1 as entry, environment, filters, fix, format, _default$4 as formatCommand, formatConfigSchema, formats$1 as formats, host, isUnpluginAdapter, isWebAnvilPlugin, lint, _default$5 as lintCommand, lintConfigSchema, loadConfig, minify$1 as minify, mode, open, outDir$1 as outDir, paths, platform$1 as platform, port, preview, _default$6 as previewCommand, resolveEffectiveBuildConfig, resolveRolldownPlugins, resolveVitePlugins, rolldownConfigSchema, sourcemap$1 as sourcemap, syntaxTargetSchema, target$1 as target, test, _default$7 as testCommand, testConfigSchema, typecheck, _default$8 as typecheckCommand, ui, uiPort, userConfigSchema, viteConfigSchema, watch, withConfig };
+export { BuildConfig, ConfigExport, CopyMapping, FormatConfig, LintConfig, ResolvedConfig, RolldownConfig, StorybookConfig, SyntaxTarget, TestConfig, UnpluginAdapter, UserConfig, UserConfigFactory, ViteConfig, WebAnvilPlugin, WebAnvilUnplugin, assertSyntaxTarget, build, _default as buildCommand, buildConfigSchema, bundle$1 as bundle, check, _default$1 as checkCommand, checkProject, clean, _default$2 as cleanCommand, copy, copyMappingSchema, coverage, declaration, defaultConfig, defineConfig, definePlugin, dev, _default$3 as devCommand, effectiveUserConfigSchema, entry$1 as entry, environment, filters, fix, format, _default$4 as formatCommand, formatConfigSchema, formats$1 as formats, host, isUnpluginAdapter, isWebAnvilPlugin, lint, _default$5 as lintCommand, lintConfigSchema, loadConfig, minify$1 as minify, mode, open, outDir$1 as outDir, paths, platform$1 as platform, port, preview, _default$6 as previewCommand, resolveEffectiveBuildConfig, resolveRolldownPlugins, resolveVitePlugins, rolldownConfigSchema, sourcemap$1 as sourcemap, storybookConfigSchema, syntaxTargetSchema, target$1 as target, test, _default$7 as testCommand, testConfigSchema, typecheck, _default$8 as typecheckCommand, ui, uiPort, userConfigSchema, viteConfigSchema, watch, withConfig };

package/dist/index.mjs

@@ -1,5 +1,6 @@
-import { assertSyntaxTarget, build, buildConfigSchema, build_default, bundle, check, checkProject, check_default, clean, clean_default, copy, copyMappingSchema, coverage, declaration, defaultConfig, defineConfig as defineConfig$1, definePlugin, dev, dev_default, effectiveUserConfigSchema, entry, environment, filters, fix, format, formatConfigSchema, format_default, formats, host, isUnpluginAdapter, isWebAnvilPlugin, lint, lintConfigSchema, lint_default, loadConfig, minify, mode, open, outDir, paths, platform, port, preview, preview_default, resolveEffectiveBuildConfig, resolveRolldownPlugins, resolveVitePlugins, rolldownConfigSchema, sourcemap, syntaxTargetSchema, target, test, testConfigSchema, test_default, typecheck, typecheck_default, ui, uiPort, userConfigSchema, viteConfigSchema, watch, withConfig } from "./_chunks/commands.mjs";
+import { build, build_default, bundle, check, checkProject, check_default, clean, clean_default, copy, coverage, declaration, dev, dev_default, entry, environment, filters, fix, format, format_default, formats, host, lint, lint_default, minify, mode, open, outDir, paths, platform, port, preview, preview_default, sourcemap, target, test, test_default, typecheck, typecheck_default, ui, uiPort, watch } from "./_chunks/commands.mjs";
+import { assertSyntaxTarget, buildConfigSchema, copyMappingSchema, defaultConfig, defineConfig as defineConfig$1, definePlugin, effectiveUserConfigSchema, formatConfigSchema, isUnpluginAdapter, isWebAnvilPlugin, lintConfigSchema, loadConfig, resolveEffectiveBuildConfig, resolveRolldownPlugins, resolveVitePlugins, rolldownConfigSchema, storybookConfigSchema, syntaxTargetSchema, testConfigSchema, userConfigSchema, viteConfigSchema, withConfig } from "./_chunks/config.mjs";
 function defineConfig(config) {
 	return defineConfig$1(config);
 }
-export { assertSyntaxTarget, build, build_default as buildCommand, buildConfigSchema, bundle, check, check_default as checkCommand, checkProject, clean, clean_default as cleanCommand, copy, copyMappingSchema, coverage, declaration, defaultConfig, defineConfig, definePlugin, dev, dev_default as devCommand, effectiveUserConfigSchema, entry, environment, filters, fix, format, format_default as formatCommand, formatConfigSchema, formats, host, isUnpluginAdapter, isWebAnvilPlugin, lint, lint_default as lintCommand, lintConfigSchema, loadConfig, minify, mode, open, outDir, paths, platform, port, preview, preview_default as previewCommand, resolveEffectiveBuildConfig, resolveRolldownPlugins, resolveVitePlugins, rolldownConfigSchema, sourcemap, syntaxTargetSchema, target, test, test_default as testCommand, testConfigSchema, typecheck, typecheck_default as typecheckCommand, ui, uiPort, userConfigSchema, viteConfigSchema, watch, withConfig };
+export { assertSyntaxTarget, build, build_default as buildCommand, buildConfigSchema, bundle, check, check_default as checkCommand, checkProject, clean, clean_default as cleanCommand, copy, copyMappingSchema, coverage, declaration, defaultConfig, defineConfig, definePlugin, dev, dev_default as devCommand, effectiveUserConfigSchema, entry, environment, filters, fix, format, format_default as formatCommand, formatConfigSchema, formats, host, isUnpluginAdapter, isWebAnvilPlugin, lint, lint_default as lintCommand, lintConfigSchema, loadConfig, minify, mode, open, outDir, paths, platform, port, preview, preview_default as previewCommand, resolveEffectiveBuildConfig, resolveRolldownPlugins, resolveVitePlugins, rolldownConfigSchema, sourcemap, storybookConfigSchema, syntaxTargetSchema, target, test, test_default as testCommand, testConfigSchema, typecheck, typecheck_default as typecheckCommand, ui, uiPort, userConfigSchema, viteConfigSchema, watch, withConfig };

package/dist/storybook/react/index.d.mts

@@ -0,0 +1,3 @@
+import { StorybookConfig } from "@storybook/react-vite/node";
+declare const framework: string;
+export { type StorybookConfig, framework };

package/dist/storybook/react/index.mjs

@@ -0,0 +1,4 @@
+import { dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+const framework = dirname(fileURLToPath(import.meta.url));
+export { framework };

package/dist/storybook/react/preset

@@ -0,0 +1,8 @@
+import { withProjectVitePlugins } from "../../_chunks/project-vite.mjs";
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { viteFinal as viteFinal$1 } from "@storybook/react-vite/preset";
+export * from "@storybook/react-vite/preset";
+const addons = [resolve(fileURLToPath(new URL("..", import.meta.url)), "test")];
+const viteFinal = async (...arguments_) => viteFinal$1(await withProjectVitePlugins(arguments_[0]), arguments_[1]);
+export { addons, viteFinal };

package/dist/storybook/react/preset.d.mts

@@ -0,0 +1,5 @@
+import { viteFinal as viteFinal$1 } from "@storybook/react-vite/preset";
+export * from "@storybook/react-vite/preset";
+declare const addons: string[];
+declare const viteFinal: (...arguments_: Parameters<typeof viteFinal$1>) => Promise<import("vite").InlineConfig>;
+export { addons, viteFinal };

package/dist/storybook/react/preset.mjs

@@ -0,0 +1,8 @@
+import { withProjectVitePlugins } from "../../_chunks/project-vite.mjs";
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { viteFinal as viteFinal$1 } from "@storybook/react-vite/preset";
+export * from "@storybook/react-vite/preset";
+const addons = [resolve(fileURLToPath(new URL("..", import.meta.url)), "test")];
+const viteFinal = async (...arguments_) => viteFinal$1(await withProjectVitePlugins(arguments_[0]), arguments_[1]);
+export { addons, viteFinal };

package/dist/storybook/svelte/index.d.mts

@@ -0,0 +1,3 @@
+import { StorybookConfig } from "@storybook/svelte-vite/node";
+declare const framework: string;
+export { type StorybookConfig, framework };

package/dist/storybook/svelte/index.mjs

@@ -0,0 +1,4 @@
+import { dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+const framework = dirname(fileURLToPath(import.meta.url));
+export { framework };

package/dist/storybook/svelte/preset

@@ -0,0 +1,8 @@
+import { withProjectVitePlugins } from "../../_chunks/project-vite.mjs";
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { viteFinal as viteFinal$1 } from "@storybook/svelte-vite/preset";
+export * from "@storybook/svelte-vite/preset";
+const addons = [resolve(fileURLToPath(new URL("..", import.meta.url)), "test")];
+const viteFinal = async (...arguments_) => viteFinal$1(await withProjectVitePlugins(arguments_[0]), arguments_[1]);
+export { addons, viteFinal };

package/dist/storybook/svelte/preset.d.mts

@@ -0,0 +1,5 @@
+import { viteFinal as viteFinal$1 } from "@storybook/svelte-vite/preset";
+export * from "@storybook/svelte-vite/preset";
+declare const addons: string[];
+declare const viteFinal: (...arguments_: Parameters<typeof viteFinal$1>) => Promise<import("vite").InlineConfig>;
+export { addons, viteFinal };

package/dist/storybook/svelte/preset.mjs

@@ -0,0 +1,8 @@
+import { withProjectVitePlugins } from "../../_chunks/project-vite.mjs";
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { viteFinal as viteFinal$1 } from "@storybook/svelte-vite/preset";
+export * from "@storybook/svelte-vite/preset";
+const addons = [resolve(fileURLToPath(new URL("..", import.meta.url)), "test")];
+const viteFinal = async (...arguments_) => viteFinal$1(await withProjectVitePlugins(arguments_[0]), arguments_[1]);
+export { addons, viteFinal };

package/dist/storybook/test/preset

@@ -0,0 +1,2 @@
+export * from "@storybook/addon-vitest/preset";
+export {};

package/dist/storybook/test/preset.d.mts

@@ -0,0 +1 @@
+export * from "@storybook/addon-vitest/preset";

package/dist/storybook/test/preset.mjs

@@ -0,0 +1,2 @@
+export * from "@storybook/addon-vitest/preset";
+export {};

package/dist/storybook/vue/index.d.mts

@@ -0,0 +1,3 @@
+import { StorybookConfig } from "@storybook/vue3-vite/node";
+declare const framework: string;
+export { type StorybookConfig, framework };

package/dist/storybook/vue/index.mjs

@@ -0,0 +1,4 @@
+import { dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+const framework = dirname(fileURLToPath(import.meta.url));
+export { framework };

package/dist/storybook/vue/preset

@@ -0,0 +1,8 @@
+import { withProjectVitePlugins } from "../../_chunks/project-vite.mjs";
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { viteFinal as viteFinal$1 } from "@storybook/vue3-vite/preset";
+export * from "@storybook/vue3-vite/preset";
+const addons = [resolve(fileURLToPath(new URL("..", import.meta.url)), "test")];
+const viteFinal = async (...arguments_) => viteFinal$1(await withProjectVitePlugins(arguments_[0]), arguments_[1]);
+export { addons, viteFinal };

package/dist/storybook/vue/preset.d.mts

@@ -0,0 +1,5 @@
+import { viteFinal as viteFinal$1 } from "@storybook/vue3-vite/preset";
+export * from "@storybook/vue3-vite/preset";
+declare const addons: string[];
+declare const viteFinal: (...arguments_: Parameters<typeof viteFinal$1>) => Promise<any>;
+export { addons, viteFinal };

package/dist/storybook/vue/preset.mjs

@@ -0,0 +1,8 @@
+import { withProjectVitePlugins } from "../../_chunks/project-vite.mjs";
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { viteFinal as viteFinal$1 } from "@storybook/vue3-vite/preset";
+export * from "@storybook/vue3-vite/preset";
+const addons = [resolve(fileURLToPath(new URL("..", import.meta.url)), "test")];
+const viteFinal = async (...arguments_) => viteFinal$1(await withProjectVitePlugins(arguments_[0]), arguments_[1]);
+export { addons, viteFinal };

package/dist/storybook/web-components/index.d.mts

@@ -0,0 +1,3 @@
+import { StorybookConfig } from "@storybook/web-components-vite/node";
+declare const framework: string;
+export { type StorybookConfig, framework };

package/dist/storybook/web-components/index.mjs

@@ -0,0 +1,4 @@
+import { dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+const framework = dirname(fileURLToPath(import.meta.url));
+export { framework };

package/dist/storybook/web-components/preset

@@ -0,0 +1,7 @@
+import { withProjectVitePlugins } from "../../_chunks/project-vite.mjs";
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+export * from "@storybook/web-components-vite/preset";
+const addons = [resolve(fileURLToPath(new URL("..", import.meta.url)), "test")];
+const viteFinal = withProjectVitePlugins;
+export { addons, viteFinal };

package/dist/storybook/web-components/preset.d.mts

@@ -0,0 +1,4 @@
+export * from "@storybook/web-components-vite/preset";
+declare const addons: string[];
+declare const viteFinal: (config: import("vite").InlineConfig) => Promise<import("vite").InlineConfig>;
+export { addons, viteFinal };

package/dist/storybook/web-components/preset.mjs

@@ -0,0 +1,7 @@
+import { withProjectVitePlugins } from "../../_chunks/project-vite.mjs";
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+export * from "@storybook/web-components-vite/preset";
+const addons = [resolve(fileURLToPath(new URL("..", import.meta.url)), "test")];
+const viteFinal = withProjectVitePlugins;
+export { addons, viteFinal };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "webanvil",
-    "version": "0.0.7",
+    "version": "0.0.9",
     "description": "A unified CLI for building, testing, linting, formatting, and type-checking JavaScript and TypeScript projects.",
     "keywords": [
         "build-tool",
@@ -40,6 +40,51 @@
             "types": "./dist/index.d.mts",
             "import": "./dist/index.mjs",
             "default": "./dist/index.mjs"
+        },
+        "./storybook/test/preset": {
+            "types": "./dist/storybook/test/preset.d.mts",
+            "import": "./dist/storybook/test/preset.mjs",
+            "default": "./dist/storybook/test/preset.mjs"
+        },
+        "./storybook/react": {
+            "types": "./dist/storybook/react/index.d.mts",
+            "import": "./dist/storybook/react/index.mjs",
+            "default": "./dist/storybook/react/index.mjs"
+        },
+        "./storybook/react/preset": {
+            "types": "./dist/storybook/react/preset.d.mts",
+            "import": "./dist/storybook/react/preset.mjs",
+            "default": "./dist/storybook/react/preset.mjs"
+        },
+        "./storybook/svelte": {
+            "types": "./dist/storybook/svelte/index.d.mts",
+            "import": "./dist/storybook/svelte/index.mjs",
+            "default": "./dist/storybook/svelte/index.mjs"
+        },
+        "./storybook/svelte/preset": {
+            "types": "./dist/storybook/svelte/preset.d.mts",
+            "import": "./dist/storybook/svelte/preset.mjs",
+            "default": "./dist/storybook/svelte/preset.mjs"
+        },
+        "./storybook/vue": {
+            "types": "./dist/storybook/vue/index.d.mts",
+            "import": "./dist/storybook/vue/index.mjs",
+            "default": "./dist/storybook/vue/index.mjs"
+        },
+        "./storybook/vue/preset": {
+            "types": "./dist/storybook/vue/preset.d.mts",
+            "import": "./dist/storybook/vue/preset.mjs",
+            "default": "./dist/storybook/vue/preset.mjs"
+        },
+        "./storybook/web-components": {
+            "types": "./dist/storybook/web-components/index.d.mts",
+            "import": "./dist/storybook/web-components/index.mjs",
+            "default": "./dist/storybook/web-components/index.mjs"
+        },
+        "./storybook/web-components/preset": {
+            "types": "./dist/storybook/web-components/preset.d.mts",
+            "import": "./dist/storybook/web-components/preset.mjs",
+            "default": "./dist/storybook/web-components/preset.mjs"
         }
     },
     "publishConfig": {
@@ -47,7 +92,7 @@
         "registry": "https://registry.npmjs.org/"
     },
     "scripts": {
-        "build": "obuild",
+        "build": "obuild && node scripts/prepare-storybook-presets.mjs",
         "prepack": "npm run build",
         "pretest": "npm run build",
         "test": "vitest run --passWithNoTests --config vitest.repo.config.ts",
@@ -60,10 +105,18 @@
         "check": "npm run typecheck && npm run lint && npm run format:check && npm test"
     },
     "dependencies": {
+        "@playwright/browser-chromium": "1.58.2",
+        "@storybook/addon-vitest": "10.5.9",
+        "@storybook/react-vite": "10.5.9",
+        "@storybook/svelte-vite": "10.5.9",
+        "@storybook/vue3-vite": "10.5.9",
+        "@storybook/web-components-vite": "10.5.9",
         "@types/node": "^26.1.1",
         "@typescript/native-preview": "7.0.0-dev.20260707.2",
-        "@vitest/coverage-v8": "^4.1.10",
-        "@vitest/ui": "^4.1.10",
+        "@vitest/browser": "4.1.10",
+        "@vitest/browser-playwright": "4.1.10",
+        "@vitest/coverage-v8": "4.1.10",
+        "@vitest/ui": "4.1.10",
         "c12": "^4.0.0-beta.5",
         "cmdore": "^0.4.1",
         "consola": "^3.4.2",
@@ -76,9 +129,11 @@
         "oxlint": "1.75.0",
         "pathe": "^2.0.3",
         "pkg-types": "^2.3.1",
+        "playwright": "1.58.2",
         "rolldown": "1.2.0",
         "rolldown-plugin-dts": "0.27.13",
         "semver": "7.8.5",
+        "storybook": "10.5.9",
         "tinyglobby": "^0.2.15",
         "typescript": "6.0.3",
         "vite": "8.1.5",