@orkestrel/scaffold 0.0.70 → 0.0.72

package/dist/src/core/index.cjs

@@ -4,7 +4,7 @@ let _orkestrel_template = require("@orkestrel/template");
 let _orkestrel_emitter = require("@orkestrel/emitter");
 var package_default = {
 	name: "@orkestrel/scaffold",
-	version: "0.0.70",
+	version: "0.0.72",
 	description: "Scaffold workspaces with commands: new, audit, repair, catalog, and overwrite.",
 	keywords: [
 		"audit",
@@ -90,19 +90,19 @@ var package_default = {
 		"prepublishOnly": "npm run format:check && npm run lint:check && npm run check && npm run build && npm test && npm run test:distribution -- --mode release"
 	},
 	dependencies: {
-		"@orkestrel/console": "^0.0.13",
+		"@orkestrel/console": "^0.0.14",
 		"@orkestrel/contract": "^0.0.17",
 		"@orkestrel/emitter": "^0.0.10",
-		"@orkestrel/markdown": "^0.0.14",
-		"@orkestrel/process": "^0.0.12",
-		"@orkestrel/template": "^0.0.7"
+		"@orkestrel/markdown": "^0.0.15",
+		"@orkestrel/process": "^0.0.13",
+		"@orkestrel/template": "^0.0.8"
 	},
 	devDependencies: {
 		"@microsoft/api-extractor": "^7.59.1",
-		"@orkestrel/guide": "^0.0.19",
-		"@orkestrel/html": "^0.0.9",
-		"@orkestrel/probe": "^0.0.14",
-		"@orkestrel/test": "^0.0.14",
+		"@orkestrel/guide": "^0.0.20",
+		"@orkestrel/html": "^0.0.10",
+		"@orkestrel/probe": "^0.0.16",
+		"@orkestrel/test": "^0.0.16",
 		"@types/node": "^26.5.1",
 		"@vitest/browser-playwright": "^4.1.11",
 		"oxfmt": "^0.68.0",
@@ -671,7 +671,8 @@ var CONFIG_TEMPLATES = Object.freeze({
 	"exclude": ["node_modules", "dist", "tmp"]
 }
 `,
-		vite: `import type { {{viteTypes}} } from 'vite'
+		vite: `import type { PluginOption, UserConfig } from 'vite'
+import { mergeConfig } from 'vite'
 {{imports}}import { defineConfig } from 'vitest/config'
 import manifest from './package.json' with { type: 'json' }
 import tsconfig from './tsconfig.json' with { type: 'json' }
@@ -701,6 +702,68 @@ const resolve = {
 	}, {}),
 }
 
+// Merges a caller's override onto the configuration a factory declares, so a
+// package's own configuration reaches the factory through its parameter instead of
+// wrapping the call from outside.
+//
+// Vitest calls every registered project factory with its own invocation record —
+// \`command\`, \`mode\`, \`isSsrBuild\`, \`isPreview\` — so a factory that also takes an
+// override receives that record in the same position. A \`UserConfig\` declares \`mode\`
+// but not \`command\`, and the invocation record always carries both, so a value
+// carrying the pair is that record rather than an override. The merge returns the
+// base unchanged and reports nothing. The \`tests/config.test.ts\` file drives every
+// registered factory through it.
+//
+// \`mergeConfig\` concatenates arrays, so an override carrying \`plugins\` would otherwise
+// add a second copy of a plugin the base already declares. Only named top-level
+// objects replace a base plugin of the same name, in the base's position, and one
+// override entry is taken at most once. An entry no base position took appends in its
+// written order; the caller's own entries never merge with each other. Nested arrays,
+// promises, falsy entries, and anonymous objects pass through unchanged. An override
+// cannot remove a base plugin. Every key other than \`plugins\` merges as \`mergeConfig\`
+// merges it, so an override's arrays elsewhere concatenate with the base's rather than
+// replacing them.
+export function mergeOverride(base: UserConfig, override?: UserConfig): UserConfig {
+	if (override === undefined || ('command' in override && 'mode' in override)) return base
+	const merged: UserConfig = mergeConfig(base, override)
+	if (merged.plugins === undefined) return merged
+	const candidates = override.plugins ?? []
+	const taken = new Set<number>()
+	const selected: PluginOption[] = []
+	for (const plugin of base.plugins ?? []) {
+		if (!isNamedPlugin(plugin)) {
+			selected.push(plugin)
+			continue
+		}
+		const index = candidates.findIndex(
+			(candidate, position) =>
+				!taken.has(position) && isNamedPlugin(candidate) && candidate.name === plugin.name,
+		)
+		const replacement = candidates[index]
+		if (replacement === undefined) {
+			selected.push(plugin)
+		} else {
+			selected.push(replacement)
+			taken.add(index)
+		}
+	}
+	for (const [index, plugin] of candidates.entries()) {
+		if (!taken.has(index)) selected.push(plugin)
+	}
+	return { ...merged, plugins: selected }
+}
+
+function isNamedPlugin(plugin: PluginOption): plugin is { name: string } {
+	return (
+		typeof plugin === 'object' &&
+		plugin !== null &&
+		!Array.isArray(plugin) &&
+		!('then' in plugin && typeof plugin.then === 'function') &&
+		'name' in plugin &&
+		typeof plugin.name === 'string'
+	)
+}
+
 {{factories}}export default defineConfig({
 	resolve,
 	test: {
@@ -711,149 +774,166 @@ const resolve = {
 	}),
 	factories: Object.freeze({
 		src: Object.freeze({
-			core: `export const srcCore = (): UserConfig => ({
-	resolve,
-	publicDir: false,
-	build: {
-		emptyOutDir: true,
-		sourcemap: true,
-		minify: false,
-		rolldownOptions: { onLog: enforceBuildLog },
-	},
-	test: {
-		name: { label: 'src:core', color: 'magenta' },
-		include: ['tests/src/core/**/*.test.ts'],
-		setupFiles: ['./tests/setup.ts'],
-		environment: 'node',
-		browser: { enabled: false },
-	},
-})
-`,
-			browser: `export const srcBrowser = (): UserConfig => ({
-	resolve,
-	publicDir: false,
-	plugins: [outputBoundary('dist/src/browser'), environmentBoundary('src/browser')],
-	build: {
-		emptyOutDir: true,
-		sourcemap: true,
-		minify: false,
-		lib: {
-			entry: resolveWorkspacePath('src/browser/index.ts'),
-			formats: ['es'],
-			fileName: () => 'index.js',
+			core: `export function srcCore(override?: UserConfig): UserConfig {
+	const project: UserConfig = {
+		resolve,
+		publicDir: false,
+		build: {
+			emptyOutDir: true,
+			sourcemap: true,
+			minify: false,
+			rolldownOptions: { onLog: enforceBuildLog },
+		},
+		test: {
+			name: { label: 'src:core', color: 'magenta' },
+			include: ['tests/src/core/**/*.test.ts'],
+			setupFiles: ['./tests/setup.ts'],
+			environment: 'node',
+			browser: { enabled: false },
 		},
-		outDir: 'dist/src/browser',
-		rolldownOptions: {
-			onLog: enforceBuildLog,
-			{{external}}
+	}
+	return mergeOverride(project, override)
+}
+`,
+			browser: `export function srcBrowser(override?: UserConfig): UserConfig {
+	const project: UserConfig = {
+		resolve,
+		publicDir: false,
+		plugins: [outputBoundary('dist/src/browser'), environmentBoundary('src/browser')],
+		build: {
+			emptyOutDir: true,
+			sourcemap: true,
+			minify: false,
+			lib: {
+				entry: resolveWorkspacePath('src/browser/index.ts'),
+				formats: ['es'],
+				fileName: () => 'index.js',
+			},
+			outDir: 'dist/src/browser',
+			rolldownOptions: {
+				onLog: enforceBuildLog,
+				{{external}}
 {{output}}
+			},
 		},
-	},
-	test: {
-		name: { label: 'src:browser', color: 'yellow' },
-		include: ['tests/src/browser/**/*.test.ts'],
-{{exclude}}		setupFiles: ['./tests/setup.ts', './tests/setupBrowser.ts'],
+		test: {
+			name: { label: 'src:browser', color: 'yellow' },
+			include: ['tests/src/browser/**/*.test.ts'],
+{{exclude}}			setupFiles: ['./tests/setup.ts', './tests/setupBrowser.ts'],
 {{global}}
-		browser: {
-			enabled: true,
-			provider: playwright(browserOptions),
-			instances: [{ browser: 'chromium', headless: true }],
+			browser: {
+				enabled: true,
+				provider: playwright(browserOptions),
+				instances: [{ browser: 'chromium', headless: true }],
+			},
+			fileParallelism: false,
 		},
-		fileParallelism: false,
-	},
-})
+	}
+	return mergeOverride(project, override)
+}
 `,
-			server: `export const srcServer = (): UserConfig => ({
-	resolve,
-	publicDir: false,
-	plugins: [outputBoundary('dist/src/server'), environmentBoundary('src/server')],
-	build: {
-		emptyOutDir: true,
-		sourcemap: true,
-		minify: false,
-		lib: {
-			entry: resolveWorkspacePath('src/server/index.ts'),
-			formats: ['es', 'cjs'],
-			fileName: (format: string) => (format === 'es' ? 'index.js' : 'index.cjs'),
-		},
-		outDir: 'dist/src/server',
-		target: 'node22',
-		rolldownOptions: {
-			onLog: enforceBuildLog,
-			platform: 'node',
-			{{external}}
+			server: `export function srcServer(override?: UserConfig): UserConfig {
+	const project: UserConfig = {
+		resolve,
+		publicDir: false,
+		plugins: [outputBoundary('dist/src/server'), environmentBoundary('src/server')],
+		build: {
+			emptyOutDir: true,
+			sourcemap: true,
+			minify: false,
+			lib: {
+				entry: resolveWorkspacePath('src/server/index.ts'),
+				formats: ['es', 'cjs'],
+				fileName: (format: string) => (format === 'es' ? 'index.js' : 'index.cjs'),
+			},
+			outDir: 'dist/src/server',
+			target: 'node22',
+			rolldownOptions: {
+				onLog: enforceBuildLog,
+				platform: 'node',
+				{{external}}
 {{output}}
+			},
 		},
-	},
-	test: {
-		name: { label: 'src:server', color: 'red' },
-		include: ['tests/src/server/**/*.test.ts'],
-{{exclude}}		setupFiles: ['./tests/setup.ts', './tests/setupServer.ts'],
-		environment: 'node',
-		browser: { enabled: false },
-	},
-})
+		test: {
+			name: { label: 'src:server', color: 'red' },
+			include: ['tests/src/server/**/*.test.ts'],
+{{exclude}}			setupFiles: ['./tests/setup.ts', './tests/setupServer.ts'],
+			environment: 'node',
+			browser: { enabled: false },
+		},
+	}
+	return mergeOverride(project, override)
+}
 `,
-			bin: `export const srcBin = (): UserConfig => ({
-	resolve,
-	publicDir: false,
-	plugins: [outputBoundary('dist/bin')],
-	build: {
-		emptyOutDir: true,
-		sourcemap: true,
-		minify: false,
-		lib: {
-			entry: resolveWorkspacePath('${BIN_ENTRY_PATH}'),
-			formats: ['es'],
-			fileName: () => 'main.js',
+			bin: `export function srcBin(override?: UserConfig): UserConfig {
+	const project: UserConfig = {
+		resolve,
+		publicDir: false,
+		plugins: [outputBoundary('dist/bin')],
+		build: {
+			emptyOutDir: true,
+			sourcemap: true,
+			minify: false,
+			lib: {
+				entry: resolveWorkspacePath('${BIN_ENTRY_PATH}'),
+				formats: ['es'],
+				fileName: () => 'main.js',
+			},
+			outDir: 'dist/bin',
+			target: 'node22',
+			rolldownOptions: {
+				onLog: enforceBuildLog,
+				external: (id: string) =>
+					id.startsWith('node:') ||
+					id.startsWith('@orkestrel/') ||
+					id.startsWith('@src/') ||
+					peers.some((peer) => id === peer || id.startsWith(peer + '/')),
+			},
 		},
-		outDir: 'dist/bin',
-		target: 'node22',
-		rolldownOptions: {
-			onLog: enforceBuildLog,
-			external: (id: string) =>
-				id.startsWith('node:') ||
-				id.startsWith('@orkestrel/') ||
-				id.startsWith('@src/') ||
-				peers.some((peer) => id === peer || id.startsWith(peer + '/')),
+		test: {
+			name: { label: 'src:bin', color: 'yellow' },
+			include: ['tests/src/bin/**/*.test.ts'],
+			setupFiles: ['./tests/setup.ts', './tests/setupServer.ts'],
+			environment: 'node',
+			browser: { enabled: false },
+			// A bin test drives the real executable over a real temporary repository, so it
+			// spends seconds in process startup and filesystem work rather than milliseconds.
+			// Vitest's five-second default clears one alone and times out under a full suite.
+			testTimeout: 15_000,
 		},
-	},
-	test: {
-		name: { label: 'src:bin', color: 'yellow' },
-		include: ['tests/src/bin/**/*.test.ts'],
-		setupFiles: ['./tests/setup.ts', './tests/setupServer.ts'],
-		environment: 'node',
-		browser: { enabled: false },
-		// A bin test drives the real executable over a real temporary repository, so it
-		// spends seconds in process startup and filesystem work rather than milliseconds.
-		// Vitest's five-second default clears one alone and times out under a full suite.
-		testTimeout: 15_000,
-	},
-})
+	}
+	return mergeOverride(project, override)
+}
 `
 		}),
 		app: Object.freeze({
-			core: `export const appCore = (): UserConfig => ({
-	resolve,
-	publicDir: false,
-	plugins: [environmentBoundary('app/core')],
-	test: {
-		name: { label: 'app:core', color: 'cyan' },
-		include: ['tests/app/core/**/*.test.ts'],
-		setupFiles: ['./tests/setup.ts'],
-		environment: 'node',
-		browser: { enabled: false },
-	},
-})
+			core: `export function appCore(override?: UserConfig): UserConfig {
+	const project: UserConfig = {
+		resolve,
+		publicDir: false,
+		plugins: [environmentBoundary('app/core')],
+		test: {
+			name: { label: 'app:core', color: 'cyan' },
+			include: ['tests/app/core/**/*.test.ts'],
+			setupFiles: ['./tests/setup.ts'],
+			environment: 'node',
+			browser: { enabled: false },
+		},
+	}
+	return mergeOverride(project, override)
+}
 `,
-			browser: `function applicationBrowser(showcase: boolean): UserConfig {
-	const output = showcase ? 'dist/showcase' : 'dist/app/browser'
-{{showcasePlugins}}	return {
+			browser: `export function appBrowser(override?: UserConfig): UserConfig {
+	const output = 'dist/app/browser'
+	const project: UserConfig = {
 		resolve,
-{{plugins}}		root: resolveWorkspacePath('app/browser'),
+		plugins: [outputBoundary(output), environmentBoundary('app/browser'), vue()],
+		root: resolveWorkspacePath('app/browser'),
 		publicDir: false,
 		build: {
-{{showcaseBuild}}			emptyOutDir: true,
+			assetsInlineLimit: 0,
+			emptyOutDir: true,
 			outDir: resolveWorkspacePath(output),
 			rolldownOptions: {
 				onLog: enforceBuildLog,
@@ -874,160 +954,229 @@ const resolve = {
 			fileParallelism: false,
 		},
 	}
-}
-
-export function appBrowser(): UserConfig {
-	return applicationBrowser(false)
+	return mergeOverride(project, override)
 }
 {{showcaseFactory}}`,
-			server: `export const appServer = (): UserConfig => ({
-	resolve,
-	publicDir: false,
-	plugins: [outputBoundary('dist/app/server'), environmentBoundary('app/server')],
-	build: {
-		emptyOutDir: true,
-		lib: {
-			entry: resolveWorkspacePath('app/server/main.ts'),
-			formats: ['cjs'],
-			fileName: () => 'main.cjs',
+			showcase: `
+export function appShowcase(override?: UserConfig): UserConfig {
+	const output = 'dist/showcase'
+	const showcase: UserConfig = {
+		plugins: [
+			outputBoundary(output),
+			viteSingleFile({
+				removeViteModuleLoader: true,
+				useRecommendedBuildConfig: true,
+			}),
+			{
+				name: 'orkestrel-showcase-html',
+				transformIndexHtml: {
+					order: 'post',
+					handler(html) {
+						const stamp = new Date().toISOString()
+						return html.replace(
+							'</head>',
+							'\t\t<meta name="build-id" content="' + stamp + '" />\\n\t</head>',
+						)
+					},
+				},
+			},
+		],
+		build: {
+			// The \`appBrowser\` factory sets \`assetsInlineLimit\` to 0, so every asset becomes
+			// its own file, and 4096 is Vite's own default put back. The \`viteSingleFile\`
+			// plugin overwrites the value while the \`useRecommendedBuildConfig\` option stays
+			// true, so this line takes effect only in a workspace that turns that option off.
+			assetsInlineLimit: 4096,
+			cssMinify: 'lightningcss',
+			minify: 'oxc',
+			modulePreload: false,
+			outDir: resolveWorkspacePath(output),
+			reportCompressedSize: false,
+			sourcemap: false,
+			target: 'esnext',
 		},
-		outDir: resolveWorkspacePath('dist/app/server'),
-		target: 'node22',
-		rolldownOptions: {
-			onLog: enforceBuildLog,
-			external: (id: string) => id.startsWith('node:'),
+	}
+	return appBrowser(mergeOverride(showcase, override))
+}
+`,
+			server: `export function appServer(override?: UserConfig): UserConfig {
+	const project: UserConfig = {
+		resolve,
+		publicDir: false,
+		plugins: [outputBoundary('dist/app/server'), environmentBoundary('app/server')],
+		build: {
+			emptyOutDir: true,
+			lib: {
+				entry: resolveWorkspacePath('app/server/main.ts'),
+				formats: ['cjs'],
+				fileName: () => 'main.cjs',
+			},
+			outDir: resolveWorkspacePath('dist/app/server'),
+			target: 'node22',
+			rolldownOptions: {
+				onLog: enforceBuildLog,
+				external: (id: string) => id.startsWith('node:'),
+			},
 		},
-	},
-	test: {
-		name: { label: 'app:server', color: 'green' },
-		include: ['tests/app/server/**/*.test.ts'],
-		setupFiles: ['./tests/setup.ts', './tests/setupServer.ts'],
-		environment: 'node',
-		browser: { enabled: false },
-	},
-})
+		test: {
+			name: { label: 'app:server', color: 'green' },
+			include: ['tests/app/server/**/*.test.ts'],
+			setupFiles: ['./tests/setup.ts', './tests/setupServer.ts'],
+			environment: 'node',
+			browser: { enabled: false },
+		},
+	}
+	return mergeOverride(project, override)
+}
 `
 		}),
-		policy: `export const policy = (): UserConfig => ({
-	resolve,
-	test: {
-		name: { label: 'policy', color: 'white' },
-		include: ['tests/policy.test.ts'],
-		setupFiles: ['./tests/setup.ts'],
-		environment: 'node',
-		browser: { enabled: false },
-	},
-})
+		policy: `export function policy(override?: UserConfig): UserConfig {
+	const project: UserConfig = {
+		resolve,
+		test: {
+			name: { label: 'policy', color: 'white' },
+			include: ['tests/policy.test.ts'],
+			setupFiles: ['./tests/setup.ts'],
+			environment: 'node',
+			browser: { enabled: false },
+		},
+	}
+	return mergeOverride(project, override)
+}
 `,
-		config: `export const config = (): UserConfig => ({
-	resolve,
-	test: {
-		name: { label: 'config', color: 'yellow' },
-		include: ['tests/config.test.ts'],
-		setupFiles: ['./tests/setup.ts'],
-		environment: 'node',
-		browser: { enabled: false },
-		// A config test validates every target wrapper, spawns the real linter twice under
-		// 15-second child caps, and rolls one face up through the compiler and the extractor it
-		// spawns, so this budget clears the capped pair with room for a contended host.
-		testTimeout: 60_000,
-	},
-})
+		config: `export function config(override?: UserConfig): UserConfig {
+	const project: UserConfig = {
+		resolve,
+		test: {
+			name: { label: 'config', color: 'yellow' },
+			include: ['tests/config.test.ts'],
+			setupFiles: ['./tests/setup.ts'],
+			environment: 'node',
+			browser: { enabled: false },
+			// A config test validates every target wrapper, spawns the real linter twice under
+			// 15-second child caps, and rolls one face up through the compiler and the extractor it
+			// spawns, so this budget clears the capped pair with room for a contended host.
+			testTimeout: 60_000,
+		},
+	}
+	return mergeOverride(project, override)
+}
 `,
-		setup: `export const setup = (): UserConfig => ({
-	resolve,
-	test: {
-		name: { label: 'setup', color: 'white' },
-		include: ['tests/setup*.test.ts'],
-		setupFiles: ['./tests/setup.ts'],
-		environment: 'node',
-		browser: { enabled: false },
-	},
-})
+		setup: `export function setup(override?: UserConfig): UserConfig {
+	const project: UserConfig = {
+		resolve,
+		test: {
+			name: { label: 'setup', color: 'white' },
+			include: ['tests/setup*.test.ts'],
+			setupFiles: ['./tests/setup.ts'],
+			environment: 'node',
+			browser: { enabled: false },
+		},
+	}
+	return mergeOverride(project, override)
+}
 `,
-		guides: `export const guides = (): UserConfig => ({
-	resolve,
-	test: {
-		name: { label: 'guides', color: 'green' },
-		include: ['${GUIDES_TEST_PATH}'],
-		exclude: ['tests/src/**/*.test.ts', 'tests/app/**/*.test.ts', 'tests/setup.test.ts'],
-		setupFiles: ['./tests/setup.ts'],
-		environment: 'node',
-		browser: { enabled: false },
-	},
-})
+		guides: `export function guides(override?: UserConfig): UserConfig {
+	const project: UserConfig = {
+		resolve,
+		test: {
+			name: { label: 'guides', color: 'green' },
+			include: ['${GUIDES_TEST_PATH}'],
+			exclude: ['tests/src/**/*.test.ts', 'tests/app/**/*.test.ts', 'tests/setup.test.ts'],
+			setupFiles: ['./tests/setup.ts'],
+			environment: 'node',
+			browser: { enabled: false },
+		},
+	}
+	return mergeOverride(project, override)
+}
 `,
 		conformance: `// Where this package drifts from the official tooling it stays compatible with.
 // The subject is this package, so the proof is hermetic and stays in \`npm test\`.
-export const conformance = (): UserConfig => ({
-	resolve,
-	test: {
-		name: { label: 'conformance', color: 'magenta' },
-		include: ['${CONFORMANCE_TEST_PATH}'],
-		setupFiles: ['./tests/setup.ts'],
-		environment: 'node',
-		browser: { enabled: false },
-	},
-})
+export function conformance(override?: UserConfig): UserConfig {
+	const project: UserConfig = {
+		resolve,
+		test: {
+			name: { label: 'conformance', color: 'magenta' },
+			include: ['${CONFORMANCE_TEST_PATH}'],
+			setupFiles: ['./tests/setup.ts'],
+			environment: 'node',
+			browser: { enabled: false },
+		},
+	}
+	return mergeOverride(project, override)
+}
 `,
 		service: `// The caller prepares the live external services before this project.
 // \`tests/setupService.ts\` verifies readiness, and the project stays out of \`npm test\`
 // because a real service answers it.
-export const service = (): UserConfig => ({
-	resolve,
-	test: {
-		name: { label: 'service', color: 'red' },
-		include: ['${SERVICE_TEST_INCLUDE}'],
-		setupFiles: ['./tests/setup.ts', './tests/setupService.ts'],
-		environment: 'node',
-		browser: { enabled: false },
-		testTimeout: 120_000,
-		hookTimeout: 120_000,
-		fileParallelism: false,
-	},
-})
+export function service(override?: UserConfig): UserConfig {
+	const project: UserConfig = {
+		resolve,
+		test: {
+			name: { label: 'service', color: 'red' },
+			include: ['${SERVICE_TEST_INCLUDE}'],
+			setupFiles: ['./tests/setup.ts', './tests/setupService.ts'],
+			environment: 'node',
+			browser: { enabled: false },
+			testTimeout: 120_000,
+			hookTimeout: 120_000,
+			fileParallelism: false,
+		},
+	}
+	return mergeOverride(project, override)
+}
 `,
-		distribution: `export const distribution = (): UserConfig => ({
-	resolve,
-	test: {
-		name: { label: 'distribution', color: 'cyan' },
-		include: ['${DISTRIBUTION_TEST_PATH}'],
-		setupFiles: ['./tests/setup.ts'],
-		environment: 'node',
-		testTimeout: 120_000,
-		hookTimeout: 120_000,
-		fileParallelism: false,
-	},
-})
+		distribution: `export function distribution(override?: UserConfig): UserConfig {
+	const project: UserConfig = {
+		resolve,
+		test: {
+			name: { label: 'distribution', color: 'cyan' },
+			include: ['${DISTRIBUTION_TEST_PATH}'],
+			setupFiles: ['./tests/setup.ts'],
+			environment: 'node',
+			testTimeout: 120_000,
+			hookTimeout: 120_000,
+			fileParallelism: false,
+		},
+	}
+	return mergeOverride(project, override)
+}
 `,
 		probe: `// A workbench, not a proof. No gate selects this project. Run in test mode by the
 // \`test:probe\` script, it collects \`tmp/probe/**/*.test.ts\`. Run in benchmark mode by the
 // \`test:bench\` script, the same workbench also collects \`tests/**/*.test.ts\` for a \`bench\` block,
 // so a suite may carry a bench beside its ordinary tests without a second project. The mode
 // guard around each \`bench\` call keeps it out of test mode, so it never executes there.
-export const probe = (): UserConfig => ({
-	resolve,
-	test: {
-		name: { label: 'probe', color: 'black' },
-		include: ['tmp/probe/**/*.test.ts'],
-		setupFiles: ['./tests/setup.ts'],
-		environment: 'node',
-		browser: { enabled: false },
-		fileParallelism: false,
-		pool: 'threads',
-		benchmark: { include: ['tmp/probe/**/*.test.ts', 'tests/**/*.test.ts'] },
-	},
-})
+export function probe(override?: UserConfig): UserConfig {
+	const project: UserConfig = {
+		resolve,
+		test: {
+			name: { label: 'probe', color: 'black' },
+			include: ['tmp/probe/**/*.test.ts'],
+			setupFiles: ['./tests/setup.ts'],
+			environment: 'node',
+			browser: { enabled: false },
+			fileParallelism: false,
+			pool: 'threads',
+			benchmark: { include: ['tmp/probe/**/*.test.ts', 'tests/**/*.test.ts'] },
+		},
+	}
+	return mergeOverride(project, override)
+}
 `,
-		integration: `export const integration = (): UserConfig => ({
-	resolve,
-	test: {
-		name: { label: 'integration', color: 'blue' },
-		include: ['${INTEGRATION_TEST_PATH}'],
-		setupFiles: ['./tests/setup.ts'],
-{{global}}		environment: 'node',
-	},
-})
+		integration: `export function integration(override?: UserConfig): UserConfig {
+	const project: UserConfig = {
+		resolve,
+		test: {
+			name: { label: 'integration', color: 'blue' },
+			include: ['${INTEGRATION_TEST_PATH}'],
+			setupFiles: ['./tests/setup.ts'],
+{{global}}			environment: 'node',
+		},
+	}
+	return mergeOverride(project, override)
+}
 `
 	}),
 	tsconfigs: Object.freeze({
@@ -1155,12 +1304,12 @@ export const probe = (): UserConfig => ({
 	}),
 	vites: Object.freeze({
 		src: Object.freeze({
-			core: `import { defineConfig, mergeConfig } from 'vite'
+			core: `import { defineConfig } from 'vite'
 import { declarationRollup, environmentBoundary, outputBoundary } from '../helpers.js'
 import { peers, srcCore, resolveWorkspacePath } from '../../vite.config.ts'
 
 export default defineConfig(
-	mergeConfig(srcCore(), {
+	srcCore({
 		publicDir: false,
 		plugins: [
 			outputBoundary('dist/src/core'),
@@ -1187,14 +1336,14 @@ export default defineConfig(
 	}),
 )
 `,
-			browser: `import { defineConfig, mergeConfig } from 'vite'
+			browser: `import { defineConfig } from 'vite'
 import { declarationRollup, rewriteCoreSpecifier } from '../helpers.js'
 import { srcBrowser, resolveWorkspacePath } from '../../vite.config.ts'
 
 // The roll-up reaches src/core through a specifier the tarball does not carry, so the rewrite
 // externalizes core through the package's own published root export, on the final roll-up alone.
 export default defineConfig(
-	mergeConfig(srcBrowser(), {
+	srcBrowser({
 		plugins: [
 			declarationRollup({
 				project: resolveWorkspacePath('configs/src/tsconfig.browser.json'),
@@ -1204,14 +1353,14 @@ export default defineConfig(
 	}),
 )
 `,
-			server: `import { defineConfig, mergeConfig } from 'vite'
+			server: `import { defineConfig } from 'vite'
 import { declarationRollup, rewriteCoreSpecifier } from '../helpers.js'
 import { srcServer, resolveWorkspacePath } from '../../vite.config.ts'
 
 // The roll-up reaches src/core through a specifier the tarball does not carry, so the rewrite
 // externalizes core through the package's own published root export, on the final roll-up alone.
 export default defineConfig(
-	mergeConfig(srcServer(), {
+	srcServer({
 		plugins: [
 			declarationRollup({
 				project: resolveWorkspacePath('configs/src/tsconfig.server.json'),
@@ -1222,7 +1371,7 @@ export default defineConfig(
 )
 `
 		}),
-		bin: `import { defineConfig, mergeConfig } from 'vite'
+		bin: `import { defineConfig } from 'vite'
 import { srcBin } from '../../vite.config.ts'
 
 // The \`scaffold\` executable build — a single ESM lib file, no declarations (an
@@ -1231,7 +1380,7 @@ import { srcBin } from '../../vite.config.ts'
 // \`output.paths\` rewriting the externalized \`@src/*\` specifiers to the built sibling
 // src environments (relative to \`dist/bin/\`), so the emitted bin resolves at runtime.
 export default defineConfig(
-	mergeConfig(srcBin(), {
+	srcBin({
 		build: {
 			rolldownOptions: {
 				output: {
@@ -2851,7 +3000,7 @@ var ScaffoldError = class extends Error {
 * ```
 */
 function isScaffoldError(value) {
-	return value instanceof ScaffoldError;
+	return (0, _orkestrel_contract.isInstance)(value, ScaffoldError);
 }
 //#endregion
 //#region src/core/validators.ts
@@ -4999,14 +5148,14 @@ function blueprintToRootVite(blueprint) {
 		const core = blueprint.src.includes("core");
 		factories.push((0, _orkestrel_template.fillTemplate)(CONFIG_TEMPLATES.factories.src.browser, {
 			external: core ? `external: (id: string) =>
-				id === '@src/core' ||
-				id.startsWith('@orkestrel/') ||
-				peers.some((peer) => id === peer || id.startsWith(peer + '/')),` : `external: (id: string) =>
-				id.startsWith('@orkestrel/') ||
-				peers.some((peer) => id === peer || id.startsWith(peer + '/')),`,
-			output: core ? "			output: { paths: { '@src/core': '../core/index.js' } }," : "			output: {},",
-			exclude: core ? "		exclude: ['tests/src/core/**/*.test.ts'],\n" : "",
-			global: blueprint.global ? "		globalSetup: ['./tests/setupGlobal.ts'],\n" : ""
+					id === '@src/core' ||
+					id.startsWith('@orkestrel/') ||
+					peers.some((peer) => id === peer || id.startsWith(peer + '/')),` : `external: (id: string) =>
+					id.startsWith('@orkestrel/') ||
+					peers.some((peer) => id === peer || id.startsWith(peer + '/')),`,
+			output: core ? "				output: { paths: { '@src/core': '../core/index.js' } }," : "				output: {},",
+			exclude: core ? "			exclude: ['tests/src/core/**/*.test.ts'],\n" : "",
+			global: blueprint.global ? "			globalSetup: ['./tests/setupGlobal.ts'],\n" : ""
 		}));
 		projects.push("srcBrowser");
 	}
@@ -5014,26 +5163,26 @@ function blueprintToRootVite(blueprint) {
 		const core = blueprint.src.includes("core");
 		factories.push((0, _orkestrel_template.fillTemplate)(CONFIG_TEMPLATES.factories.src.server, {
 			external: core ? `external: (id: string) =>
-				id === '@src/core' ||
-				id.startsWith('node:') ||
-				id.startsWith('@orkestrel/') ||
-				peers.some((peer) => id === peer || id.startsWith(peer + '/')),` : `external: (id: string) =>
-				id.startsWith('node:') ||
-				id.startsWith('@orkestrel/') ||
-				peers.some((peer) => id === peer || id.startsWith(peer + '/')),`,
-			output: core ? `\t\t\toutput: [
-				{
-					format: 'es',
-					entryFileNames: 'index.js',
-					paths: { '@src/core': '../core/index.js' },
-				},
-				{
-					format: 'cjs',
-					entryFileNames: 'index.cjs',
-					paths: { '@src/core': '../core/index.cjs' },
-				},
-			],` : "			output: {},",
-			exclude: core ? "		exclude: ['tests/src/core/**/*.test.ts'],\n" : ""
+					id === '@src/core' ||
+					id.startsWith('node:') ||
+					id.startsWith('@orkestrel/') ||
+					peers.some((peer) => id === peer || id.startsWith(peer + '/')),` : `external: (id: string) =>
+					id.startsWith('node:') ||
+					id.startsWith('@orkestrel/') ||
+					peers.some((peer) => id === peer || id.startsWith(peer + '/')),`,
+			output: core ? `\t\t\t\toutput: [
+					{
+						format: 'es',
+						entryFileNames: 'index.js',
+						paths: { '@src/core': '../core/index.js' },
+					},
+					{
+						format: 'cjs',
+						entryFileNames: 'index.cjs',
+						paths: { '@src/core': '../core/index.cjs' },
+					},
+				],` : "				output: {},",
+			exclude: core ? "			exclude: ['tests/src/core/**/*.test.ts'],\n" : ""
 		}));
 		projects.push("srcServer");
 	}
@@ -5046,57 +5195,8 @@ function blueprintToRootVite(blueprint) {
 		projects.push("appCore");
 	}
 	if (blueprint.app.includes("browser")) {
-		const showcasePlugins = machinery.showcase ? `	const showcasePlugins: PluginOption[] = showcase
-		? [
-				viteSingleFile({
-					removeViteModuleLoader: true,
-					useRecommendedBuildConfig: true,
-				}),
-				{
-					name: 'orkestrel-showcase-html',
-					transformIndexHtml: {
-						order: 'post',
-						handler(html) {
-							const stamp = new Date().toISOString()
-							return html.replace(
-								'</head>',
-								'\t\t<meta name="build-id" content="' + stamp + '" />\\n\t</head>',
-							)
-						},
-					},
-				},
-			]
-		: []
-` : "";
-		const plugins = machinery.showcase ? `\t\tplugins: [
-			outputBoundary(output),
-			environmentBoundary('app/browser'),
-			vue(),
-			...showcasePlugins,
-		],
-` : "		plugins: [outputBoundary(output), environmentBoundary('app/browser'), vue()],\n";
-		const showcaseBuild = machinery.showcase ? `\t\t\t...(showcase
-				? {
-						cssMinify: 'lightningcss',
-						minify: 'oxc',
-						modulePreload: false,
-						reportCompressedSize: false,
-						sourcemap: false,
-						target: 'esnext',
-					}
-				: { assetsInlineLimit: 0 }),
-` : "			assetsInlineLimit: 0,\n";
-		const showcaseFactory = machinery.showcase ? `
-export function appShowcase(): UserConfig {
-	return applicationBrowser(true)
-}
-` : "";
-		factories.push((0, _orkestrel_template.fillTemplate)(CONFIG_TEMPLATES.factories.app.browser, {
-			plugins,
-			showcasePlugins,
-			showcaseBuild,
-			showcaseFactory
-		}));
+		const showcaseFactory = machinery.showcase ? CONFIG_TEMPLATES.factories.app.showcase : "";
+		factories.push((0, _orkestrel_template.fillTemplate)(CONFIG_TEMPLATES.factories.app.browser, { showcaseFactory }));
 		projects.push("appBrowser");
 	}
 	if (blueprint.app.includes("server")) {
@@ -5128,7 +5228,7 @@ export function appShowcase(): UserConfig {
 		projects.push("distribution");
 	}
 	if (blueprint.integration) {
-		factories.push((0, _orkestrel_template.fillTemplate)(CONFIG_TEMPLATES.factories.integration, { global: blueprint.global ? "		globalSetup: ['./tests/setupGlobal.ts'],\n" : "" }));
+		factories.push((0, _orkestrel_template.fillTemplate)(CONFIG_TEMPLATES.factories.integration, { global: blueprint.global ? "			globalSetup: ['./tests/setupGlobal.ts'],\n" : "" }));
 		projects.push("integration");
 	}
 	factories.push(CONFIG_TEMPLATES.factories.probe);
@@ -5144,7 +5244,6 @@ ${projects.map((project) => `\t\t\t${project},`).join("\n")}
 		"outputBoundary"
 	].filter((helper) => body.includes(helper));
 	return (0, _orkestrel_template.fillTemplate)(CONFIG_TEMPLATES.root.vite, {
-		viteTypes: machinery.showcase ? "PluginOption, UserConfig" : "UserConfig",
 		imports: imports.length === 0 ? "" : `${imports.join("\n")}\n`,
 		helpers: helpers.length === 0 ? "" : `import { ${helpers.join(", ")} } from './configs/helpers.js'\n`,
 		browsers: machinery.browser ? "import { resolveBrowser, resolvePinnedBrowser } from './configs/browsers.js'\n" : "",
@@ -5791,7 +5890,7 @@ function replaceManifestRanges(manifest, pins) {
 			if (manifest.charAt(value) === ":") {
 				value += 1;
 				while (value < manifest.length && /\s/u.test(manifest.charAt(value))) value += 1;
-				if (typeof key === "string" && sectionNames.has(key) && manifest.charAt(value) === "{") {
+				if ((0, _orkestrel_contract.isString)(key) && sectionNames.has(key) && manifest.charAt(value) === "{") {
 					let sectionDepth = 0;
 					let sectionCursor = value;
 					while (sectionCursor < manifest.length) {
@@ -5873,7 +5972,7 @@ function replaceManifestRanges(manifest, pins) {
 			}
 			valueStart += 1;
 			while (valueStart < section.length && /\s/u.test(section.charAt(valueStart))) valueStart += 1;
-			if (typeof key !== "string" || section.charAt(valueStart) !== "\"") {
+			if (!(0, _orkestrel_contract.isString)(key) || section.charAt(valueStart) !== "\"") {
 				sectionCursor = keyEnd;
 				continue;
 			}