webanvil 0.0.16 → 0.0.18

package/README.md

@@ -167,8 +167,10 @@ 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.
+browser support, and Chromium. It exposes that exact Storybook release as a
+peer dependency, so package-manager-installed addons resolve against the same
+runtime. Add a Storybook configuration, addons, and your project's normal
+framework dependencies.
 
 For a Node design-system project, configure Storybook beside the package build:
 
@@ -423,9 +425,11 @@ names and source maps.
 
 ### Node declarations
 
-`build.declaration: true` uses `rolldown-plugin-dts` with its TypeScript
-generator. Pass a native declaration options object to select the `"oxc"` or
-`"tsgo"` generator and other plugin settings:
+`build.declaration: true` uses `rolldown-plugin-dts`. TypeScript 5 and 6 use
+the full `tsc` generator. TypeScript 7 uses `tsgo` when the project has a
+`tsconfig.json`; otherwise it uses Oxc's isolated declaration generator. Pass a
+native declaration options object to choose a generator and other plugin
+settings explicitly:
 
 ```ts
 import { defineConfig } from "webanvil"
@@ -440,11 +444,12 @@ export default defineConfig({
 })
 ```
 
-The TypeScript generator selects a compatible project/workspace TypeScript
+The `tsc` generator selects a compatible project/workspace TypeScript
 declaration when present, otherwise WebAnvil's exact TypeScript fallback.
 Project-local `ts-patch` and TypeScript emit transforms are honored when they
-are directly declared and resolve to that same compiler. Emit transforms
-require the `tsc` generator; Oxc and `tsgo` are explicit alternatives.
+are directly declared and resolve to that same compiler. They require `tsc`,
+which supports TypeScript 5 and 6; use `tsgo` with a `tsconfig.json` or Oxc for
+TypeScript 7 declarations.
 
 `rolldown-plugin-dts` owns declaration paths and imports. ESM-only builds attach
 one declaration graph; CommonJS-only and dual-format builds use one

package/dist/_chunks/commands.mjs

@@ -13,8 +13,6 @@ 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 { tmpdir } from "node:os";
@@ -365,7 +363,6 @@ var Toolchain = class {
 };
 const formatResolvedTool = (tool) => `${tool.packageName} ${tool.version} (${tool.source})`;
 const declarationDefaults = {
-	generator: "tsc",
 	incremental: false,
 	newContext: true,
 	parallel: false
@@ -469,11 +466,21 @@ const withoutImplicitIncremental = (config) => {
 		}
 	};
 };
+const usesTypeScriptSeven = (typescript) => typescript.version.startsWith("7.");
+const selectDeclarationGenerator = async (configured, plugins, tsconfigPath, toolchain) => {
+	const requested = configured.generator;
+	if (plugins.length > 0 && requested !== void 0 && requested !== "tsc") throw new Error(`TypeScript declaration transforms from ${tsconfigPath ?? "compilerOptions"} require build.declaration.generator "tsc"; ${requested} cannot apply TypeScript emit transforms`);
+	if (requested === "oxc" || requested === "tsgo") return requested;
+	const typescript = await toolchain.resolve("typescript");
+	if (!usesTypeScriptSeven(typescript)) return "tsc";
+	if (requested === "tsc") throw new Error(`build.declaration.generator "tsc" does not support TypeScript ${typescript.version}; use "tsgo" with a tsconfig.json or "oxc" instead`);
+	if (plugins.length > 0) throw new Error(`TypeScript declaration transforms from ${tsconfigPath ?? "compilerOptions"} require the "tsc" generator, which does not support TypeScript ${typescript.version}; use TypeScript 6 or below, or remove the transforms`);
+	return tsconfigPath === void 0 ? "oxc" : "tsgo";
+};
 const createDeclarationPlugins = async (declaration, cwd, toolchain, emitDtsOnly) => serializeSetup(async () => {
 	const configured = withoutImplicitIncremental(declaration === true ? {} : declaration);
-	const generator = configured.generator ?? declarationDefaults.generator;
 	const { plugins, tsconfigPath } = compilerPlugins(cwd, configured);
-	if (plugins.length > 0 && generator !== "tsc") throw new Error(`TypeScript declaration transforms from ${tsconfigPath ?? "compilerOptions"} require build.declaration.generator "tsc"; ${generator} cannot apply TypeScript emit transforms`);
+	const generator = await selectDeclarationGenerator(configured, plugins, tsconfigPath, toolchain);
 	const options = {
 		...declarationDefaults,
 		...configured,
@@ -1208,6 +1215,7 @@ const createStorybookTestProject = async (config = {}, vitestVersion = storybook
 	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";
+	const [{ playwright }, { storybookTest }] = await Promise.all([import("@vitest/browser-playwright"), import("@storybook/addon-vitest/vitest-plugin")]);
 	let plugins;
 	try {
 		plugins = await storybookTest({ configDir: config.configDir });

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "webanvil",
-    "version": "0.0.16",
+    "version": "0.0.18",
     "description": "A unified CLI for building, testing, linting, formatting, and type-checking JavaScript and TypeScript projects.",
     "keywords": [
         "build-tool",
@@ -161,6 +161,9 @@
         "obuild": "^0.4.38",
         "unplugin": "^3.3.0"
     },
+    "peerDependencies": {
+        "storybook": "10.5.9"
+    },
     "engines": {
         "node": "^22.18.0 || >=24.11.0"
     }